<p><em>mkbook</em> is my simpler alternative to <ahref="https://crates.io/crates/mdbook"><em>mdbook</em></a> which is a great tool, but for which I really dislike some of the decisions they took, such as relying on javascript for highlighting and navigation, and including a lot of bells and whistles such as javascript-based search.</p>
<p>This tool aims to work somewhat similarly to <em>mdbook</em>, but is generally intended to be a more minimal alternative that is customized more towards my needs and desires than anything else.</p>
<p>If you’re not familiar with <em>mdbook</em>, <em>mkbook</em> is a tool to convert a collection of <ahref="https://commonmark.org/">Markdown</a> files into a static website / book which can be published online. It was created to help me write documentation with minimum fuss while presenting it in an easy-to-consume manner.</p>
<p><em>mkbook</em> may be installed using <em>Cargo</em> (<code>cargo install --force --path .</code> in the <em>mkbook</em> repo directory), and after that it presents a command-line interface:</p>
</span><spanstyle="color:#d3d0c8;"></span><spanstyle="color:#6699cc;">build</span><spanstyle="color:#d3d0c8;"> build the book
</span><spanstyle="color:#d3d0c8;"></span><spanstyle="color:#66cccc;">help</span><spanstyle="color:#d3d0c8;"> Prints this message or the help of the given subcommand(s)
</span><spanstyle="color:#d3d0c8;"></span><spanstyle="color:#6699cc;">init</span><spanstyle="color:#d3d0c8;"> initialize a mkbook directory tree
</span><spanstyle="color:#d3d0c8;"></span><spanstyle="color:#6699cc;">-h,</span><spanstyle="color:#f2777a;"> --help</span><spanstyle="color:#d3d0c8;"> Prints help information
</span><spanstyle="color:#d3d0c8;"></span><spanstyle="color:#6699cc;">-V,</span><spanstyle="color:#f2777a;"> --version</span><spanstyle="color:#d3d0c8;"> Prints version information
</span><spanstyle="color:#d3d0c8;"></span><spanstyle="color:#6699cc;">-d,</span><spanstyle="color:#f2777a;"> --directory </span><spanstyle="color:#d3d0c8;"><directory> an optional directory to initialize into </span><spanstyle="color:#cc99cc;">[</span><spanstyle="color:#d3d0c8;">default: src</span><spanstyle="color:#cc99cc;">]
<p>The build command is the primary command for <em>mkbook</em>, and is responsible for taking the <code>.md</code> files and building the resulting website.</p>
</span><spanstyle="color:#d3d0c8;"></span><spanstyle="color:#6699cc;">-h,</span><spanstyle="color:#f2777a;"> --help</span><spanstyle="color:#d3d0c8;"> Prints help information
</span><spanstyle="color:#d3d0c8;"></span><spanstyle="color:#6699cc;">-V,</span><spanstyle="color:#f2777a;"> --version</span><spanstyle="color:#d3d0c8;"> Prints version information
</span><spanstyle="color:#d3d0c8;"></span><spanstyle="color:#6699cc;">-i,</span><spanstyle="color:#f2777a;"> --in </span><spanstyle="color:#d3d0c8;"><in> an optional directory to take the book sources from </span><spanstyle="color:#cc99cc;">[</span><spanstyle="color:#d3d0c8;">default: src</span><spanstyle="color:#cc99cc;">]
</span><spanstyle="color:#d3d0c8;"></span><spanstyle="color:#6699cc;">-o,</span><spanstyle="color:#f2777a;"> --out </span><spanstyle="color:#d3d0c8;"><out> an optional directory to render the contents into </span><spanstyle="color:#cc99cc;">[</span><spanstyle="color:#d3d0c8;">default: book</span><spanstyle="color:#cc99cc;">]