unofficial mirror of help-guix@gnu.org 
 help / color / mirror / Atom feed
* how to translate info guix to text file or pdf or html ?
@ 2019-03-27 19:15 znavko
  2019-03-28 18:52 ` Oleg Pykhalov
  2019-03-28 19:30 ` Joshua Branson
  0 siblings, 2 replies; 11+ messages in thread
From: znavko @ 2019-03-27 19:15 UTC (permalink / raw)
  To: Help Guix

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


Hi! I've learned that guix manual updates with the updates more quickly than manual's web-page.

But `info guix` is hard for using. I like html.
Please, let me know if it is possible to transform `info guix` to text file or html or pdf?

PS: I tried to learn `info` commands but using mouse and search by web-page in browser is better.

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

^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: how to translate info guix to text file or pdf or html ?
  2019-03-27 19:15 how to translate info guix to text file or pdf or html ? znavko
@ 2019-03-28 18:52 ` Oleg Pykhalov
  2019-03-28 19:11   ` Quiliro Ordonez
                     ` (2 more replies)
  2019-03-28 19:30 ` Joshua Branson
  1 sibling, 3 replies; 11+ messages in thread
From: Oleg Pykhalov @ 2019-03-28 18:52 UTC (permalink / raw)
  To: znavko; +Cc: Help Guix

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

Hi,

<znavko@tutanota.com> writes:

> Hi! I've learned that guix manual updates with the updates more quickly than manual's web-page.
>
> But `info guix` is hard for using. I like html.
> Please, let me know if it is possible to transform `info guix` to text file or html or pdf?
>
> PS: I tried to learn `info` commands but using mouse and search by web-page in browser is better.

You could call a ‘make html’ command inside Guix Git repository
https://www.gnu.org/software/guix/manual/html_node/Building-from-Git.html

Then ‘firefox doc/guix.html/index.html’ will open a fresh manual.

Oleg.

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

^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: how to translate info guix to text file or pdf or html ?
  2019-03-28 18:52 ` Oleg Pykhalov
@ 2019-03-28 19:11   ` Quiliro Ordonez
  2019-03-28 20:31     ` Ricardo Wurmus
  2019-03-29  9:45   ` znavko
  2019-03-29  9:47   ` znavko
  2 siblings, 1 reply; 11+ messages in thread
From: Quiliro Ordonez @ 2019-03-28 19:11 UTC (permalink / raw)
  To: help-guix

El 2019-03-28 18:52, Oleg Pykhalov escribió:
> Hi,
> 
> <znavko@tutanota.com> writes:
> 
>> Hi! I've learned that guix manual updates with the updates more quickly than manual's web-page.
>>
>> But `info guix` is hard for using. I like html.
>> Please, let me know if it is possible to transform `info guix` to text file or html or pdf?
>>
>> PS: I tried to learn `info` commands but using mouse and search by web-page in browser is better.
> 
> You could call a ‘make html’ command inside Guix Git repository
> https://www.gnu.org/software/guix/manual/html_node/Building-from-Git.html
> 
> Then ‘firefox doc/guix.html/index.html’ will open a fresh manual.
> 
> Oleg.

Thanks Oleg. Nice to know.

It would be nice if that would be the published version of the manual.

^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: how to translate info guix to text file or pdf or html ?
  2019-03-27 19:15 how to translate info guix to text file or pdf or html ? znavko
  2019-03-28 18:52 ` Oleg Pykhalov
@ 2019-03-28 19:30 ` Joshua Branson
  2019-03-28 20:29   ` Ricardo Wurmus
  1 sibling, 1 reply; 11+ messages in thread
From: Joshua Branson @ 2019-03-28 19:30 UTC (permalink / raw)
  To: help-guix

<znavko@tutanota.com> writes:

> Hi! I've learned that guix manual updates with the updates more quickly than
> manual's web-page.
>
> But `info guix` is hard for using. I like html.
> Please, let me know if it is possible to transform `info guix` to text file or html or pdf?

It is possible to convert info into html and pdf.  Guix's manual changes
all the time.  Trying to keep the website up-to-date is a tough task.
Perhaps you would like to give this a try?

>
> PS: I tried to learn `info` commands but using mouse and search by web-page in
> browser is better.
>

I used to feel the same way.  But info is super cool once you get the
hang of it.  It is especially awesome inside emacs.  M-x helm-info-guix
is probably my favorite command.  It lets you search through all of the
guix documentation.  Try going through the info tutorial.  "info info".
It'll be dividends.  

--
Joshua Branson
Sent from Emacs and Gnus

^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: how to translate info guix to text file or pdf or html ?
  2019-03-28 19:30 ` Joshua Branson
@ 2019-03-28 20:29   ` Ricardo Wurmus
  2019-03-28 22:41     ` Quiliro Ordonez
  0 siblings, 1 reply; 11+ messages in thread
From: Ricardo Wurmus @ 2019-03-28 20:29 UTC (permalink / raw)
  To: Joshua Branson; +Cc: help-guix


Joshua Branson <jbranso@dismail.de> writes:

> Guix's manual changes
> all the time.  Trying to keep the website up-to-date is a tough task.

It is a decision, not a technical limitation.  We want the public copy
of the manual to match the latest release, not an arbitrary later
version.

--
Ricardo

^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: how to translate info guix to text file or pdf or html ?
  2019-03-28 19:11   ` Quiliro Ordonez
@ 2019-03-28 20:31     ` Ricardo Wurmus
  0 siblings, 0 replies; 11+ messages in thread
From: Ricardo Wurmus @ 2019-03-28 20:31 UTC (permalink / raw)
  To: Quiliro Ordonez; +Cc: help-guix


Quiliro Ordonez <quiliro@riseup.net> writes:

>> You could call a ‘make html’ command inside Guix Git repository
>> https://www.gnu.org/software/guix/manual/html_node/Building-from-Git.html
[…]
> It would be nice if that would be the published version of the manual.

The published manual on the website is roughly equivalent the output of
“make html” (generated via a gnulib script).

It just is not the manual for an arbitrary later version of Guix but for
the version that people can actually download, namely the latest release.

--
Ricardo

^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: how to translate info guix to text file or pdf or html ?
  2019-03-28 20:29   ` Ricardo Wurmus
@ 2019-03-28 22:41     ` Quiliro Ordonez
  2019-03-29  3:00       ` Ricardo Wurmus
  0 siblings, 1 reply; 11+ messages in thread
From: Quiliro Ordonez @ 2019-03-28 22:41 UTC (permalink / raw)
  To: help-guix

El 2019-03-28 20:29, Ricardo Wurmus escribió:
> Joshua Branson <jbranso@dismail.de> writes:
> 
>> Guix's manual changes
>> all the time.  Trying to keep the website up-to-date is a tough task.
> 
> It is a decision, not a technical limitation.  We want the public copy
> of the manual to match the latest release, not an arbitrary later
> version.

Sounds reasonable.

So, would a link to an "alfa" version be possible to place on the web?
Is it complicated to generate automatically each day with a cron job?

^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: how to translate info guix to text file or pdf or html ?
  2019-03-28 22:41     ` Quiliro Ordonez
@ 2019-03-29  3:00       ` Ricardo Wurmus
  0 siblings, 0 replies; 11+ messages in thread
From: Ricardo Wurmus @ 2019-03-29  3:00 UTC (permalink / raw)
  To: quiliro; +Cc: help-guix


Quiliro Ordonez <quiliro@riseup.net> writes:

> El 2019-03-28 20:29, Ricardo Wurmus escribió:
>> Joshua Branson <jbranso@dismail.de> writes:
>> 
>>> Guix's manual changes
>>> all the time.  Trying to keep the website up-to-date is a tough task.
>> 
>> It is a decision, not a technical limitation.  We want the public copy
>> of the manual to match the latest release, not an arbitrary later
>> version.
>
> Sounds reasonable.
>
> So, would a link to an "alfa" version be possible to place on the web?
> Is it complicated to generate automatically each day with a cron job?

I wanted to always show the latest manual on guix.info (where it’s
easier for us to update the pages), but I haven’t gotten around to doing
that yet.

-- 
Ricardo

^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: how to translate info guix to text file or pdf or html ?
  2019-03-28 18:52 ` Oleg Pykhalov
  2019-03-28 19:11   ` Quiliro Ordonez
@ 2019-03-29  9:45   ` znavko
  2019-03-29  9:47   ` znavko
  2 siblings, 0 replies; 11+ messages in thread
From: znavko @ 2019-03-29  9:45 UTC (permalink / raw)
  To: Oleg Pykhalov; +Cc: Help Guix

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

Thank you, Oleg. It took about 1 hour to execute.

$ git clone https://git.savannah.gnu.org/git/guix.git <https://git.savannah.gnu.org/git/guix.git>
$ cd guix
$ guix environment guix
$ ./bootstrap
$ ./configure --localstatedir=/home/user/git/guix
$ make
$ make html

And I've got the directory doc/guix.html with manual. Works!



Mar 28, 2019, 6:52 PM by go.wigust@gmail.com:

> Hi,
>
> <> znavko@tutanota.com <mailto:znavko@tutanota.com>> > writes:
>
>> Hi! I've learned that guix manual updates with the updates more quickly than manual's web-page.
>>
>> But `info guix` is hard for using. I like html.
>> Please, let me know if it is possible to transform `info guix` to text file or html or pdf?
>>
>> PS: I tried to learn `info` commands but using mouse and search by web-page in browser is better.
>>
>
> You could call a ‘make html’ command inside Guix Git repository
> https://www.gnu.org/software/guix/manual/html_node/Building-from-Git.html <https://www.gnu.org/software/guix/manual/html_node/Building-from-Git.html>
>
> Then ‘firefox doc/guix.html/index.html’ will open a fresh manual.
>
> Oleg.
>


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

^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: how to translate info guix to text file or pdf or html ?
  2019-03-28 18:52 ` Oleg Pykhalov
  2019-03-28 19:11   ` Quiliro Ordonez
  2019-03-29  9:45   ` znavko
@ 2019-03-29  9:47   ` znavko
  2019-03-29 13:40     ` Joshua Branson
  2 siblings, 1 reply; 11+ messages in thread
From: znavko @ 2019-03-29  9:47 UTC (permalink / raw)
  To: Oleg Pykhalov; +Cc: Help Guix

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

Is it possible to compile into one page manual?


Mar 28, 2019, 6:52 PM by go.wigust@gmail.com:

> Hi,
>
> <> znavko@tutanota.com <mailto:znavko@tutanota.com>> > writes:
>
>> Hi! I've learned that guix manual updates with the updates more quickly than manual's web-page.
>>
>> But `info guix` is hard for using. I like html.
>> Please, let me know if it is possible to transform `info guix` to text file or html or pdf?
>>
>> PS: I tried to learn `info` commands but using mouse and search by web-page in browser is better.
>>
>
> You could call a ‘make html’ command inside Guix Git repository
> https://www.gnu.org/software/guix/manual/html_node/Building-from-Git.html <https://www.gnu.org/software/guix/manual/html_node/Building-from-Git.html>
>
> Then ‘firefox doc/guix.html/index.html’ will open a fresh manual.
>
> Oleg.
>


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

^ permalink raw reply	[flat|nested] 11+ messages in thread

* Re: how to translate info guix to text file or pdf or html ?
  2019-03-29  9:47   ` znavko
@ 2019-03-29 13:40     ` Joshua Branson
  0 siblings, 0 replies; 11+ messages in thread
From: Joshua Branson @ 2019-03-29 13:40 UTC (permalink / raw)
  To: help-guix

<znavko@tutanota.com> writes:

> Is it possible to compile into one page manual?

I believe it is.  Most GNU manuals online can be served as a single
page.

For example, guile-SDL can be served on one page.  Take a look here:

https://www.gnu.org/software/guile-sdl/manual/

You can also read all the other GNU manuals here:

https://www.gnu.org/manual/

>
> Mar 28, 2019, 6:52 PM by go.wigust@gmail.com:
>
>  Hi,
>
>  <znavko@tutanota.com> writes:
>
>  Hi! I've learned that guix manual updates with the updates more quickly than
>  manual's web-page.
>
>  But `info guix` is hard for using. I like html.
>  Please, let me know if it is possible to transform `info guix` to text file or
>  html or pdf?
>
>  PS: I tried to learn `info` commands but using mouse and search by
>  web-page in browser is better.
>
>  You could call a ‘make html’ command inside Guix Git repository
>  https://www.gnu.org/software/guix/manual/html_node/Building-from-Git.html
>
>  Then ‘firefox doc/guix.html/index.html’ will open a fresh manual.
>
>  Oleg.
>

--
Joshua Branson
Sent from Emacs and Gnus

^ permalink raw reply	[flat|nested] 11+ messages in thread

end of thread, other threads:[~2019-03-29 13:47 UTC | newest]

Thread overview: 11+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2019-03-27 19:15 how to translate info guix to text file or pdf or html ? znavko
2019-03-28 18:52 ` Oleg Pykhalov
2019-03-28 19:11   ` Quiliro Ordonez
2019-03-28 20:31     ` Ricardo Wurmus
2019-03-29  9:45   ` znavko
2019-03-29  9:47   ` znavko
2019-03-29 13:40     ` Joshua Branson
2019-03-28 19:30 ` Joshua Branson
2019-03-28 20:29   ` Ricardo Wurmus
2019-03-28 22:41     ` Quiliro Ordonez
2019-03-29  3:00       ` Ricardo Wurmus

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).