Feat: Add "Open in Readwise" link

Feat: Show tags in default highlight template

Author: jsonMartin

CHANGELOG.md

@@ -1,4 +1,11 @@
 # Changelog
+## 1.4.1 (2023-10-27)
+This update adds better support for Readwise article highlighting and default tag template support. Thanks to first time contributor @tdznr for adding to this release.
+
+- Feature: Add "Open in Readwise" link when Readwise `url` field is present. The `url` field contains the link to Readwise's website showing the highlighted snippet in context of the source.
+  - The `url` field is not available for book types, but is available for other content types such as Articles.
+- Feature: Show tags in default highlight template
+
 ## 1.4.0 (2023-08-18)
 Thanks to @johannrichard for the following contributions:
 
@@ -15,20 +22,20 @@ Thanks to @johannrichard for the following contributions:
     The following highlight
     ```
     Multi-line text in blockquotes
-    
-    This is an example of a multi-line highlight with line-breaks. 
+
+    This is an example of a multi-line highlight with line-breaks.
     ```
     ... with this template
     ```markdown+nunjucks
     > [!quote]
     > {{ text | bq }}
     ```
-    will turn into 
+    will turn into
     ```markdown
     > [!quote]
     > Multi-line text in blockquotes
     >
-    > This is an example of a multi-line highlight with line-breaks. 
+    > This is an example of a multi-line highlight with line-breaks.
     ```
 ### Updates
 - Change field names to reflect their use in frontmatter

README.md

@@ -171,6 +171,7 @@ The highlight template exposes the following variables:
 - ```note```: Your nore
 - ```location```: The location
 - ```location_url```: The url of the location
+- ```url```: Unique highlight link (Open in Readwise)
 - ```color```: The color
 - ```highlighted_at```: Date highlighted (empty if none)
 - ```tags```: A formatted string of tags

main.ts

@@ -77,6 +77,9 @@ Note: {{ note }}
 {%- endif %}{%- if tags %}
 
 Tags: {{ tags }}
+{%- endif %}{%- if url %}
+
+[Open in Readwise]({{ url }})
 {%- endif %}
 
 ---
@@ -119,9 +122,11 @@ export default class ReadwiseMirror extends Plugin {
       note: note,
       location: location,
       location_url: locationUrl,
+      url, // URL is set for source of highlight (webpage, tweet, etc). null for books
       color: color,
       highlighted_at: highlighted_at ? this.formatDate(highlighted_at) : '',
       tags: formattedTagStr,
+
       // Book fields
       category: book.category,
     });
@@ -272,12 +277,12 @@ export default class ReadwiseMirror extends Plugin {
         let authorStr =
           authors[0] && authors?.length > 1
             ? authors
-                .filter((authorName: string) => authorName.trim() != '')
-                .map((authorName: string) => `[[${authorName.trim()}]]`)
-                .join(', ')
+              .filter((authorName: string) => authorName.trim() != '')
+              .map((authorName: string) => `[[${authorName.trim()}]]`)
+              .join(', ')
             : author
-            ? `[[${author}]]`
-            : ``;
+              ? `[[${author}]]`
+              : ``;
 
         const metadata = {
           id: id,
@@ -302,9 +307,8 @@ export default class ReadwiseMirror extends Plugin {
         const headerContents = this.headerTemplate.render(metadata);
         const contents = `${frontMatterContents}${headerContents}${formattedHighlights}`;
 
-        let path = `${this.settings.baseFolderName}/${
-          category.charAt(0).toUpperCase() + category.slice(1)
-        }/${sanitizedTitle}.md`;
+        let path = `${this.settings.baseFolderName}/${category.charAt(0).toUpperCase() + category.slice(1)
+          }/${sanitizedTitle}.md`;
 
         const abstractFile = vault.getAbstractFileByPath(path);
 

manifest.json

@@ -1,7 +1,7 @@
 {
   "id": "readwise-mirror",
   "name": "Readwise Mirror",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "minAppVersion": "0.11.0",
   "description": "Mirror your Readwise library directly to an Obsidian vault",
   "author": "jsonmartin",