docs: fix syntax highlighting (#137)

Author: CodeShellDev

docs/integrations/authentik/authentik.md

@@ -72,17 +72,7 @@ return {
 Since you have decided to go the advanced way, you will have to use [**Message Templates**](../configuration/message-templates), here is an example:
 
 ```yaml
-settings:
-  message:
-    template: |
-      **Your Verification Code**
-
-      Use the verification code below to complete your sign-in:
-
-      {{ @token }}
-
-      This code expires in 5 minutes⏱️. 
-      If you didn’t request it, you can ignore this message.
+{{{ #://./message-template.yaml }}}
 ```
 
 ### 4. Enable SMS-Verification

docs/integrations/authentik/message-template.yml

@@ -1,11 +1,12 @@
 settings:
   message:
+    # prettier-ignore
     template: |
       **Your Verification Code**
 
       Use the verification code below to complete your sign-in:
 
       {{ @token }}
-
+      
       This code expires in 5 minutes⏱️. 
       If you didn’t request it, you can ignore this message.

docs/integrations/gitea/message-template.yml

@@ -1,20 +1,21 @@
 settings:
   message:
+    # prettier-ignore
     template: |
       {{- /* === ISSUE === */ - }}
       {{- if and @issue (ne @issue nil) (not @is_pull) -}}
       📝 **#{{@issue.number}} {{@issue.title}}**  
       {{ if eq @issue.state "open" -}}🟢{{- else if eq @issue.state "closed" -}}🔴{{- else -}}{{@issue.state}}{{- end }} | 👤 {{@sender.full_name}}
       🔗 {{@issue.html_url}}
       {{- end -}}
-
+      
       {{- /* === PULL REQUEST === */ - }}
       {{- if and @pull_request (ne @pull_request nil) -}}
       🚀 **#{{@pull_request.number}} {{@pull_request.title}}**  
       {{ if eq @pull_request.state "open" -}}🟢{{- else if eq @pull_request.state "closed" -}}🔴{{- else if eq @pull_request.state "merged" -}}🟣{{- else -}}{{@pull_request.state}}{{- end }} | 👤 {{@sender.full_name}}
       🔗 {{@pull_request.html_url}}
       {{- end -}}
-
+      
       {{- /* === COMMIT === */ - }}
       {{- if and @commits (gt (len @commits) 0) }}
       📥️ **Push** → *{{@ref}}*  
@@ -32,6 +33,6 @@ settings:
         {{- end }}
         🔗 {{.url}}
       {{- end }}
-
+      
       🔎 Compare: {{@compare_url}}
       {{- end -}}

docusaurus.config.js

@@ -62,7 +62,11 @@ const config = {
 					beforeDefaultRemarkPlugins: [
 						require("remark-github-admonitions-to-directives"),
 					],
-					remarkPlugins: [require("remark-gfm"), require("remark-directive")],
+					remarkPlugins: [
+						require("remark-gfm"),
+						require("remark-directive"),
+						require("./prettier-ignore"),
+					],
 				},
 				theme: {
 					customCss: ["./src/css/custom.css"],
@@ -144,7 +148,6 @@ const config = {
 				additionalLanguages: [
 					"bash",
 					"apacheconf",
-					"custom-yaml-scalar",
 					"custom-go-template",
 					"custom-yaml-go-template",
 					"custom-yaml-empty-key",

package-lock.json

@@ -24,7 +24,8 @@
 		"react-dom": "^19.0.0",
 		"remark-directive": "^4.0.0",
 		"remark-gfm": "^4.0.1",
-		"remark-github-admonitions-to-directives": "^2.1.0"
+		"remark-github-admonitions-to-directives": "^2.1.0",
+		"unist-util-visit": "^5.0.0"
 	},
 	"devDependencies": {
 		"@docusaurus/module-type-aliases": "3.9.2",

package.json

@@ -0,0 +1,15 @@
+module.exports = () => {
+	return (tree) => {
+		const visit = require("unist-util-visit").visit
+
+		visit(tree, "code", (node) => {
+			if (node.value) {
+				// Remove any line that contains "# prettier-ignore"
+				node.value = node.value
+					.split("\n")
+					.filter((line) => !line.includes("# prettier-ignore"))
+					.join("\n")
+			}
+		})
+	}
+}

prettier-ignore.js

@@ -9,7 +9,7 @@ const lang = "go-template"
 			alias: "comment",
 			inside: {
 				delimiter: /^\{\{\/\*|\*\/\}\}/,
-				content: /[\s\S]+/, // the inner comment content
+				content: /[\s\S]+/,
 			},
 		},
 
@@ -20,7 +20,7 @@ const lang = "go-template"
 			alias: "variable",
 			inside: {
 				delimiter: /^\{\{|\}\}$/,
-				expression: /[\s\S]+/, // the inner expression
+				expression: /[\s\S]+/,
 			},
 		},
 	}