mirrors/mycorrhiza
1
0
Fork 0
mirror of https://github.com/osmarks/mycorrhiza.git synced 2024-12-12 05:20:26 +00:00
Code Issues Releases Wiki Activity
d83543b4d7
mycorrhiza/README.md
bouncepaw f6a41b4818 Some adjusting before merging
2021-03-05 14:39:33 +05:00

2.6 KiB
Raw Blame History

🍄 MycorrhizaWiki 0.13

A wiki engine.

Main wiki

Building

Also see detailed instructions on wiki.

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.

Usage

mycorrhiza [OPTIONS...] WIKI_PATH

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

Options:
  -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")
  -gemini-cert-path string
        Directory where you store Gemini certificates. Leave empty if you don't want to use Gemini.
  -header-links-hypha string
        Optional hypha that overrides the header links
  -home string
        The home page (default "home")
  -icon string
        What to show in the navititle in the beginning, before the colon (default "🍄")
  -name string
        What is the name of your wiki (default "wiki")
  -port string
        Port to serve the wiki at (default "1737")
  -url string
        URL at which your wiki can be found. Used to generate feeds (default "http://0.0.0.0:$port")
  -user-hypha string
        Hypha which is a superhypha of all user pages (default "u")

Features

  • Edit pages through html forms, graphical preview
  • Responsive design, dark theme (synced with system theme)
  • Works in text browsers
  • 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
  • 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
  • Basic Gemini protocol support

Contributing

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

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