Structured authoring: Difference between revisions
Jump to navigation
Jump to search
m (using an external editor) |
m (→Formats) |
||
| (2 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
{Stub}} | {{Stub}} | ||
== Definitions == | == Definitions == | ||
'''Structured authoring''' and '''structured content''' | '''Structured authoring''' and '''structured content''' refer to development, deployment and management of structured contents. | ||
{{quotation|Structured authoring is a publishing workflow that lets you define and enforce consistent organization of information in documents, whether printed or online. ( | {{quotation|Structured authoring is a publishing workflow that lets you define and enforce consistent organization of information in documents, whether printed or online. ([http://www.scriptorium.com/structure.pdf whitepaper on structured authoring])}} | ||
== Discussion == | |||
Writing structured contents is more difficult than writing with an ordinary word processor, but there are benefits like: | |||
* Flexible publishing (books on demand) | |||
* Single sourcing for many formats and devices | |||
* Better support for search and data retrieval | |||
* Easy redesign of style | |||
* etc. | |||
(more later, this article is just a stub) | |||
== Formats == | == Formats == | ||
| Line 12: | Line 22: | ||
The most popular formats today are: | The most popular formats today are: | ||
* [[DocBook]] and [[DITA]] for single source authoring (both text and online) | * [[DocBook]] and [[DITA]] for single source authoring (both text and online) | ||
* Latex, an older less structured format that | * Latex, an older less structured format that remains very popular in science. | ||
* [[XHTML]] (mostly just | * [[XHTML]] (mostly just to author web pages, though the language is rich enough to markup moderately complex documents. | ||
* [[E-book]] formats such as [[ePub]] (often XML-based) | |||
For educational contents, see: | For educational contents, see: | ||
| Line 20: | Line 31: | ||
See [[document standard]] for more | See [[document standard]] for more | ||
== Links == | |||
* [http://www.stc.org/ Society for technical communication] | |||
== Bibliography == | == Bibliography == | ||
| Line 25: | Line 40: | ||
=== Tutorials === | === Tutorials === | ||
O'Keefe, Sarah (2008) [http://www.scriptorium.com/structure.pdf whitepaper on structured authoring], Scriptorium.com | O'Keefe, Sarah (2008) [http://www.scriptorium.com/structure.pdf whitepaper on structured authoring], Scriptorium.com. There is [http://scriptorium.com/papers.html a list of other interesting white papers] in tutorial format. | ||
=== Propaganda articles === | === Propaganda articles === | ||
Latest revision as of 17:24, 27 February 2009
Definitions
Structured authoring and structured content refer to development, deployment and management of structured contents.
“Structured authoring is a publishing workflow that lets you define and enforce consistent organization of information in documents, whether printed or online. (whitepaper on structured authoring)”
Discussion
Writing structured contents is more difficult than writing with an ordinary word processor, but there are benefits like:
- Flexible publishing (books on demand)
- Single sourcing for many formats and devices
- Better support for search and data retrieval
- Easy redesign of style
- etc.
(more later, this article is just a stub)
Formats
The most popular formats today are:
- DocBook and DITA for single source authoring (both text and online)
- Latex, an older less structured format that remains very popular in science.
- XHTML (mostly just to author web pages, though the language is rich enough to markup moderately complex documents.
- E-book formats such as ePub (often XML-based)
For educational contents, see:
- eLML (eLesson Markup Language)
Note: IMS Content Packaging just packs sequences in XML format. Isolated contents themselves (modules) are not structured.
See document standard for more
Links
Bibliography
Tutorials
O'Keefe, Sarah (2008) whitepaper on structured authoring, Scriptorium.com. There is a list of other interesting white papers in tutorial format.
Propaganda articles
- Thinking Outside the (Tech Docs) Box: Structured Authoring as Competitive Advantage, by J. Sorofman, The Content Wrangler, May 2008. This site has other articles on structured content.