Diff for DITA and Wikis
Tue, 2011-06-21 01:48 by ldyer | Mon, 2015-10-05 20:40 by jhackos | ||
---|---|---|---|
update URL | |||
< previous diff | |||
Changes to Body | |||
Line 1 | Line 1 | ||
<p>
| <p>
| ||
- | 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.
| + | 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.
|
- | </p>
| + | |
- | <p>
| + | |
- | Three approaches are currently being discussed or implemented:
| + | |
- | </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>
| + | |
- | 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://jectbd.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>
| ||
Current revision:
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.