org.asciidoctor.extension

Class Processor

java.lang.Object

org.asciidoctor.extension.Processor

Direct Known Subclasses:

BlockProcessor, DocinfoProcessor, IncludeProcessor, MacroProcessor, Postprocessor, Preprocessor, Treeprocessor

public class Processor
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.Map<java.lang.String,java.lang.Object>	config
static java.lang.String	CONTENT_MODEL Deprecated. Use the constant ContentModel.KEY instead or the annotation ContentModel to describe this Processor
static java.lang.String	CONTENT_MODEL_ATTRIBUTES Deprecated. Use ContentModel.ATTRIBUTES instead.
static java.lang.String	CONTENT_MODEL_COMPOUND Deprecated. Use ContentModel.COMPOUND instead.
static java.lang.String	CONTENT_MODEL_EMPTY Deprecated. Use ContentModel.EMPTY instead.
static java.lang.String	CONTENT_MODEL_RAW Deprecated. Use ContentModel.RAW instead.
static java.lang.String	CONTENT_MODEL_SIMPLE Deprecated. Use ContentModel.SIMPLE instead.
static java.lang.String	CONTENT_MODEL_SKIP Deprecated. Use ContentModel.SKIP instead.
static java.lang.String	CONTENT_MODEL_VERBATIM Deprecated. Use ContentModel.VERBATIM instead.

Constructor Summary

Constructors

Constructor and Description
Processor()
Processor(java.util.Map<java.lang.String,java.lang.Object> config)

Method Summary

Modifier and Type	Method and Description
Block	createBlock(StructuralNode parent, java.lang.String context, java.util.List<java.lang.String> content)
Block	createBlock(StructuralNode parent, java.lang.String context, java.util.List<java.lang.String> content, java.util.Map<java.lang.String,java.lang.Object> attributes)
Block	createBlock(StructuralNode parent, java.lang.String context, java.util.List<java.lang.String> content, java.util.Map<java.lang.String,java.lang.Object> attributes, java.util.Map<java.lang.Object,java.lang.Object> options)
Block	createBlock(StructuralNode parent, java.lang.String context, java.lang.String content)
Block	createBlock(StructuralNode parent, java.lang.String context, java.lang.String content, java.util.Map<java.lang.String,java.lang.Object> attributes)
Block	createBlock(StructuralNode parent, java.lang.String context, java.lang.String content, java.util.Map<java.lang.String,java.lang.Object> attributes, java.util.Map<java.lang.Object,java.lang.Object> options)
Document	createDocument(Document parentDocument) Creates an inner document for the given parent document.
ListItem	createListItem(DescriptionList parent, java.lang.String text)
ListItem	createListItem(List parent, java.lang.String text)
PhraseNode	createPhraseNode(ContentNode parent, java.lang.String context, java.util.List<java.lang.String> text)
PhraseNode	createPhraseNode(ContentNode parent, java.lang.String context, java.util.List<java.lang.String> text, java.util.Map<java.lang.String,java.lang.Object> attributes)
PhraseNode	createPhraseNode(ContentNode parent, java.lang.String context, java.util.List<java.lang.String> text, java.util.Map<java.lang.String,java.lang.Object> attributes, java.util.Map<java.lang.Object,java.lang.Object> options)
PhraseNode	createPhraseNode(ContentNode parent, java.lang.String context, java.lang.String text)
PhraseNode	createPhraseNode(ContentNode parent, java.lang.String context, java.lang.String text, java.util.Map<java.lang.String,java.lang.Object> attributes)
PhraseNode	createPhraseNode(ContentNode parent, java.lang.String context, java.lang.String text, java.util.Map<java.lang.String,java.lang.Object> attributes, java.util.Map<java.lang.String,java.lang.Object> options)
Section	createSection(StructuralNode parent)
Section	createSection(StructuralNode parent, boolean numbered, java.util.Map<java.lang.Object,java.lang.Object> options)
Section	createSection(StructuralNode parent, int level, boolean numbered, java.util.Map<java.lang.Object,java.lang.Object> options)
Section	createSection(StructuralNode parent, java.util.Map<java.lang.Object,java.lang.Object> options)
Table	createTable(StructuralNode parent)
Table	createTable(StructuralNode parent, java.util.Map<java.lang.String,java.lang.Object> attributes)
Cell	createTableCell(Column column, Document innerDocument)
Cell	createTableCell(Column column, Document innerDocument, java.util.Map<java.lang.String,java.lang.Object> attributes)
Cell	createTableCell(Column column, java.lang.String text)
Cell	createTableCell(Column column, java.lang.String text, java.util.Map<java.lang.String,java.lang.Object> attributes)
Column	createTableColumn(Table parent, int index)
Column	createTableColumn(Table parent, int index, java.util.Map<java.lang.String,java.lang.Object> attributes)
Row	createTableRow(Table parent)
java.util.Map<java.lang.String,java.lang.Object>	getConfig()
void	parseContent(StructuralNode parent, java.util.List<java.lang.String> lines) Parses the given raw asciidoctor content, parses it and appends it as children to the given parent block.
void	setConfig(java.util.Map<java.lang.String,java.lang.Object> config)
void	setConfigFinalized() Lock the config of this processor so that it is no longer allowed to invoke setConfig(Map).
void	updateConfig(java.util.Map<java.lang.String,java.lang.Object> config)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

CONTENT_MODEL

@Deprecated
public static final java.lang.String CONTENT_MODEL

Deprecated. Use the constant ContentModel.KEY instead or the annotation ContentModel to describe this Processor

This value is used as the config option key to configure how Asciidoctor should treat blocks created by this Processor. Its value must be a String constant.

Example to Asciidoctor know that a BlockProcessor creates zero or more child blocks:

 
 Map<String, Object> config = new HashMap<>();
 config.put(CONTENT_MODEL, ContentModel.COMPOUND);
 BlockProcessor blockProcessor = new BlockProcessor("foo", config);
 asciidoctor.javaExtensionRegistry().block(blockProcessor);
 
 

See Also:

Constant Field Values

CONTENT_MODEL_COMPOUND

@Deprecated
public static final java.lang.String CONTENT_MODEL_COMPOUND

Deprecated. Use ContentModel.COMPOUND instead.

Predefined constant to let Asciidoctor know that this BlockProcessor creates zero or more child blocks.

See Also:

Constant Field Values

CONTENT_MODEL_SIMPLE

@Deprecated
public static final java.lang.String CONTENT_MODEL_SIMPLE

Deprecated. Use ContentModel.SIMPLE instead.

Predefined constant to let Asciidoctor know that this BlockProcessor creates simple paragraph content.

See Also:

Constant Field Values

CONTENT_MODEL_VERBATIM

@Deprecated
public static final java.lang.String CONTENT_MODEL_VERBATIM

Deprecated. Use ContentModel.VERBATIM instead.

Predefined constant to let Asciidoctor know that this BlockProcessor creates literal content.

See Also:

Constant Field Values

CONTENT_MODEL_RAW

@Deprecated
public static final java.lang.String CONTENT_MODEL_RAW

Deprecated. Use ContentModel.RAW instead.

Predefined constant to make Asciidoctor pass through the content unprocessed.

See Also:

Constant Field Values

CONTENT_MODEL_SKIP

@Deprecated
public static final java.lang.String CONTENT_MODEL_SKIP

Deprecated. Use ContentModel.SKIP instead.

Predefined constant to make Asciidoctor drop the content.

See Also:

Constant Field Values

CONTENT_MODEL_EMPTY

@Deprecated
public static final java.lang.String CONTENT_MODEL_EMPTY

Deprecated. Use ContentModel.EMPTY instead.

Predefined constant to make Asciidoctor not expect any content.

See Also:

Constant Field Values

CONTENT_MODEL_ATTRIBUTES

@Deprecated
public static final java.lang.String CONTENT_MODEL_ATTRIBUTES

Deprecated. Use ContentModel.ATTRIBUTES instead.

Predefined constant to make Asciidoctor parse content as attributes.

See Also:

Constant Field Values

config

protected java.util.Map<java.lang.String,java.lang.Object> config

Constructor Detail

Processor

public Processor()

Processor

public Processor(java.util.Map<java.lang.String,java.lang.Object> config)

Method Detail

getConfig

public java.util.Map<java.lang.String,java.lang.Object> getConfig()

setConfig

public final void setConfig(java.util.Map<java.lang.String,java.lang.Object> config)

updateConfig

public final void updateConfig(java.util.Map<java.lang.String,java.lang.Object> config)

setConfigFinalized

public final void setConfigFinalized()

Lock the config of this processor so that it is no longer allowed to invoke setConfig(Map).

createTable

public Table createTable(StructuralNode parent)

createTable

public Table createTable(StructuralNode parent,
                         java.util.Map<java.lang.String,java.lang.Object> attributes)

createTableRow

public Row createTableRow(Table parent)

createTableColumn

public Column createTableColumn(Table parent,
                                int index)

createTableColumn

public Column createTableColumn(Table parent,
                                int index,
                                java.util.Map<java.lang.String,java.lang.Object> attributes)

createTableCell

public Cell createTableCell(Column column,
                            java.lang.String text)

createTableCell

public Cell createTableCell(Column column,
                            Document innerDocument)

createTableCell

public Cell createTableCell(Column column,
                            Document innerDocument,
                            java.util.Map<java.lang.String,java.lang.Object> attributes)

createTableCell

public Cell createTableCell(Column column,
                            java.lang.String text,
                            java.util.Map<java.lang.String,java.lang.Object> attributes)

createBlock

public Block createBlock(StructuralNode parent,
                         java.lang.String context,
                         java.lang.String content)

createBlock

public Block createBlock(StructuralNode parent,
                         java.lang.String context,
                         java.lang.String content,
                         java.util.Map<java.lang.String,java.lang.Object> attributes)

createBlock

public Block createBlock(StructuralNode parent,
                         java.lang.String context,
                         java.lang.String content,
                         java.util.Map<java.lang.String,java.lang.Object> attributes,
                         java.util.Map<java.lang.Object,java.lang.Object> options)

createBlock

public Block createBlock(StructuralNode parent,
                         java.lang.String context,
                         java.util.List<java.lang.String> content)

createBlock

public Block createBlock(StructuralNode parent,
                         java.lang.String context,
                         java.util.List<java.lang.String> content,
                         java.util.Map<java.lang.String,java.lang.Object> attributes)

createBlock

public Block createBlock(StructuralNode parent,
                         java.lang.String context,
                         java.util.List<java.lang.String> content,
                         java.util.Map<java.lang.String,java.lang.Object> attributes,
                         java.util.Map<java.lang.Object,java.lang.Object> options)

createSection

public Section createSection(StructuralNode parent)

createSection

public Section createSection(StructuralNode parent,
                             java.util.Map<java.lang.Object,java.lang.Object> options)

createSection

public Section createSection(StructuralNode parent,
                             boolean numbered,
                             java.util.Map<java.lang.Object,java.lang.Object> options)

createSection

public Section createSection(StructuralNode parent,
                             int level,
                             boolean numbered,
                             java.util.Map<java.lang.Object,java.lang.Object> options)

createPhraseNode

public PhraseNode createPhraseNode(ContentNode parent,
                                   java.lang.String context,
                                   java.util.List<java.lang.String> text)

createPhraseNode

public PhraseNode createPhraseNode(ContentNode parent,
                                   java.lang.String context,
                                   java.util.List<java.lang.String> text,
                                   java.util.Map<java.lang.String,java.lang.Object> attributes)

createPhraseNode

public PhraseNode createPhraseNode(ContentNode parent,
                                   java.lang.String context,
                                   java.util.List<java.lang.String> text,
                                   java.util.Map<java.lang.String,java.lang.Object> attributes,
                                   java.util.Map<java.lang.Object,java.lang.Object> options)

createPhraseNode

public PhraseNode createPhraseNode(ContentNode parent,
                                   java.lang.String context,
                                   java.lang.String text)

createPhraseNode

public PhraseNode createPhraseNode(ContentNode parent,
                                   java.lang.String context,
                                   java.lang.String text,
                                   java.util.Map<java.lang.String,java.lang.Object> attributes)

createPhraseNode

public PhraseNode createPhraseNode(ContentNode parent,
                                   java.lang.String context,
                                   java.lang.String text,
                                   java.util.Map<java.lang.String,java.lang.Object> attributes,
                                   java.util.Map<java.lang.String,java.lang.Object> options)

createDocument

public Document createDocument(Document parentDocument)

Creates an inner document for the given parent document. Inner documents are used for tables cells with style asciidoc.

Parameters:

parentDocument - The parent document of the new document.

Returns:

A new inner document.

createListItem

public ListItem createListItem(List parent,
                               java.lang.String text)

createListItem

public ListItem createListItem(DescriptionList parent,
                               java.lang.String text)

parseContent

public void parseContent(StructuralNode parent,
                         java.util.List<java.lang.String> lines)

Parses the given raw asciidoctor content, parses it and appends it as children to the given parent block.

The following example will add two paragraphs with the role newcontent to all top level sections of a document:

     
 Asciidoctor asciidoctor = ...
 asciidoctor.javaExtensionRegistry().treeprocessor(new Treeprocessor() {
     DocumentRuby process(DocumentRuby document) {
         for (AbstractBlock block: document.getBlocks()) {
             if (block instanceof Section) {
                 parseContent(block, Arrays.asList(new String[]{
                                             "[newcontent]",
                                             "This is new content"
                                             "",
                                             "[newcontent]",
                                             "This is also new content"}));
             }
         }
     }
 });
     
 

Parameters:

parent - The block to which the parsed content should be added as children.

lines - Raw asciidoctor content