# Introduction
**ddoc** is a markdown based static site generator.
**ddoc** powers the documentations of [bacon](https://dystroy.org/bacon), [broot](https://dystroy.org/broot), [dysk](https://dystroy.org/dysk), [rhit](https://dystroy.org/rhit), [safecloset](https://dystroy.org/safecloset).
<div class=image-strip>
<img src=img/thumb-bacon.png>
<img src=img/thumb-broot.png>
<img src=img/thumb-dysk.png>
<img src=img/thumb-rhit.png>
<img src=img/thumb-safecloset.png>
</div>
**ddoc** makes sense when you want a simple site, such as this one, with a site-wide navigation menu, a table of content on every page, and you want to be confident the style you defined won't be broken at every release of the tool.
**ddoc** aims to have the simplest and fastest installation and configuration process, after which you just have to add markdown files and edit your CSS in a standard and obvious way.
# Project goals and features
The development of ddoc was motivated by the frequent breakages occuring with other popular documentation generators.
You should be able to regenerate your site from whatever system, whatever new version of the tool, and get the same style.
You should not have to deal with uncompatible versions of node/Python/whatever, plugin versions, etc. to just get the same result.
You should also not have to deal with huge imported theming CSS files full of `!important` and crumbling under their complexity.
Once built, the site should be deployable on any standard http server, whatever the location and path depth, and whatever the proxies.
Summarizing the goals and features of **ddoc**:
* A reliable static site generator for documentation sites
* Cross-platform and easy to install - a single binary with no dependencies
* Complete and reasonable navigation (menu, TOC, links, search)
* Avoid breaks among versions - no imported CSS
* Support images, tables, code sections, links, etc.
* Clean URL paths, no history shenanigans, obvious links
* Generated HTML is easy to style with CSS
* All internal links are relative, ddoc doesn't need to know the base url of the site
* Integrated search function - but you can replace it with your own
# Getting started
* [Install ddoc](install)
* [Setup your site](setup)
* [Understand plugins](plugins)
* [Edit your site](edit)
* [Look at examples](examples)