add inline monospace section to text styles
authorSarah White <graphitefriction@gmail.com>
Thu, 5 Apr 2018 17:54:30 +0000 (11:54 -0600)
committerSarah White <graphitefriction@gmail.com>
Tue, 10 Apr 2018 16:31:36 +0000 (10:31 -0600)
docs/modules/ROOT/nav.adoc
docs/modules/ROOT/pages/inline-text-styles.adoc

index 8c0aa93..3bd9374 100644 (file)
@@ -5,4 +5,4 @@
 * xref:templates.adoc[Work with the Handlebars Templates]
 * xref:stylesheets.adoc[Work with the CSS Stylesheets]
 * xref:style-guide.adoc[UI Element Styles]
-** xref:inline-text-styles.adoc[Inline Text Styles]
+** xref:inline-text-styles.adoc[Inline Text]
index 7c7df02..f6a8cc4 100644 (file)
@@ -32,3 +32,17 @@ How xref:antora:asciidoc:italics.adoc[italicized text] appears on your site depe
 ----
 
 In the default UI, the italic fonts (`font-style: italic`) loaded by the typeface stylesheets are applied to inline text enclosed in `<em>`.
+
+[#monospace]
+== Monospace text
+
+Technical content often requires text to be styled in a way that indicates it is a command or source code.
+Such text is usually emphasized using a fixed-width, i.e., monospace, font.
+Consequentially, how xref:antora:asciidoc:monospace.adoc[inline monospace text] is displayed depends on the fixed-width font loaded by your UI and any CSS styles it applies to the `<code>` HTML tag.
+
+[source,html]
+----
+<p>A monospace <code>word</code>, and a <code>monospace phrase</code>.</p>
+----
+
+In the default UI, the `code` element, specified in [.path]_css/base.css_, uses a fixed-width font which is loaded by a corresponding typeface stylesheet.