April 1994
Intermediate to advanced
522 pages
9h 12m
English
Content preview from Making TeX WorkBecome an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
O’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.I wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.I’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.I'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.
Chapter 10. Online Documentation
Some common kinds of documentation---for example, manuals for computer programs---present a unique challenge to the author. In many cases, it would be nice to be able to provide online documentation in addition to a typeset manual.
One option is to maintain two different documents: one for publication and one for online access. This is difficult to maintain and is prone to error. As the documentation evolves, it is almost inevitable that some changes to one document will not be implemented in the other.
Another option is to include only very limited formatting information in the document designed for publication so that it is easy to “strip out” the formatting commands and produce an online manual. The unfortunate side effect of this approach is that the resulting typeset documentation doesn't have a very professional appearance.
With care, TeX can be the basis for a middle-ground approach to this problem.[109] If you are starting a new documentation project, TeXinfo and LameTeX provide two alternatives for the production of typeset and online documentation from the same source. \LaTeX2HTML and \LaTeX2hy provide alternatives that may be suitable for existing documentation.
You'll find that the best results occur when you plan ahead: if you know that you need both typeset and ASCII documentation, try to use tools that will make the task easier. But, even if you try to plan ahead, it's not uncommon to find out after the fact that you need or want ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access
More than 5,000 organizations count on O’Reilly
O’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.Julian F.
I wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.Addison B.
I’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.Amir M.
I'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.