From 5599eb590e1b9163d41847153545764ed9b02ff6 Mon Sep 17 00:00:00 2001
From: Jacky Zhao <j.zhao2k19@gmail.com>
Date: Sun, 23 Jul 2023 21:02:57 +0000
Subject: [PATCH] feat: process tags in content

---
 quartz/plugins/transformers/links.ts  |    3 +
 content/features/upcoming features.md |    6 --
 quartz/plugins/transformers/ofm.ts    |   48 ++++++++++++++++++------
 quartz/components/TagList.tsx         |    4 +-
 4 files changed, 41 insertions(+), 20 deletions(-)

diff --git a/content/features/upcoming features.md b/content/features/upcoming features.md
index 5cb7b97..de16880 100644
--- a/content/features/upcoming features.md
+++ b/content/features/upcoming features.md
@@ -2,7 +2,6 @@
 draft: true
 ---
 
-- parse tags in content
 - breadcrumbs component
 - filetree component
 - recent notes component
@@ -10,10 +9,7 @@
 - [https://giscus.app/](https://giscus.app/) extension
 - custom md blocks (e.g. for poetry)
 - sidenotes? [https://github.com/capnfabs/paperesque](https://github.com/capnfabs/paperesque)
-- watch mode
-  - watch for markdown changes and quartz config changes
-  - markdown changes only involve processing that single markdown file (at least for parsing) and then rerunning the filter and emitters
-  - config changes rebuild the whole thing
+- watch mode for config/source code
 - direct match in search using double quotes
 - attachments path
 - [https://help.obsidian.md/Advanced+topics/Using+Obsidian+URI](https://help.obsidian.md/Advanced+topics/Using+Obsidian+URI)
diff --git a/quartz/components/TagList.tsx b/quartz/components/TagList.tsx
index c36b0a2..8b90955 100644
--- a/quartz/components/TagList.tsx
+++ b/quartz/components/TagList.tsx
@@ -14,7 +14,7 @@
           const linkDest = baseDir + `/tags/${slugAnchor(tag)}`
           return (
             <li>
-              <a href={linkDest} class="internal">
+              <a href={linkDest} class="internal tag-link">
                 {display}
               </a>
             </li>
@@ -42,7 +42,7 @@
   overflow-wrap: normal;
 }
 
-.tags > li > a {
+a.tag-link {
   border-radius: 8px;
   background-color: var(--highlight);
   padding: 0.2rem 0.5rem;
diff --git a/quartz/plugins/transformers/links.ts b/quartz/plugins/transformers/links.ts
index 96c5f58..e496171 100644
--- a/quartz/plugins/transformers/links.ts
+++ b/quartz/plugins/transformers/links.ts
@@ -72,7 +72,8 @@
                 typeof node.properties.href === "string"
               ) {
                 let dest = node.properties.href as RelativeURL
-                node.properties.className = isAbsoluteUrl(dest) ? "external" : "internal"
+                node.properties.className ??= []
+                node.properties.className.push(isAbsoluteUrl(dest) ? "external" : "internal")
 
                 // don't process external links or intra-document anchors
                 if (!(isAbsoluteUrl(dest) || dest.startsWith("#"))) {
diff --git a/quartz/plugins/transformers/ofm.ts b/quartz/plugins/transformers/ofm.ts
index 23b1401..6b68fcc 100644
--- a/quartz/plugins/transformers/ofm.ts
+++ b/quartz/plugins/transformers/ofm.ts
@@ -9,7 +9,7 @@
 import { JSResource } from "../../resources"
 // @ts-ignore
 import calloutScript from "../../components/scripts/callout.inline.ts"
-import { FilePath, slugifyFilePath } from "../../path"
+import { FilePath, canonicalizeServer, pathToRoot, slugifyFilePath } from "../../path"
 
 export interface Options {
   comments: boolean
@@ -17,6 +17,7 @@
   wikilinks: boolean
   callouts: boolean
   mermaid: boolean
+  parseTags: boolean
 }
 
 const defaultOptions: Options = {
@@ -25,6 +26,7 @@
   wikilinks: true,
   callouts: true,
   mermaid: true,
+  parseTags: true,
 }
 
 const icons = {
@@ -97,22 +99,19 @@
   return s.substring(0, 1).toUpperCase() + s.substring(1)
 }
 
-// Match wikilinks
 // !?               -> optional embedding
 // \[\[             -> open brace
 // ([^\[\]\|\#]+)   -> one or more non-special characters ([,],|, or #) (name)
 // (#[^\[\]\|\#]+)? -> # then one or more non-special characters (heading link)
 // (|[^\[\]\|\#]+)? -> | then one or more non-special characters (alias)
 const wikilinkRegex = new RegExp(/!?\[\[([^\[\]\|\#]+)(#[^\[\]\|\#]+)?(\|[^\[\]\|\#]+)?\]\]/, "g")
-
-// Match highlights
 const highlightRegex = new RegExp(/==(.+)==/, "g")
-
-// Match comments
 const commentRegex = new RegExp(/%%(.+)%%/, "g")
-
 // from https://github.com/escwxyz/remark-obsidian-callout/blob/main/src/index.ts
 const calloutRegex = new RegExp(/^\[\!(\w+)\]([+-]?)/)
+// (?:^| )   -> non-capturing group, tag should start be separated by a space or be the start of the line
+// #(\w+)    -> tag itself is # followed by a string of alpha-numeric characters 
+const tagRegex = new RegExp(/(?:^| )#(\w+)/, "g")
 
 export const ObsidianFlavoredMarkdown: QuartzTransformerPlugin<Partial<Options> | undefined> = (
   userOpts,
@@ -226,7 +225,7 @@
             findAndReplace(tree, commentRegex, (_value: string, ..._capture: string[]) => {
               return {
                 type: "text",
-                value: "",
+                value: ""
               }
             })
           }
@@ -297,9 +296,8 @@
                 node.data = {
                   hProperties: {
                     ...(node.data?.hProperties ?? {}),
-                    className: `callout ${collapse ? "is-collapsible" : ""} ${
-                      defaultState === "collapsed" ? "is-collapsed" : ""
-                    }`,
+                    className: `callout ${collapse ? "is-collapsible" : ""} ${defaultState === "collapsed" ? "is-collapsed" : ""
+                      }`,
                     "data-callout": calloutType,
                     "data-callout-fold": collapse,
                   },
@@ -317,7 +315,7 @@
               if (node.lang === "mermaid") {
                 node.data = {
                   hProperties: {
-                    className: "mermaid",
+                    className: ["mermaid"],
                   },
                 }
               }
@@ -326,6 +324,32 @@
         })
       }
 
+      if (opts.parseTags) {
+        plugins.push(() => {
+          return (tree: Root, file) => {
+            const slug = canonicalizeServer(file.data.slug!)
+            const base = pathToRoot(slug)
+            findAndReplace(tree, tagRegex, (value: string, tag: string) => {
+              return {
+                type: "link",
+                url: base + `/tags/${slugAnchor(tag)}`,
+                data: {
+                  hProperties: {
+                    className: ["tag-link"],
+                  },
+                },
+                children: [
+                  {
+                    type: "text",
+                    value,
+                  },
+                ],
+              }
+            })
+          }
+        })
+      }
+
       return plugins
     },
     htmlPlugins() {

--
Gitblit v1.10.0