Class DefaultSiteRenderer
java.lang.Object
org.apache.maven.doxia.siterenderer.DefaultSiteRenderer
- All Implemented Interfaces:
Renderer
,SiteRenderer
DefaultSiteRenderer class.
- Since:
- 1.0
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate org.apache.maven.doxia.Doxia
private static final String
private static final org.slf4j.Logger
private org.apache.maven.doxia.parser.module.ParserModuleManager
private org.codehaus.plexus.PlexusContainer
private static final String
private static final String
private org.codehaus.plexus.velocity.VelocityComponent
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprivate void
addModuleFiles
(File rootDir, File moduleBasedir, org.apache.maven.doxia.parser.module.ParserModule module, String excludes, Map<String, DocumentRenderer> files, boolean editable) private static void
closeZipFile
(ZipFile zipFile) protected void
copyDirectory
(File source, File destination) Copy the directoryprivate static void
copyFileFromZip
(ZipFile file, ZipEntry entry, File destFile) void
copyResources
(SiteRenderingContext siteRenderingContext, File outputDirectory) Copy resource files from skin, template, and site resources.createContextForSkin
(org.apache.maven.artifact.Artifact skin, Map<String, ?> attributes, SiteModel siteModel, String defaultTitle, Locale locale) Create a Site Rendering Context for a site using a skin.protected org.apache.velocity.context.Context
createDocumentVelocityContext
(DocumentRenderingContext docRenderingContext, SiteRenderingContext siteRenderingContext) Create a Velocity Context for a Doxia document, containing every information about rendered document.private SiteRenderingContext
createSiteRenderingContext
(Map<String, ?> attributes, SiteModel siteModel, String defaultTitle, Locale locale) protected org.apache.velocity.context.Context
createSiteTemplateVelocityContext
(DocumentContent content, SiteRenderingContext siteRenderingContext) Create a Velocity Context for the site template decorating the document.protected org.apache.velocity.context.Context
createToolManagedVelocityContext
(SiteRenderingContext siteRenderingContext) Creates a Velocity Context with all generic tools configured wit the site rendering context.(package private) static boolean
endsWithIgnoreCase
(String str, String searchStr) filterExtensionIgnoreCase
(List<String> fileNames, String extension) void
generateDocument
(Writer writer, SiteRendererSink sink, SiteRenderingContext siteRenderingContext) private static String
private static ZipFile
getZipFile
(File file) locateDocumentFiles
(SiteRenderingContext siteRenderingContext) Locate Doxia document source files in the site source context.(package private) boolean
matchVersion
(String current, String prerequisite) void
mergeDocumentIntoSite
(Writer writer, DocumentContent content, SiteRenderingContext siteRenderingContext) Generate a document output integrated in a site from a document content, i.e.void
render
(Collection<DocumentRenderer> documents, SiteRenderingContext siteRenderingContext, File outputDirectory) Render a collection of documents into a site.void
renderDocument
(Writer writer, DocumentRenderingContext docRenderingContext, SiteRenderingContext siteContext) Render a document written in a Doxia markup language.private void
saveVelocityProcessedContent
(DocumentRenderingContext docRenderingContext, SiteRenderingContext siteContext, String doxiaContent) private Reader
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface org.apache.maven.doxia.siterenderer.SiteRenderer
locateDocumentFiles
-
Field Details
-
LOGGER
private static final org.slf4j.Logger LOGGER -
velocity
@Inject private org.codehaus.plexus.velocity.VelocityComponent velocity -
parserModuleManager
@Inject private org.apache.maven.doxia.parser.module.ParserModuleManager parserModuleManager -
doxia
@Inject private org.apache.maven.doxia.Doxia doxia -
plexus
@Inject private org.codehaus.plexus.PlexusContainer plexus -
SKIN_TEMPLATE_LOCATION
- See Also:
-
TOOLS_LOCATION
- See Also:
-
DOXIA_SITE_RENDERER_VERSION
-
-
Constructor Details
-
DefaultSiteRenderer
public DefaultSiteRenderer()
-
-
Method Details
-
locateDocumentFiles
public Map<String,DocumentRenderer> locateDocumentFiles(SiteRenderingContext siteRenderingContext) throws IOException, RendererException Locate Doxia document source files in the site source context.- Specified by:
locateDocumentFiles
in interfaceSiteRenderer
- Parameters:
siteRenderingContext
- the SiteRenderingContext to use- Returns:
- the Doxia document renderers in a Map keyed by output file path.
- Throws:
IOException
- if it bombs.RendererException
- if it bombs.
-
filterExtensionIgnoreCase
-
addModuleFiles
private void addModuleFiles(File rootDir, File moduleBasedir, org.apache.maven.doxia.parser.module.ParserModule module, String excludes, Map<String, DocumentRenderer> files, boolean editable) throws IOException, RendererException- Throws:
IOException
RendererException
-
render
public void render(Collection<DocumentRenderer> documents, SiteRenderingContext siteRenderingContext, File outputDirectory) throws RendererException, IOException Render a collection of documents into a site.- Specified by:
render
in interfaceSiteRenderer
- Parameters:
documents
- the documents to render.siteRenderingContext
- the SiteRenderingContext to use.outputDirectory
- the output directory to write results.- Throws:
RendererException
- if it bombs.IOException
- if it bombs.
-
renderDocument
public void renderDocument(Writer writer, DocumentRenderingContext docRenderingContext, SiteRenderingContext siteContext) throws RendererException Render a document written in a Doxia markup language. This method is an internal method, used byDoxiaDocumentRenderer
.- Specified by:
renderDocument
in interfaceSiteRenderer
- Parameters:
writer
- the writer to render the document to.docRenderingContext
- the document's rendering context, which is expected to have a non-null parser id.siteContext
- the site's rendering context- Throws:
RendererException
- if it bombs.
-
saveVelocityProcessedContent
private void saveVelocityProcessedContent(DocumentRenderingContext docRenderingContext, SiteRenderingContext siteContext, String doxiaContent) throws IOException - Throws:
IOException
-
createToolManagedVelocityContext
protected org.apache.velocity.context.Context createToolManagedVelocityContext(SiteRenderingContext siteRenderingContext) Creates a Velocity Context with all generic tools configured wit the site rendering context.- Parameters:
siteRenderingContext
- the site rendering context- Returns:
- a Velocity tools managed context
-
createDocumentVelocityContext
protected org.apache.velocity.context.Context createDocumentVelocityContext(DocumentRenderingContext docRenderingContext, SiteRenderingContext siteRenderingContext) Create a Velocity Context for a Doxia document, containing every information about rendered document.- Parameters:
docRenderingContext
- the document's rendering contextsiteRenderingContext
- the site rendering context- Returns:
- a Velocity tools managed context
-
createSiteTemplateVelocityContext
protected org.apache.velocity.context.Context createSiteTemplateVelocityContext(DocumentContent content, SiteRenderingContext siteRenderingContext) Create a Velocity Context for the site template decorating the document. In addition to all the informations from the document, this context contains data gathered inSiteRendererSink
during document rendering.- Parameters:
content
- the document content to be merged into the templatesiteRenderingContext
- the site rendering context- Returns:
- a Velocity tools managed context
-
generateDocument
public void generateDocument(Writer writer, SiteRendererSink sink, SiteRenderingContext siteRenderingContext) throws RendererException - Throws:
RendererException
-
mergeDocumentIntoSite
public void mergeDocumentIntoSite(Writer writer, DocumentContent content, SiteRenderingContext siteRenderingContext) throws RendererException Generate a document output integrated in a site from a document content, i.e. merge the document content into the site template.- Specified by:
mergeDocumentIntoSite
in interfaceSiteRenderer
- Parameters:
writer
- the Writer to use.content
- the document content to be merged.siteRenderingContext
- the SiteRenderingContext to use.- Throws:
RendererException
- if it bombs.
-
createSiteRenderingContext
-
createContextForSkin
public SiteRenderingContext createContextForSkin(org.apache.maven.artifact.Artifact skin, Map<String, ?> attributes, SiteModel siteModel, String defaultTitle, Locale locale) throws IOException, RendererExceptionCreate a Site Rendering Context for a site using a skin.- Specified by:
createContextForSkin
in interfaceSiteRenderer
- Parameters:
skin
- a skinattributes
- attributes to usesiteModel
- a site modeldefaultTitle
- default titlelocale
- locale to use- Returns:
- a SiteRenderingContext.
- Throws:
IOException
- if it bombs.RendererException
- if it bombs.
-
matchVersion
- Throws:
RendererException
-
copyResources
public void copyResources(SiteRenderingContext siteRenderingContext, File outputDirectory) throws IOException Copy resource files from skin, template, and site resources.- Specified by:
copyResources
in interfaceSiteRenderer
- Parameters:
siteRenderingContext
- the SiteRenderingContext to use.outputDirectory
- output directory as file- Throws:
IOException
- if it bombs.
-
copyFileFromZip
- Throws:
IOException
-
copyDirectory
Copy the directory- Parameters:
source
- source file to be copieddestination
- destination file- Throws:
IOException
- if any
-
validate
private Reader validate(Reader source, String resource) throws org.apache.maven.doxia.parser.ParseException, IOException - Throws:
org.apache.maven.doxia.parser.ParseException
IOException
-
endsWithIgnoreCase
-
getZipFile
- Throws:
IOException
-
closeZipFile
-
getSiteRendererVersion
-