Re: Compile skribilo doc containing guix channel references

2022-11-17 Thread Ludovic Courtès
Hi, zimoun skribis: > On jeu., 10 nov. 2022 at 12:58, Ludovic Courtès wrote: > >>> Is it possible to have a Skribilo reader which would use less >>> parenthesis? Similar to Racket Scribble? >> >> Definitely, there’s already a couple of them and we could add one with a >> syntax similar to Texi

Re: Compile skribilo doc containing guix channel references

2022-11-11 Thread zimoun
Hi Ludo, On jeu., 10 nov. 2022 at 12:58, Ludovic Courtès wrote: >> Is it possible to have a Skribilo reader which would use less >> parenthesis? Similar to Racket Scribble? > > Definitely, there’s already a couple of them and we could add one with a > syntax similar to Texinfo or Scribble. Do

Re: Compile skribilo doc containing guix channel references

2022-11-10 Thread Ludovic Courtès
Hi, zimoun skribis: > About the channel information to include in a published paper, yeah > Skribilo/Guix is one (non-straightforwardly?) way to get “guix describe > -f channels”. ;-) Sure, one can achieve the same thing without Skribilo. > Is it possible to have a Skribilo reader which would

Re: Compile skribilo doc containing guix channel references

2022-11-07 Thread zimoun
Hi Ludo, On lun., 07 nov. 2022 at 10:21, Ludovic Courtès wrote: > In a published paper, it’d be useful to include channel information, and > Skribilo/Guix integration is one way to do that. For the convenience of > people who do not use Guix, some might also find it to include > approximate pac

Re: Compile skribilo doc containing guix channel references

2022-11-07 Thread zimoun
Hi Phil, On dim., 06 nov. 2022 at 22:12, Phil wrote: > At the moment compilation is only manual and from inside the repo clone: > guix environment skribilo guile -- guix repl -- compile-docs.scm I see. Interesting as a way to document the channel. Because I find hard to write and read Skribil

Re: Compile skribilo doc containing guix channel references

2022-11-07 Thread Ludovic Courtès
Hi, zimoun skribis: > On Sat, 05 Nov 2022 at 19:03, Ludovic Courtès wrote: [...] >> Nice! Including channel info in the document like you do here is >> probably a major use case; it also makes a lot of sense in the context >> of reproducible research workflows. > > Ludo, what do you have in

Re: Compile skribilo doc containing guix channel references

2022-11-06 Thread Phil
Hi Simon, zimoun writes: > I am missing how the Skribilo file is it compiled? At “guix pull” time? > Or manually when running the script compile-docs.scm? > At the moment compilation is only manual and from inside the repo clone: guix environment skribilo guile -- guix repl -- compile-docs.scm

Re: Compile skribilo doc containing guix channel references

2022-11-06 Thread zimoun
Hi, On Sat, 05 Nov 2022 at 19:03, Ludovic Courtès wrote: >> This generates the docs with guix imports - see compile-command in the >> header: >> https://github.com/quantiletechnologies/qt-guix/blob/feature/EA-133/compile-docs.scm >> >> This is the document - it's less ambitious than my internal

Re: Compile skribilo doc containing guix channel references

2022-11-05 Thread Ludovic Courtès
Phil skribis: > At the risk of cross-posting from skribilo list, whilst our internal > documentation has to remain private, we also have a public fork of guix > which would benefit from some documentation explaining the changes we've made > to guix core code that we hope one day to push upstream

Re: Compile skribilo doc containing guix channel references

2022-11-05 Thread Ludovic Courtès
Hi, Phil skribis: > The proposed fix can been see here: > https://github.com/quantiletechnologies/qt-guix/commit/49900405617fdf6a2e4ab6f4004306a2770221e0 Sure, that makes sense; you can send it to guix-patches. I’d suggest using #:autoload for (guix git) and adding a test case in ‘tests/print.

Re: Compile skribilo doc containing guix channel references

2022-11-05 Thread Phil
Hi, Phil writes: > Hi, > > Ludovic Courtès writes: > >> We toyed with Skribilo/Guix integration in this paper: >> >> https://hal.inria.fr/hal-01161771/en >> >> https://git.savannah.gnu.org/cgit/guix/maintenance.git/tree/doc/reppar-2015/reproducible-hpc.skb >> >> (Note that it starts with ugly

Re: Compile skribilo doc containing guix channel references

2022-11-04 Thread Phil
Hi, Ludovic Courtès writes: > We toyed with Skribilo/Guix integration in this paper: > > https://hal.inria.fr/hal-01161771/en > > https://git.savannah.gnu.org/cgit/guix/maintenance.git/tree/doc/reppar-2015/reproducible-hpc.skb > > (Note that it starts with ugly ‘%load-path’ hacks. :-)) Thank

Re: Compile skribilo doc containing guix channel references

2022-11-02 Thread Ludovic Courtès
Hi, Phil skribis: > The idea is that the guix channel repo will contain a skb file which can > then reference code in the channel by setting the source-path and then > using the :definition in the source function to reference bits of the > package I want to talk about in my document. > > (source

Re: Compile skribilo doc containing guix channel references

2022-10-31 Thread Phil
Hi, Phil writes: > My guess is there is a better approach - any suggestions? Perhaps I can > call the skribilo compiler from inside "guix repl" for example? To somewhat answer my own question in case it's useful to anyone else or if anyone has any suggestion on how to do it better - there are 2

Compile skribilo doc containing guix channel references

2022-10-30 Thread Phil
Hi all, I'd like to document a private guix channel using Guile-based document framework: Skribilo - https://www.nongnu.org/skribilo/. The idea is that the guix channel repo will contain a skb file which can then reference code in the channel by setting the source-path and then using the :definit