Re: The cookbook is on-line!
Done!
For posterity, here is the process I've used:
- Add the following to .dir-locals.el:
--8<---cut here---start->8---
((org-mode
(org-texinfo-classes ("guix"
"@documentencoding AUTO\n@documentlanguage AUTO"
("@subsection %s" "@unnumberedsubsec %s" "@subheading
%s"
"@appendixsubsec %s")
("@subsubsection %s" "@unnumberedsubsubsec %s"
"@subsubheading %s"
"@appendixsubsubsec %s")
--8<---cut here---end--->8---
- Add "#+TEXINFO_CLASS: guix" to the Org document. This fixes the
section mapping.
- M-x load-library RET ox-texinfo RET
- C-c C-e C-b i t (or "M-x org-export-dispath", then enable "Body only"
and export in texinfo).
The result was really good and needed only a few minor changes:
- Add/remove some @node where it makes sense.
- Remove the @menu entries. (Can this be set in the export settings?)
- Change the @uref to @xref / @pxref.
Cheers!
--
Pierre Neidhardt
https://ambrevar.xyz/
signature.asc
Description: PGP signature
Re: The cookbook is on-line!
Pierre Neidhardt skribis: > By the way, the original tutorial was published here in Org format: > > https://ambrevar.xyz/guix-packaging/index.html > > So it's possible to export it to texi with Org. > That should save some work. Please do! :-) Ludo’.
Re: The cookbook is on-line!
By the way, the original tutorial was published here in Org format: https://ambrevar.xyz/guix-packaging/index.html So it's possible to export it to texi with Org. That should save some work. -- Pierre Neidhardt https://ambrevar.xyz/ signature.asc Description: PGP signature
Re: The cookbook is on-line!
Pierre Neidhardt writes: > I just noticed that about half the packaging tutorial is missing (the > part after the Scheme crash course). > > Shouldn't be added? Maybe Ricardo had a plan in mind. >From the sources: @c TODO: Continue the tutorial So yeah, the plan was to add the rest :) I just don’t have the time to do this myself. More important to me was to put *something* out there that others can more easily edit. -- Ricardo
Re: The cookbook is on-line!
This is great! :) I just noticed that about half the packaging tutorial is missing (the part after the Scheme crash course). Shouldn't be added? Maybe Ricardo had a plan in mind. -- Pierre Neidhardt https://ambrevar.xyz/ signature.asc Description: PGP signature
The cookbook is on-line!
Hello Guix! A few weeks ago Ricardo started writing a Guix Cookbook⁰ based on material previously published elsewhere, notably on the blog. The cookbook made it in to the repo¹, and you’re all welcome to propose new sections based on your experience with Guix! The news is that the Cookbook is now on-line and automatically updated from ‘master’: https://guix.gnu.org/cookbook/en/ (The page says “Reference Manual” but it’s a mistake that I’ll fix.) So I guess we can go ahead and fill in that cookbook! :-) Please share what you’d like to see or to write about as a Guix user! For the record, here are the changes to the config of berlin.guix.gnu.org to publish the cookbook: https://git.savannah.gnu.org/cgit/guix/maintenance.git/commit/?id=8897e7bc35cbcd0d6cf60c4a57063cd2dceb7bbe and the changes to ‘doc/build.scm’: https://git.savannah.gnu.org/cgit/guix.git/commit/?id=cacb5576cc517cba45f69f1fb1551348714d85d0 Ludo’. ⁰ https://lists.gnu.org/archive/html/guix-devel/2019-09/msg00098.html ¹ https://git.savannah.gnu.org/cgit/guix.git/tree/doc/guix-cookbook.texi signature.asc Description: PGP signature
