Re: [lazarus] To all technical writers...

2007-12-11 Thread Mark Morgan Lloyd

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

2007-12-10 Thread Michael Van Canneyt


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

2007-12-10 Thread Marco van de Voort
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...

2007-12-10 Thread Mark Morgan Lloyd

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

2007-12-10 Thread Andrew Haines
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...

2007-12-09 Thread Marco van de Voort
 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...

2007-12-09 Thread Mark Morgan Lloyd

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

2007-12-08 Thread Mark Morgan Lloyd

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