The HTML DocGen add-on provides the capacity to launch the documentation generation from the command line.
Please visit the Capella Command Line documentation section in order to learn more about this aspect.
The HTML DocGen Command Line relies on parameters from the Capella CommandLine core mechanism parameters with the addition of the following parameter.
Name | Category | Description |
---|---|---|
configurationFile | optional | defines the workspace or absolute path to a configuration file (see Selective Documentation Generation option) |
You can use the -help argument to see all of the applicable arguments for the command line.
For all the examples bellow we assume the existence of:
<CapellaInstallationPath>/capellac.exe -nosplash -application org.polarsys.capella.core.commandline.core -appid org.polarsys.kitalpha.doc.gen.business.capella.commandline -data <workspacePath> -input /EOLE_AF/EOLE_AF.aird -outputfolder /DocProject/HTML
This command will generate HTML report from the EOLE-AF aird file specified to the output folder HTML present into DocProject .
Use a configuration file
It is also possible to use the Selective Documentation Generation option from commandline. This is done by relying on the alternative appid parameter value org.polarsys.kitalpha.doc.conf.gen.business.capella.commandline and the configurationfile parameter:
<CapellaInstallationPath>/capellac.exe -nosplash -application org.polarsys.capella.core.commandline.core -appid org.polarsys.kitalpha.doc.conf.gen.business.capella.commandline -data <workspacePath> -input /EOLE_AF/EOLE_AF.aird -outputfolder /DocProject/HTML -configurationfile <workspace or absolute path to a .configuration file>
Import Capella project and generate inside it
<CapellaInstallationPath>/capellac.exe -nosplash -application org.polarsys.capella.core.commandline.core -appid org.polarsys.kitalpha.doc.gen.business.capella.commandline -data <targetWorkspacePath> -import <absolutePath>/EOLE_AF -input /EOLE_AF/EOLE_AF.aird -outputfolder /EOLE_AF/HTML -logfile <absolutePath>/log.html
This command will import the EOLE_AF project from <absolutePath> workspace into <targetWorkspacePath> workspace before generating the HTML report inside it.
Import Capella project and generate inside a new project
<CapellaInstallationPath>/capellac.exe -nosplash -application org.polarsys.capella.core.commandline.core -appid org.polarsys.kitalpha.doc.gen.business.capella.commandline -data <targetWorkspacePath> -import <absolutePath>/EOLE_AF -input /EOLE_AF/EOLE_AF.aird -outputfolder /DocProject/HTML -logfile <absolutePath>/log.html
This command will import the EOLE_AF project from <absolutePath> workspace into <targetWorkspacePath> workspace and create the DocProject to generate the HTML report inside it.
Import Capella project and a Doc project to generate inside it
<CapellaInstallationPath>/capellac.exe -nosplash -application org.polarsys.capella.core.commandline.core -appid org.polarsys.kitalpha.doc.gen.business.capella.commandline -data <targetWorkspacePath> -import "<absolutePath>/EOLE_AF | <absolutePath>/DocProject" -input /EOLE_AF/EOLE_AF.aird -outputfolder /DocProject/HTML -logfile <absolutePath>/log.html
This command will import two projects (EOLE_AF and DocProject) from <absolutePath> workspace into <targetWorkspacePath> workspace before generating the HTML report inside the DocProject.
NOTE: The source and target workspaces have to be different.