Diff for DITA and Wikis
Fri, 2007-11-23 11:22 by Bruce Esrig | Mon, 2008-09-22 16:07 by ldyer | ||
---|---|---|---|
Announcement of the open-source DITA2Wiki project + more information about different approaches being discussed | |||
< previous diff | next diff > | ||
Changes to Body | |||
Line 3 | Line 3 | ||
</p>
| </p>
| ||
<p>
| <p>
| ||
- | '<a href="http://blogs.sun.com/coolstuff/entry/wikis_docs_and_the_reuse">Wikis, Docs, and the Reuse Proposition</a>' by Eric Armstrong of Sun explores the possibility of implementing DITA features using a combination of JavaScript and CSS. He suspects it can be done most easily using a Ruby-based Wiki like MediaCloth.
| + | Three approaches are currently being discussed or implemented:
|
</p>
| </p>
| ||
+ | <ul>
| ||
+ | <li>
| ||
+ | A DITA-enabled wiki</li>
| ||
+ | <li>Wiki as an output
| ||
+ | </li>
| ||
+ | <li>Wikislices (building DITA maps from wiki content)
| ||
+ | </li>
| ||
+ | </ul>
| ||
<p>
| <p>
| ||
- |  
| + | Related to a DITA-enabled wiki, '<a href="http://blogs.sun.com/coolstuff/entry/wikis_docs_and_the_reuse">Wikis, Docs, and the Reuse Proposition</a>' by Eric Armstrong of Sun explores the possibility of implementing DITA features using a combination of JavaScript and CSS. He suspects it can be done most easily using a Ruby-based Wiki like MediaCloth.
|
+ | </p>
| ||
+ | <p>
| ||
+ | Related to DITA as an output, Lombardi has developed a system in which a mix of "warrantied" content is continuously updated from the DITA source while retaining "unwarrantied" community contributions. This system is described on <a href="http://www.slideshare.net/lisa.dyer/lombardi-wikis-model" target="_blank">SlideShare</a>.
| ||
+ | </p>
| ||
+ | <p>
| ||
+ | The model is enabled by a DITA2Confluence import tool developed by Lombardi. Lombardi has donated this tool to the open-source<a href="http://sourceforge.net/projects/dita2wiki/" target="_blank"> DITA2Wiki project</a>. To learn more, visit the <a href="http://development.lombardi.com/?p=68" target="_blank">Lombardi Development Blog</a>.
| ||
+ | </p>
| ||
+ | <p>
| ||
+ | Related to exporting content to DITA, the Wikislices vision is described in the April issue of <a href="http://www.stc.org/intercom/PDFs/2008/200804_18-21.pdf" target="_blank">STC Intercom</a>.
| ||
+ | </p>
| ||
+ | <p>
| ||
+ |
| ||
</p>
| </p>
| ||
DITA and Wikis
Wiki systems make it easy to edit documents online, which makes wikis a compelling tool for document collaboration. Current wiki formats, however, don't allow for the kind of reuse that the DITA was designed to enable.
Three approaches are currently being discussed or implemented:
- A DITA-enabled wiki
- Wiki as an output
- Wikislices (building DITA maps from wiki content)
Related to a DITA-enabled wiki, 'Wikis, Docs, and the Reuse Proposition' by Eric Armstrong of Sun explores the possibility of implementing DITA features using a combination of JavaScript and CSS. He suspects it can be done most easily using a Ruby-based Wiki like MediaCloth.
Related to DITA as an output, Lombardi has developed a system in which a mix of "warrantied" content is continuously updated from the DITA source while retaining "unwarrantied" community contributions. This system is described on SlideShare.
The model is enabled by a DITA2Confluence import tool developed by Lombardi. Lombardi has donated this tool to the open-source DITA2Wiki project. To learn more, visit the Lombardi Development Blog.
Related to exporting content to DITA, the Wikislices vision is described in the April issue of STC Intercom.