From b840e9fa7fa0aa7f77b43f0bb341ab6544947344 Mon Sep 17 00:00:00 2001
From: bcdax110 <bcdax110@qq.com>
Date: Sat, 2 Mar 2024 00:19:00 +0800
Subject: [PATCH 1/3] feat: Add field id_base62 to Highlight

---
 package.json                              |  3 ++-
 src/models.ts                             |  1 +
 src/parser/parseSyncResponse.ts           | 14 +++++++++++++-
 src/settingsTab/templateInstructions.html |  3 ++-
 4 files changed, 18 insertions(+), 3 deletions(-)

diff --git a/package.json b/package.json
index 6c7172b..dc9cad0 100644
--- a/package.json
+++ b/package.json
@@ -48,6 +48,7 @@
     "typescript": "^4.2.4",
     "webpack": "^5.30.0",
     "webpack-cli": "^4.6.0",
-    "webpack-node-externals": "^2.5.2"
+    "webpack-node-externals": "^2.5.2",
+    "base-x": "^4.0.0"
   }
 }
\ No newline at end of file
diff --git a/src/models.ts b/src/models.ts
index c39a7a0..d347b44 100644
--- a/src/models.ts
+++ b/src/models.ts
@@ -14,6 +14,7 @@ export type Metadata = {
 
 export type Highlights = {
   id?: string;
+  id_base62?: string;
   created: string;
   updated: string;
   text: string;
diff --git a/src/parser/parseSyncResponse.ts b/src/parser/parseSyncResponse.ts
index 75a1527..b038b1a 100644
--- a/src/parser/parseSyncResponse.ts
+++ b/src/parser/parseSyncResponse.ts
@@ -2,8 +2,12 @@ import md5 from 'crypto-js/md5';
 import { moment } from 'obsidian';
 import { settingsStore } from '~/store';
 import { get } from 'svelte/store';
+import basex from 'base-x';
 import type { Article, Highlights } from '../models'
 
+const BASE62_CHARSET = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
+const base62 = basex(BASE62_CHARSET);
+
 const parseAuthorUrl = (url: string) => {
     const domain = (new URL(url));
     const author = domain.hostname.replace('www.', '');
@@ -52,8 +56,16 @@ const parseHighlight = (annotationData, groupName: string, momentFormat: string)
             }
         }
 
+        const id = annotationData['id'];
+        let id_base62 = null;
+        if(id != null){
+            const uint8Array = Buffer.from(id, 'utf-8');
+            id_base62 = base62.encode(uint8Array);
+        }
+
         return {
-            id: annotationData['id'],
+            id,
+            id_base62,
             created: moment(annotationData['created']).format(momentFormat),
             updated: moment(annotationData['updated']).format(momentFormat),
             text: highlightText && cleanTextSelectorHighlight(highlightText),
diff --git a/src/settingsTab/templateInstructions.html b/src/settingsTab/templateInstructions.html
index 43dc0fd..e939344 100644
--- a/src/settingsTab/templateInstructions.html
+++ b/src/settingsTab/templateInstructions.html
@@ -16,7 +16,8 @@
 
 Highlight
 <ul>
-  <li><span class="u-pop">{{id}}</span> - Unique Id</li>
+  <li><span class="u-pop">{{id}}</span> - Unique Id<br/>May contain the character <code>_</code> , <br/>cannot be used as an obsidian block reference id</li>
+  <li><span class="u-pop">{{id_base62}}</span> - Unique id after base62 encoding<br/> Character sets:<br/> <code>0</code> to <code>9</code>, <code>A</code> to <code>Z</code>, <code>a</code> to <code>z</code></li>
   <li><span class="u-pop">{{text}}</span> - Text</li>
   <li><span class="u-pop">{{color}}</span> - Highlight color</li>
   <li><span class="u-pop">{{incontext}}</span> - Link to Highlight in context</li>

From 38ea89c6e8c7d266198edd7ad970cc199d1a642e Mon Sep 17 00:00:00 2001
From: Mohammed159159 <mohammedhany300@gmail.com>
Date: Fri, 17 May 2024 11:45:11 +0300
Subject: [PATCH 2/3] fix: Display deletedfiles correctly in select

---
 src/modals/resyncDelFileModal.ts | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/modals/resyncDelFileModal.ts b/src/modals/resyncDelFileModal.ts
index 8ce9a0e..ac4cf64 100644
--- a/src/modals/resyncDelFileModal.ts
+++ b/src/modals/resyncDelFileModal.ts
@@ -70,9 +70,9 @@ export default class ResyncDelFileModal extends Modal {
 
         // Check which files are actually present
         const deletedArticles = await Promise.all(allArticles.filter(async article => !(await this.fileManager.isArticleSaved(article))));
-        return deletedArticles.map((article: Article) => 
-            ({ uri: article.metadata.url, filename: this.fileManager.getNewArticleFilePath(article)})
-        );
+        return await Promise.all(deletedArticles.map(async (article: Article) => 
+            ({ uri: article.metadata.url, filename: (await this.fileManager.getNewArticleFilePath(article)).split('//')[1]})
+        ));
     }
 
     async startResync(selectedFiles: SyncedFile[]): Promise<void> {

From 0f70f93ddf4c2971e84b218a86a25ed6afcf5799 Mon Sep 17 00:00:00 2001
From: bcdax110 <1711382287@qq.com>
Date: Mon, 10 Feb 2025 15:40:37 +0800
Subject: [PATCH 3/3] feat(feat: Support folder structure based on article URL
 path)

---
 src/fileManager.ts       | 11 +++++++++--
 src/settingsTab/index.ts | 17 +++++++++++++++++
 src/store/settings.ts    | 12 +++++++++++-
 3 files changed, 37 insertions(+), 3 deletions(-)

diff --git a/src/fileManager.ts b/src/fileManager.ts
index 265b26c..73f68c3 100644
--- a/src/fileManager.ts
+++ b/src/fileManager.ts
@@ -13,12 +13,19 @@ type AnnotationFile = {
 
 const articleFolderPath = (article: Article): string => {
   const settings = get(settingsStore);
+  let folderPath = settings.highlightsFolder;
+
   if (settings.useDomainFolders) {
     // "metadata.author" is equal to the article domain at the moment
-    return `${settings.highlightsFolder}/${article.metadata.author}`;
+      folderPath = `${folderPath}/${article.metadata.author}`;
+  }
+
+  if (settings.useURLPathFolders) {
+      const pathname = new URL(article.metadata.url).pathname.replace(/\/$/, '');
+      folderPath = `${folderPath}/${pathname}`;
   }
 
-  return settings.highlightsFolder;
+  return folderPath;
 };
 
 export default class FileManager {
diff --git a/src/settingsTab/index.ts b/src/settingsTab/index.ts
index 031386b..e2a4097 100644
--- a/src/settingsTab/index.ts
+++ b/src/settingsTab/index.ts
@@ -43,6 +43,7 @@ export class SettingsTab extends PluginSettingTab {
     this.autoSyncInterval();
     this.highlightsFolder();
     this.folderPath();
+    this.folderURLPath()
     this.syncOnBoot();
     this.dateFormat();
     this.template();
@@ -192,6 +193,22 @@ export class SettingsTab extends PluginSettingTab {
     );
   }
 
+  private folderURLPath(): void {
+
+    new Setting(this.containerEl)
+    .setName('Use URL path folders')
+    .setDesc('The generated file directory is based on the path of the highlight URL.' +
+        'This option is designed to prevent filename conflicts caused by identical webpage titles under different paths of a website' +
+        'It is recommended to enable this option only when "Use domain folders" is enabled.')
+    .addToggle((toggle) =>
+      toggle
+        .setValue(get(settingsStore).useDomainFolders)
+        .onChange(async (value) => {
+          await settingsStore.actions.setURLPathFolders(value);
+        })
+    );
+  }
+
   private syncOnBoot(): void {
     new Setting(this.containerEl)
       .setName('Sync on Startup')
diff --git a/src/store/settings.ts b/src/store/settings.ts
index f2a94ad..f9905d1 100644
--- a/src/store/settings.ts
+++ b/src/store/settings.ts
@@ -21,6 +21,7 @@ type Settings = {
   autoSyncInterval: number;
   groups: Group[];
   useDomainFolders: boolean;
+  useURLPathFolders: boolean;
 };
 
 const DEFAULT_SETTINGS: Settings = {
@@ -37,7 +38,8 @@ const DEFAULT_SETTINGS: Settings = {
     totalHighlights: 0,
   },
   groups: [],
-  useDomainFolders: false
+  useDomainFolders: false,
+  useURLPathFolders: false
 };
 
 const createSettingsStore = () => {
@@ -173,6 +175,13 @@ const createSettingsStore = () => {
     });
   };
 
+  const setURLPathFolders = (value: boolean) => {
+    store.update((state) => {
+      state.useURLPathFolders = value;
+      return state;
+    });
+  };
+
   return {
     subscribe: store.subscribe,
     initialise,
@@ -190,6 +199,7 @@ const createSettingsStore = () => {
       setGroups,
       resetGroups,
       setUseDomainFolder,
+      setURLPathFolders
     },
   };
 };