Package org.asciidoctor

Interface Asciidoctor

All Known Implementing Classes:

JRubyAsciidoctor

public interface Asciidoctor

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	Asciidoctor.Factory	Factory for creating a new instance of Asciidoctor interface.

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	STRUCTURE_MAX_LEVEL

Method Summary

Modifier and Type	Method	Description
java.lang.String	asciidoctorVersion()	Method that gets the asciidoctor version which is being used..
void	convert(java.io.Reader contentReader, java.io.Writer rendererWriter, java.util.Map<java.lang.String,java.lang.Object> options)	Parse the document read from reader, and rendered result is sent to writer.
void	convert(java.io.Reader contentReader, java.io.Writer rendererWriter, org.asciidoctor.Options options)	Parse the document read from reader, and rendered result is sent to writer.
void	convert(java.io.Reader contentReader, java.io.Writer rendererWriter, org.asciidoctor.OptionsBuilder options)	Parse the document read from reader, and rendered result is sent to writer.
java.lang.String	convert(java.lang.String content, java.util.Map<java.lang.String,java.lang.Object> options)	Parse the AsciiDoc source input into an Document Document and render it to the specified backend format.
<T> T	convert(java.lang.String content, java.util.Map<java.lang.String,java.lang.Object> options, java.lang.Class<T> expectedResult)	Parse the AsciiDoc source input into an Document Document and render it to the specified backend format.
java.lang.String	convert(java.lang.String content, org.asciidoctor.Options options)	Parse the AsciiDoc source input into an Document Document and render it to the specified backend format.
java.lang.String	convert(java.lang.String content, org.asciidoctor.OptionsBuilder options)	Parse the AsciiDoc source input into an Document Document and render it to the specified backend format.
<T> T	convert(java.lang.String content, org.asciidoctor.OptionsBuilder options, java.lang.Class<T> expectedResult)	Parse the AsciiDoc source input into an Document Document and render it to the specified backend format.
<T> T	convert(java.lang.String content, org.asciidoctor.Options options, java.lang.Class<T> expectedResult)	Parse the AsciiDoc source input into an Document Document and render it to the specified backend format.
java.lang.String[]	convertDirectory(org.asciidoctor.DirectoryWalker directoryWalker, java.util.Map<java.lang.String,java.lang.Object> options)	Parse all AsciiDoc files found using DirectoryWalker instance.
java.lang.String[]	convertDirectory(org.asciidoctor.DirectoryWalker directoryWalker, org.asciidoctor.Options options)	Parse all AsciiDoc files found using DirectoryWalker instance.
java.lang.String[]	convertDirectory(org.asciidoctor.DirectoryWalker directoryWalker, org.asciidoctor.OptionsBuilder options)	Parse all AsciiDoc files found using DirectoryWalker instance.
java.lang.String	convertFile(java.io.File filename, java.util.Map<java.lang.String,java.lang.Object> options)	Parse the AsciiDoc source input into an Document Document and render it to the specified backend format.
<T> T	convertFile(java.io.File filename, java.util.Map<java.lang.String,java.lang.Object> options, java.lang.Class<T> expectedResult)	Parse the AsciiDoc source input into an Document Document and render it to the specified backend format.
java.lang.String	convertFile(java.io.File filename, org.asciidoctor.Options options)	Parse the AsciiDoc source input into an Document Document and render it to the specified backend format.
java.lang.String	convertFile(java.io.File filename, org.asciidoctor.OptionsBuilder options)	Parse the AsciiDoc source input into an Document Document and render it to the specified backend format.
<T> T	convertFile(java.io.File filename, org.asciidoctor.OptionsBuilder options, java.lang.Class<T> expectedResult)	Parse the AsciiDoc source input into an Document Document and render it to the specified backend format.
<T> T	convertFile(java.io.File filename, org.asciidoctor.Options options, java.lang.Class<T> expectedResult)	Parse the AsciiDoc source input into an Document Document and render it to the specified backend format.
java.lang.String[]	convertFiles(java.util.Collection<java.io.File> asciidoctorFiles, java.util.Map<java.lang.String,java.lang.Object> options)	Parses all files added inside a collection.
java.lang.String[]	convertFiles(java.util.Collection<java.io.File> asciidoctorFiles, org.asciidoctor.Options options)	Parses all files added inside a collection.
java.lang.String[]	convertFiles(java.util.Collection<java.io.File> asciidoctorFiles, org.asciidoctor.OptionsBuilder options)	Parses all files added inside a collection.
ExtensionGroup	createGroup()	Creates an ExtensionGroup that can be used to register and unregister a group of extensions.
ExtensionGroup	createGroup(java.lang.String groupName)	Creates an ExtensionGroup that can be used to register and unregister a group of extensions.
JavaConverterRegistry	javaConverterRegistry()	Creates a registry for registering converters.
JavaExtensionRegistry	javaExtensionRegistry()	Creates an extension registry ready to be used for registering all processors
org.asciidoctor.ast.Document	load(java.lang.String content, java.util.Map<java.lang.String,java.lang.Object> options)	Loads AsciiDoc content and returns the Document object.
org.asciidoctor.ast.Document	loadFile(java.io.File file, java.util.Map<java.lang.String,java.lang.Object> options)	Loads AsciiDoc content from file and returns the Document object.
org.asciidoctor.ast.DocumentHeader	readDocumentHeader(java.io.File filename)	Reads only header parameters instead of all document.
org.asciidoctor.ast.DocumentHeader	readDocumentHeader(java.io.Reader contentReader)	Reads only header parameters instead of all document.
org.asciidoctor.ast.DocumentHeader	readDocumentHeader(java.lang.String content)	Reads only header parameters instead of all document.
org.asciidoctor.ast.StructuredDocument	readDocumentStructure(java.io.File filename, java.util.Map<java.lang.String,java.lang.Object> options)	Reads and creates structured document containing header and content chunks.
org.asciidoctor.ast.StructuredDocument	readDocumentStructure(java.io.Reader contentReader, java.util.Map<java.lang.String,java.lang.Object> options)	Reads and creates structured document containing header and content chunks.
org.asciidoctor.ast.StructuredDocument	readDocumentStructure(java.lang.String content, java.util.Map<java.lang.String,java.lang.Object> options)	Reads and creates structured document containing header and content chunks.
void	registerLogHandler(LogHandler logHandler)
void	render(java.io.Reader contentReader, java.io.Writer rendererWriter, java.util.Map<java.lang.String,java.lang.Object> options)	Parse the document read from reader, and rendered result is sent to writer.
void	render(java.io.Reader contentReader, java.io.Writer rendererWriter, org.asciidoctor.Options options)	Parse the document read from reader, and rendered result is sent to writer.
void	render(java.io.Reader contentReader, java.io.Writer rendererWriter, org.asciidoctor.OptionsBuilder options)	Parse the document read from reader, and rendered result is sent to writer.
java.lang.String	render(java.lang.String content, java.util.Map<java.lang.String,java.lang.Object> options)	Parse the AsciiDoc source input into an Document Document and render it to the specified backend format.
java.lang.String	render(java.lang.String content, org.asciidoctor.Options options)	Parse the AsciiDoc source input into an Document Document and render it to the specified backend format.
java.lang.String	render(java.lang.String content, org.asciidoctor.OptionsBuilder options)	Parse the AsciiDoc source input into an Document Document and render it to the specified backend format.
java.lang.String[]	renderDirectory(org.asciidoctor.DirectoryWalker directoryWalker, java.util.Map<java.lang.String,java.lang.Object> options)	Parse all AsciiDoc files found using DirectoryWalker instance.
java.lang.String[]	renderDirectory(org.asciidoctor.DirectoryWalker directoryWalker, org.asciidoctor.Options options)	Parse all AsciiDoc files found using DirectoryWalker instance.
java.lang.String[]	renderDirectory(org.asciidoctor.DirectoryWalker directoryWalker, org.asciidoctor.OptionsBuilder options)	Parse all AsciiDoc files found using DirectoryWalker instance.
java.lang.String	renderFile(java.io.File filename, java.util.Map<java.lang.String,java.lang.Object> options)	Parse the AsciiDoc source input into an Document Document and render it to the specified backend format.
java.lang.String	renderFile(java.io.File filename, org.asciidoctor.Options options)	Parse the AsciiDoc source input into an Document Document and render it to the specified backend format.
java.lang.String	renderFile(java.io.File filename, org.asciidoctor.OptionsBuilder options)	Parse the AsciiDoc source input into an Document Document and render it to the specified backend format.
java.lang.String[]	renderFiles(java.util.Collection<java.io.File> asciidoctorFiles, java.util.Map<java.lang.String,java.lang.Object> options)	Parses all files added inside a collection.
java.lang.String[]	renderFiles(java.util.Collection<java.io.File> asciidoctorFiles, org.asciidoctor.Options options)	Parses all files added inside a collection.
java.lang.String[]	renderFiles(java.util.Collection<java.io.File> asciidoctorFiles, org.asciidoctor.OptionsBuilder options)	Parses all files added inside a collection.
void	requireLibraries(java.util.Collection<java.lang.String> requiredLibraries)	Require the given Ruby libraries by name when rendering.
void	requireLibrary(java.lang.String... requiredLibraries)	Require the given Ruby libraries by name when rendering.
RubyExtensionRegistry	rubyExtensionRegistry()	Creates an Ruby extension registry ready to be used for registering all processors
void	shutdown()	This method frees all resources consumed by asciidoctorJ module.
void	unregisterAllExtensions()	Unregister all registered extensions.
void	unregisterLogHandler(LogHandler logHandler)

Field Detail

STRUCTURE_MAX_LEVEL

static final java.lang.String STRUCTURE_MAX_LEVEL

See Also:

Constant Field Values

Method Detail

render

java.lang.String render(java.lang.String content,
                        java.util.Map<java.lang.String,java.lang.Object> options)

Parse the AsciiDoc source input into an Document Document and render it to the specified backend format. Accepts input as String object.

Parameters:

content - the AsciiDoc source as String.

options - a Hash of options to control processing (default: {}).

Returns:

the rendered output String is returned

render

java.lang.String render(java.lang.String content,
                        org.asciidoctor.Options options)

Parse the AsciiDoc source input into an Document Document and render it to the specified backend format. Accepts input as String object.

Parameters:

content - the AsciiDoc source as String.

options - a Hash of options to control processing (default: {}).

Returns:

the rendered output String is returned

render

java.lang.String render(java.lang.String content,
                        org.asciidoctor.OptionsBuilder options)

Parse the AsciiDoc source input into an Document Document and render it to the specified backend format. Accepts input as String object.

Parameters:

content - the AsciiDoc source as String.

options - a Hash of options to control processing (default: {}).

Returns:

the rendered output String is returned

render

void render(java.io.Reader contentReader,
            java.io.Writer rendererWriter,
            java.util.Map<java.lang.String,java.lang.Object> options)
     throws java.io.IOException

Parse the document read from reader, and rendered result is sent to writer.

Parameters:

contentReader - where asciidoc content is read.

rendererWriter - where rendered content is written. Writer is flushed, but not closed.

options - a Hash of options to control processing (default: {}).

Throws:

java.io.IOException - if an error occurs while writing rendered content, this exception is thrown.

render

void render(java.io.Reader contentReader,
            java.io.Writer rendererWriter,
            org.asciidoctor.Options options)
     throws java.io.IOException

Parse the document read from reader, and rendered result is sent to writer.

Parameters:

contentReader - where asciidoc content is read.

rendererWriter - where rendered content is written. Writer is flushed, but not closed.

options - a Hash of options to control processing (default: {}).

Throws:

java.io.IOException - if an error occurs while writing rendered content, this exception is thrown.

render

void render(java.io.Reader contentReader,
            java.io.Writer rendererWriter,
            org.asciidoctor.OptionsBuilder options)
     throws java.io.IOException

Parse the document read from reader, and rendered result is sent to writer.

Parameters:

contentReader - where asciidoc content is read.

rendererWriter - where rendered content is written. Writer is flushed, but not closed.

options - a Hash of options to control processing (default: {}).

Throws:

java.io.IOException - if an error occurs while writing rendered content, this exception is thrown.

renderFile

java.lang.String renderFile(java.io.File filename,
                            java.util.Map<java.lang.String,java.lang.Object> options)

Parse the AsciiDoc source input into an Document Document and render it to the specified backend format. Accepts input as File path. If the :in_place option is true, and the input is a File, the output is written to a file adjacent to the input file, having an extension that corresponds to the backend format. Otherwise, if the :to_file option is specified, the file is written to that file. If :to_file is not an absolute path, it is resolved relative to :to_dir, if given, otherwise the Document#base_dir. If the target directory does not exist, it will not be created unless the :mkdirs option is set to true. If the file cannot be written because the target directory does not exist, or because it falls outside of the Document#base_dir in safe mode, an IOError is raised.

Parameters:

filename - an input Asciidoctor file.

options - a Hash of options to control processing (default: {}).

Returns:

returns nothing if the rendered output String is written to a file.

renderFile

java.lang.String renderFile(java.io.File filename,
                            org.asciidoctor.Options options)

Parse the AsciiDoc source input into an Document Document and render it to the specified backend format. Accepts input as File path. If the :in_place option is true, and the input is a File, the output is written to a file adjacent to the input file, having an extension that corresponds to the backend format. Otherwise, if the :to_file option is specified, the file is written to that file. If :to_file is not an absolute path, it is resolved relative to :to_dir, if given, otherwise the Document#base_dir. If the target directory does not exist, it will not be created unless the :mkdirs option is set to true. If the file cannot be written because the target directory does not exist, or because it falls outside of the Document#base_dir in safe mode, an IOError is raised.

Parameters:

filename - an input Asciidoctor file.

options - a Hash of options to control processing (default: {}).

Returns:

returns nothing if the rendered output String is written to a file.

renderFile

java.lang.String renderFile(java.io.File filename,
                            org.asciidoctor.OptionsBuilder options)

Parse the AsciiDoc source input into an Document Document and render it to the specified backend format. Accepts input as File path. If the :in_place option is true, and the input is a File, the output is written to a file adjacent to the input file, having an extension that corresponds to the backend format. Otherwise, if the :to_file option is specified, the file is written to that file. If :to_file is not an absolute path, it is resolved relative to :to_dir, if given, otherwise the Document#base_dir. If the target directory does not exist, it will not be created unless the :mkdirs option is set to true. If the file cannot be written because the target directory does not exist, or because it falls outside of the Document#base_dir in safe mode, an IOError is raised.

Parameters:

filename - an input Asciidoctor file.

options - a Hash of options to control processing (default: {}).

Returns:

returns nothing if the rendered output String is written to a file.

renderDirectory

java.lang.String[] renderDirectory(org.asciidoctor.DirectoryWalker directoryWalker,
                                   java.util.Map<java.lang.String,java.lang.Object> options)

Parse all AsciiDoc files found using DirectoryWalker instance.

Parameters:

directoryWalker - strategy used to retrieve all files to be rendered.

options - a Hash of options to control processing (default: {}).

Returns:

returns an array of 0 positions if the rendered output is written to a file.

renderDirectory

java.lang.String[] renderDirectory(org.asciidoctor.DirectoryWalker directoryWalker,
                                   org.asciidoctor.Options options)

Parse all AsciiDoc files found using DirectoryWalker instance.

Parameters:

directoryWalker - strategy used to retrieve all files to be rendered.

options - a Hash of options to control processing (default: {}).

Returns:

returns an array of 0 positions if the rendered output is written to a file.

renderDirectory

java.lang.String[] renderDirectory(org.asciidoctor.DirectoryWalker directoryWalker,
                                   org.asciidoctor.OptionsBuilder options)

Parse all AsciiDoc files found using DirectoryWalker instance.

Parameters:

directoryWalker - strategy used to retrieve all files to be rendered.

options - a Hash of options to control processing (default: {}).

Returns:

returns an array of 0 positions if the rendered output is written to a file.

renderFiles

java.lang.String[] renderFiles(java.util.Collection<java.io.File> asciidoctorFiles,
                               java.util.Map<java.lang.String,java.lang.Object> options)

Parses all files added inside a collection.

Parameters:

asciidoctorFiles - to be rendered.

options - a Hash of options to control processing (default: {}).

Returns:

returns an array of 0 positions if the rendered output is written to a file.

renderFiles

java.lang.String[] renderFiles(java.util.Collection<java.io.File> asciidoctorFiles,
                               org.asciidoctor.Options options)

Parses all files added inside a collection.

Parameters:

asciidoctorFiles - to be rendered.

options - a Hash of options to control processing (default: {}).

Returns:

returns an array of 0 positions if the rendered output is written to a file.

renderFiles

java.lang.String[] renderFiles(java.util.Collection<java.io.File> asciidoctorFiles,
                               org.asciidoctor.OptionsBuilder options)

Parses all files added inside a collection.

Parameters:

asciidoctorFiles - to be rendered.

options - a Hash of options to control processing (default: {}).

Returns:

returns an array of 0 positions if the rendered output is written to a file.

convert

java.lang.String convert(java.lang.String content,
                         java.util.Map<java.lang.String,java.lang.Object> options)

Parse the AsciiDoc source input into an Document Document and render it to the specified backend format. Accepts input as String object.

Parameters:

content - the AsciiDoc source as String.

options - a Hash of options to control processing (default: {}).

Returns:

the rendered output String is returned

convert

<T> T convert(java.lang.String content,
              java.util.Map<java.lang.String,java.lang.Object> options,
              java.lang.Class<T> expectedResult)

Parse the AsciiDoc source input into an Document Document and render it to the specified backend format. Accepts input as String object.

Parameters:

content - the AsciiDoc source as String.

options - a Hash of options to control processing (default: {}).

expectedResult - the expected return type. Usually String for HTML based formats. In this case convert(String, Map) is the same.

Returns:

the rendered output String is returned

convert

java.lang.String convert(java.lang.String content,
                         org.asciidoctor.Options options)

Parse the AsciiDoc source input into an Document Document and render it to the specified backend format. Accepts input as String object.

Parameters:

content - the AsciiDoc source as String.

options - a Hash of options to control processing (default: {}).

Returns:

the rendered output String is returned

convert

<T> T convert(java.lang.String content,
              org.asciidoctor.Options options,
              java.lang.Class<T> expectedResult)

Parse the AsciiDoc source input into an Document Document and render it to the specified backend format. Accepts input as String object.

Parameters:

content - the AsciiDoc source as String.

options - a Hash of options to control processing (default: {}).

expectedResult - the expected return type. Usually String for HTML based formats. In this case convert(String, Options) is the same.

Returns:

the rendered output String is returned

convert

java.lang.String convert(java.lang.String content,
                         org.asciidoctor.OptionsBuilder options)

Parse the AsciiDoc source input into an Document Document and render it to the specified backend format. Accepts input as String object.

Parameters:

content - the AsciiDoc source as String.

options - a Hash of options to control processing (default: {}).

Returns:

the rendered output String is returned

convert

<T> T convert(java.lang.String content,
              org.asciidoctor.OptionsBuilder options,
              java.lang.Class<T> expectedResult)

Parse the AsciiDoc source input into an Document Document and render it to the specified backend format. Accepts input as String object.

Parameters:

content - the AsciiDoc source as String.

options - a Hash of options to control processing (default: {}).

expectedResult - the expected return type. Usually String for HTML based formats. In this case convert(String, OptionsBuilder) is the same.

Returns:

the rendered output String is returned

convert

void convert(java.io.Reader contentReader,
             java.io.Writer rendererWriter,
             java.util.Map<java.lang.String,java.lang.Object> options)
      throws java.io.IOException

Parse the document read from reader, and rendered result is sent to writer.

Parameters:

contentReader - where asciidoc content is read.

rendererWriter - where rendered content is written. Writer is flushed, but not closed.

options - a Hash of options to control processing (default: {}).

Throws:

java.io.IOException - if an error occurs while writing rendered content, this exception is thrown.

convert

void convert(java.io.Reader contentReader,
             java.io.Writer rendererWriter,
             org.asciidoctor.Options options)
      throws java.io.IOException

Parse the document read from reader, and rendered result is sent to writer.

Parameters:

contentReader - where asciidoc content is read.

rendererWriter - where rendered content is written. Writer is flushed, but not closed.

options - a Hash of options to control processing (default: {}).

Throws:

java.io.IOException - if an error occurs while writing rendered content, this exception is thrown.

convert

void convert(java.io.Reader contentReader,
             java.io.Writer rendererWriter,
             org.asciidoctor.OptionsBuilder options)
      throws java.io.IOException

Parse the document read from reader, and rendered result is sent to writer.

Parameters:

contentReader - where asciidoc content is read.

rendererWriter - where rendered content is written. Writer is flushed, but not closed.

options - a Hash of options to control processing (default: {}).

Throws:

java.io.IOException - if an error occurs while writing rendered content, this exception is thrown.

convertFile

java.lang.String convertFile(java.io.File filename,
                             java.util.Map<java.lang.String,java.lang.Object> options)

Parse the AsciiDoc source input into an Document Document and render it to the specified backend format. Accepts input as File path. If the :in_place option is true, and the input is a File, the output is written to a file adjacent to the input file, having an extension that corresponds to the backend format. Otherwise, if the :to_file option is specified, the file is written to that file. If :to_file is not an absolute path, it is resolved relative to :to_dir, if given, otherwise the Document#base_dir. If the target directory does not exist, it will not be created unless the :mkdirs option is set to true. If the file cannot be written because the target directory does not exist, or because it falls outside of the Document#base_dir in safe mode, an IOError is raised.

Parameters:

filename - an input Asciidoctor file.

options - a Hash of options to control processing (default: {}).

Returns:

returns nothing if the rendered output String is written to a file.

convertFile

<T> T convertFile(java.io.File filename,
                  java.util.Map<java.lang.String,java.lang.Object> options,
                  java.lang.Class<T> expectedResult)

Parse the AsciiDoc source input into an Document Document and render it to the specified backend format. Accepts input as File path. If the :in_place option is true, and the input is a File, the output is written to a file adjacent to the input file, having an extension that corresponds to the backend format. Otherwise, if the :to_file option is specified, the file is written to that file. If :to_file is not an absolute path, it is resolved relative to :to_dir, if given, otherwise the Document#base_dir. If the target directory does not exist, it will not be created unless the :mkdirs option is set to true. If the file cannot be written because the target directory does not exist, or because it falls outside of the Document#base_dir in safe mode, an IOError is raised.

Parameters:

filename - an input Asciidoctor file.

options - a Hash of options to control processing (default: {}).

expectedResult - the expected return type. Usually String for HTML based formats. In this case convertFile(File, Map) is the same.

Returns:

returns nothing if the rendered output is written to a file.

convertFile

java.lang.String convertFile(java.io.File filename,
                             org.asciidoctor.Options options)

Parse the AsciiDoc source input into an Document Document and render it to the specified backend format. Accepts input as File path. If the :in_place option is true, and the input is a File, the output is written to a file adjacent to the input file, having an extension that corresponds to the backend format. Otherwise, if the :to_file option is specified, the file is written to that file. If :to_file is not an absolute path, it is resolved relative to :to_dir, if given, otherwise the Document#base_dir. If the target directory does not exist, it will not be created unless the :mkdirs option is set to true. If the file cannot be written because the target directory does not exist, or because it falls outside of the Document#base_dir in safe mode, an IOError is raised.

Parameters:

filename - an input Asciidoctor file.

options - a Hash of options to control processing (default: {}).

Returns:

returns nothing if the rendered output String is written to a file.

convertFile

<T> T convertFile(java.io.File filename,
                  org.asciidoctor.Options options,
                  java.lang.Class<T> expectedResult)

Parse the AsciiDoc source input into an Document Document and render it to the specified backend format. Accepts input as File path. If the :in_place option is true, and the input is a File, the output is written to a file adjacent to the input file, having an extension that corresponds to the backend format. Otherwise, if the :to_file option is specified, the file is written to that file. If :to_file is not an absolute path, it is resolved relative to :to_dir, if given, otherwise the Document#base_dir. If the target directory does not exist, it will not be created unless the :mkdirs option is set to true. If the file cannot be written because the target directory does not exist, or because it falls outside of the Document#base_dir in safe mode, an IOError is raised.

Parameters:

filename - an input Asciidoctor file.

options - a Hash of options to control processing (default: {}).

expectedResult - the expected return type. Usually String for HTML based formats. In this case convertFile(File, Map) is the same.

Returns:

returns nothing if the rendered output is written to a file.

convertFile

java.lang.String convertFile(java.io.File filename,
                             org.asciidoctor.OptionsBuilder options)

Parse the AsciiDoc source input into an Document Document and render it to the specified backend format. Accepts input as File path. If the :in_place option is true, and the input is a File, the output is written to a file adjacent to the input file, having an extension that corresponds to the backend format. Otherwise, if the :to_file option is specified, the file is written to that file. If :to_file is not an absolute path, it is resolved relative to :to_dir, if given, otherwise the Document#base_dir. If the target directory does not exist, it will not be created unless the :mkdirs option is set to true. If the file cannot be written because the target directory does not exist, or because it falls outside of the Document#base_dir in safe mode, an IOError is raised.

Parameters:

filename - an input Asciidoctor file.

options - a Hash of options to control processing (default: {}).

Returns:

returns nothing if the rendered output String is written to a file.

convertFile

<T> T convertFile(java.io.File filename,
                  org.asciidoctor.OptionsBuilder options,
                  java.lang.Class<T> expectedResult)

Parse the AsciiDoc source input into an Document Document and render it to the specified backend format. Accepts input as File path. If the :in_place option is true, and the input is a File, the output is written to a file adjacent to the input file, having an extension that corresponds to the backend format. Otherwise, if the :to_file option is specified, the file is written to that file. If :to_file is not an absolute path, it is resolved relative to :to_dir, if given, otherwise the Document#base_dir. If the target directory does not exist, it will not be created unless the :mkdirs option is set to true. If the file cannot be written because the target directory does not exist, or because it falls outside of the Document#base_dir in safe mode, an IOError is raised.

Parameters:

filename - an input Asciidoctor file.

options - a Hash of options to control processing (default: {}).

expectedResult - the expected return type. Usually String for HTML based formats. In this case convertFile(File, Map) is the same.

Returns:

returns nothing if the rendered output is written to a file.

convertDirectory

java.lang.String[] convertDirectory(org.asciidoctor.DirectoryWalker directoryWalker,
                                    java.util.Map<java.lang.String,java.lang.Object> options)

Parse all AsciiDoc files found using DirectoryWalker instance.

Parameters:

directoryWalker - strategy used to retrieve all files to be rendered.

options - a Hash of options to control processing (default: {}).

Returns:

returns an array of 0 positions if the rendered output is written to a file.

convertDirectory

java.lang.String[] convertDirectory(org.asciidoctor.DirectoryWalker directoryWalker,
                                    org.asciidoctor.Options options)

Parse all AsciiDoc files found using DirectoryWalker instance.

Parameters:

directoryWalker - strategy used to retrieve all files to be rendered.

options - a Hash of options to control processing (default: {}).

Returns:

returns an array of 0 positions if the rendered output is written to a file.

convertDirectory

java.lang.String[] convertDirectory(org.asciidoctor.DirectoryWalker directoryWalker,
                                    org.asciidoctor.OptionsBuilder options)

Parse all AsciiDoc files found using DirectoryWalker instance.

Parameters:

directoryWalker - strategy used to retrieve all files to be rendered.

options - a Hash of options to control processing (default: {}).

Returns:

returns an array of 0 positions if the rendered output is written to a file.

convertFiles

java.lang.String[] convertFiles(java.util.Collection<java.io.File> asciidoctorFiles,
                                java.util.Map<java.lang.String,java.lang.Object> options)

Parses all files added inside a collection.

Parameters:

asciidoctorFiles - to be rendered.

options - a Hash of options to control processing (default: {}).

Returns:

returns an array of 0 positions if the rendered output is written to a file.

convertFiles

java.lang.String[] convertFiles(java.util.Collection<java.io.File> asciidoctorFiles,
                                org.asciidoctor.Options options)

Parses all files added inside a collection.

Parameters:

asciidoctorFiles - to be rendered.

options - a Hash of options to control processing (default: {}).

Returns:

returns an array of 0 positions if the rendered output is written to a file.

convertFiles

java.lang.String[] convertFiles(java.util.Collection<java.io.File> asciidoctorFiles,
                                org.asciidoctor.OptionsBuilder options)

Parses all files added inside a collection.

Parameters:

asciidoctorFiles - to be rendered.

options - a Hash of options to control processing (default: {}).

Returns:

returns an array of 0 positions if the rendered output is written to a file.

readDocumentStructure

org.asciidoctor.ast.StructuredDocument readDocumentStructure(java.io.File filename,
                                                             java.util.Map<java.lang.String,java.lang.Object> options)

Reads and creates structured document containing header and content chunks. By default it dig only one level down but it can be tweak by setting STRUCTURE_MAX_LEVEL option.

Parameters:

filename - to read the attributes.

options - a Hash of options to control processing (default: {}).

Returns:

structured document.

readDocumentStructure

org.asciidoctor.ast.StructuredDocument readDocumentStructure(java.lang.String content,
                                                             java.util.Map<java.lang.String,java.lang.Object> options)

Reads and creates structured document containing header and content chunks. By default it dig only one level down but it can be tweak by setting STRUCTURE_MAX_LEVEL option.

Parameters:

content - where rendered content is written. Writer is flushed, but not closed.

options - a Hash of options to control processing (default: {}).

Returns:

structured document.

readDocumentStructure

org.asciidoctor.ast.StructuredDocument readDocumentStructure(java.io.Reader contentReader,
                                                             java.util.Map<java.lang.String,java.lang.Object> options)

Reads and creates structured document containing header and content chunks. By default it dig only one level down but it can be tweak by setting STRUCTURE_MAX_LEVEL option.

Parameters:

contentReader - where asciidoc content is read.

options - a Hash of options to control processing (default: {}).

Returns:

structured document.

readDocumentHeader

org.asciidoctor.ast.DocumentHeader readDocumentHeader(java.io.File filename)

Reads only header parameters instead of all document.

Parameters:

filename - to read the attributes.

Returns:

header.

readDocumentHeader

org.asciidoctor.ast.DocumentHeader readDocumentHeader(java.lang.String content)

Reads only header parameters instead of all document.

Parameters:

content - where rendered content is written. Writer is flushed, but not closed.

Returns:

header.

readDocumentHeader

org.asciidoctor.ast.DocumentHeader readDocumentHeader(java.io.Reader contentReader)

Reads only header parameters instead of all document.

Parameters:

contentReader - where asciidoc content is read.

Returns:

header.

requireLibrary

void requireLibrary(java.lang.String... requiredLibraries)

Require the given Ruby libraries by name when rendering.

Parameters:

requiredLibraries -

requireLibraries

void requireLibraries(java.util.Collection<java.lang.String> requiredLibraries)

Require the given Ruby libraries by name when rendering.

Parameters:

requiredLibraries -

javaExtensionRegistry

JavaExtensionRegistry javaExtensionRegistry()

Creates an extension registry ready to be used for registering all processors

Returns:

Extension Registry object.

rubyExtensionRegistry

RubyExtensionRegistry rubyExtensionRegistry()

Creates an Ruby extension registry ready to be used for registering all processors

Returns:

Extension Registry object.

javaConverterRegistry

JavaConverterRegistry javaConverterRegistry()

Creates a registry for registering converters.

Returns:

Converter Registry object.

createGroup

ExtensionGroup createGroup()

Creates an ExtensionGroup that can be used to register and unregister a group of extensions.

Returns:

createGroup

ExtensionGroup createGroup(java.lang.String groupName)

Creates an ExtensionGroup that can be used to register and unregister a group of extensions.

Returns:

unregisterAllExtensions

void unregisterAllExtensions()

Unregister all registered extensions.

shutdown

void shutdown()

This method frees all resources consumed by asciidoctorJ module. Keep in mind that if this method is called, instance becomes unusable and you should create another instance.

asciidoctorVersion

java.lang.String asciidoctorVersion()

Method that gets the asciidoctor version which is being used..

Returns:

Version number.

load

org.asciidoctor.ast.Document load(java.lang.String content,
                                  java.util.Map<java.lang.String,java.lang.Object> options)

Loads AsciiDoc content and returns the Document object.

Parameters:

content - to be parsed.

options -

Returns:

Document of given content.

loadFile

org.asciidoctor.ast.Document loadFile(java.io.File file,
                                      java.util.Map<java.lang.String,java.lang.Object> options)

Loads AsciiDoc content from file and returns the Document object.

Parameters:

file - to be loaded.

options -

Returns:

Document of given content.

registerLogHandler

void registerLogHandler(LogHandler logHandler)

unregisterLogHandler

void unregisterLogHandler(LogHandler logHandler)