|
1 | 1 | # Obsidian Meta Bind Plugin |
2 | 2 |
|
3 | | -This plugin can create input fields inside your notes and bind them to metadata fields. |
| 3 | +This plugin can create input fields inside your notes and bind them to metadata fields, syncing their contents. |
| 4 | +Allowing you to create things like checkboxes inside your notes that change a metadata field e.g. `done` when checked. |
| 5 | +Or creating a slider inside your movie notes, that syncs up with a metadata field named `rating`. |
4 | 6 |
|
5 | | -### New docs |
| 7 | +### Demo |
6 | 8 |
|
7 | | -I am currently working on new docs for this plugin. |
8 | | -https://mprojectscode.github.io/obsidian-meta-bind-plugin-docs |
| 9 | + |
9 | 10 |
|
10 | | -### How to use |
| 11 | +### Docs |
11 | 12 |
|
12 | | -To create an input field you have to write an inline code block or normal code block starting with `INPUT`. Then in square brackets the type of input field, in round brackets arguments and finally behind a colon the metadata field to bind to. |
13 | | - |
14 | | -#### Examples: |
15 | | - |
16 | | -- `INPUT[toggle]` will create an unbound toggle |
17 | | -- `INPUT[slider:rating]` will create a slider bound to the metadata field `rating` of this note |
18 | | -- `INPUT[text:task#completedOn]` will create a text input bound to the metadata field `completedOn` of the note with the name `task` |
19 | | - |
20 | | -The plugin also allows further customization with arguments. So the complete syntax looks like this: |
21 | | - |
22 | | -``` |
23 | | -INPUT[input_type(argument_name(argument_value), argument_name_2, ...):file_name_or_path#metadata_field] |
24 | | -``` |
25 | | - |
26 | | -For more examples see the `exampleVault` folder. |
27 | | - |
28 | | -#### Input field types |
29 | | - |
30 | | -- `slider` a slider from 0 to 100 (custom ranges can be set using `minValue` and `maxValue`, see below) |
31 | | -- `toggle` a toggle element |
32 | | -- `text` a text field |
33 | | -- `text_area` a bigger text field |
34 | | -- `select` a select input field, only for code blocks |
35 | | -- `multi_select` a multi-select input field, only for code blocks |
36 | | -- `date` a date input field |
37 | | -- `date_picker` a date picker |
38 | | - |
39 | | -#### Arguments |
40 | | - |
41 | | -- `class(class_name)` adds a css class to the input field |
42 | | -- `addLabels` only for slider, adds labels for the min and max values |
43 | | -- `minValue(value)` only for slider, sets the min value |
44 | | -- `maxValue(value)` only for slider, sets the max value |
45 | | -- `option(value)` only for (multi-)selects, adds an option to the select |
46 | | -- `title(value)` only for (multi-)selects, adds a title to the select input |
47 | | -- `alignRight` only for date picker, aligns the date picker popup to the right of the input field |
48 | | - |
49 | | -### How to install |
50 | | - |
51 | | -You can eiter download it directly through Obsidian's plugin page or you can manually download the zip archive from the latest release here on GitHub. |
52 | | -After downloading, extract the archive into the `.obsidian/plugins` folder in your vault. |
53 | | - |
54 | | -The folder structure should look like this: |
55 | | - |
56 | | -``` |
57 | | -[path to your vault] |
58 | | -|_ .obsidian |
59 | | - |_ plugins |
60 | | - |_ obsidian-meta-bind-plugin |
61 | | - |_ main.js |
62 | | - |_ manifest.json |
63 | | - |_ styles.css |
64 | | -``` |
| 13 | +The docs are available [here](https://mprojectscode.github.io/obsidian-meta-bind-plugin-docs). |
65 | 14 |
|
66 | 15 | ### Problems, unexpected behavior or improvement suggestions? |
67 | 16 |
|
68 | 17 | You are more than welcome to open an issue on [GitHub](https://github.com/mProjectsCode/obsidian-meta-bind-plugin/issues). |
69 | 18 |
|
70 | | -#### The sync seems laggy |
| 19 | +#### The sync seems laggy / It takes half a second for the changes to sync |
71 | 20 |
|
72 | 21 | This is intentional. To reduce the load on your hard drive the plugin ony syncs about 5 times a second. |
73 | 22 | There is a setting to change the sync interval, but I don't recommend changing it. |
|
0 commit comments