Structured authoring: Difference between revisions
m (using an external editor) |
m (using an external editor) |
||
Line 3: | Line 3: | ||
== 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 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 20: | Line 30: | ||
See [[document standard]] for more | See [[document standard]] for more | ||
== Links == | |||
* [http://www.stc.org/ Society for technical communication] | |||
== Bibliography == | == Bibliography == | ||
Line 25: | Line 39: | ||
=== 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 === |
Revision as of 11:32, 25 September 2008
{Stub}}
Definitions
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. (whitepaper on structured authoring)
Discussion
Writing structured contents is more difficult 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 is still very popular in science.
- XHTML (mostly just online, though the language is rich enough to markup moderatly complex documents.
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.