luzifer/wiki
1
0
Fork 0
mirror of https://github.com/Luzifer/wiki.git synced 2024-12-27 14:01:20 +00:00
Code Issues Releases Wiki Activity
File-based Wiki implementation with web-editing capabilities and a Git backed storage
43 commits 1 branch 8 tags 4.7 MiB
Go 40.6%
Vue 29.7%
CSS 7.5%
Shell 5.9%
JavaScript 5.5%
Other 10.8%
Find a file
Knut Ahlers 567372fb27
prepare release v0.4.2
2024-12-12 11:35:58 +01:00
.github/workflows CI: Replace old build-system 2024-01-30 15:52:11 +01:00
ci CI: Replace old build-system 2024-01-30 15:52:11 +01:00
default_files Move default files, add navigation default 2019-08-15 22:39:05 +02:00
frontend CI: Build app code on-demand 2024-01-30 16:30:19 +01:00
src Style blockquotes (better) 2024-01-30 16:46:57 +01:00
.eslintrc.js Port frontend to Vue 3 / Bootstrap 5.3 2024-01-30 15:46:01 +01:00
.gitignore CI: Build app code on-demand 2024-01-30 16:30:19 +01:00
assets.go Update dependencies, modernize code 2024-01-29 23:56:17 +01:00
docker-entrypoint.sh Add dockerized version 2019-08-07 08:01:59 +02:00
Dockerfile CI: Build app code on-demand 2024-01-30 16:30:19 +01:00
go.mod Update Go dependencies 2024-12-12 11:31:59 +01:00
go.sum Update Go dependencies 2024-12-12 11:31:59 +01:00
History.md prepare release v0.4.2 2024-12-12 11:35:58 +01:00
LICENSE Add META 2019-08-07 07:31:56 +02:00
main.go Port frontend to Vue 3 / Bootstrap 5.3 2024-01-30 15:46:01 +01:00
Makefile CI: Build app code on-demand 2024-01-30 16:30:19 +01:00
package-lock.json Update node dependencies 2024-12-12 11:32:28 +01:00
package.json Port frontend to Vue 3 / Bootstrap 5.3 2024-01-30 15:46:01 +01:00
README.md Add support for custom author configuration through auth proxy 2020-08-04 17:36:05 +02:00
storage.go Update dependencies, modernize code 2024-01-29 23:56:17 +01:00
storage_test.go Update dependencies, modernize code 2024-01-29 23:56:17 +01:00

README.md

Go Report Card

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.