|
1 | | -# Obsidian Markwhen |
| 1 | +# Markwhen Obsidian Plugin |
2 | 2 |
|
3 | | - |
| 3 | + |
4 | 4 |
|
5 | 5 |  |
6 | 6 |
|
7 | 7 | This plugin integrates [Markwhen](https://github.com/mark-when/markwhen/) into [Obsidian.md](https://obsidian.md/). You can use markwhen syntax to create timelines. |
8 | 8 |
|
9 | | -> **Note** |
10 | | -> Latest release: NaN |
11 | | -> Document version: developer |
| 9 | +> [!Note] |
| 10 | +> Latest release: 0.0.1 |
| 11 | +> Document version: 0.0.1 |
| 12 | +
|
| 13 | +## Installation |
| 14 | + |
| 15 | +> [!Note] |
| 16 | +> Make sure that you are not in the **Restricted Mode**. |
| 17 | +
|
| 18 | +### Install the plugin manually |
| 19 | + |
| 20 | +1. Go to the repo's latest [release page](https://github.com/mark-when/obsidian-plugin/releases/latest), and download `main.js`, `manifest.json` and `styles.css` (or the zip file). |
| 21 | +2. Copy these files to your local path `[your vault]/.obsidian/plugins/markwhen/`. |
| 22 | +3. Relaunch Obsidian, or refresh the plugin list, you will see this plugin. |
| 23 | +4. In the plugin list, enable `Markwhen` and enjoy! |
| 24 | + |
| 25 | +### Install via BRAT |
| 26 | + |
| 27 | +:construction: |
12 | 28 |
|
13 | 29 | ## Development |
14 | 30 |
|
15 | | -Ensure you first have Obsidian installed. If the path to your vault is something other than `~/Documents/Obsidian Vault`, update `copyAssets.sh` to point to your vault's location. |
| 31 | +Ensure you first have Obsidian installed, and set up a development vault. |
| 32 | + |
| 33 | +For developers on Linux / MacOS, if the path to your vault is something other than `~/Documents/Obsidian Vault`, update `copyAssets.sh` to point to your vault's location. |
| 34 | + |
| 35 | +For developers on Windows, since there's no watch command out-of-the-box, you can place the repo right in the dev vault config directory (i.e. `[your vault]/.obsidian/plugins/markwhen/`), and set the `outDir` to `./` in `vite.config.ts` (vite complains about this). |
| 36 | + |
| 37 | +> [!Note] |
| 38 | +> The plugin id in the manifest is `markwhen`, indicating users will find their plugin under the `.obsidian/plugins/markwhen` directory if they install this plugin from official Obsidian distribution. |
16 | 39 |
|
17 | 40 | ```sh |
18 | 41 | git clone [email protected]:mark-when/obsidian-plugin.git |
|
21 | 44 | npm run vite |
22 | 45 | ``` |
23 | 46 |
|
24 | | -## Installation |
25 | | - |
26 | | -> **Note** |
27 | | -> Make sure that you are not in the **Restricted Mode**. |
28 | | -
|
29 | | -The plugin is in active deveplopment. |
30 | | - |
31 | | -### Install the plugin manually |
32 | | - |
33 | | -1. Go to the repo's latest [release page](https://github.com/mark-when/obsidian-plugin/releases/latest), and download `obsidian-markwhen.zip`. |
34 | | -2. Copy these files to your local path `[yourvault]/.obsidian/plugins/`. |
35 | | -3. Launch/restart Obsidian, or refresh the plugin list, you will see this plugin. |
36 | | -4. In the plugin list, enable `Markwhen` and enjoy! |
37 | | - |
38 | | -### Building the plugin from source code |
39 | | - |
40 | | -Check our [contributing instructions](CONTRIBUTING.md). |
| 47 | +You can download and enable the [Hot-Reload](https://github.com/pjeby/hot-reload) plugin in the dev vault to experience a smooth debugging workflow. Every time `main.js`, `manifest.json` or `styles.css` updates, it will trigger an auto-reload. |
0 commit comments