Difference between revisions of "Documentation/4.0/HowTo"

From Slicer Wiki
Jump to: navigation, search
Line 48: Line 48:
  
 
*All module documentation page should be named according to the following pattern: '''Documentation/4.0/Modules/MODULENAME'''
 
*All module documentation page should be named according to the following pattern: '''Documentation/4.0/Modules/MODULENAME'''
 +
** There is a python helper script for SEM compliant tools that can save a significant amount of transcription time:  Slicer/Scripts/SEMToMediaWiki.py
 
*High resolution logos are in the [[Logo_Gallery|Logo Gallery]]
 
*High resolution logos are in the [[Logo_Gallery|Logo Gallery]]
 
*Collaborators' name, logo, URL have been centralized into a convenient set of [http://wiki.slicer.org/slicerWiki/index.php/Template:Collaborator templates]
 
*Collaborators' name, logo, URL have been centralized into a convenient set of [http://wiki.slicer.org/slicerWiki/index.php/Template:Collaborator templates]
 
*The following [http://wiki.slicer.org/slicerWiki/index.php?title=Category:Documentation/4.0/Modules  link] will list all modules belonging to the Documentation/4.0/Modules category.
 
*The following [http://wiki.slicer.org/slicerWiki/index.php?title=Category:Documentation/4.0/Modules  link] will list all modules belonging to the Documentation/4.0/Modules category.
 
*For CLI modules, the '''SVNREVISION''' revision number is reported on this [http://viewvc.slicer.org/viewvc.cgi/Slicer4/trunk/Applications/CLI page]. The module description and the information for developers would be automatically extracted from the corresponding XML description. '''Note:''' for the moment it's required to update that number at multiple location within the wiki source of a given module documentation page. Soon this will be centralized.
 
*For CLI modules, the '''SVNREVISION''' revision number is reported on this [http://viewvc.slicer.org/viewvc.cgi/Slicer4/trunk/Applications/CLI page]. The module description and the information for developers would be automatically extracted from the corresponding XML description. '''Note:''' for the moment it's required to update that number at multiple location within the wiki source of a given module documentation page. Soon this will be centralized.

Revision as of 16:25, 11 November 2011

Home < Documentation < 4.0 < HowTo



3D Slicer
3D Slicer 4.0
Description
Research platform for the analysis and visualization of medical images, including image guided therapy.
Free and extensible open source package.
Multi-platform Linux, MacOSX, Windows
Version 4.0
License Contribution and Software License Agreement
v · d · e

Overview

This document aims at describing the steps required to write Slicer user documentation.

The user documentation could be grouped under two main sections:

  • Slicer Application
  • Modules


The basic approach is to have most of the documentation in the source code and to populate the wiki pages using scripts.

  • For the end user documentation use this Template
  • All module documentation page should be named according to the following pattern: Documentation/4.0/Modules/MODULENAME
    • There is a python helper script for SEM compliant tools that can save a significant amount of transcription time: Slicer/Scripts/SEMToMediaWiki.py
  • High resolution logos are in the Logo Gallery
  • Collaborators' name, logo, URL have been centralized into a convenient set of templates
  • The following link will list all modules belonging to the Documentation/4.0/Modules category.
  • For CLI modules, the SVNREVISION revision number is reported on this page. The module description and the information for developers would be automatically extracted from the corresponding XML description. Note: for the moment it's required to update that number at multiple location within the wiki source of a given module documentation page. Soon this will be centralized.