wiki/README.md

Luzifer / wiki

wiki is a small file-based Wiki implementation with web-editing capabilities and a Git backed storage for history of pages.

The goal of this project was to have a small application to be deployed without any dependencies to open a Wiki for note taking or documentation purpose.

The software itself has no concept of users or authentication and is held as simple as possible. Saved pages are stored as plain Markdown file onto the local disk inside a Git repository which on the one hand can be used to backup the state (just add a remote and set up a cron to push changes) and on the other hand to recover contents if someone deleted contents from a page.

Usage

# wiki --help
Usage of wiki:
      --author-email-header string   Header to use as Author email
      --author-name-header string    Header to use as Author name
      --data-dir string              Directory to store data to (default "./data/")
      --listen string                Port/IP to listen on (default ":3000")
      --log-level string             Log level (debug, info, warn, error, fatal) (default "info")
      --version                      Prints current version and exits

To use this you can

• download pre-build binaries from the releases
• pull the Docker image
• or go get -u github.com/Luzifer/wiki the project

Given you've used the binary you can now just execute ./wiki and go to http://localhost:3000. Everything you save will be stored in the ./data directory.

Setting the author name of the commit

If you've put the wiki behind an auth-proxy which is able to set headers containing the username / email of the authenticated user (for example nginx with nginx-sso) you can specify the --author-email-header and/or --author-name-header and provide the header names you've used there. These values will then be used as the author of the commit while the committer will still be the wiki-user.