summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorDan Allen <dan.j.allen@gmail.com>2023-05-16 23:55:25 -0600
committerDan Allen <dan.j.allen@gmail.com>2023-05-17 00:46:52 -0600
commit6b2ab72ffccd653ad2daf3e05c3712d3f1ad4708 (patch)
treeb6134ee4ee8cbff353966d7a5797a8d22d0d47bf /docs
parentf717cc76330eedfc627995437409ab2e8385cefa (diff)
fix cases when source style is missing on literal block in docs
Diffstat (limited to 'docs')
-rw-r--r--docs/modules/extensions/pages/preprocessor.adoc6
-rw-r--r--docs/modules/html-backend/examples/wrap.adoc2
-rw-r--r--docs/modules/html-backend/pages/verbatim-line-wrap.adoc4
-rw-r--r--docs/modules/syntax-highlighting/pages/index.adoc4
-rw-r--r--docs/modules/syntax-highlighting/pages/pygments.adoc8
5 files changed, 12 insertions, 12 deletions
diff --git a/docs/modules/extensions/pages/preprocessor.adoc b/docs/modules/extensions/pages/preprocessor.adoc
index 0eba4f4b..83c48026 100644
--- a/docs/modules/extensions/pages/preprocessor.adoc
+++ b/docs/modules/extensions/pages/preprocessor.adoc
@@ -32,7 +32,7 @@ Skim off front matter from the top of the document that gets used by site genera
=== sample-with-front-matter.adoc
[source,asciidoc]
-----
+....
tags: [announcement, website]
---
= Document Title
@@ -41,12 +41,12 @@ content
[subs=+attributes]
.Captured front matter
-....
+----
---
{front-matter}
---
-....
----
+....
=== FrontMatterPreprocessor
diff --git a/docs/modules/html-backend/examples/wrap.adoc b/docs/modules/html-backend/examples/wrap.adoc
index 3f877d7d..9060f4d4 100644
--- a/docs/modules/html-backend/examples/wrap.adoc
+++ b/docs/modules/html-backend/examples/wrap.adoc
@@ -1,5 +1,5 @@
// tag::nowrap[]
-[source%nowrap,java]
+[%nowrap,java]
----
public class ApplicationConfigurationProvider extends HttpConfigurationProvider
{
diff --git a/docs/modules/html-backend/pages/verbatim-line-wrap.adoc b/docs/modules/html-backend/pages/verbatim-line-wrap.adoc
index a032a193..f77c465f 100644
--- a/docs/modules/html-backend/pages/verbatim-line-wrap.adoc
+++ b/docs/modules/html-backend/pages/verbatim-line-wrap.adoc
@@ -15,8 +15,8 @@ There are two ways to prevent lines from wrapping so that horizontal scrolling i
You can use the `nowrap` option on literal or listing blocks to prevent lines from being wrapped in the HTML.
-// FIXME this section is creating broken AsciiDoc!!
.Listing block with nowrap option syntax
+[source,asciidoc]
....
include::example$wrap.adoc[tag=nowrap]
....
@@ -30,7 +30,7 @@ include::example$wrap.adoc[tag=nowrap]
To prevent lines from wrapping globally, unset the `prewrap` attribute on the document.
.Disable prewrap globally (thus, enabling nowrap)
-[source,asciidoc]
+[,asciidoc]
----
:prewrap!:
----
diff --git a/docs/modules/syntax-highlighting/pages/index.adoc b/docs/modules/syntax-highlighting/pages/index.adoc
index 87e81c80..e63609d8 100644
--- a/docs/modules/syntax-highlighting/pages/index.adoc
+++ b/docs/modules/syntax-highlighting/pages/index.adoc
@@ -93,7 +93,7 @@ You should not mix syntax highlighting with AsciiDoc text formatting (i.e., the
In many converters, these two operations are mutually exclusive.
.Improper use of custom substitutions on a source block
-[,asciidoc]
+[source,asciidoc]
....
[,java,subs=+quotes]
----
@@ -112,7 +112,7 @@ While it may work in some syntax highlighters in the HTML backend (which perhaps
If you're going to customize the substitutions on a source block using the `subs` attribute, you should limit those substitutions to attribute replacements (`attributes`).
.Valid use of custom substitutions on a source block
-[,asciidoc]
+[source,asciidoc]
....
[,java,subs=attributes+]
----
diff --git a/docs/modules/syntax-highlighting/pages/pygments.adoc b/docs/modules/syntax-highlighting/pages/pygments.adoc
index 1d5fa99f..77997004 100644
--- a/docs/modules/syntax-highlighting/pages/pygments.adoc
+++ b/docs/modules/syntax-highlighting/pages/pygments.adoc
@@ -25,11 +25,11 @@ Check that you have a `python2` (Linux), `python` (macOS), or `py -2` (Windows)
Check that you have a `python3` (Linux/macOS) or `py -3` (Windows) executable on your PATH.
.Installing Python and the pygments.rb gem via the CLI (cross platform)
-[source,console]
-....
+[,console]
+----
$ "`\which apt-get || \which dnf || \which yum || \which brew`" install python # <.>
$ gem install pygments.rb # <.>
-....
+----
<.> Install Python using your package manager
<.> Install the pygments.rb gem
@@ -37,7 +37,7 @@ $ gem install pygments.rb # <.>
Once you've installed these libraries, assign `pygments` to the `source-highlighter` attribute in your document's header.
-[source,asciidoc]
+[,asciidoc]
----
:source-highlighter: pygments
----