The Funtoo Linux project has transitioned to "Hobby Mode" and this wiki is now read-only.
Difference between revisions of "ConsoleOutput MediaWiki Extension"
Line 1: | Line 1: | ||
The ConsoleOutput MediaWiki extension was created by Daniel Robbins to provide highlighting of user input for interactive terminal session blocks. To use it, surround user input with <tt><console></tt> opening and closing tags. This tag works similarly to a <tt><pre></tt> tag, and preserves output formatting in the quoted text. | The [https://github.com/BreezyOps/MediaWiki-ConsoleOutput ConsoleOutput MediaWiki extension] was created by Daniel Robbins to provide highlighting of user input for interactive terminal session blocks. To use it, surround user input with <tt><console></tt> opening and closing tags. This tag works similarly to a <tt><pre></tt> tag, and preserves output formatting in the quoted text. | ||
To highlight text typed by a user, rather than program output, put a <tt>##i##</tt> input code immediately before user input on each line. This will cause all text from the <tt>##i##</tt> to the end of the line to be highlighted in orange to offset it from the prompt and other other program output. | To highlight text typed by a user, rather than program output, put a <tt>##i##</tt> input code immediately before user input on each line. This will cause all text from the <tt>##i##</tt> to the end of the line to be highlighted in orange to offset it from the prompt and other other program output. |
Latest revision as of 01:32, April 30, 2018
The ConsoleOutput MediaWiki extension was created by Daniel Robbins to provide highlighting of user input for interactive terminal session blocks. To use it, surround user input with <console> opening and closing tags. This tag works similarly to a <pre> tag, and preserves output formatting in the quoted text.
To highlight text typed by a user, rather than program output, put a ##i## input code immediately before user input on each line. This will cause all text from the ##i## to the end of the line to be highlighted in orange to offset it from the prompt and other other program output.
Console Markup
The folowing elements are available for marking up text within <console> elements:
##i##
- Tag all following text on this line as user input.##b##
- Highlight the rest of the line in bold.##b##text here##!b##
- Highlight the text between both markers in bold.##i##text here##!i##
- Highlight the text between both markers as user input.##g##
- Green##y##
- Yellow##bl##
- Blue##r##
- Red
Examples
Here are a few examples of the ConsoleOutput extension. First this is how you might typically display ls
output, with a particular directory highlighted:
www@www-smw ~/public_html $ ls COPYING LocalSettings.php api.php extensions index.php maintenance redirect.php skins thumb_handler.php5 CREDITS README api.php5 images index.php5 mw-config redirect.php5 tests wiki.phtml FAQ RELEASE-NOTES-1.19 bin img_auth.php languages opensearch_desc.php redirect.phtml thumb.php HISTORY StartProfiler.sample cache img_auth.php5 load.php opensearch_desc.php5 resources thumb.php5 INSTALL UPGRADE docs includes load.php5 profileinfo.php serialized thumb_handler.php www@www-smw ~/public_html $ cd extensions/
And here is how you might display a more detailed example of console output, using colors:
root # bluetoothctl [NEW] Controller 00:02:72:C9:62:65 antec [default] root ##bl##[bluetooth]##!bl### power on Changing power on succeeded root ##bl##[bluetooth]##!bl### agent on Agent registered root ##bl##[bluetooth]##!bl### scan on Discovery started root ##bl##[bluetooth]##!bl### devices Device 00:1F:20:3D:1E:75 Logitech K760 root ##bl##[bluetooth]##!bl### pair 00:1F:20:3D:1E:75 Attempting to pair with 00:1F:20:3D:1E:75 [CHG] Device 00:1F:20:3D:1E:75 Connected: yes root ##r##[agent]##!r## Passkey: 454358 root ##r##[agent]##!r## Passkey: 454358 root ##r##[agent]##!r## Passkey: 454358 root ##r##[agent]##!r## Passkey: 454358 root ##r##[agent]##!r## Passkey: 454358 root ##r##[agent]##!r## Passkey: 454358 root ##r##[agent]##!r## Passkey: 454358 [CHG] Device 00:1F:20:3D:1E:75 Paired: yes Pairing successful [CHG] Device 00:1F:20:3D:1E:75 Connected: no root ##bl##[bluetooth]##!bl### connect 00:1F:20:3D:1E:75 Attempting to connect to 00:1F:20:3D:1E:75 [CHG] Device 00:1F:20:3D:1E:75 Connected: yes Connection successful root ##bl##[bluetooth]##!bl### quit [DEL] Controller 00:02:72:C9:62:65 antec [default] root #
Installation
Please see ConsoleOutput GitHub page for install instructions.