Skip to content

SilverRainZ/silverrainz.github.io

Repository files navigation

logo Silver Bullet

Sphinx-powered note-taking system of SilverRainZ.

There are some articles describes the architecture of this note-taking system.

Browse

Visit https://silverrainz.me/ (hosted by Github Pages).

For visitors in China, there is a Gitee Pages mirror: https://silverrainz.gitee.io/

位于中国的访客可以访问 Gitee 镜像: https://silverrainz.gitee.io/

Dependencies

You MUST have following programs installed:

  • Git
  • GNU make
  • Python>=3.9
  • Sphinx>5

Install python package dependencies by the following commmands:

pip3 install --user -r requirements.txt

I developed series of sphinx extensions for my note-taking system. You can found them in the requirements.txt:

The following programs are OPTIONAL if you don’t need to build various contents embedded in the documentation:

  • Lilypond
  • Timidity++
  • FFmpeg
  • ImageMagick
  • Graphviz
  • PlantUML

Build

Firstly clone this repository (The repository is quite big, clone with --depth=1 if you dont want to make any changes):

git clone https://github.com/SilverRainZ/bullet.git

Ask sphinx to build HTML documentation:

make

Root page of the HTML documentation can be found at _build/html/index.html.

LICENSE

Copyright 2020-2024, Shengyu Zhang.

The contents of this repository/documentation are all published under cc-badge Attribution-ShareAlike (CC BY-SA) agreement. For more details, please refer to: LICENSE.