Refactored the website
parent
1e8a96ef20
commit
5c3612eeeb
|
@ -1,4 +1,4 @@
|
||||||
#meta-tag
|
#core
|
||||||
|
|
||||||
SilverBullet automatically builds and maintains an index of _objects_ extracted from all markdown pages in your space. It subsequently allows you to [[Live Queries]] this database in (potentially) useful ways.
|
SilverBullet automatically builds and maintains an index of _objects_ extracted from all markdown pages in your space. It subsequently allows you to [[Live Queries]] this database in (potentially) useful ways.
|
||||||
|
|
||||||
|
@ -26,7 +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
|
||||||
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 in this particular page with a #meta-tag.
|
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:
|
||||||
|
|
||||||
|
|
|
@ -70,12 +70,22 @@ name: SilverBullet
|
||||||
rating: 5
|
rating: 5
|
||||||
```
|
```
|
||||||
|
|
||||||
But where things get really interesting when using features like [[Live Queries]]. For instance, here are:
|
But where things get _really_ interesting is when using features like [[Live Queries]] that allow you to query all types of [[Objects]] indexed based on the pages in your space.
|
||||||
|
|
||||||
|
Let’s explore this with a meta example of using this for this very website. All pages in this space that represent a plug are tagged with the #plug tag. Now, if we would want to render a list of all plugs in one place using the [[template/plug]] template, we can simply do this:
|
||||||
|
|
||||||
```query
|
```query
|
||||||
page order by name desc limit 5
|
plug render [[template/plug]]
|
||||||
```
|
```
|
||||||
|
Hover over that list, click the edit button to see the query that generates this view.
|
||||||
|
|
||||||
|
And it’s not just pages that can be queried, there’s a large variety of queriable sources and you can define your own via tags. Examples include `task`s, `page`s, `tag`s, and `link`s.
|
||||||
|
|
||||||
|
For instance, here’s a list of all outgoing page links from this page:
|
||||||
|
```query
|
||||||
|
link where page = "{{@page.name}}" select toPage as name render [[template/page]]
|
||||||
|
```
|
||||||
|
The sky is the limit.
|
||||||
|
|
||||||
## Install SilverBullet
|
## Install SilverBullet
|
||||||
Has your mind been sufficiently blown to commit to an install? Took you long enough, alright then. Please proceed to the [[Install]] and enjoy!
|
Has your mind been sufficiently blown to commit to an install? Took you long enough, alright then. Please proceed to the [[Install]] and enjoy!
|
||||||
|
|
|
@ -1,7 +1,4 @@
|
||||||
---
|
#plug
|
||||||
type: plug
|
|
||||||
repo: https://github.com/silverbulletmd/silverbullet
|
|
||||||
---
|
|
||||||
|
|
||||||
> **Warning** Deprecated
|
> **Warning** Deprecated
|
||||||
> Directives are now deprecated and will likely soon be removed, use [[Live Templates]] and [[Live Queries]] instead.
|
> Directives are now deprecated and will likely soon be removed, use [[Live Templates]] and [[Live Queries]] instead.
|
||||||
|
|
|
@ -1,7 +1,4 @@
|
||||||
---
|
#plug
|
||||||
type: plug
|
|
||||||
repo: https://github.com/silverbulletmd/silverbullet
|
|
||||||
---
|
|
||||||
|
|
||||||
The `editor` plug implements foundational editor functionality for SilverBullet.
|
The `editor` plug implements foundational editor functionality for SilverBullet.
|
||||||
|
|
||||||
|
|
|
@ -1,6 +1,3 @@
|
||||||
---
|
#plug
|
||||||
type: plug
|
|
||||||
repo: https://github.com/silverbulletmd/silverbullet
|
|
||||||
---
|
|
||||||
|
|
||||||
The Emoji plug provides support for auto-completion of the `:emoji:` style syntax.
|
The Emoji plug provides support for auto-completion of the `:emoji:` style syntax.
|
|
@ -1,11 +1,9 @@
|
||||||
---
|
---
|
||||||
type: plug
|
|
||||||
uri: github:silverbulletmd/silverbullet-github/github.plug.js
|
uri: github:silverbulletmd/silverbullet-github/github.plug.js
|
||||||
repo: https://github.com/silverbulletmd/silverbullet-github
|
repo: https://github.com/silverbulletmd/silverbullet-github
|
||||||
author: Zef Hemel
|
author: Zef Hemel
|
||||||
share-support: true
|
|
||||||
---
|
---
|
||||||
|
#plug #share-support
|
||||||
```template
|
```template
|
||||||
page: "[[!raw.githubusercontent.com/silverbulletmd/silverbullet-github/main/README]]"
|
page: "[[!raw.githubusercontent.com/silverbulletmd/silverbullet-github/main/README]]"
|
||||||
raw: true
|
raw: true
|
||||||
|
|
|
@ -1,10 +1,9 @@
|
||||||
---
|
---
|
||||||
type: plug
|
|
||||||
uri: github:silverbulletmd/silverbullet-graphview/graphview.plug.json
|
uri: github:silverbulletmd/silverbullet-graphview/graphview.plug.json
|
||||||
repo: https://github.com/silverbulletmd/silverbullet-graphview
|
repo: https://github.com/silverbulletmd/silverbullet-graphview
|
||||||
author: Bertjan Broeksema
|
author: Bertjan Broeksema
|
||||||
---
|
---
|
||||||
|
#plug
|
||||||
```template
|
```template
|
||||||
page: "[[!raw.githubusercontent.com/silverbulletmd/silverbullet-graphview/main/README]]"
|
page: "[[!raw.githubusercontent.com/silverbulletmd/silverbullet-graphview/main/README]]"
|
||||||
raw: true
|
raw: true
|
||||||
|
|
|
@ -1,7 +1,5 @@
|
||||||
---
|
#plug
|
||||||
type: plug
|
|
||||||
repo: https://github.com/silverbulletmd/silverbullet
|
|
||||||
---
|
|
||||||
SilverBullet has a generic indexing infrastructure. Pages are reindexed upon saving, so about every second.
|
SilverBullet has a generic indexing infrastructure. Pages are reindexed upon saving, so about every second.
|
||||||
|
|
||||||
The [[🔌 Index]] plug also defines syntax for [[Tags]]
|
The [[🔌 Index]] plug also defines syntax for [[Tags]]
|
||||||
|
|
|
@ -1,5 +1,6 @@
|
||||||
---
|
---
|
||||||
type: plug
|
tags:
|
||||||
|
- plug
|
||||||
uri: github:silverbulletmd/silverbullet-katex/katex.plug.js
|
uri: github:silverbulletmd/silverbullet-katex/katex.plug.js
|
||||||
repo: https://github.com/silverbulletmd/silverbullet-katex
|
repo: https://github.com/silverbulletmd/silverbullet-katex
|
||||||
author: Zef Hemel
|
author: Zef Hemel
|
||||||
|
|
|
@ -1,8 +1,4 @@
|
||||||
---
|
#share-support #plug
|
||||||
type: plug
|
|
||||||
repo: https://github.com/silverbulletmd/silverbullet
|
|
||||||
share-support: true
|
|
||||||
---
|
|
||||||
|
|
||||||
The Markdown plug provides support for various advanced Markdown features, specifically:
|
The Markdown plug provides support for various advanced Markdown features, specifically:
|
||||||
|
|
||||||
|
|
|
@ -1,11 +1,9 @@
|
||||||
---
|
---
|
||||||
type: plug
|
|
||||||
uri: github:silverbulletmd/silverbullet-mattermost/mattermost.plug.json
|
uri: github:silverbulletmd/silverbullet-mattermost/mattermost.plug.json
|
||||||
repo: https://github.com/silverbulletmd/silverbullet-mattermost
|
repo: https://github.com/silverbulletmd/silverbullet-mattermost
|
||||||
author: Zef Hemel
|
author: Zef Hemel
|
||||||
share-support: true
|
|
||||||
---
|
---
|
||||||
|
#plug #share-support
|
||||||
```template
|
```template
|
||||||
page: "[[!raw.githubusercontent.com/silverbulletmd/silverbullet-mattermost/main/README]]"
|
page: "[[!raw.githubusercontent.com/silverbulletmd/silverbullet-mattermost/main/README]]"
|
||||||
raw: true
|
raw: true
|
||||||
|
|
|
@ -1,5 +1,6 @@
|
||||||
---
|
---
|
||||||
type: plug
|
tags:
|
||||||
|
- plug
|
||||||
uri: github:silverbulletmd/silverbullet-mermaid/mermaid.plug.js
|
uri: github:silverbulletmd/silverbullet-mermaid/mermaid.plug.js
|
||||||
repo: https://github.com/silverbulletmd/silverbullet-mermaid
|
repo: https://github.com/silverbulletmd/silverbullet-mermaid
|
||||||
author: Zef Hemel
|
author: Zef Hemel
|
||||||
|
|
|
@ -17,12 +17,12 @@ Plugs are distributed as self-contained JavaScript bundles (ending with `.plug.j
|
||||||
## Core plugs
|
## Core plugs
|
||||||
These plugs are distributed with SilverBullet and are automatically enabled:
|
These plugs are distributed with SilverBullet and are automatically enabled:
|
||||||
```query
|
```query
|
||||||
page where type = "plug" and uri = null order by name render [[template/plug]]
|
plug where uri = null order by name render [[template/plug]]
|
||||||
```
|
```
|
||||||
## Third-party plugs
|
## Third-party plugs
|
||||||
These plugs are written either by third parties or distributed separately from the main SB distribution:
|
These plugs are written either by third parties or distributed separately from the main SB distribution:
|
||||||
```query
|
```query
|
||||||
page where type = "plug" and uri != null order by name render [[template/plug]]
|
plug where uri != null order by name render [[template/plug]]
|
||||||
```
|
```
|
||||||
|
|
||||||
## How to develop your own plug
|
## How to develop your own plug
|
||||||
|
|
|
@ -1,10 +1,9 @@
|
||||||
---
|
---
|
||||||
type: plug
|
|
||||||
uri: github:m1lt0n/silverbullet-serendipity/serendipity.plug.json
|
uri: github:m1lt0n/silverbullet-serendipity/serendipity.plug.json
|
||||||
repo: https://github.com/m1lt0n/silverbullet-serendipity
|
repo: https://github.com/m1lt0n/silverbullet-serendipity
|
||||||
author: Pantelis Vratsalis
|
author: Pantelis Vratsalis
|
||||||
---
|
---
|
||||||
|
#plug
|
||||||
```template
|
```template
|
||||||
page: "[[!raw.githubusercontent.com/m1lt0n/silverbullet-serendipity/main/README]]"
|
page: "[[!raw.githubusercontent.com/m1lt0n/silverbullet-serendipity/main/README]]"
|
||||||
raw: true
|
raw: true
|
||||||
|
|
|
@ -1,5 +1,6 @@
|
||||||
---
|
---
|
||||||
type: plug
|
tags:
|
||||||
|
-
|
||||||
repo: https://github.com/silverbulletmd/silverbullet
|
repo: https://github.com/silverbulletmd/silverbullet
|
||||||
---
|
---
|
||||||
|
|
||||||
|
@ -9,5 +10,5 @@ See the [original RFC](https://github.com/silverbulletmd/silverbullet/discussion
|
||||||
|
|
||||||
Specific implementations for sharing are implemented in other plugs, specifically:
|
Specific implementations for sharing are implemented in other plugs, specifically:
|
||||||
```query
|
```query
|
||||||
page where share-support = true render [[template/page]]
|
share-support render [[template/page]]
|
||||||
```
|
```
|
||||||
|
|
|
@ -1,7 +1,4 @@
|
||||||
---
|
#plug
|
||||||
type: plug
|
|
||||||
repo: https://github.com/silverbulletmd/silverbullet
|
|
||||||
---
|
|
||||||
|
|
||||||
The Tasks plug implements task support in SilverBullet.
|
The Tasks plug implements task support in SilverBullet.
|
||||||
|
|
||||||
|
|
|
@ -1,7 +1,4 @@
|
||||||
---
|
#plug
|
||||||
type: plug
|
|
||||||
repo: https://github.com/silverbulletmd/silverbullet
|
|
||||||
---
|
|
||||||
|
|
||||||
The [[🔌 Template]] plug implements a few templating mechanisms.
|
The [[🔌 Template]] plug implements a few templating mechanisms.
|
||||||
|
|
||||||
|
|
|
@ -1,5 +1,6 @@
|
||||||
---
|
---
|
||||||
type: plug
|
tags:
|
||||||
|
- plug
|
||||||
uri: github:silverbulletmd/silverbullet-twitter/twitter.plug.js
|
uri: github:silverbulletmd/silverbullet-twitter/twitter.plug.js
|
||||||
repo: https://github.com/silverbulletmd/silverbullet-twitter
|
repo: https://github.com/silverbulletmd/silverbullet-twitter
|
||||||
author: SilverBullet Authors
|
author: SilverBullet Authors
|
||||||
|
|
Loading…
Reference in New Issue