Feat: Migrate the guides from protocol documentation (#36)

Co-authored-by: Robin Le Caignec <72495599+Le-Caignec@users.noreply.github.com>
Co-authored-by: Le-Caignec <robinlecaignec@yahoo.fr>

Author: 64ix

.vitepress/config.mts

@@ -0,0 +1,142 @@
+import { transformerTwoslash } from '@shikijs/vitepress-twoslash';
+import tailwindcss from '@tailwindcss/vite';
+import { defineConfig, loadEnv } from 'vitepress';
+import { fileURLToPath, URL } from 'node:url';
+import { getSidebar } from './sidebar';
+import {
+  groupIconMdPlugin,
+  groupIconVitePlugin,
+} from 'vitepress-plugin-group-icons';
+import { withMermaid } from 'vitepress-plugin-mermaid';
+
+// Charger les variables d'environnement
+const env = loadEnv('', process.cwd());
+
+// https://vitepress.dev/reference/site-config
+export default withMermaid(
+  defineConfig({
+    title: 'iExec documentation',
+    description:
+      'Build decentralized applications that combine ownership, privacy, and monetization.',
+    cleanUrls: true,
+    lastUpdated: true,
+    vite: {
+      plugins: [tailwindcss(), groupIconVitePlugin()],
+      resolve: {
+        alias: {
+          '@': fileURLToPath(new URL('../src', import.meta.url)),
+        },
+      },
+      // Expose environment variables to the client
+      define: {
+        'import.meta.env.VITE_REOWN_PROJECT_ID': JSON.stringify(
+          env.VITE_REOWN_PROJECT_ID
+        ),
+      },
+    },
+    srcDir: './src',
+    markdown: {
+      codeTransformers: [transformerTwoslash()],
+      config(md) {
+        md.use(groupIconMdPlugin);
+      },
+    },
+
+    head: [
+      ['link', { rel: 'icon', href: '/Logo-RLC-Yellow.png' }],
+      [
+        'link',
+        {
+          rel: 'stylesheet',
+          href: 'https://fonts.googleapis.com/css2?family=Open+Sans:ital,wght@0,300;0,400;0,500;0,600;0,700;0,800;1,300;1,400;1,500;1,600;1,700;1,800&display=swap',
+        },
+      ],
+      [
+        'script',
+        {},
+        `
+      window.axeptioSettings = {
+        clientId: "6413111857e4d2a6342cd5c6",
+        cookiesVersion: "iexec-en",
+      };
+
+      (function(d, s) {
+        var t = d.getElementsByTagName(s)[0], e = d.createElement(s);
+        e.async = true; e.src = "//static.axept.io/sdk.js";
+        t.parentNode.insertBefore(e, t);
+      })(document, "script");
+      `,
+      ],
+      // Mava widget
+      [
+        'script',
+        {
+          defer: '',
+          src: 'https://widget.mava.app',
+          'widget-version': 'v2',
+          id: 'MavaWebChat',
+          'enable-sdk': 'false',
+          'data-token':
+            '8e4e10aad5750451e8726768e8c639dae54f461beeb176f5ebd687371c9390f2',
+        },
+      ],
+      // Hotjar Tracking Script
+      [
+        'script',
+        {},
+        `
+      (function(h,o,t,j,a,r){
+          h.hj=h.hj||function(){(h.hj.q=h.hj.q||[]).push(arguments)};
+          h._hjSettings={hjid:5303222,hjsv:6};
+          a=o.getElementsByTagName('head')[0];
+          r=o.createElement('script');r.async=1;
+          r.src=t+h._hjSettings.hjid+j+h._hjSettings.hjsv;
+          a.appendChild(r);
+      })(window,document,'https://static.hotjar.com/c/hotjar-','.js?sv=');
+      `,
+      ],
+    ],
+
+    themeConfig: {
+      // https://vitepress.dev/reference/default-theme-config
+      nav: [
+        { text: 'Get Started', link: '/get-started/welcome' },
+        { text: 'Guides', link: '/guides/build-iapp/' },
+        { text: 'References', link: '/references/dataProtector' },
+        {
+          component: 'ChainSelector',
+          props: {
+            className: 'w-48',
+          },
+        },
+      ],
+      outline: {
+        level: [2, 4],
+      },
+
+      sidebar: getSidebar(),
+
+      search: {
+        provider: 'local',
+      },
+
+      socialLinks: [
+        { icon: 'github', link: 'https://github.com/iExecBlockchainComputing' },
+        { icon: 'x', link: 'https://twitter.com/iEx_ec' },
+        { icon: 'discord', link: 'https://discord.com/invite/pbt9m98wnU' },
+      ],
+
+      editLink: {
+        pattern:
+          'https://github.com/iExecBlockchainComputing/documentation/blob/main/:path',
+        text: 'Suggest changes to this page',
+      },
+
+      logo: {
+        light: '/Logo-RLC-Yellow.png',
+        dark: '/Logo-RLC-Yellow.png',
+        alt: 'iExec logo',
+      },
+    },
+  })
+);

.vitepress/config.ts

@@ -127,6 +127,16 @@ export function getSidebar() {
               },
             ],
           },
+          {
+            text: 'TEE Technology',
+            collapsed: true,
+            items: [
+              {
+                text: 'Intel SGX Technology Overview',
+                link: '/get-started/protocol/tee/intel-sgx-technology',
+              },
+            ],
+          },
         ],
       },
     ],
@@ -175,6 +185,44 @@ export function getSidebar() {
             text: 'Debugging',
             link: '/guides/build-iapp/debugging',
           },
+          {
+            text: 'Advanced',
+            collapsed: true,
+            items: [
+              {
+                text: 'Overview',
+                link: '/guides/build-iapp/advanced/overview',
+              },
+              {
+                text: 'Quick Start for Developers',
+                link: '/guides/build-iapp/advanced/quick-start-for-developers',
+              },
+              {
+                text: 'Build your first application',
+                link: '/guides/build-iapp/advanced/your-first-app',
+              },
+              {
+                text: 'Build your first SGX app (SCONE)',
+                link: '/guides/build-iapp/advanced/create-your-first-sgx-app',
+              },
+              {
+                text: 'End-to-end Encryption',
+                link: '/guides/build-iapp/advanced/end-to-end-encryption',
+              },
+              {
+                text: 'SGX Encrypted Dataset',
+                link: '/guides/build-iapp/advanced/sgx-encrypted-dataset',
+              },
+              {
+                text: 'Access Confidential Assets',
+                link: '/guides/build-iapp/advanced/access-confidential-assets',
+              },
+              {
+                text: 'Build Intel TDX app',
+                link: '/guides/build-iapp/advanced/create-your-first-tdx-app',
+              },
+            ],
+          },
         ],
       },
       {
@@ -562,5 +610,5 @@ export function getSidebar() {
         link: '/references/glossary',
       },
     ],
-  } satisfies DefaultTheme.Sidebar;
+  } as DefaultTheme.Sidebar;
 }

.vitepress/sidebar.ts

@@ -192,3 +192,4 @@ for input parameters:
 - migrate github SDK doc here
 - migrate pay-per-task page into a guide
 - check pages (introduction & getting-started) for use-iapp guide
+- Rework Advanced iApp building guides. (from "old" protocol doc)