lumis.portal.documentation

Interface IDocumentationManager

public interface IDocumentationManager

The documentation manager interface.

Since:

9.0.0

Version:

$Revision: 19136 $ $Date: 2016-06-02 21:14:45 +0000 (Thu, 02 Jun 2016) $

Method Summary

Modifier and Type	Method and Description
void	generateDocumentation(String sourceRootPath, boolean reGenerateImages, Locale locale, boolean insertStringHolders) Generates documentation for one or more services and static directories specified in a documentationdefinition.xml file
void	generateServiceDocumentation(String serviceId, boolean reGenerateImages, Locale locale, boolean insertStringHolders) Generates documentation for a given service.
void	generateStaticDocumentation(String sourceRootPath, Locale locale) Generates documentation given a root directory.

Method Detail

generateServiceDocumentation

void generateServiceDocumentation(String serviceId,
                                  boolean reGenerateImages,
                                  Locale locale,
                                  boolean insertStringHolders)
                           throws PortalException

Generates documentation for a given service.

Parameters:

serviceId - the identifier of the service

reGenerateImages - true if during generation of documentation, autogeneration of images should also be executed.

locale - the locale in which the documentation should be generated.

insertStringHolders - if true, will generate the string id of non-localized strings for ease of translation

Throws:

PortalException

Since:

9.0.0

generateStaticDocumentation

void generateStaticDocumentation(String sourceRootPath,
                                 Locale locale)
                          throws PortalException

Generates documentation given a root directory. The root directory should have a sub-directory named with the locale that the documentation manager is trying to generate.

Parameters:

sourceRootPath - the root directory generally ending with documentationfiles directory.

locale - the locale in which the documentation should be generated.

Throws:

PortalException

Since:

9.0.0

generateDocumentation

void generateDocumentation(String sourceRootPath,
                           boolean reGenerateImages,
                           Locale locale,
                           boolean insertStringHolders)
                    throws PortalException

Generates documentation for one or more services and static directories specified in a documentationdefinition.xml file

Parameters:

sourceRootPath - the root path that should contain a documentationdefinition.xml file

reGenerateImages - true if during generation of documentation, autogeneration of service images should also be executed.

locale - the locale in which the documentation should be generated.

insertStringHolders - if true, will generate the string id of non-localized strings for ease of translation

Throws:

PortalException

Since:

9.0.0