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 commit 66936f15a5)
* Re-add heading id
It was removed in pandoc step for some reason.
(cherry picked from commit cf39aa5ad9)
* 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 commit bc9bd13844)
* 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>
41 lines
1.7 KiB
TOML
41 lines
1.7 KiB
TOML
[book]
|
|
title = "Nix Pills"
|
|
authors = ["Luca Bruno"]
|
|
language = "en"
|
|
multilingual = false
|
|
src = "pills"
|
|
|
|
[output.html]
|
|
additional-css = ["custom.css"]
|
|
edit-url-template = "https://github.com/NixOS/nix-pills/tree/master/{path}"
|
|
git-repository-url = "https://github.com/NixOS/nix-pills"
|
|
|
|
[output.html.redirect]
|
|
"pr01.html" = "00-preface.html"
|
|
"why-you-should-give-it-a-try.html" = "01-why-you-should-give-it-a-try.html"
|
|
"install-on-your-running-system.html" = "02-install-on-your-running-system.html"
|
|
"enter-environment.html" = "03-enter-environment.html"
|
|
"basics-of-language.html" = "04-basics-of-language.html"
|
|
"functions-and-imports.html" = "05-functions-and-imports.html"
|
|
"our-first-derivation.html" = "06-our-first-derivation.html"
|
|
"working-derivation.html" = "07-working-derivation.html"
|
|
"generic-builders.html" = "08-generic-builders.html"
|
|
"automatic-runtime-dependencies.html" = "09-automatic-runtime-dependencies.html"
|
|
"developing-with-nix-shell.html" = "10-developing-with-nix-shell.html"
|
|
"garbage-collector.html" = "11-garbage-collector.html"
|
|
"inputs-design-pattern.html" = "12-inputs-design-pattern.html"
|
|
"callpackage-design-pattern.html" = "13-callpackage-design-pattern.html"
|
|
"override-design-pattern.html" = "14-override-design-pattern.html"
|
|
"nix-search-paths.html" = "15-nix-search-paths.html"
|
|
"nixpkgs-parameters.html" = "16-nixpkgs-parameters.html"
|
|
"nixpkgs-overriding-packages.html" = "17-nixpkgs-overriding-packages.html"
|
|
"nix-store-paths.html" = "18-nix-store-paths.html"
|
|
"fundamentals-of-stdenv.html" = "19-fundamentals-of-stdenv.html"
|
|
"basic-dependencies-and-hooks.html" = "20-basic-dependencies-and-hooks.html"
|
|
|
|
[output.linkcheck]
|
|
follow-web-links = true
|
|
|
|
# To build the epub version, run:
|
|
# mdbook-epub --standalone true
|