* 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>
In #89 it has been reported that the third step can't be done as
`nix-repl` doesn't evaluate anymore on 18.09 and unstable as in both
cases an evaluation error will be thrown.
First of all this may confuse new users who want to learn Nix, but don't
know the ecosystem sufficiently to understand why the install failed.
As recent NixOS versions (unstable and 18.09) use Nix 2.0 by default and
unstable doesn't evaluate with Nix 1.x anymore it should be a safe thing
to do now.
This patch covers two aspects:
* Using Nix 2.0: I replayed the installation steps with `nix-env` to
ensure that the steps and explanations provided in the first three
chapters are still valid.
* Replacing `nix-repl` references: most of the cases it was sufficient
to replace `nix-repl` with the newly introduced command `nix repl`.
In chapter three `nix-repl` was used to demonstrate the installation
of a package with `nix-env`. I decided to use `nix-index` as demo
package as I figured this tool to be extremely helpful to locate
packages by output files.
The explanation that Nix is not only a tool for package/derivation
management, but a functional language as well was moved to chapter
four where the basics of the language were actually covered.
This change is just a first step towards an updated series, in the
future we may want to use even more Nix 2.0 features (such as
`nix-build` vs. `nix build` with `nix log`).
Fixes#89
Possibly supersedes #71
