Merge pull request #155 from appwrite/fix-specs-links

fix: specs links

package.json

@@ -53,7 +53,7 @@
     "dependencies": {
         "@appwrite.io/pink": "0.1.0-next.9",
         "@appwrite.io/pink-icons": "0.1.0-next.9",
-        "@appwrite.io/repo": "github:appwrite/appwrite",
+        "@appwrite.io/repo": "github:appwrite/appwrite#main",
         "@splinetool/viewer": "0.9.455",
         "compression": "^1.7.4",
         "express": "^4.18.2",

src/lib/utils/markdown.ts

@@ -2,35 +2,38 @@ import MarkdownIt from 'markdown-it';
 
 const md = new MarkdownIt('commonmark');
 export function parse(content: string): string {
-	const tokens = md.parse(content, null);
+    const tokens = md.parse(content, null);
 
-	return md.renderer.render(
-		transform_tokens(tokens),
-		{
-			highlight: null
-		},
-		null
-	);
+    return md.renderer.render(
+        transform_tokens(tokens),
+        {
+            highlight: null
+        },
+        null
+    );
 }
 
 function transform_tokens(tokens: ReturnType<typeof md.parse>): ReturnType<typeof md.parse> {
-	return tokens.map((token) => {
-		if (token.children) {
-			token.children = transform_tokens(token.children);
-		}
-		switch (token.type) {
-			case 'paragraph_open':
-				token.attrPush(['class', 'aw-paragraph']);
-				break;
-			case 'link_open':
-				if (token.attrGet('href')?.startsWith('http')) {
-					token.attrPush(['target', '_blank']);
-				}
-				// disable links for now
-				token.attrSet('href', '#');
-				token.attrPush(['class', 'aw-link']);
-				break;
-		}
-		return token;
-	});
+    return tokens.map((token) => {
+        if (token.children) {
+            token.children = transform_tokens(token.children);
+        }
+        switch (token.type) {
+            case 'paragraph_open':
+                token.attrPush(['class', 'aw-paragraph']);
+                break;
+            case 'link_open': {
+                const href = token.attrGet('href');
+                if (href?.startsWith('http')) {
+                    if (!href.startsWith('https://appwrite.io')) {
+						token.attrPush(['rel', 'noopener noreferrer']);
+                        token.attrPush(['target', '_blank']);
+                    }
+                }
+                token.attrPush(['class', 'aw-link']);
+                break;
+            }
+        }
+        return token;
+    });
 }

src/routes/docs/references/[version]/[platform]/[service]/+page.svelte

@@ -151,7 +151,7 @@
 				<section class="aw-article-content-grid-6-4">
 					<div class="aw-article-content-grid-6-4-column-1 u-flex-vertical u-gap-32">
 						<header class="aw-article-content-header">
-							<Heading id={method.id} level={2} inReferences>{method.title}</Heading>
+							<Heading id={method.id} level={1} inReferences>{method.title}</Heading>
 						</header>
 						<p class="aw-sub-body-400">
 							{@html parse(method.description)}

src/routes/docs/references/[version]/[platform]/[service]/descriptions/account.md

@@ -1,5 +1,5 @@
 The Account service allows you to authenticate and manage a user account. You can use the account service to update user information, retrieve the user sessions across different devices, and fetch the user security logs with his or her recent activity.
 
-Register new user accounts with the [Create Account](#create), [Create Magic URL session](#createMagicURLSession), or [Create Phone session](#createPhoneSession) endpoint. You can authenticate the user account by using multiple sign-in methods available. Once the user is authenticated, a new session object will be created to allow the user to access his or her private data and settings.
+Register new user accounts with the [Create Account](/docs/references/cloud/client-web/account#create), [Create Magic URL session](/docs/references/cloud/client-web/account#createMagicURLSession), or [Create Phone session](/docs/references/cloud/client-web/account#createPhoneSession) endpoint. You can authenticate the user account by using multiple sign-in methods available. Once the user is authenticated, a new session object will be created to allow the user to access his or her private data and settings.
 
-This service also exposes an endpoint to save and read the [user preferences](#updatePrefs) as a key-value object. This feature is handy if you want to allow extra customization in your app. Common usage for this feature may include saving the user's preferred locale, timezone, or custom app theme.
+This service also exposes an endpoint to save and read the [user preferences](/docs/references/cloud/client-web/account#updatePrefs) as a key-value object. This feature is handy if you want to allow extra customization in your app. Common usage for this feature may include saving the user's preferred locale, timezone, or custom app theme.