From fd32efff518fedf890452a5c76197874e6dd15df Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ji=C5=99=C3=AD=20Herrmann?= Date: Mon, 13 Oct 2025 14:57:00 +0200 Subject: [PATCH] Initial rewrite of adoc codeblock formatting --- .../style_guidelines/formatting.adoc | 28 ++++++++++--------- 1 file changed, 15 insertions(+), 13 deletions(-) diff --git a/supplementary_style_guide/style_guidelines/formatting.adoc b/supplementary_style_guide/style_guidelines/formatting.adoc index 064f4fc3..35078605 100644 --- a/supplementary_style_guide/style_guidelines/formatting.adoc +++ b/supplementary_style_guide/style_guidelines/formatting.adoc @@ -13,22 +13,24 @@ By default, use bold formatting for commands in code blocks to visually distingu To apply formatting in a code block, you must use the `quotes` link:https://docs.asciidoctor.org/asciidoc/latest/subs/apply-subs-to-blocks/[AsciiDoc substitution]. ==== -.Example AsciiDoc: A command and its output in separate code blocks +*Example AsciiDoc: A command and its output in separate code blocks* - Verify that the `libvirt` default network is active and configured to start automatically: +[literal] +-- +Verify that the `libvirt` default network is active and configured to start automatically: - [subs="+quotes"] - ---- - # *virsh net-list --all* - ---- +[subs="+quotes"] +---- +# *virsh net-list --all* +---- - [subs="+quotes"] - ---- - Name State Autostart Persistent - -------------------------------------------- - default active yes yes - ---- - +[subs="+quotes"] +---- +Name State Autostart Persistent +-------------------------------------------- +default active yes yes +---- +-- This example renders as follows in HTML: