mirror of
https://github.com/NixOS/nix-pills
synced 2024-09-19 04:00:13 -04:00
4033045782
* Transform <xi:include> elements to include content * Remove 3 files which were not referenced The files were probably included in previous versions and weren't removed. * Automatic conversion using pandoc I just run `pandoc {fn} -f docbook -t markdown --wrap=none -s -o {fn.with_suffix(".md")}` over all .xml files in pills/, and on /book.xml I manually created SUMMARY.md based on the list in book.xml. * Remove front matter from 00-preface.md * Support "note" sections, fix inter-links * Fix code sections with highlighting, which pandoc missed * Replace `\'` with `'`. * Replace `\"` with `"`. * Replace `\...` with `...` * Format markdown with Prettier * Convert code section to fenced, with the appropriate syntax * Build the book with Nix * Add highlight.js which supports nix syntax highlighting * Add redirects from original paths to new paths * make prompts unselectable * README: Remove DocBook-specific instructions (cherry picked from commit66936f15a5
) * Re-add heading id It was removed in pandoc step for some reason. (cherry picked from commitcf39aa5ad9
) * Fix footnote rendering with mdbook-epub mdbook-epub 0.4.37 will collapse the second footnote into the first one. This does not happen with HTML output from plain mdbook. (cherry picked from commitbc9bd13844
) * Manually added backticks for <package> tags in original * Put «» around what was originally <replaceable> * epub: Remove extra page breaks before headings The sections are pretty short, leading to unnecessary pagination being required. --------- Co-authored-by: Noam Yorav-Raphael <noam.yoravraphael@mobileye.com> Co-authored-by: Jan Tojnar <jtojnar@gmail.com>
463 B
463 B
Nix Pills
Available online as a multi-page HTML or an e-book in EPUB format.
You can also build them locally:
nix-build release.nix -A html-split && firefox result/share/doc/nix-pills/index.html
Similarly, for an EPUB version, run:
nix-build release.nix -A epub && foliate result/share/doc/nix-pills/nix-pills.epub