Refactored the website

pull/528/head
Zef Hemel 2023-10-03 17:59:33 +02:00
parent 1e8a96ef20
commit 5c3612eeeb
18 changed files with 37 additions and 50 deletions

View File

@ -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:

View File

@ -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.
Lets 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 its not just pages that can be queried, theres 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, heres 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!

View File

@ -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.

View File

@ -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.

View File

@ -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.

View File

@ -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

View File

@ -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

View File

@ -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]]

View File

@ -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

View File

@ -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:

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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]]
``` ```

View File

@ -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.

View File

@ -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.

View File

@ -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