public interface Renderer
Site Renderer interface: render a collection of documents into a site, ie decored with a site template (eventually packaged as skin).
Modifier and Type | Method and Description |
---|---|
void |
copyResources(SiteRenderingContext siteRenderingContext,
File outputDirectory)
Copy resource files from skin, template, and site resources.
|
void |
copyResources(SiteRenderingContext siteRenderingContext,
File resourcesDirectory,
File outputDirectory)
Deprecated.
since 1.7, use copyResources without resourcesDirectory parameter
|
SiteRenderingContext |
createContextForSkin(Artifact skin,
Map<String,?> attributes,
DecorationModel decoration,
String defaultWindowTitle,
Locale locale)
Create a Site Rendering Context for a site using a skin.
|
SiteRenderingContext |
createContextForTemplate(File templateFile,
Map<String,?> attributes,
DecorationModel decoration,
String defaultWindowTitle,
Locale locale)
Deprecated.
Deprecated without replacement, use skins only.
|
void |
generateDocument(Writer writer,
SiteRendererSink sink,
SiteRenderingContext siteRenderingContext)
Deprecated.
since 1.8, use mergeDocumentIntoSite
|
Map<String,DocumentRenderer> |
locateDocumentFiles(SiteRenderingContext siteRenderingContext)
Deprecated.
since 1.8, use locateDocumentFiles with editable parameter
|
Map<String,DocumentRenderer> |
locateDocumentFiles(SiteRenderingContext siteRenderingContext,
boolean editable)
Locate Doxia document source files in the site source context.
|
void |
mergeDocumentIntoSite(Writer writer,
DocumentContent content,
SiteRenderingContext siteRenderingContext)
Generate a document output integrated in a site from a document content,
i.e. merge the document content into the site template.
|
void |
render(Collection<DocumentRenderer> documents,
SiteRenderingContext siteRenderingContext,
File outputDirectory)
Render a collection of documents into a site.
|
void |
renderDocument(Writer writer,
RenderingContext docRenderingContext,
SiteRenderingContext siteContext)
Render a document written in a Doxia markup language.
|
static final String ROLE
void render(Collection<DocumentRenderer> documents, SiteRenderingContext siteRenderingContext, File outputDirectory) throws RendererException, IOException
documents
- the documents to render.siteRenderingContext
- the SiteRenderingContext to use.outputDirectory
- the output directory to write results.RendererException
- if it bombs.IOException
- if it bombs.void generateDocument(Writer writer, SiteRendererSink sink, SiteRenderingContext siteRenderingContext) throws RendererException
writer
- the Writer to use.sink
- the Site Renderer Sink that received the Doxia events during document content rendering.siteRenderingContext
- the SiteRenderingContext to use.RendererException
- if it bombs.void mergeDocumentIntoSite(Writer writer, DocumentContent content, SiteRenderingContext siteRenderingContext) throws RendererException
writer
- the Writer to use.content
- the document content to be mergedsiteRenderingContext
- the SiteRenderingContext to use.RendererException
- if it bombs.SiteRenderingContext createContextForSkin(Artifact skin, Map<String,?> attributes, DecorationModel decoration, String defaultWindowTitle, Locale locale) throws RendererException, IOException
skin
- attributes
- decoration
- defaultWindowTitle
- locale
- IOException
- if it bombs.RendererException
@Deprecated SiteRenderingContext createContextForTemplate(File templateFile, Map<String,?> attributes, DecorationModel decoration, String defaultWindowTitle, Locale locale) throws MalformedURLException
templateFile
- attributes
- decoration
- defaultWindowTitle
- locale
- MalformedURLException
- if it bombs.#createContextForSkin(File, Map, DecorationModel, String, Locale)
void copyResources(SiteRenderingContext siteRenderingContext, File resourcesDirectory, File outputDirectory) throws IOException
siteRenderingContext
- resourcesDirectory
- outputDirectory
- IOException
- if it bombs.void copyResources(SiteRenderingContext siteRenderingContext, File outputDirectory) throws IOException
siteRenderingContext
- outputDirectory
- IOException
- if it bombs.Map<String,DocumentRenderer> locateDocumentFiles(SiteRenderingContext siteRenderingContext) throws IOException, RendererException
siteRenderingContext
- IOException
- if it bombs.RendererException
- if it bombs.Map<String,DocumentRenderer> locateDocumentFiles(SiteRenderingContext siteRenderingContext, boolean editable) throws IOException, RendererException
siteRenderingContext
- mark
- Doxia document renderer as editable? (should not mark editable if generated Doxia source)IOException
- if it bombs.RendererException
- if it bombs.void renderDocument(Writer writer, RenderingContext docRenderingContext, SiteRenderingContext siteContext) throws RendererException, FileNotFoundException, UnsupportedEncodingException
DoxiaDocumentRenderer
.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 contextRendererException
- if it bombs.FileNotFoundException
- if it bombs.UnsupportedEncodingException
- if it bombs.Copyright © 2005–2018 The Apache Software Foundation. All rights reserved.