Cytoscape Wiki|
Size: 607
Comment:
|
Size: 1765
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 9: | Line 9: |
| It would be nice to have a more cross-platform and manageable solution to user documentation. Mike Smoot suggested DocBook, though as of late 2005, it appears not to have a GUI editor, which is definitely a requirement for us. If you are aware of other options, let us know. | Cytoscape also uses [http://java.sun.com/products/javahelp/ JavaHelp] to manage help within the Cytoscape application. This is currently a mirror of the PDF manual. To update this content, edit the files in the following directory in CVS. The main content is in HTML format and the indexes are in XML format and are relatively easy to edit. Commercial GUIs are [http://java.sun.com/products/javahelp/industry.html available] for automating this. |
| Line 11: | Line 11: |
|
{{{ cytoscape\help }}} We are considering moving to a more cross-platform and manageable solution to user documentation. One option is [http://docbook.org DocBook], however, as of late 2005 it appears that GUI DocBook editors, a requirement for us, are somewhat limited. If you are aware of other options, let us know. * ["/Learn about DocBook"] |
|
| Line 12: | Line 19: |
|
Another possibility is to use HTML (for this one, there is a high number of editors) and use [http://htmldoc.org/ htmldoc] to convert to PDF. This has the advantage of letting users to consult the manual direct from the Cytoscape website. Yet another possibility is to use the wiki for all content editing and then write scripts that create a PDF and JavaHelp directly from the wiki. We could have an index page to all content and each 'chapter' would have its own wiki page. This would make updating the manual very easy, but we would have to develop scripts to convert the index and chapter pages to PDF and JavaHelp. |
The Cytoscape user manual exists as a Microsoft Word file in:
cytoscape\user_docs
To modify the manual, edit the document in Microsoft Word and check it back in to CVS. Someone (maybe it will be you!) will create a PDF from this Word document near release time for distribution.
Cytoscape also uses [http://java.sun.com/products/javahelp/ JavaHelp] to manage help within the Cytoscape application. This is currently a mirror of the PDF manual. To update this content, edit the files in the following directory in CVS. The main content is in HTML format and the indexes are in XML format and are relatively easy to edit. Commercial GUIs are [http://java.sun.com/products/javahelp/industry.html available] for automating this.
cytoscape\help
We are considering moving to a more cross-platform and manageable solution to user documentation. One option is [http://docbook.org DocBook], however, as of late 2005 it appears that GUI DocBook editors, a requirement for us, are somewhat limited. If you are aware of other options, let us know.
Another possibility is to use HTML (for this one, there is a high number of editors) and use [http://htmldoc.org/ htmldoc] to convert to PDF. This has the advantage of letting users to consult the manual direct from the Cytoscape website.
Yet another possibility is to use the wiki for all content editing and then write scripts that create a PDF and JavaHelp directly from the wiki. We could have an index page to all content and each 'chapter' would have its own wiki page. This would make updating the manual very easy, but we would have to develop scripts to convert the index and chapter pages to PDF and JavaHelp.