Strapdown-Zeta - Git powered Wiki for Hackers!
Strapdown-Zeta is a git-powered wiki system for hackers, derived from strapdown.js project.
Strapdown.js makes it embarrassingly simple to create elegant Markdown documents. No server-side compilation required.
Strapdown-Zeta add more features including a standalone server providing a git powered wiki system, on top of libgit2, we don't want any potential command injections!
Features
Strapdown Static Markdown Page
- Search Engine friendly.
- Cross-browser compatible and responsive in mobile screens.
- GitHub flavored Markdown syntax.
- MathJax support. Feel free to type in your awesome math equations.
- Theme switchable. 15 Bootstrap themes included by default, you can add more as you wish. And everybody can switch the theme thru one click.
Table of Contentauto generation. Just specifytoc="true"in thexmptag- Heading numbering and anchor support, just one click will bring you to the section you are going to.
- Use highlight.js for syntax highlighting, which provides more beautiful coloring and more powerful syntax parsing.
- Blazing fast loading speed! All the codes are written using vanilla-js, only less than 200KiB source code after compressing.
Git powered Wiki
- Git Powered Wiki system. A standalone server is provided, just
git initthen run the server will get you a full functional geeky wiki server. - File modification history and view by commit version(shortened sha hash).
- Custom view options can be specified for different files.
- Handle of static files. Directory listing can be turned on and off.
- HTTP Authentication.
For more, please see:
Usage
Use Strapdown static html
Open your favorite text editor, paste the following lines into the text, then type markdown content in the middle, save the file as test.html, and open it, here you go!
<!DOCTYPE html> <html> <title>Hello, Strapdown</title> <meta charset="utf-8"> <xmp theme="cerulean" style="display:none;">
# title
your awesome markdown content goes here...
</xmp> <script src="http://cdn.ztx.io/strapdown/strapdown.min.js"></script> </html>Alternatively use src attribute
You can points to an external script file through the src attribute:
<!DOCTYPE html> <html> <title>Hello, Strapdown</title> <meta charset="utf-8">
<xmp theme="cerulean" style="display:none;" src="content.md">
</xmp> <script src="http://cdn.ztx.io/strapdown/strapdown.min.js"></script> </html>(in this example we display parsed content.md file located at same path).
src attribute specifies the URL of an external markdown file.
It should be placed on same domain because of web browsers same-origin policy.
Choose theme
You can set your favorite theme in xmp tag. The following themes are built-in by default.
- Chaitin
- Amelia
- Bootstrap
- Cerulean
- Cosmo
- Cyborg
- Flatly
- Journal
- Readable
- Simplex
- Slate
- Spacelab
- Spruce
- Superhero
- United
To use Cosmo, use the following line
<!DOCTYPE html> <html> <title>Hello, Strapdown</title> <meta charset="utf-8"> <xmp theme="cosmo" style="display:none;">
your awesome markdown content goes here...
</xmp> <script src="http://cdn.ztx.io/strapdown/strapdown.min.js"></script> </html>Table of Content
To generate table of content, specify toc="true" in xmp tag.
<!DOCTYPE html> <html> <title>Hello, Strapdown</title> <meta charset="utf-8"> <xmp theme="cosmo" toc="true" style="display:none;">
your awesome markdown content goes here...
</xmp> <script src="http://cdn.ztx.io/strapdown/strapdown.min.js"></script> </html>Strapdown Server
The server supports the following parameters.
-addr="0.0.0.0", specify the listening host:port tuple, multiple addresses can be specified by separation of comma, e.g.192.168.1.10:8080,127.0.0.1:8080.-init, do automaticgit initbefore starting the server, if git repo not found in working directory.-dir=/path/to/dir, use the directory as the root of the git powered wiki.-title=MyTitle, specify the default title of Wiki-auth=.htpasswd, specify the authentication file to use, htpasswd format-heading_number=true|false, set default value for whether to show heading numbers-toc=true|false, set default value for whether to show table of content-host=some.domain.com, the default hosting of strapdown static files-theme=cerulean|cosmo|..., the default theme to use
Installation
For normal users
Standalone downloadable binary can be downloaded at https://github.com/chaitin/strapdown-zeta/releases
For hackers
You can hack this project any way you want. Please follow the following build instructions to get started.
Build
build strapdown.min.js and strapdown.min.css
$ npm install
$ gruntThe generated file would be build/strapdown.min.js and build/strapdown.min.css
Build strapdown server
The server can be built into a single standalone binary.
The server is written using go programming language.
First, you need to install go dependency libraries.
$ make -C server depsAfter that, just run make in server directory.
$ cd server
$ make
or just do following in project root directory, both will work!
$ make -C server allUsage
Just copy the strapdown-server binary to anywhere you want and run the server with proper parameters.
examples here:
$ mkdir -p /home/wiki
$ strapdown-server -dir /home/wiki -init -addr 127.0.0.1:8080
Or,you can run in docker:
$ mkdir -p /home/wiki
$ docker build . -t wiki
$ docker run -d -p 8080:8080 -v /home/wiki:/wiki wiki -dir /wiki -init -addr :8080
Note
The server relies on /etc/mime.types to correctly detect file mime types. So make sure /etc/mime.types exists.
for Mac OSX users, the file is builtin.
For Archlinux users, install mime-types
$ pacman -S mime-types
For other Linux distributions, install apache server will also help.
Systemd script
To run this server using systemd, copy the strapdown.service file into your /etc/systemd/system/ directory and systemctl start strapdown
License
This project use SATA License (Star And Thank Author License), so you have to star this project before using. Read the license carefully.
Credits
All credit goes to the projects below that make up most of Strapdown.js:
- Strapdown - Original strapdown by r2r
- MathJax - MathJax, Beautiful math in all browsers
- Marked - Fast Markdown parser in JavaScript
- Google Code Prettify - Syntax highlighting in JavaScript
- Highlight.js - Syntax highlighting in Javascript
- Twitter Bootstrap - Beautiful, responsive CSS framework
- Bootswatch - Additional Bootstrap themes
- Stackedit - I borrowed some mathjax preprocessing code from this project. Thanks. And https://stackedit.io/ is a great project!
- persist.js - Client Side persistent storage solution for remembering themes.