You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

102 lines
1.5 KiB

4 years ago
////
Included in:
- user-manual: Text Substitutions: quotes
////
The `quotes` substitution replaces the formatting markup on inline elements.
For example, when a document is converted to HTML, any asterisks enclosing text are replaced with `<strong>` HTML tags.
.Syntax input
[source]
----
Happy werewolves are *really* slobbery.
----
.HTML output
[source,html]
----
Happy werewolves are <strong>really</strong> slobbery.
----
The following table shows the HTML markup that is generated by the quotes substitution process.
.HTML markup generated from AsciiDoc formatting syntax
[cols="3,^3,^4l"]
|===
|Name |AsciiDoc |HTML
|emphasis
|pass:[_word_]
|<em>word</em>
|strong
|pass:[*word*]
|<strong>word</strong>
|monospace
|pass:[`word`]
|<code>word</code>
|superscript
|pass:[^word^]
|<sup>word</sup>
|subscript
|pass:[~word~]
|<sub>word</sub>
|double curved quotes
|pass:["`word`"]
|&#8220;word&#8221;
|single curved quotes
|pass:['`word`']
|&#8216;word&#8217;
|===
The quotes substitution occurs on formatted text within title, paragraph, example, quote, sidebar, and verse blocks.
.Elements subject to quotes text substitution
[width="40%", cols="3,^2"]
|===
|Element | `quotes` substitution
|Attribute Entry Value |{n}
|Comment |{n}
|Example |{y}
|Fenced |{n}
|Header |{n}
|Literal |{n}
|Listing |{n}
|Macro |{y}
|Open |Varies
|Paragraph |{y}
|Passthrough |{n}
|Quote |{y}
|Sidebar |{y}
|Source |{n}
|Special sections |{y}
|Table |Varies
|Title |{y}
|Verse |{y}
|===