Skip to content

The non-customizable markdown to html CLI (another documentation generator)

License

Notifications You must be signed in to change notification settings

barelyhuman/mudkip

Repository files navigation

The non-customizable markdown to html generator

Highlights

  • Tightly scoped
  • Multi Threaded
  • Atomic File Processor
  • Small (1.1 MB)
  • File Watcher (Monitor file changes)
  • (Optional) Client sided search, if JS is enabled

Things missing

  • File Server (bring your own) (or I'll add it at some point)

Installation

Prebuilt Binaries

You can download the binaries from Releases →

Curl for the Prebuilt Binaries

On unix(including macOS)/linux environments you can just use the below commands to download and install the binary

curl -o mudkip.tgz -L https://github.com/barelyhuman/mudkip/releases/latest/download/<platform>-<arch>.tgz

tar -xvzf mudkip.tgz

install <platform>-<arch>/mudkip /usr/local/bin

Replace <platform> and <arch> with the available values from the releases page

Compile from source

You can also compile from source prerequisites make sure you have nim lang installed and running on your system.

Then

  1. Clone and build
git clone https://github.com/barelyhuman/mudkip
cd mudkip
nimble install
nimble build -d:release
  1. Copy the binary to a folder that's available on your system PATH variable

Documentation

You can read it on the website (which, mudkip generated) or if locally cloned, go through the docs folders

License

MIT © Reaper