Skip to content

Commit 37ccb72

Browse files
committed
Merge branch 'metadata-lib'
2 parents b4a6181 + 6e35129 commit 37ccb72

File tree

11 files changed

+552
-420
lines changed

11 files changed

+552
-420
lines changed

README.md

Lines changed: 8 additions & 59 deletions
Original file line numberDiff line numberDiff line change
@@ -1,73 +1,22 @@
11
# Obsidian Meta Bind Plugin
22

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`.
46

5-
### New docs
7+
### Demo
68

7-
I am currently working on new docs for this plugin.
8-
https://mprojectscode.github.io/obsidian-meta-bind-plugin-docs
9+
![](https://github.com/mProjectsCode/obsidian-meta-bind-plugin/tree/master/images/meta-bind-plugin-demo-3.mp4)
910

10-
### How to use
11+
### Docs
1112

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).
6514

6615
### Problems, unexpected behavior or improvement suggestions?
6716

6817
You are more than welcome to open an issue on [GitHub](https://github.com/mProjectsCode/obsidian-meta-bind-plugin/issues).
6918

70-
#### The sync seems laggy
19+
#### The sync seems laggy / It takes half a second for the changes to sync
7120

7221
This is intentional. To reduce the load on your hard drive the plugin ony syncs about 5 times a second.
7322
There is a setting to change the sync interval, but I don't recommend changing it.

0 commit comments

Comments
 (0)