A less opinionated document aggregator and publisher. Easier to use and to adapt than Antora, Hugo, JBake and the likes.
Monako abstracts the complexity of collecting documentation from a configurable amount of Git repositories (origins).
Monako uses Hugo as a static site generator but hides it to the user. It also uses the great Hugo Book Theme which I forked at Monako Book.
$ monako -h
Usage of monako:
-base-url string
Custom base URL
-config string
Configuration file (default "config.monako.yaml")
-fail-on-error
Fail on document conversion errors
-menu-config string
Menu file for monako-book theme (default "config.menu.md")
-compose
Only compose the Monako structure
-render
Only render HTML files from an existing Monako structure
-trace
Enable trace logging
A Docker image is available from Dockerhub.
---
baseURL : "https://example.com/"
title : "My Projects"
whitelist:
- ".md"
- ".adoc"
- ".jpg"
- ".svg"
- ".png"
origins:
- src: https://github.com/snipem/commute-tube
branch: master
docdir: .
targetdir: docs/commute
- src: https://github.com/snipem/monako
branch: develop
docdir: doc
targetdir: docs/monako
- **My Projects**
- [Commute Tube]({{< relref "/docs/commute/readme" >}})
- [Monako]({{< relref "/docs/monako/readme" >}})
...
Monako supports all Hugo Frontmatter types (YAML, TOML and JSON). Monako converts them to YAML.
Add frontmatter as you wish at long as it's supported by Hugo and the Theme.
Hide Git links like "edit this page" and "last edit by". Add this line to the frontmatter of the document:
MonakoGitLinks = false
- Make it simple and stupid, single binary with no dependencies ✓
- Git clone existing repositories ✓
- Don't attempt to change their structure ✓
- Transform all documents below a specific structure ✓
- Use Antora like configuration file for main structure ✓
- Support Mermaid ✓
- Multi repository document fetching
- Bundled dependencies (minus Asciidoctor)
Init with make init
- Support edit this page links with links to origin repository. Book theme provides a similar feature.