35 lines
2.4 KiB
Markdown
35 lines
2.4 KiB
Markdown
> **warning** Beta feature
|
||
> This is a **beta** feature. Feel free to use it, but it may change (significantly) in the future or potentially replaced.
|
||
|
||
SilverBullet is designed to be [[Extensions|extensible]]. In fact, a lot of functionality in SilverBullet is implemented through [[Space Lua]] embedded in [[Meta Pages]], other functionality is implemented using [[Plugs]].
|
||
|
||
A big part of the fun of SilverBullet is hacking around in it, building your own extensions. Libraries are the way to [[Share]] those extensions. Both for you to publish your own libraries, but also to pull in other people’s creations.
|
||
|
||
There are a few things at play here:
|
||
|
||
[[Libraries]] are the **unit of distribution**, typically implemented as [[Meta Pages]]. Most libraries will be implemented in a single page (e.g. with a big [[Space Lua]] block), but more elaborate libraries may span multiple pages, some may contain [[Plugs]].
|
||
|
||
[[Repositories]] are a **discovery mechanism** for libraries. They are collections of _pointers_ of _where_ to find libraries to install.
|
||
|
||
[[Share]] is the general-purpose mechanism built into SilverBullet to both _push_, _pull_ and _sync_ content in your space with the outside world. In the context of Libraries this mechanism is used (partially under the hood, but you’ll recognize traces of it) both for you to _publish_ your libraries somewhere, as well as to _install_ and _update_ other people’s creations.
|
||
|
||
To make discovery and installation of libraries easier, SilverBullet includes a basic [[Library Manager]].
|
||
|
||
Libraries kept under the `Library/` prefix in your space.
|
||
|
||
# What’s in a library
|
||
Here are some things that a library may provide:
|
||
* Various [[Slash Commands]], such as `/today`, `/task`, `/table`.
|
||
* Useful [[Page Templates]]
|
||
* Useful [[^Library/Std/Widgets/Widgets]]
|
||
* Useful pages that help you perform maintenance on your space, like detecting broken links, such as [[^Library/Std/Pages/Maintenance]].
|
||
* Additional functionality with compiled [[Plugs]]
|
||
|
||
# Can I change libraries locally?
|
||
Libraries you manually installed can be freely changed. Do note that when you attempt to update them, your local changes will be overwritten.
|
||
|
||
The [[^Library/Std]] library comes “baked in” with SilverBullet and is read only. You cannot change it. However, for most things there are ways to override or disable standard behavior, check [[Space Lua#Load order]] for some hints.
|
||
|
||
# How do I develop my own library?
|
||
See [[Libraries/Development]]
|