1
0
This commit is contained in:
Zef Hemel 2023-10-13 16:33:49 +02:00
parent 13903a3e30
commit 05431bdee5
3 changed files with 33 additions and 4 deletions

View File

@ -1 +1 @@
export const version = "0.5.1"; export const version = "0.5.2";

View File

@ -1,6 +1,18 @@
An attempt at documenting the changes/new features introduced in each An attempt at documenting the changes/new features introduced in each
release. release.
---
## 0.5.2
* Changes to [[Objects]]:
* Paragraphs are now indexed, see [[Objects@paragraph]] (thanks to [Ian Shehadeh](https://github.com/silverbulletmd/silverbullet/pull/528))
* For consistency, list items are now always indexed as well (whether they contain a [[Tags|tag]] or not) see [[Objects@item]].
* The {[Directive: Convert to Live Query/Template]} now also converts `#use` and `#include` directives
* Styling improvements for Linked Mentions
* SilverBullet now fully works when added as PWA on Safari 17 (via the “Add to Dock” option).
* Fix support for handlebars variables in [[Live Queries]] and [[live]]
* Plug robustness improvements (SB shouldnt fully break when loading plugs that rely on disabled syscalls)
* Various other bug fixes
--- ---
## 0.5.1 ## 0.5.1

View File

@ -26,6 +26,7 @@ Every object has one or more tags, defining the types of an object. Some tags ar
Here are the currently built-in tags: Here are the currently built-in tags:
## page ## page
$page
Every page in your space is available via the `page` tag. You can attach _additional tags_ to a page, by either specifying them in the `tags` attribute [[Frontmatter]], or by putting additional [[Tags]] in the _first paragraph of your page_, as is done with the #core tag at the beginning of this page. Every page in your space is available via the `page` tag. You can attach _additional tags_ to a page, by either specifying them in the `tags` attribute [[Frontmatter]], or by putting additional [[Tags]] in the _first paragraph of your page_, as is done with the #core tag at the beginning of this page.
In addition to `ref` and `tags`, the `page` tag defines a bunch of additional attributes as can be seen in this example query: In addition to `ref` and `tags`, the `page` tag defines a bunch of additional attributes as can be seen in this example query:
@ -35,6 +36,7 @@ page where name = "{{@page.name}}"
``` ```
## task ## task
$task
Every task in your space is tagged with the `task` tag by default. You tag it with additional tags by using [[Tags]] in the task name, e.g. Every task in your space is tagged with the `task` tag by default. You tag it with additional tags by using [[Tags]] in the task name, e.g.
* [ ] My task #upnext * [ ] My task #upnext
@ -53,7 +55,8 @@ upnext render [[template/task]]
``` ```
## item ## item
List items are not currently indexed unless explicitly tagged (for performance reasons). Like other things, an an item can be tagged using [[Tags]]. $item
List items (both bullet point and numbered items) are indexed by default with the `item` tag, and additional tags can be added using [[Tags]].
Here is an example of a #quote item using a custom [[Attributes|attribute]]: Here is an example of a #quote item using a custom [[Attributes|attribute]]:
@ -62,10 +65,21 @@ Here is an example of a #quote item using a custom [[Attributes|attribute]]:
And then queried via the #quote tag: And then queried via the #quote tag:
```query ```query
quote select by, name quote where tags = "item" select name, by
```
## paragraph
$paragraph
Top-level paragraphs (that is: paragraphs not embedded in a list) are indexed using the `paragraph` tag, any additional tags can be added usin [[Tags]].
A paragraph with a #paragraph-tag.
```query
paragraph-tag
``` ```
## data ## data
$data
You can also embed arbitrary YAML data blocks in pages via fenced code blocks and use a tag as a coding language, e.g. You can also embed arbitrary YAML data blocks in pages via fenced code blocks and use a tag as a coding language, e.g.
```#person ```#person
@ -80,6 +94,7 @@ person
``` ```
## link ## link
$link
All page _links_ are tagged with `link`. You cannot attach additional tags to links. The main two attributes of a link are: All page _links_ are tagged with `link`. You cannot attach additional tags to links. The main two attributes of a link are:
* `toPage` the page the link is linking _to_ * `toPage` the page the link is linking _to_
@ -96,7 +111,7 @@ link where page = "{{@page.name}}" and inDirective = false
``` ```
## anchor ## anchor
$myanchor $anchor
[[Anchors]] use the `$myanchor` notation to allow deeplinking into a page and are also indexed and queryable. It is not possible to attach additional tags to an anchor. [[Anchors]] use the `$myanchor` notation to allow deeplinking into a page and are also indexed and queryable. It is not possible to attach additional tags to an anchor.
@ -107,6 +122,7 @@ anchor where page = "{{@page.name}}"
``` ```
## tag ## tag
$tag
The ultimate meta tag is _tag_ itself, which indexes for all tags used, in which page they appear and what their “parent tag” is (the context of the tag: either `page`, `item` or `task`). The ultimate meta tag is _tag_ itself, which indexes for all tags used, in which page they appear and what their “parent tag” is (the context of the tag: either `page`, `item` or `task`).
Here are the tags used/defined in this page: Here are the tags used/defined in this page:
@ -116,6 +132,7 @@ tag where page = "{{@page.name}}"
``` ```
## attribute ## attribute
$attribute
This is another meta tag, which is used to index all [[Attributes]] used in your space. This is used by e.g. attribute completion in various contexts. You likely dont need to use this tag directly, but its there. This is another meta tag, which is used to index all [[Attributes]] used in your space. This is used by e.g. attribute completion in various contexts. You likely dont need to use this tag directly, but its there.
```query ```query