🍄 Mycorrhiza Wiki 1.2

A wiki engine.

Main wiki

Building

See the guide on the wiki.

Installing

Pacman

If you use a linux distro with pacman package manager (Arch, Manjaro, Garuda, etc) you can install it using PKGBUILD:

$ wget https://raw.githubusercontent.com/bouncepaw/mycorrhiza/master/PKGBUILD
$ makepkg --install

Docker

You can run Mycorrhiza Wiki in Docker using Dockerfile provided by this repository. Clone the repo and build the image:

$ git clone https://github.com/bouncepaw/mycorrhiza/
$ docker build -t mycorrhiza .

Now you can create a new Mycorrhiza Wiki container using this command:

$ docker run -v /full/path/to/my/wiki:/wiki -p 1737:1737 mycorrhiza

Example:

$ cd /dev/shm
$ git clone https://github.com/bouncepaw/mycorrhiza/
$ docker build -t mycorrhiza .
$ git clone https://github.com/bouncepaw/example-wiki
$ docker run -v /dev/shm/example-wiki:/wiki -p 1737:1737 mycorrhiza

Example 2:

...
$ docker run -v /dev/shm/:/config -v /dev/shm/example-wiki:/wiki -p 80:1737 mycorrhiza -config-path /config/myconfig.ini /wiki

Usage

mycorrhiza [OPTIONS...] WIKI_PATH

WIKI_PATH must be a path to a git repository which you want to be a wiki.

Options:
  -config-path string
        Path to a configuration file. Leave empty if you don't want to use it.
  -print-example-config
        If true, print an example configuration file contents and exit. You can save the output to a file and base your own configuration on it.

Features

Wiki pages (called hyphae) are written in mycomarkup
Edit pages through html forms, a graphical preview and a toolbar that helps you use mycomarkup
Responsive design, dark theme (synced with system theme)
Works in text browsers
Everything is stored as simple files, no database required. You can run a wiki on almost any directory and get something to work with
Page trees; links to previous and next pages
Changes are saved to git
List of hyphae page
History page
Random page
Recent changes page; RSS, Atom and JSON feeds available
Hyphae can be deleted while still preserving history
Hyphae can be renamed (recursive renaming of subhyphae is also supported)
Light on resources
Authorization with pre-set credentials, registration
Basic Gemini protocol support

Contributing

Help is always needed. We have a tg chat where some development is coordinated. You can also sponsor bouncepaw on boosty. Feel free to open an issue or contact us directly.

You can view list of all planned features on our kanban board.

2.7 KiB Raw Blame History