New Guix reference card

New Guix reference card

[Ludovic Courtès]

Hello Guix!

I’ve written a reference card for Guix, which you can find here:

  https://gnu.org/s/guix/guix-refcard.pdf

The source is at:

  https://git.savannah.gnu.org/cgit/guix/maintenance.git/tree/doc/refcard

It’s written using the Lout document formatting system, so I provided a
simple build file such that you just have to run:

  guix build -f build.scm

I initially tried to do this in plain TeX based on the Org-mode and GDB
refcards, on the grounds that people were more likely to be familiar
with TeX, but that turned out to be too tricky for me and I’m just more
fluent in Lout than in TeX.

Enjoy, share, and improve!  :-)

Ludo’.

Re: New Guix reference card

[Laura Lazzati]

On Fri, Oct 19, 2018 at 10:45 AM Ludovic Courtès <ludo@gnu.org> wrote:
>
> Hello Guix!
>
> I’ve written a reference card for Guix, which you can find here:
>
>   https://gnu.org/s/guix/guix-refcard.pdf
Thanks! I find it really useful. I did not know you call them
reference card, I generally call them cheatsheets
>
> The source is at:
>
>   https://git.savannah.gnu.org/cgit/guix/maintenance.git/tree/doc/refcard
>
> It’s written using the Lout document formatting system, so I provided a
> simple build file such that you just have to run:
>
>   guix build -f build.scm
>
> I initially tried to do this in plain TeX based on the Org-mode and GDB
> refcards, on the grounds that people were more likely to be familiar
> with TeX, but that turned out to be too tricky for me and I’m just more
> fluent in Lout than in TeX.
>
> Enjoy, share, and improve!  :-)
>
> Ludo’.
>

Re: New Guix reference card

[znavko]

[-- Attachment #1: Type: text/plain, Size: 2424 bytes --]

So beautiful reference card!
My system is this:

# guix describe
Generation 9    Oct 18 2018 20:58:22    (current)
  guix 33428d1
    repository URL: https://git.savannah.gnu.org/git/guix.git <https://git.savannah.gnu.org/git/guix.git>
    branch: master
    commit: 33428d12672fefde745b313ce1f0c02ae9870e39


I often use `guix package -s ATOM`, assume it will be able to search by file name (when need header like intel-vga.h...) or will show all available versions 

# guix package --show=python
name: python
version: 3.6.5
outputs: out tk
systems: x86_64-linux i686-linux armhf-linux aarch64-linux mips64el-linux
dependencies: bzip2@1.0.6 gdbm@1.14.1 libffi@3.2.1 openssl@1.0.2o
+ pkg-config@0.29.2 readline@7.0.3 sqlite@3.23.0 tcl@8.6.8 tk@8.6.8 zlib@1.2.11
location: gnu/packages/python.scm:370:2
homepage: https://www.python.org <https://www.python.org>
license: Python Software Foundation License
synopsis: High-level, dynamically-typed programming language  
description: Python is a remarkably powerful dynamic programming language that
+ is used in a wide variety of application domains.  Some of its key
+ distinguishing features include: clear, readable syntax; strong introspection
+ capabilities; intuitive object orientation; natural expression of procedural
+ code; full modularity, supporting hierarchical packages; exception-based error
+ handling; and very high level dynamic data types.

name: python
version: 2.7.14
outputs: out tk
systems: x86_64-linux i686-linux armhf-linux aarch64-linux mips64el-linux
dependencies: bzip2@1.0.6 gdbm@1.14.1 libffi@3.2.1 openssl@1.0.2o
+ pkg-config@0.29.2 readline@7.0.3 sqlite@3.23.0 tcl@8.6.8 tk@8.6.8 zlib@1.2.11
location: gnu/packages/python.scm:364:2
homepage: https://www.python.org <https://www.python.org>
license: Python Software Foundation License
synopsis: High-level, dynamically-typed programming language  
description: Python is a remarkably powerful dynamic programming language that
+ is used in a wide variety of application domains.  Some of its key
+ distinguishing features include: clear, readable syntax; strong introspection
+ capabilities; intuitive object orientation; natural expression of procedural
+ code; full modularity, supporting hierarchical packages; exception-based error
+ handling; and very high level dynamic data types.

# guix package --show=python3
# 


[-- Attachment #2: Type: text/html, Size: 3002 bytes --]

Re: New Guix reference card

[Ludovic Courtès]

Hi Laura,

Laura Lazzati <laura.lazzati.15@gmail.com> skribis:

> On Fri, Oct 19, 2018 at 10:45 AM Ludovic Courtès <ludo@gnu.org> wrote:
>>
>> Hello Guix!
>>
>> I’ve written a reference card for Guix, which you can find here:
>>
>>   https://gnu.org/s/guix/guix-refcard.pdf
> Thanks! I find it really useful. I did not know you call them
> reference card, I generally call them cheatsheets

Yeah I guess both terms work.  :-)  I’m glad you find it useful!

Ludo’.

Re: New Guix reference card

[Chris Marusich]

[-- Attachment #1: Type: text/plain, Size: 517 bytes --]

ludo@gnu.org (Ludovic Courtès) writes:

> I’ve written a reference card for Guix, which you can find here:
>
>   https://gnu.org/s/guix/guix-refcard.pdf
>
> The source is at:
>
>   https://git.savannah.gnu.org/cgit/guix/maintenance.git/tree/doc/refcard

Excellent!  I was actually thinking about making something like this to
share with people at my upcoming talk at SeaGL, but maybe I'll just
steal yours, instead.  :-)

I see that the second page is mostly blank.  Is that intended?

-- 
Chris

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 832 bytes --]

Re: New Guix reference card

[Leo Famulari]

[-- Attachment #1: Type: text/plain, Size: 240 bytes --]

On Sat, Oct 20, 2018 at 01:05:18PM -0700, Chris Marusich wrote:
> I see that the second page is mostly blank.  Is that intended?

I think it's meant to be the back of a printed card. It would be great
to have a stack of these for FOSDEM :)

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: New Guix reference card

[Gábor Boskovits]

Hello Leo,

Leo Famulari <leo@famulari.name> ezt írta (időpont: 2018. okt. 22., H, 4:56):
>
> I think it's meant to be the back of a printed card. It would be great
> to have a stack of these for FOSDEM :)

How big stack are you thinking about? Maybe I can help there :)
g_bor

Re: New Guix reference card

[Ludovic Courtès]

Hello!

Leo Famulari <leo@famulari.name> skribis:

> On Sat, Oct 20, 2018 at 01:05:18PM -0700, Chris Marusich wrote:
>> I see that the second page is mostly blank.  Is that intended?
>
> I think it's meant to be the back of a printed card.

Exactly!  If you don’t have a double-sided printer, you can obviously
skip the second page.

Or, if you do have a double-sided printer but still find the second page
to be too empty, you could add stuff about ‘guix system’ there.  Hint,
hint!  ;-)

Chris, note that you may want to modify ‘refcard-style.lout’ to use
Letter rather than A4, but then the layout may need to be tweaked.
(Alternately find yourself a bunch of A4 sheets.  ;-))

Gábor Boskovits <boskovits@gmail.com> skribis:

> Leo Famulari <leo@famulari.name> ezt írta (időpont: 2018. okt. 22., H, 4:56):
>>
>> I think it's meant to be the back of a printed card. It would be great
>> to have a stack of these for FOSDEM :)
>
> How big stack are you thinking about? Maybe I can help there :)

I suppose that’ll depend on whether we get a booth!  But anyway, we
could bring some in the pre-FOSDEM Guix workshop as well as in the
devrooms where we present Guix.

Thanks,
Ludo’.

Re: New Guix reference card

[Quiliro Ordonez]

El 2018-10-19 08:40, ludo@gnu.org escribió:
> Hello Guix!
> 
> I’ve written a reference card for Guix, which you can find here:
> 
>   https://gnu.org/s/guix/guix-refcard.pdf
> 
> The source is at:
> 
>   https://git.savannah.gnu.org/cgit/guix/maintenance.git/tree/doc/refcard

I tryed to open a file which I downloaded:
https://git.savannah.gnu.org/cgit/guix/maintenance.git/tree/doc/refcard/Guix-horizontal-print.eps
It would stay forever trying to open with eVince.

Re: New Guix reference card

[Maxim Cournoyer]

Thanks Ludovic, this is a neat reference card! I also learned about the
"Lout" software for the first time, for which you appear to be a
maintainer ;)

Maxim

Re: New Guix reference card

[Ludovic Courtès]

Maxim Cournoyer <maxim.cournoyer@gmail.com> skribis:

> Thanks Ludovic, this is a neat reference card! I also learned about the
> "Lout" software for the first time, for which you appear to be a
> maintainer ;)

No no, I made a few contributions to Lout but that’s it.  It’s
functional programming for text layout; if you’re frustrated with TeX as
a language, you may like it.  :-)

Ludo’.