Commit graph

4 commits

Author SHA1 Message Date
Noam Yorav-Raphael
a6ef5303e2
Update 09-automatic-runtime-dependencies.md - fix NixOps link
The link to NixOps was corrupted by mistake in this PR: https://github.com/NixOS/nix-pills/pull/181/files#diff-a53cbc0f08ac225fd5073d54147a9a6ba2ebbdbd0e5164711ab362d0439cc27aR265

It was changed from http://nixos.org/nixops/manual/#chap-introduction to https://nixos.org/manual/nix/stable/introduction.html.

I think that at least for now, it would be better to link to https://github.com/NixOS/nixops, as the old link just links to an obscure in-development HTML document, and the github link starts with a warning "NixOps is in low-maintenance mode and probably not suited for new projects. Use at your own risks", and also links to an experimental NixOps4.
2024-04-10 20:39:17 +03:00
Noam Yorav-Raphael
a2210a8712 Add redirects from original paths to new paths 2024-04-09 01:46:32 +02:00
Jan Tojnar
8291ca1677 Revert "Convert from docbook to mdbook (#233)"
This reverts commit 4033045782.

To preserve history.
2024-04-09 01:46:08 +02:00
Noam Yorav-Raphael
4033045782
Convert from docbook to mdbook (#233)
* 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 66936f15a573e36e7138fc93cecb8d2845296ace)

* Re-add heading id

It was removed in pandoc step for some reason.

(cherry picked from commit cf39aa5ad95cf3d704ecd2aa4055e4c23e74fb6b)

* 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 bc9bd1384427a443dd12674c5ae2ae0c36ffc7ee)

* 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>
2024-04-08 16:37:11 -07:00