2020-11-11 17:31:12 +00:00
# 🍄 MycorrhizaWiki 0.11
2020-09-01 16:52:40 +00:00
A wiki engine.
2020-11-11 17:31:12 +00:00
Features planned for this release:
* [ ] Authorization
2020-11-14 10:39:18 +00:00
* [x] User groups: `anon` , `editor` , `trusted` , `moderator` , `admin`
* [ ] Login page
* [ ] Rights
2020-11-11 17:31:12 +00:00
* [ ] Mycomarkup improvements
2020-11-13 18:45:42 +00:00
* [x] Strike-through syntax
* [x] Formatting in headings
2020-11-11 17:31:12 +00:00
* [ ] Fix empty line codeblock bug #26
* [ ] `img{}` improvements
* [ ] ...
2020-10-03 17:05:10 +00:00
## Building
2020-09-01 16:52:40 +00:00
```sh
git clone --recurse-submodules https://github.com/bouncepaw/mycorrhiza
cd mycorrhiza
make
# That make will:
# * run the default wiki. You can edit it right away.
# * create an executable called `mycorrhiza`. Run it with path to your wiki.
```
2020-07-02 19:03:30 +00:00
2020-10-25 15:06:51 +00:00
## Usage
```
mycorrhiza [OPTIONS...] WIKI_PATH
Options:
2020-11-13 18:45:42 +00:00
-auth-method string
What auth method to use. Variants: "none", "fixed" (default "none")
-fixed-credentials-path string
Used when -auth-method=fixed. Path to file with user credentials. (default "mycocredentials.json")
2020-10-25 15:06:51 +00:00
-home string
The home page (default "home")
-port string
Port to serve the wiki at (default "1737")
-title string
How to call your wiki in the navititle (default "🍄")
2020-11-13 18:45:42 +00:00
-user-tree string
Hypha which is a superhypha of all user pages (default "u")
2020-10-25 15:06:51 +00:00
```
2020-10-03 17:05:10 +00:00
## Features
2020-07-19 15:00:44 +00:00
* Edit pages through html forms
* Responsive design
* Works in text browsers
2020-11-11 16:55:36 +00:00
* Wiki pages (called hyphae) are written in mycomarkup
* Everything is stored as simple files, no database required. You can run a wiki on almost any directory and get something to work with.
2020-08-28 19:10:46 +00:00
* Page trees
* Changes are saved to git
2020-09-01 16:52:40 +00:00
* List of hyphae page
2020-08-28 19:10:46 +00:00
* History page
2020-09-01 16:52:40 +00:00
* Random page
2020-10-03 17:05:10 +00:00
* Recent changes page
* Hyphae can be deleted (while still preserving history)
* Hyphae can be renamed (recursive renaming of subhyphae is also supported)
2020-09-01 16:52:40 +00:00
* Light on resources: I run a home wiki on this engine 24/7 at an [Orange π Lite ](http://www.orangepi.org/orangepilite/ ).
2020-07-19 15:00:44 +00:00
2020-09-01 16:52:40 +00:00
## Contributing
Help is always needed. We have a [tg chat ](https://t.me/mycorrhizadev ) where some development is coordinated. Feel free to open an issue or contact me.
2020-07-19 15:00:44 +00:00
2020-09-01 16:52:40 +00:00
## Future plans
* Tagging system
* Better history viewing
