silverbullet_ynh/README.md

SilverBullet for YunoHost

Read this README in other languages.

This package allows you to install SilverBullet quickly and simply on a YunoHost server.
If you don't have YunoHost, please consult the guide to learn how to install it.

Overview

SilverBullet aims to be your workshop for the mind: a creative space where you collect, create and expand your personal knowledge, while also letting you constantly evolve the tools you use to do so.

While you can use SilverBullet as a simple note taking application that stores notes in plain markdown files on disk, it becomes truly powerful in the hands of more technical power users. By leveraging metadata annotations, its Objects infrastructure, Live Queries and Live Templates, SilverBullet becomes a powerful end-user programming tool, enabling you to quickly develop various types of ad-hoc knowledge applications.

Features

SilverBullet...

• Runs in any modern browser (including on mobile) as a PWA in two Client Modes (online and synced mode), where the synced mode enables 100% offline operation, keeping a copy of content in the browser, syncing back to the server when a network connection is available.
• Provides an enjoyable markdown writing experience with a clean UI, rendering text using Live Preview, further reducing visual noise while still providing direct access to the underlying markdown syntax.
• Supports wiki-style page linking using the [[page link]] syntax. Incoming links are indexed and appear as “Linked Mentions” at the bottom of the pages linked to thereby providing bi-directional linking.
• Optimized for keyboard-based operation:
  • Quickly navigate between pages using the page switcher (triggered with Cmd-k on Mac or Ctrl-k on Linux and Windows).
  • Run commands via their keyboard shortcuts or the command palette (triggered with Cmd-/ or Ctrl-/ on Linux and Windows).
  • Use Slash Commands to perform common text editing operations.
• Provides a platform for end-user programming through its support for Objects, Live Queries and Live Templates.
• Robust extension mechanism using plugs.
• Self-hosted: you own your data. All content is stored as plain files in a folder on disk. Back up, sync, edit, publish, script with any additional tools you like.
• SilverBullet is open source, MIT licensed software.

Shipped version: 0.9.2~ynh2

Demo: https://play.silverbullet.md/

Screenshots

Documentation and resources

• Official app website: https://silverbullet.md
• Upstream app code repository: https://github.com/silverbulletmd/silverbullet
• YunoHost Store: https://apps.yunohost.org/app/silverbullet
• Report a bug: https://github.com/YunoHost-Apps/silverbullet_ynh/issues

Developer info

Please send your pull request to the testing branch.

To try the testing branch, please proceed like that:

sudo yunohost app install https://github.com/YunoHost-Apps/silverbullet_ynh/tree/testing --debug
or
sudo yunohost app upgrade silverbullet -u https://github.com/YunoHost-Apps/silverbullet_ynh/tree/testing --debug

More info regarding app packaging: https://yunohost.org/packaging_apps