diff options
| author | Dan Allen <dan.j.allen@gmail.com> | 2021-08-04 01:32:38 -0600 |
|---|---|---|
| committer | Dan Allen <dan.j.allen@gmail.com> | 2021-08-04 01:32:38 -0600 |
| commit | 0b77daffebf9dff7a7d0d303b5b9fddc92cc701a (patch) | |
| tree | 6c4b2decf197fda940454dbc68a0b736dfecc396 /docs/modules | |
| parent | 13768dc29c8738c8d1fe4c60abe2ee45469886ac (diff) | |
remove unused See Also column on errors and warnings page
Diffstat (limited to 'docs/modules')
| -rw-r--r-- | docs/modules/ROOT/pages/errors-and-warnings.adoc | 60 |
1 files changed, 6 insertions, 54 deletions
diff --git a/docs/modules/ROOT/pages/errors-and-warnings.adoc b/docs/modules/ROOT/pages/errors-and-warnings.adoc index 16c8dec9..23c8fe3a 100644 --- a/docs/modules/ROOT/pages/errors-and-warnings.adoc +++ b/docs/modules/ROOT/pages/errors-and-warnings.adoc @@ -42,214 +42,167 @@ Placeholders for other contextual information in the message. [#warning] == Warning messages -[options="header,breakable",cols="<60,<50,<30"] +[cols=2*] |=== -|Message |Troubleshooting |Also see +|Message |Troubleshooting |abstract block cannot be used in a document without a title when doctype is book. Excluding block content. |Invalid book document structure. -|#user-abstract# |cannot retrieve contents of <x> at URI: <uri> (allow-uri-read attribute not enabled) |Reading from a URI is only allowed in certain safe modes and the allow-uri-read attribute must be passed to the application. -|#include-uri# |could not retrieve contents of <x> at URI: <uri> |Web address not found. -| |could not retrieve image data from URI: <uri> |Web address not found. Only occurs with `allow-uri-read` and `data-uri`. Check the URI. -|#include-images-by-full-url# |dropping line containing reference to missing attribute: <x> |An attribute cannot be resolved and the `attribute-missing` attribute is set to `drop-line`. -|#catch-a-missing-or-undefined-attribute# |file does not exist or cannot be read: <file> |You specified a stylesheet (`-a stylesheet=<file>`) but <file> does not exist or is not readable. -| |gem 'thread_safe' is not installed. This gem is recommended when registering custom converters. |You have registered a custom converter, and you have not installed the thread_safe gem. -| |gem 'thread_safe' is not installed. This gem is recommended when using custom backend templates. |You are using custom templates (`-T <template_dir>`), but you have not installed the thread_safe gem. -| |image to embed not found or not readable: <file> |You used `:data-uri:` but the file could not be found. -|#managing-images# |include file not readable: <file> |You do not have permission to access the file. -|#include-nonasciidoc# |input path <file> is a <x>, not a file |The path is not a file (perhaps it is a socket or a block device). -|#include-nonasciidoc# |optional gem 'asciimath' is not installed. Functionality disabled. |asciimath is one of the libraries used for equations. -|#stem# |optional gem 'coderay' is not installed. Functionality disabled. |CodeRay is used for source code highlighting. -|#coderay# |skipping reference to missing attribute: <x> |An attribute cannot be resolved and the `attribute-missing` attribute is set to `skip`. -|#catch-a-missing-or-undefined-attribute# |tables must have at least one body row | -|#tables# |tag '<x>' not found in include file: <file> |You tried to include by tagged region, but the included document does not have that tag. -|#include-partial# |<docname>: id assigned to <type> already in use: <id> |<id> is a duplicate ID, meaning it has already been assigned to a node of <type> (e.g., section, block, anchor). If you don't see the problem in <docname>, check that the duplicate ID isn't coming from a file which is being included. -| |<docname> callout list item index: expected <x> got <y> |Callouts are expected to be in numerical order, just like any ordered list. -|#callouts# |<docname> include <x> not readable: <y> |If <y> is a file, do you have read permissions for it? If it is a URI and `-a allow-uri-read` is set, does it exist? -| |<docname> include file not found: <file> |Probably a typo or missing file. If not, make sure you understand the search process. -|#include-directive#, #include-resolution# |<docname> invalid empty <x> detected in style attribute |The first positional attribute in the block attributes could not be parsed. -|#options# |<docname> invalid style for <x> block: <y> |You have added a custom style to a block, but you haven't registered a custom block extension to handle it. -| |<docname> invalid style for paragraph: <x> |You have a line `[<name-of-style>]` before a paragraph, but `name-of-style` isn't a recognized built-in style. -|#style# |<docname> list item index: expected <x>, got <y> |You gave explicit numbers on an ordered list, but they were not sequential. Asciidoctor renumbers them for you, and gives this warning. -|#ordered-lists# |<docname> multiple ids detected in style attribute |Multiple IDs cannot be specified in the block style (e.g., `[#cat#dog]`). -// But [#wibble,id="wobble"] does not generate an error -|#id# |<docname> no callouts refer to list item <x> |The callout is missing or not recognized. In source listings, is the callout the last thing on the line? -|#callouts# |<docname> section title out of sequence |Invalid document structure. Check section levels. -|#sections# |=== [#error] == Error messages -[options="header,breakable",cols="<60,<50,<30"] +[cols=2*] |=== -|Message |Troubleshooting |Also see +|Message |Troubleshooting |input file <file> missing or cannot be read |Check that the file exists and that the filename is not misspelled. -|#using-the-command-line-interface# |include file has illegal reference to ancestor of jail; recovering automatically |The safe mode is restricting access to an include file outside of the base directory. -|#running-asciidoctor-securely# |input file and output file cannot be the same: <file> |Choose a different output directory or filename. -| |partintro block can only be used when doctype is book and it\'s a child of a part section. Excluding block content. |Invalid book document structure. -|#book-parts-and-chapters# |unmatched macro: endif::<x>[] |`endif::[]` with no unclosed preceding `ifdef::<x>[]`. -|#ifdef-directive# |<docname> dropping cell because it exceeds specified number of columns // The extra cells are dropped, but this message is not produced ??? | -|#tables# |<docname> illegal block content outside of partintro block |Invalid book document structure. -|#book-parts-and-chapters# |<docname> invalid part, must have at least one section (e.g., chapter, appendix, etc.) |Invalid book document structure. -|#book-parts-and-chapters# |<docname> malformed manpage title |Document does not conform to the structure required by the declared manpage doctype. -|#man-pages# |<docname> malformed name section body |Document does not conform to the structure required by the declared manpage doctype. -|#man-pages# |<docname> maximum include depth of 64 exceeded |Does your file include itself, directly or indirectly? -| |<docname> mismatched macro: endif::<x>[], expected endif::<y>[] |ifdef/endif blocks must be strictly nested. -|#ifdef-directive# |<docname> name section expected |Document does not conform to the structure required by the declared manpage doctype. -|#man-pages# |<docname> name section title must be at level 1 |Document does not conform to the structure required by the declared manpage doctype. -|#man-pages# |<docname> only book doctypes can contain level 0 sections |Illegal use of a level-0 section when doctype is not book. -|#sections# |<docname> table missing leading separator, recovering automatically |Check for missing cell separator characters at the start of the line. -|#tables# |=== [#fail] == Failure messages -[options="header,breakable",cols="<60,<50,<30"] +[cols=2*] |=== -|Message |Troubleshooting |Also see +|Message |Troubleshooting |missing converter for backend '<x>'. Processing aborted. (RuntimeError) |You used -b with an invalid or missing backend. -| //|Failed to load AsciiDoc document - undefined method `convert' for nil:NilClass //| -//|#cli-options# |'tilt' could not be loaded |You must have the tilt gem installed (`gem install tilt`) to use custom backend templates -| |=== //// @@ -258,5 +211,4 @@ API only |ERROR |IOError, %(target directory does not exist: #{to_dir}) |API, the mkdirs option is not set, and the target directory does not already exist. -| //// |
