From 62481c3d9ada67440e749c4948b8e78df99bdf9c Mon Sep 17 00:00:00 2001 From: hankuoffroad Date: Tue, 12 Dec 2023 18:03:33 +0000 Subject: [PATCH] asciidoc-macro-update --- .../contributing-docs/asciidoc-markup.adoc | 33 +++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/modules/ROOT/pages/contributing-docs/asciidoc-markup.adoc b/modules/ROOT/pages/contributing-docs/asciidoc-markup.adoc index 3163a45..580c0b0 100644 --- a/modules/ROOT/pages/contributing-docs/asciidoc-markup.adoc +++ b/modules/ROOT/pages/contributing-docs/asciidoc-markup.adoc @@ -277,6 +277,39 @@ This option is enabled by the `page-pagination` attribute. You can see a live example on this page. +=== Button and Menu UI macro +To keep consistency in presenting a button, keyboard bindings, or a menu item (path), Button and Menu UI Macros communicate to the reader what actions they need to take. + +IMPORTANT: Although this attribute is named experimental, the UI macros are considered a stable feature of the AsciiDoc and used in latest Quick Docs edited. + +This option is enabled by the experimental attribute. + +[,asciidoc] +---- += Page Title +:experimental: +---- + +Examples of defining Button UI Macro + +[,asciidoc] +---- +. Click btn:[Create]. + +. Choose a passphrase that is strong but also easy to remember in the dialog that is displayed. + +. Click btn:[OK] and the key is created. +---- + +Examples of defining Menu UI Macro + +[,asciidoc] +---- +To save the file, select menu:File[Save]. + +Select menu:View[Zoom > Reset] to reset the zoom level to the default setting. +---- + == Best practices A few recommendation when writing a new pages, or editing an existing one.