Re: [lazarus] To all technical writers...
Andrew Haines wrote: Mark Morgan Lloyd wrote: Marco van de Voort wrote: Exactly, and somebody stubborn like me who persists in using a non-x86 CPU is really left out in the cold. HTML looks like the winner but I still don't know if htmlhelp can jump to the middle of a document. As far as I know it can. Try it. :) Are you talking about chm files? I'm talking about the method discussed at http://wiki.lazarus.freepascal.org/Add_Help_to_Your_Application which I think is uncompressed-only, unless recent browsers have universally gained the ability to handle .chm files. -- Mark Morgan Lloyd markMLl .AT. telemetry.co .DOT. uk [Opinions above are the author's, not those of his employers or colleagues] _ To unsubscribe: mail [EMAIL PROTECTED] with unsubscribe as the Subject archives at http://www.lazarus.freepascal.org/mailarchives
Re: [lazarus] To all technical writers...
On Sun, 9 Dec 2007, Mark Morgan Lloyd wrote: Marco van de Voort wrote: I use Lyx here, exporting to PDF with thumbnails, automatic TOC etc. Same here. I use OO for work for technical documentation, and that experience convinced me to stay with LyX/LateX privately. :-) I'm well pleased with the results. The two things that I've not worked out are (a) how to thread a sequence of sections into an article (with multiple articles in the overall document) and (b) how to tell a reader to start at a given article. If the reader could be told to start in a specific place it would make PDF a viable helpfile format. At work we use the AcroBat Reader API and use PDF as help format. I don't think there is a command-line option, but the API allows you to open a document and start at a certain bookmark. Michael. _ To unsubscribe: mail [EMAIL PROTECTED] with unsubscribe as the Subject archives at http://www.lazarus.freepascal.org/mailarchives
Re: [lazarus] To all technical writers...
On Sun, Dec 09, 2007 at 03:00:10PM +, Mark Morgan Lloyd wrote: Marco van de Voort wrote: I use Lyx here, exporting to PDF with thumbnails, automatic TOC etc. Same here. I use OO for work for technical documentation, and that experience convinced me to stay with LyX/LateX privately. :-) I'm well pleased with the results. The two things that I've not worked out are (a) how to thread a sequence of sections into an article (with multiple articles in the overall document) and (b) how to tell a reader to start at a given article. Don't use an article, but use a book. A book has parts. If the reader could be told to start in a specific place it would make PDF a viable helpfile format. See Michael's mail. Of course the API would have to work on *nix too. _ To unsubscribe: mail [EMAIL PROTECTED] with unsubscribe as the Subject archives at http://www.lazarus.freepascal.org/mailarchives
Re: [lazarus] To all technical writers...
Marco van de Voort wrote: On Sun, Dec 09, 2007 at 03:00:10PM +, Mark Morgan Lloyd wrote: Marco van de Voort wrote: I use Lyx here, exporting to PDF with thumbnails, automatic TOC etc. Same here. I use OO for work for technical documentation, and that experience convinced me to stay with LyX/LateX privately. :-) I'm well pleased with the results. The two things that I've not worked out are (a) how to thread a sequence of sections into an article (with multiple articles in the overall document) and (b) how to tell a reader to start at a given article. Don't use an article, but use a book. A book has parts. And a set of articles can chain sections together in different ways. Both have advantages. If the reader could be told to start in a specific place it would make PDF a viable helpfile format. See Michael's mail. Of course the API would have to work on *nix too. Exactly, and somebody stubborn like me who persists in using a non-x86 CPU is really left out in the cold. HTML looks like the winner but I still don't know if htmlhelp can jump to the middle of a document. -- Mark Morgan Lloyd markMLl .AT. telemetry.co .DOT. uk [Opinions above are the author's, not those of his employers or colleagues] _ To unsubscribe: mail [EMAIL PROTECTED] with unsubscribe as the Subject archives at http://www.lazarus.freepascal.org/mailarchives
Re: [lazarus] To all technical writers...
Mark Morgan Lloyd wrote: Marco van de Voort wrote: Exactly, and somebody stubborn like me who persists in using a non-x86 CPU is really left out in the cold. HTML looks like the winner but I still don't know if htmlhelp can jump to the middle of a document. As far as I know it can. Try it. :) Are you talking about chm files? Regards, Andrew Haines _ To unsubscribe: mail [EMAIL PROTECTED] with unsubscribe as the Subject archives at http://www.lazarus.freepascal.org/mailarchives
Re: [lazarus] To all technical writers...
Graeme Geldenhuys wrote: OpenOffice seeing that it runs on a lot of platforms and is freely available. I use Lyx here, exporting to PDF with thumbnails, automatic TOC etc. Same here. I use OO for work for technical documentation, and that experience convinced me to stay with LyX/LateX privately. :-) _ To unsubscribe: mail [EMAIL PROTECTED] with unsubscribe as the Subject archives at http://www.lazarus.freepascal.org/mailarchives
Re: [lazarus] To all technical writers...
Marco van de Voort wrote: I use Lyx here, exporting to PDF with thumbnails, automatic TOC etc. Same here. I use OO for work for technical documentation, and that experience convinced me to stay with LyX/LateX privately. :-) I'm well pleased with the results. The two things that I've not worked out are (a) how to thread a sequence of sections into an article (with multiple articles in the overall document) and (b) how to tell a reader to start at a given article. If the reader could be told to start in a specific place it would make PDF a viable helpfile format. -- Mark Morgan Lloyd markMLl .AT. telemetry.co .DOT. uk [Opinions above are the author's, not those of his employers or colleagues] _ To unsubscribe: mail [EMAIL PROTECTED] with unsubscribe as the Subject archives at http://www.lazarus.freepascal.org/mailarchives
Re: [lazarus] To all technical writers...
Graeme Geldenhuys wrote: I normally use LaTeX for documentation or articles. LaTeX does the most beautiful typesetting by far. But seeing that most people don't even know what LaTeX is I thought another format might help (for our company at least). Please note, I'm not suggesting rewriting FPC or Lazarus articles (or documentation)! Anyway I decided to use the Open Document Format (ODF), seeing that it's recognized as a standard format. I also decided to use OpenOffice seeing that it runs on a lot of platforms and is freely available. I use Lyx here, exporting to PDF with thumbnails, automatic TOC etc. -- Mark Morgan Lloyd markMLl .AT. telemetry.co .DOT. uk [Opinions above are the author's, not those of his employers or colleagues] _ To unsubscribe: mail [EMAIL PROTECTED] with unsubscribe as the Subject archives at http://www.lazarus.freepascal.org/mailarchives