A directory of resources inthe field of technical communication.

Articles>Documentation>DocBook

17 found.

About this Site | Advanced Search | Localization | Site Maps
 

 

1.
#26309

Using DocBook to Generate WebHelp

A brief tutorial on creating cross-platform WebHelp (similar to that produced by RoboHelp) using DocBook.

Nesbitt, Scott. DMN Communications (2004). Articles>Documentation>Help>DocBook

2.
#26373

DocBook Demystification Howto

This howto attempts to clear the fog and mystery surrounding the DocBook markup system and the tools that go with it. It is aimed at authors of technical documentation for open-source projects hosted on Linux, but should be useful for people composing other kinds on other Unixes as well.

Raymond, Eric S. tldp.org. Articles>Documentation>XML>DocBook

3.
#31161

DocBook for the Masses

Having new DocBook standards in place may do little to push adoption. An important factor in driving user adoption is the availability of software that implements the standard. It would be interesting to see whether big software companies would jump on the bandwagon...Unless the open-source community comes to the rescue!

Talbot, Fabrice. LiveTechDocs (2008). Articles>Documentation>XML>DocBook

4.
#26193

Docbook Frequently Asked Questions

This is a collation of some Frequently Asked questions regarding Docbook. The initial focus will be on the XML version of the DTD, and the XSLT based stylesheets.

dpawson.co.uk (2005). Articles>Documentation>Standards>DocBook

5.
#26197

Get Going With DocBook

A tutorial on writing documentation that will be used in a particular project.

Galassi, Mark. Galassi.org (1998). Articles>Documentation>Standards>DocBook

6.
#27740

Getting Started with the DocBook XML Dialect

Gets you started with DocBook, an SGML/XML dialect that describes the content of technical articles and other documents. David discusses the benefits of using DocBook, and then describes how to plan and modularize a large document conversion project.

Mertz, David. IBM (2000). Articles>Documentation>XML>DocBook

7.
#26308

Moving to DocBook   (PDF)

DocBook is a powerful tool for creating and maintaining documentation. However, there are a number of factors you should consider before you move your documentation to DocBook. This article discusses reasons for and against making the switch to DocBook.

Nesbitt, Scott. ScottNesbitt.net (2002). Articles>Documentation>Standards>DocBook

8.
#26306

DocBook Conversions with XFC

There are a number of tools available for transforming DocBook XML documents to various formats. All of these tools have strengths, as well as some noticeable weaknesses and drawbacks. This article looks at the benefits of using the XMLmind FO Converter, a graphical, highly configurable, and cross-platform application designed to transform DocBook XML files to any supported output format.

Nesbitt, Scott. InformIT.com (2005). Articles>Documentation>Standards>DocBook

9.
#26310

Using XML for Document Authoring and Management   (PDF)

An introduction to XML (Extensible Markup Language) and how technical writers can use it to create and manage their documentation.

Nesbitt, Scott. DMN Communications (2004). Articles>Documentation>Help>DocBook

10.
#32087

DocBook or DITA?

XML is the future. You hear it at every conference you go to, in every magazine you pick up, in every article you read on-line. For technical writers, right now that future comes down to two products—DocBook or DITA. But what exactly are they, and which one should you choose? They are schemas for creating XML.

Technical Writer (2006). Articles>Documentation>DocBook>DITA

11.
#33968

DocBook versus DITA: Will the Real Standard Please Stand Up?

More than a decade ago DocBook became the standard for the few brave souls forging ahead in XML publications. DocBook offered a cheaper and more efficient way to publish to multiple formats. Single-sourcing became a reality for hardware and software companies. However, in recent years, many in technical documentation publications have proclaimed DITA as the standard for XML documentation. DITA offered architecture in which to create and publish structured content. Are these two seemingly rival standards really that different? This article from Teresa Mulvihill answers this question with comparative examples, and allows you, the audience, to decide for yourselves.

Mulvihill, Teresa. Data Conversion Laboratory (2008). Articles>Documentation>DocBook>DITA

12.
#34486

Modular Docs Part 2: DITA vs. DocBook

When IBM decided to focus on topic-oriented documentation, it created the Darwin Information Typing Architecture (DITA), even though there was already a huge investment in DocBook. Moving to a new architecture was a decidedly non-trivial undertaking--both technically and politically--so it is worth an inquiry as to the reasons for making that move.

Armstrong, Eric. Sun Microsystems (2008). Articles>Documentation>DocBook>DITA

13.
#34784

What a Technical Writer Should Know About DocBook?

DocBook is a set of tools for implementing XML (Extended Markup Language)-based structured documentation. It is developed back in 1991 and is widely used today by those technical writers who generate single-sourced documentation. It is especially well suited for software, hardware and networking documentation.

Technical Communication Center (2009). Articles>Documentation>XML>DocBook

14.
#35017

Producing Documentation and Reusing Information in XML, Part 1: Document Publishing Using XML

XML provides a way to identify data items and subcomponents within any structured data set, but has its roots in documentation development and production. Robust, open standards for XML document markup and a rich set of freely available tools for XML document parsing and format conversion make it easy to install and configure a complete documentation development and formatting environment on any UNIX® or Linux® system.

von Hagen, William. IBM (2009). Articles>Content Management>Documentation>DocBook

15.
#35018

Producing Documentation and Reusing Information in XML, Part 2: Reuse Information in XML Documentation

Discover simple solutions to reuse information in XML documentation, such as how to use XInclude to include other documents at a given point in a document and how to use XPointer to include small document fragments from other documents or a similar pool of information in XML format. Also, get tips for structuring XML documentation to simplify information reuse, and learn how to maintain stand-alone documents that you can incorporate into larger documents.

von Hagen, William. IBM (2009). Articles>Content Management>Documentation>DocBook

16.
#35019

Producing Documentation and Reusing Information in XML, Part 3: Creating Multi-Target XML Documents

XML is an optimal format for writing documentation that you can use with many different documentation software packages and production environments. In this third article in the series, discover how to create single-source documents that can produce output in a variety of different output formats.

von Hagen, William. IBM (2009). Articles>Documentation>XML>DocBook

17.
#35041

DocBook to DITA Conversion Automation - Improving the Yield?

With DITA implementations on the rise, and an entrenched DocBook community already in place, the resulting market interest has spurred interest in automated DocBook to DITA conversion. So I would expect offerings of automated DocBook to DITA conversion scripts to emerge in the next 6-10 months. This article addresses the real questions, "What should I expect from automated tools?" and "Will they work for me?" from the viewpoint of live experience with numerous DocBook to DITA conversions. The answers to these questions are not usually obvious.

Vaysbukh, Mikhail. DCL (2008). Articles>Documentation>DocBook>DITA

There are 15 readers currently online: 1 registered user and 14 guests. Register.Follow us on: TwitterFacebookRSSPost about us on: TwitterFacebookDeliciousRSSStumbleUpon