* The cookbook is on-line! @ 2019-10-22 13:20 Ludovic Courtès 2019-10-22 13:24 ` Pierre Neidhardt 0 siblings, 1 reply; 7+ messages in thread From: Ludovic Courtès @ 2019-10-22 13:20 UTC (permalink / raw) To: Guix-devel, help-guix [-- Attachment #1: Type: text/plain, Size: 1144 bytes --] 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 [-- Attachment #2: signature.asc --] [-- Type: application/pgp-signature, Size: 832 bytes --] ^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: The cookbook is on-line! 2019-10-22 13:20 The cookbook is on-line! Ludovic Courtès @ 2019-10-22 13:24 ` Pierre Neidhardt 2019-10-22 18:13 ` Ricardo Wurmus 0 siblings, 1 reply; 7+ messages in thread From: Pierre Neidhardt @ 2019-10-22 13:24 UTC (permalink / raw) To: Ludovic Courtès, Guix-devel, help-guix [-- Attachment #1: Type: text/plain, Size: 236 bytes --] 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/ [-- Attachment #2: signature.asc --] [-- Type: application/pgp-signature, Size: 487 bytes --] ^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: The cookbook is on-line! 2019-10-22 13:24 ` Pierre Neidhardt @ 2019-10-22 18:13 ` Ricardo Wurmus 2019-10-23 10:15 ` Pierre Neidhardt 0 siblings, 1 reply; 7+ messages in thread From: Ricardo Wurmus @ 2019-10-22 18:13 UTC (permalink / raw) To: Pierre Neidhardt; +Cc: Guix-devel, help-guix Pierre Neidhardt <mail@ambrevar.xyz> 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 ^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: The cookbook is on-line! 2019-10-22 18:13 ` Ricardo Wurmus @ 2019-10-23 10:15 ` Pierre Neidhardt 2019-10-23 10:19 ` Pierre Neidhardt 0 siblings, 1 reply; 7+ messages in thread From: Pierre Neidhardt @ 2019-10-23 10:15 UTC (permalink / raw) To: Ricardo Wurmus; +Cc: Guix-devel, help-guix [-- Attachment #1: Type: text/plain, Size: 69 bytes --] Understood, thanks! -- Pierre Neidhardt https://ambrevar.xyz/ [-- Attachment #2: signature.asc --] [-- Type: application/pgp-signature, Size: 487 bytes --] ^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: The cookbook is on-line! 2019-10-23 10:15 ` Pierre Neidhardt @ 2019-10-23 10:19 ` Pierre Neidhardt 2019-10-27 22:42 ` Ludovic Courtès 0 siblings, 1 reply; 7+ messages in thread From: Pierre Neidhardt @ 2019-10-23 10:19 UTC (permalink / raw) To: Ricardo Wurmus; +Cc: Guix-devel, help-guix [-- Attachment #1: Type: text/plain, Size: 247 bytes --] 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/ [-- Attachment #2: signature.asc --] [-- Type: application/pgp-signature, Size: 487 bytes --] ^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: The cookbook is on-line! 2019-10-23 10:19 ` Pierre Neidhardt @ 2019-10-27 22:42 ` Ludovic Courtès 2019-10-28 10:13 ` Pierre Neidhardt 0 siblings, 1 reply; 7+ messages in thread From: Ludovic Courtès @ 2019-10-27 22:42 UTC (permalink / raw) To: Pierre Neidhardt; +Cc: Guix-devel, help-guix Pierre Neidhardt <mail@ambrevar.xyz> 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’. ^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: The cookbook is on-line! 2019-10-27 22:42 ` Ludovic Courtès @ 2019-10-28 10:13 ` Pierre Neidhardt 0 siblings, 0 replies; 7+ messages in thread From: Pierre Neidhardt @ 2019-10-28 10:13 UTC (permalink / raw) To: Ludovic Courtès; +Cc: Guix-devel, help-guix [-- Attachment #1: Type: text/plain, Size: 1149 bytes --] 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/ [-- Attachment #2: signature.asc --] [-- Type: application/pgp-signature, Size: 487 bytes --] ^ permalink raw reply [flat|nested] 7+ messages in thread
end of thread, other threads:[~2019-10-28 10:13 UTC | newest] Thread overview: 7+ messages (download: mbox.gz follow: Atom feed -- links below jump to the message on this page -- 2019-10-22 13:20 The cookbook is on-line! Ludovic Courtès 2019-10-22 13:24 ` Pierre Neidhardt 2019-10-22 18:13 ` Ricardo Wurmus 2019-10-23 10:15 ` Pierre Neidhardt 2019-10-23 10:19 ` Pierre Neidhardt 2019-10-27 22:42 ` Ludovic Courtès 2019-10-28 10:13 ` Pierre Neidhardt
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).