diff options
| author | Dan Allen <dan.j.allen@gmail.com> | 2021-08-16 03:33:45 -0600 |
|---|---|---|
| committer | Dan Allen <dan.j.allen@gmail.com> | 2021-08-16 03:34:03 -0600 |
| commit | ab047604971d22dabf567095e6e9ac47dc3cdadb (patch) | |
| tree | 00b33d5014fc667baf4b7d281639bc20b1007627 /docs/modules/ROOT | |
| parent | dd883e9557aeed1ff33c8c2d893d10448490cb60 (diff) | |
add one more summary clause on the difference between a converter and a backend
Diffstat (limited to 'docs/modules/ROOT')
| -rw-r--r-- | docs/modules/ROOT/pages/converters.adoc | 6 |
1 files changed, 6 insertions, 0 deletions
diff --git a/docs/modules/ROOT/pages/converters.adoc b/docs/modules/ROOT/pages/converters.adoc index 7b799a26..5eef93fb 100644 --- a/docs/modules/ROOT/pages/converters.adoc +++ b/docs/modules/ROOT/pages/converters.adoc @@ -33,6 +33,12 @@ Instead, it tells you which converter is currently registered to handle that ide The user selects which converter to use to convert a document by specifying the `backend` document attribute, `-b` (`--backend`) command line option, or `backend` API option (e.g., `--backend=docbook5`). The `html5` and `docbook5` backends can be referred to using the aliases `html` and `docbook`, respectively. +In summary, a converter is a software component that handles the conversion from a parsed AsciiDoc document to a publishable output format. +The backend represents the user's intent to transform the AsciiDoc document to a given format (e.g., `html5` for HTML 5). +That backend also serves as an identifier that tells the processor which converter to use. +More than one converter can bind to (i.e., stake claim to) the same backend in order to provide the user with alternatives for generating a given output format. +The last converter that registers itself with a backend wins. + == Built-in converters These built-in converters are bundled with Asciidoctor. |