Refactored the website
Zef Hemel
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.
|
||||
|
||||
|
|
@ -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:
|
||||
|
||||
## 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:
|
||||
|
||||
|
|
|
|||
|
|
@ -70,12 +70,22 @@ name: SilverBullet
|
|||
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
|
||||
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
|
||||
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 @@
|
|||
---
|
||||
type: plug
|
||||
repo: https://github.com/silverbulletmd/silverbullet
|
||||
---
|
||||
#plug
|
||||
|
||||
> **Warning** Deprecated
|
||||
> Directives are now deprecated and will likely soon be removed, use [[Live Templates]] and [[Live Queries]] instead.
|
||||
|
|
|
|||
|
|
@ -1,7 +1,4 @@
|
|||
---
|
||||
type: plug
|
||||
repo: https://github.com/silverbulletmd/silverbullet
|
||||
---
|
||||
#plug
|
||||
|
||||
The `editor` plug implements foundational editor functionality for SilverBullet.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,6 +1,3 @@
|
|||
---
|
||||
type: plug
|
||||
repo: https://github.com/silverbulletmd/silverbullet
|
||||
---
|
||||
#plug
|
||||
|
||||
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
|
||||
repo: https://github.com/silverbulletmd/silverbullet-github
|
||||
author: Zef Hemel
|
||||
share-support: true
|
||||
---
|
||||
|
||||
#plug #share-support
|
||||
```template
|
||||
page: "[[!raw.githubusercontent.com/silverbulletmd/silverbullet-github/main/README]]"
|
||||
raw: true
|
||||
|
|
|
|||
|
|
@ -1,10 +1,9 @@
|
|||
---
|
||||
type: plug
|
||||
uri: github:silverbulletmd/silverbullet-graphview/graphview.plug.json
|
||||
repo: https://github.com/silverbulletmd/silverbullet-graphview
|
||||
author: Bertjan Broeksema
|
||||
---
|
||||
|
||||
#plug
|
||||
```template
|
||||
page: "[[!raw.githubusercontent.com/silverbulletmd/silverbullet-graphview/main/README]]"
|
||||
raw: true
|
||||
|
|
|
|||
|
|
@ -1,7 +1,5 @@
|
|||
---
|
||||
type: plug
|
||||
repo: https://github.com/silverbulletmd/silverbullet
|
||||
---
|
||||
#plug
|
||||
|
||||
SilverBullet has a generic indexing infrastructure. Pages are reindexed upon saving, so about every second.
|
||||
|
||||
The [[🔌 Index]] plug also defines syntax for [[Tags]]
|
||||
|
|
|
|||
|
|
@ -1,5 +1,6 @@
|
|||
---
|
||||
type: plug
|
||||
tags:
|
||||
- plug
|
||||
uri: github:silverbulletmd/silverbullet-katex/katex.plug.js
|
||||
repo: https://github.com/silverbulletmd/silverbullet-katex
|
||||
author: Zef Hemel
|
||||
|
|
|
|||
|
|
@ -1,8 +1,4 @@
|
|||
---
|
||||
type: plug
|
||||
repo: https://github.com/silverbulletmd/silverbullet
|
||||
share-support: true
|
||||
---
|
||||
#share-support #plug
|
||||
|
||||
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
|
||||
repo: https://github.com/silverbulletmd/silverbullet-mattermost
|
||||
author: Zef Hemel
|
||||
share-support: true
|
||||
---
|
||||
|
||||
#plug #share-support
|
||||
```template
|
||||
page: "[[!raw.githubusercontent.com/silverbulletmd/silverbullet-mattermost/main/README]]"
|
||||
raw: true
|
||||
|
|
|
|||
|
|
@ -1,5 +1,6 @@
|
|||
---
|
||||
type: plug
|
||||
tags:
|
||||
- plug
|
||||
uri: github:silverbulletmd/silverbullet-mermaid/mermaid.plug.js
|
||||
repo: https://github.com/silverbulletmd/silverbullet-mermaid
|
||||
author: Zef Hemel
|
||||
|
|
|
|||
|
|
@ -17,12 +17,12 @@ Plugs are distributed as self-contained JavaScript bundles (ending with `.plug.j
|
|||
## Core plugs
|
||||
These plugs are distributed with SilverBullet and are automatically enabled:
|
||||
```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
|
||||
These plugs are written either by third parties or distributed separately from the main SB distribution:
|
||||
```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
|
||||
|
|
|
|||
|
|
@ -1,10 +1,9 @@
|
|||
---
|
||||
type: plug
|
||||
uri: github:m1lt0n/silverbullet-serendipity/serendipity.plug.json
|
||||
repo: https://github.com/m1lt0n/silverbullet-serendipity
|
||||
author: Pantelis Vratsalis
|
||||
---
|
||||
|
||||
#plug
|
||||
```template
|
||||
page: "[[!raw.githubusercontent.com/m1lt0n/silverbullet-serendipity/main/README]]"
|
||||
raw: true
|
||||
|
|
|
|||
|
|
@ -1,5 +1,6 @@
|
|||
---
|
||||
type: plug
|
||||
tags:
|
||||
-
|
||||
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:
|
||||
```query
|
||||
page where share-support = true render [[template/page]]
|
||||
share-support render [[template/page]]
|
||||
```
|
||||
|
|
|
|||
|
|
@ -1,7 +1,4 @@
|
|||
---
|
||||
type: plug
|
||||
repo: https://github.com/silverbulletmd/silverbullet
|
||||
---
|
||||
#plug
|
||||
|
||||
The Tasks plug implements task support in SilverBullet.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,7 +1,4 @@
|
|||
---
|
||||
type: plug
|
||||
repo: https://github.com/silverbulletmd/silverbullet
|
||||
---
|
||||
#plug
|
||||
|
||||
The [[🔌 Template]] plug implements a few templating mechanisms.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,5 +1,6 @@
|
|||
---
|
||||
type: plug
|
||||
tags:
|
||||
- plug
|
||||
uri: github:silverbulletmd/silverbullet-twitter/twitter.plug.js
|
||||
repo: https://github.com/silverbulletmd/silverbullet-twitter
|
||||
author: SilverBullet Authors
|
||||
|
|
|
|||
Loading…
Reference in New Issue