- Created by pryley
- ๐ Last Updated: 13/06/24 11:43:34
- ๐ Stars on GitHub: 42
- Please consider supporting the creator by Starring or Sponsoring them on GitHub!
- Get Latest Release
- Get Source Code
From their README
Alfred Workflow for The Archive
This is an comprehensive workflow for The Archive that helps you work with your notes more efficiently.
Table of Contents
- Installation
- Searching Notes
- Searching Tasks
- Searching Tags
- Random Notes
- Creating Notes
- Templates
- Importing URLs
- Importing Images
- Text Manipulation
- Configuration
- Documentation
- Changelog
- Credits
Installation
- Download the latest release
- Double-click the downloaded workflow to install in Alfred.
- Install Glance from the App Store (optional, this allows you to Quickview markdown files)
- Install pandoc with Homebrew (optional, this allows you to import a webpage into a note)
brew install pandoc
Searching Notes
To search your notes, type ar
along with a space, then enter your search query.
Tip: You may change the exact_match and search_content options to configure how the workflow searches The Archive.
Modifier keys
There are three modifier keys that you can use with the search results:
-
โง Shift: Pressing this key will use Quicklook to preview the selected note.
Note: To view markdown files with Quicklook, you may need to install Glance.
-
โฅ Option: Holding this key down as you press Enter will paste a wiki link of the selected note into the frontmost application (i.e.
[[title of the selected note]]
). -
โ Command: Holding this key down as you press Enter will display the following "Actions" menu:
Searching Tasks
Tasks are Github-flavoured checkboxes:
- [x] This is a completed task
- [ ] This is an uncompleted task
To search for tasks in your notes, type artask
along with a space, then enter your search query. Pressing Enter on a task will toggle its status (checked/unchecked).
Modifier keys
There are two modifier keys that you can use with tasks:
-
โฅ Option: Holding this key down as you press Enter will open the note containing the task in the default editor.
-
โ Command: Holding this key down as you press Enter will open the note containing the task in The Archive.
Searching Tags
To search the tags in your notes, type artag
along with a space, then enter your search query. Pressing Enter on a tag will match all notes that contain the tag in The Archive.
Note: Due to a limitation of the external link URL scheme that The Archive uses, it is not possible to pass the
#
symbol along with the tag name to The Archive.
Modifier keys
There is one modifier key that you can use with tags:
- โ Command: Holding this key down as you press Enter will paste the selected tag into the frontmost application.
Random Notes
To display a random note in The Archive, type arrandom
and press Enter.
Creating Notes
To create a note, type arnew
along with a space, then enter the title of the note and optionally some tags. If you use a template, the title you enter will fill the {title}
placeholder, and any tags you enter will fill the {tags}
placeholder.
Modifier keys
There are two modifier keys (and one modifier key combo) that you can use when creating a note without a template:
-
โฅ Option: Holding this key down as you press Enter will paste the current clipboard contents into the note below the tags.
-
โ Command: Holding this key down as you press Enter will either remove or add the Zettel ID to the note depending on whether or not you have enabled the "Use ID for empty file names" option in The Archive preferences.
-
โ Command + โฅ Option: Holding these two keys down as you press Enter will both paste the current clipboard contents into the note below the tags, and remove or add the Zettel ID to the note depending on whether or not you have enabled the "Use ID for empty file names" option in The Archive preferences.
Templates
Templates are simply notes in The Archive that are tagged with #template
. To create a note using a template, type arnew
along with a space, enter the title of the note and optionally some tags, and then select the template that you wish to use.
Note: The template tag must be used within the first 10 lines of the note else it will not be recognised as a template.
Tip: You may change the template_tag option to set a custom template tag.
You may use the following placeholders in your templates:
{content}
This is the content of the clipboard if you have selected to paste it.{date}
This is the formatted today date.{tags}
These are the tags if provided.{title}
This is the title of your note.{zettel_id}
This is the Zettel ID of the note if used.
Here is an example Template:
---
Title: [[{zettel_id}]] {title}
Index: [[200615130000]] Application support
Keywords: #support {tags} #template
---
{content}
Tip: You may change the use_zettel_id_in_title option to configure whether or not the
{title}
placeholder contains the Zettel ID. To change the datetime format used in the{date}
placeholder, change the default_date_format option.
Modifier keys
There are three modifier keys (and one modifier key combo) that you can use with the search results:
-
โง Shift: Pressing this key will use Quicklook to preview the selected template.
Note: To view markdown files with Quicklook, you may need to install Glance.
-
โฅ Option: Holding this key down as you press Enter will paste the current clipboard contents into the template's
{content}
placeholder. -
โ Command: Holding this key down as you press Enter will either remove or add the Zettel ID to the note depending on whether or not you have enabled the "Use ID for empty file names" option in The Archive preferences.
-
โ Command + โฅ Option: Holding these two keys down as you press Enter will both paste the current clipboard contents into the template's
{content}
placeholder, and remove or add the Zettel ID to the note depending on whether or not you have enabled the "Use ID for empty file names" option in The Archive preferences.
Importing URLs
To import the page content of a webpage into a note, type arurl
along with a space and enter a valid URL beginning with http(s)
.
Note: This action requires that you have pandoc installed on your mac. Pandoc is a universal document converter and is used to convert the HTML of a webpage to Github-flavoured markdown. If you do not have pandoc installed, then only the URL will be copied into the note.
Importing Images
The workflow provides an Add image to The Archive File Action which allows you to import a JPG or PNG image into the Resources Subfolder of your notes directory.
To use the File Action:
- First you need to set your prefered "Selection Hotkey" for Actions. You can find this option on the
Features > Actions > General
tab in the Alfred Preferences. - Select the image in Finder and press the "Selection Hotkey" that you set in Alfred Preferences.
- Type
add
and select the "Add image to The Archive" file action. - Paste the generated markdown link of the image into your note.
Text Manipulation
The workflow provides several hotkeys which allow you to perform basic text manipulation such as changing the heading levels of a line in your note, or marking multiple lines of text as a fenced code block using backticks. A hotkey is simply a combination of keys that you press together in order to perform an action. These hotkeys are specific to The Archive and will only work if The Archive is the front most application and in focus.
To use these hotkeys, click on the line in your note that you wish to change and then press the hotkey.
Note: These hotkeys use the โงโL keyboard shortcut that is provided by The Archive to select the current line of text. If you have mapped this keyboard shortcut to something else, then these hotkeys will not work.
Hotkeys
- โ + 1: Pressing this hotkey will change the line to a Heading 1
- โ + 2: Pressing this hotkey will change the line to a Heading 2
- โ + 3: Pressing this hotkey will change the line to a Heading 3
- โ + 4: Pressing this hotkey will change the line to a Heading 4
- โ + 5: Pressing this hotkey will change the line to a Heading 5
- โ + 6: Pressing this hotkey will change the line to a Heading 6
- โ + `: Pressing this hotkey will wrap the selected lines of text in backticks as a fenced code block
Configuration
To change the configuration of the workflow, type arconfig
in Alfred. You can also view the help file for each highlighted option with Quicklook by pressing the โง Shift key.
Note: To view markdown files with Quicklook, you may need to install Glance.
Default Date Format (default_date_format
)
Default value:
%A, %d %B, %Y at %H:%M
This option defines the datetime format used for the {date}
placeholder in your templates.
Please refer to the Python strftime reference for the available datetime variables.
Default Zettel ID Format (default_zettel_id_format
)
Default value:
%Y%m%d%H%M
This option defines the datetime format used for the generated Zettel ID and the {zettel_id}
placeholder in your templates.
Please refer to the Python strftime reference for the available datetime variables.
Exact Match (exact_match
)
Default value:
False
This option defines if the search should match the exact search term (True
) or the string (False
). When the value is set to True
it is possible to enhance the search term with wildcards.
When set to True
, searching for Books
will match Books
but not Bookstore
. However, Books*
will match both Books
and Bookstore
.
When set to False
, searching for Books
will match Books
as well as Bookstore
.
Prefer Filename to Title (prefer_filename_to_title
)
Default value:
True
This option defines which value is used when matching a search result in The Archive (i.e. thearchive://match/{value}
).
When set to True
, the note filename will be used.
When set to False
, the note title (if entered as # Note Title
) will be used if it exists instead of the filename.
Prefer Zettel ID Links (prefer_zettel_id_links
)
Default value:
False
When set to True
, the Zettel ID (if one exists) will be used as the link title in markdown and wiki links (i.e. [[202006131200]]
).
When set to False
, the full note title will be used in markdown and wiki links (i.e. [[202006131200 The Note Title]]
).
Search Content (search_content
)
Default value:
False
When set to True
, both the filenames and note contents will be searched.
When set to False
, only the filenames will be searched.
Search YAML Tags Only (search_yaml_tags_only
)
Default value:
False
When set to True
, tags will only be searched for in the YAML front matter.
When set to False
, tags will be searched for in the entire note.
Template Tag (template_tag
)
Default value:
#template
The template tag defines which notes are used as templates. Add the template tag somewhere in the first 10 lines of a note and it will be recognized as an available template when you create a note.
The Archive Bundle ID (the_archive_bundle_id
)
Default value:
de.zettelkasten.TheArchive
A bundle ID (or bundle identifier) uniquely identifies an application in Apple's ecosystem. This means that no two applications can have the same bundle identifier.
This workflow uses the bundle identifier together with the_archive_team_id to get the saved preferences of The Archive.
This value should never need changing.
The Archive Team ID (the_archive_team_id
)
Default value:
FRMDA3XRGC
A team ID (or team identifier) is generated by Apple and uniquely identifies the developer of an application in Apple's ecosystem.
This workflow uses the team identifier together with the_archive_bundle_id to get the saved preferences of The Archive.
This value should never need changing.
Use Zettel ID in Title (use_zettel_id_in_title
)
Default value:
False
When set to True
, the Zettel ID will be included in the {title}
placeholder of your templates.
When set to False
, the Zettel ID will not be included in the {title}
placeholder of your templates.
Documentation
You may view this README.md file at any time by typing arhelp
in Alfred.
Changelog
See: Releases
Credits
This workflow was created by Paul Ryley. Special thanks to Acidham author of Alfred Markdown Notes which was the inspiration for this workflow.
License
The MIT License (MIT).