|
|
| Line 52: |
Line 52: |
| | | | |
| | = Extension page = | | = Extension page = |
| − | # Create an extension page
| |
| − | ## [[Template:Documentation/{{documentation/version}}/extension-footer|extension-footer]] template should be at the bottom of the page. Except for page doing a REDIRECT.
| |
| − | ## If the extension bundles exactly [[Documentation/{{documentation/version}}/Developers/Tutorials/BundleModulesIntoExtension#Extension_bundles_1_module|one]] module, use [{{fullurl:Documentation/{{documentation/version}}/Extensions/SkullStripper|redirect=no}} this template]
| |
| − | ## If the extension bundles [[Documentation/{{documentation/version}}/Developers/Tutorials/BundleModulesIntoExtension#Extension_bundles_N_modules|more]] than one module, use [[Documentation/{{documentation/version}}/Extensions/Plastimatch|this template]].
| |
| − | # Add an extension entry in [[Documentation/{{documentation/version}}/Extensions#Extension_Categories]]
| |
| − | # The extension should now be listed on [[Documentation/{{documentation/version}}]].
| |
| − | # Create a [[#Module_page|regular wiki page]] for each module of the extension using the [[Documentation/{{documentation/version}}/Modules/YOURMODULENAME|template]] page. The URLs of the extension modules are the same than the built-in modules.
| |
| | | | |
| − | | + | This section has moved to https://slicer.readthedocs.io/en/latest/developer_guide/extensions.html#documentation |
| − | | |
| − | == Remarks ==
| |
| − | | |
| − | === Actively maintained and developed extension ===
| |
| − | | |
| − | * If the extension is actively developed and maintained so that the code of the nightly extension is the same as the extension associated with a specific slicer release (i.e {{documentation/currentversion}}), a different approach could be considered.
| |
| − | | |
| − | ==== Extension bundles ONE module ====
| |
| − | | |
| − | * In addition to create the following pages:
| |
| − | | |
| − | Documentation/Nightly/Extensions/YOURMODULENAME
| |
| − | Documentation/{{documentation/currentversion}}/Extensions/YOURMODULENAME
| |
| − | Documentation/Nightly/Modules/YOURMODULENAME
| |
| − | Documentation/{{documentation/currentversion}}/Modules/YOURMODULENAME
| |
| − | | |
| − | * ... and setup the following [http://www.mediawiki.org/wiki/Help:Redirects redirect]:
| |
| − | | |
| − | Documentation/Nightly/Extensions/YOURMODULENAME -> Documentation/Nightly/Modules/YOURMODULENAME
| |
| − | | |
| − | Documentation/{{documentation/currentversion}}/Modules/YOURMODULENAME -> Documentation/Nightly/Modules/YOURMODULENAME
| |
| − | | |
| − | Documentation/{{documentation/currentversion}}/Extensions/YOURMODULENAME -> Documentation/Nightly/Modules/YOURMODULENAME # Since [http://www.mediawiki.org/wiki/Help:Redirects#Double_redirects double redirect are not supported]. Version specific extension page redirects to Nightly module page.
| |
| − | | |
| − | * The only page that would be updated would be the Nightly one:
| |
| − | | |
| − | Documentation/Nightly/Modules/YOURMODULENAME
| |
| − | | |
| − | | |
| − | ==== Extension bundles N modules ====
| |
| − | | |
| − | In addition to create the following pages:
| |
| − | | |
| − | Documentation/Nightly/Modules/YOURMODULENAME_0
| |
| − | Documentation/Nightly/Modules/YOURMODULENAME_1
| |
| − | [...]
| |
| − | Documentation/Nightly/Modules/YOURMODULENAME_N
| |
| − |
| |
| − | Documentation/Nightly/Extensions/YOUREXTENSIONNAME
| |
| − |
| |
| − | Documentation/{{documentation/currentversion}}/Modules/YOURMODULENAME_0
| |
| − | Documentation/{{documentation/currentversion}}/Modules/YOURMODULENAME_1
| |
| − | [...]
| |
| − | Documentation/{{documentation/currentversion}}/Modules/YOURMODULENAME_N
| |
| − |
| |
| − | Documentation/{{documentation/currentversion}}/Extensions/YOUREXTENSIONNAME
| |
| − | | |
| − | * ... and setup the following [http://www.mediawiki.org/wiki/Help:Redirects redirect]:
| |
| − | | |
| − | Documentation/{{documentation/currentversion}}/Modules/YOURMODULENAME_0 -> Documentation/Nightly/Modules/YOURMODULENAME_0
| |
| − | Documentation/{{documentation/currentversion}}/Modules/YOURMODULENAME_1 -> Documentation/Nightly/Modules/YOURMODULENAME_1
| |
| − | [...]
| |
| − | Documentation/{{documentation/currentversion}}/Modules/YOURMODULENAME_N -> Documentation/Nightly/Modules/YOURMODULENAME_N
| |
| − | | |
| − | Documentation/{{documentation/currentversion}}/Extensions/YOUREXTENSIONNAME -> Documentation/Nightly/Extensions/YOUREXTENSIONNAME
| |
| − | | |
| − | | |
| − | * The only page(s) that would be updated would be the Nightly ones:
| |
| − | | |
| − | Documentation/Nightly/Modules/YOURMODULENAME_0
| |
| − | Documentation/Nightly/Modules/YOURMODULENAME_1
| |
| − | [...]
| |
| − | Documentation/Nightly/Modules/YOURMODULENAME_N
| |
| − |
| |
| − | Documentation/Nightly/Extensions/YOUREXTENSIONNAME
| |
| − | | |
| − | | |
| − | ==== Case where a version specific documentation page diverges from the Nightly one ====
| |
| − | | |
| − | * If for some reason the documentation associated with the version specific extension is going to diverge from the Nightly one. Before modifying the Nightly page, *MAKE SURE* to create the associated version-ed page(s) by copying the content of the Nighty module page(s) into their own page(s).
| |
| | | | |
| | = Miscellaneous = | | = Miscellaneous = |
