Am Mittwoch, 19. Juli 2006 08:58 schrieb Martin A. Hansen:
> once again -> pdf files are for printing and reading - not for
> reading online. printing the documentation may give you a nice book
> to keep under the pillow, but it prevents you from seeing how lyx
> formatting is done, using cross refereces etc. and i think that lyx
> is an extremely nice "editor" to read docs online!
>
> if you loose the overview of a single lyx document - then it is badly
> structured IMHO.
>
> if a single lyx document is too heavy for some machines i would say
> that is a major problem. will an equivalent latex file be as heavy,
> or is this a lyx specific thing?

Even if a single lyx file is not too heavy loading the document will 
still be proportional to the file size.

So what is the typical use-case for the LyX Manual? That someone wants 
to read it from the first page to the last page? Or that someone wants 
to read about a specific subject, say including graphics?

In my experience the latter is the way more common use-case. I've read 
the Introduction once and the Tutorial once. And now, every now and 
then, I open the other two documents because I want to look something 
up. Therefore it would be preferable if loading the part I'm interested 
in wouldn't take 10 seconds but only 1 second. The only way to achieve 
this is to split up the document. Of course, there should be a master 
document with a complete toc so that I can quickly navigate to the 
chapter I'm interested in. Ideally, for the user it wouldn't feel 
different from one large lyx file with the exception that loading would 
be magnitudes faster.

In any case, I'm pretty sure we can discuss this to death. Some people 
prefer a several megabyte large HTML file and other people prefer the 
same information nicely split up into several HTML files per chapter or 
even section (with nice navigation buttons of course). While the first 
approach is only feasible for people with a fast internet connection 
the second approach is feasible for anyone.

And as always there's the option to do both. Provide the LyX manual as 
one huge single file and additionally split up into several files. I'd 
put the multiple-files version into the release and put the URL of the 
single file version near the start of the multiple-files version.

And BTW, Martin, since you want to read the documentation in LyX in 
order to see how lyx formatting is done, I don't understand why you 
want to deny the users to see how they can create a document consisting 
of multiple lyx files. By creating one huge file you'd lose the chance 
to demonstrate this feature of LyX/LaTeX.

Regards,
Ingo

Attachment: pgpF3BqkO4t4T.pgp
Description: PGP signature

Reply via email to