pool

Template:Get: Difference between revisions

Browse history interactively
[unchecked revision][unchecked revision]
← Older edit
Content deleted Content added
VisualWikitext
No edit summary
No edit summary
 
(23 intermediate revisions by the same user not shown)
Line 1:
{{#ifexist:Cli:{{{1}}}|
<div class="mw-collapsible {{#if:{{{open|}}}||mw-collapsed}} force-toggle-float-left" data-collapsetext="-" data-expandtext="+" style="overflow:hidden; display: inline;">[[Cli:{{{1}}}|<span style="color: blue; display: inline;" title="{{#lst:Cli:{{{1}}}|description}} {{#if:{{#lst:Cli:{{{1}}}|version}}|{{#ifeq:{{#lst:Cli:{{{1}}}|version}}|07.0x.0y||(ver. {{#lst:Cli:{{{1}}}|version}} )}}|}}">'''{{{alt-text|{{{2|{{{1}}}}}}}}}'''</span>]]<div class="mw-collapsible-content {{{color|shellbasic}}}" style="align: left;">{{{example|{{{3|{{#lst:Cli:{{{1}}}|{{{section|example}}}}}}}}}}}</div></div>{{#if:{{{inline|}}}||<br><br style="clear:both;">}}
|
<div class="mw-collapsible {{#if:{{{open|}}}||mw-collapsed}} {{#if:{{{color|}}}|{{{color}}}}} force-toggle-float-left" data-collapsetext="-" data-expandtext="+" style="overflow:hidden; display: inline;"><span style="color: blue; display: inline;">'''{{{alt-text|{{{2|{{{1}}}}}}}}}'''</span><div class="mw-collapsible-content {{{color|shellbasic}}}" style="align: left;">{{{example|{{{3|<pre>Need an Example</pre>}}}}}}</div></div>{{#if:{{{inline|}}}||<br><br style="clear:both;">}}
}}<noinclude>
 
 
== Usage ==
Syntax Examples -
{{Note|It is not necessary (but expected) when using this template that a page exists detailing the commands usage, it is from this page that the example and tool tip is taken, for the purpose of the examples below a test page has been created: [[Cli:Command show]]|info}}
Only Specify the Command:
<pre>{{Get|command|section=YourSectionName}}</pre><br>
{{Note|If you omit the section=YourSectionName, by default the section called example will be used}}
 
Show alternative Text:
<pre>{{Get|command|alt text|section=YourSectionName}}</pre><br>
 
{| class="wikitable"
Show alternative Text and specify code sample:
|Only Specify the Command:
<pre>{{Get|command|alt text|&lt;pre&gt;sample code&lt;/pre&gt;|section=YourSectionName}}</pre><br>
|-
|<pre>{{Get|Command show}}</pre>
|-
|{{Get|Command show}}
|}
 
By setting the boolean "open" the code sample is shown by default:
<pre>{{Get|command|alt text|&lt;pre&gt;sample code&lt;/pre&gt;|open=1|section=YourSectionName}}</pre><br>
 
{| class="wikitable"
With the Word "open" the code sample is shown by default:
|Provide a different example :
<pre>{{Get|command|alt text|&lt;pre&gt;sample code&lt;/pre&gt;|open=1|color=blue-white|section=YourSectionName}}</pre>
|-
|<pre>{{Get|Command show|example=
&lt;pre&gt;
cli> dns show
# | id | addresses
----+------+-------------
1 | DNS1 | 10.24.27.42
| | 10.24.27.41
&lt;/pre&gt;}}</pre>
|-
|{{Get|Command show|example=
<pre>
cli> dns show
# | id | addresses
----+------+-------------
1 | DNS1 | 10.24.27.42
| | 10.24.27.41
cli>
</pre>}}
|}
 
 
{| class="wikitable"
|Provide a different example, this time using syntaxhighlight and recoloring:
|-
|<pre>{{Get|Command show|color=black-white|example=
&lt;syntaxhighlight lang="text" highlight="4"&gt;
cli> dns show
# | id | addresses
----+------+-------------
1 | DNS1 | 10.24.27.42
| | 10.24.27.41
&lt;/syntaxhighlight&gt;}}</pre>
|-
|{{Get|Command show|color=black-white|example=
<syntaxhighlight lang="text" highlight="4">
cli> dns show
# | id | addresses
----+------+-------------
1 | DNS1 | 10.24.27.42
| | 10.24.27.41
cli>
</syntaxhighlight>}}
|}
 
 
{{Tip|The tool tips for version and description are take from the page in the Cli namespace having the same name as the command, you can spot them between tags like this:<br>
<code><nowiki><section begin=version />1.0.0.179<section end=version /></nowiki></code> and this:<br>
<code><nowiki><section begin=description />Description Goes Here!<section end=description /></nowiki></code>}}
 
 
{| class="wikitable"
|Specify alternative section of page to pull example from:
|-
|<pre>{{Get|Command show|section=hosts}}</pre>
|-
|{{Get|Command show|section=hosts}}
|}
 
 
{{Note|If you omit the section &#61;YourSectionName, by default the section called example will be used}}
 
 
{| class="wikitable"
|Show alternative Text:
|-
|<pre>{{Get|command show|volume show|color=blue-white}}</pre>
|-
|{{Get|command show|volume show|color=blue-white}}
|}
 
 
{| class="wikitable"
|Show alternative Text and specify code example, no need to use "example=" if the example is the 3rd paramater:
|-
|<pre>{{Get|command show|appliance show|
&lt;pre&gt;
cli> appliance show
# | id | name | service_tag | model | software_installed.release_version
----+----+-----------------------+-------------+------------------+------------------------------------
1 | A1 | PowerThor-appliance-1 | 59P42W2 | PowerStore 3000X | 1.0.0.1.3.720
cli> cluster show
# | name | management_address | storage_discovery_address | master_appliance_id | appliance_count | state
----+-----------+--------------------+---------------------------+---------------------+-----------------+------------
1 | PowerThor | 10.24.31.10 | 172.28.45.17 | A1 | 1 | Configured
cli>
&lt;/pre&gt;}}</pre>
|-
|{{Get|command show|appliance show|
<pre>
cli> appliance show
# | id | name | service_tag | model | software_installed.release_version
----+----+-----------------------+-------------+------------------+------------------------------------
1 | A1 | PowerThor-appliance-1 | 59P42W2 | PowerStore 3000X | 1.0.0.1.3.720
cli> cluster show
# | name | management_address | storage_discovery_address | master_appliance_id | appliance_count | state
----+-----------+--------------------+---------------------------+---------------------+-----------------+------------
1 | PowerThor | 10.24.31.10 | 172.28.45.17 | A1 | 1 | Configured
cli>
</pre>}}
|}
 
 
{{Caution|In order to format commands like the example below, with no additional line breaks, it is necessary to enclose the commands in a table or div, this page is a good example [[compiki:common commands]]}}
 
 
 
{| class="wikitable"
|Display several commands without additional line breaks:
|-
|
<pre>{{Get|command show|command one|&lt;pre&gt;command one sample code&lt;/pre&gt;|inline=1}}<br></pre><br>
<pre>{{Get|command show|command one|&lt;pre&gt;command two sample code&lt;/pre&gt;|inline=1}}<br></pre><br>
<pre>{{Get|command show|command one|&lt;pre&gt;command three sample code&lt;/pre&gt;|inline=1}}<br></pre><br>
|-
|
{{Get|command show|command one|<pre>command one sample code</pre>|inline=1}}<br>
{{Get|command show|command two|<pre>command two sample code</pre>|inline=1}}<br>
{{Get|command show|command three|<pre>command three sample code</pre>|inline=1}}<br>
|}
 
 
{{Note|The boilerplate page for documenting commands uses black and green coloring for the pre-formatted text, this can be set back to defaults by setting the color to basic like below|info-blue}}
 
 
{| class="wikitable"
|Change color and display open:
|-
|<pre>{{Get|Command show|open=1|color=basic}}</pre>
|-
|{{Get|Command show|open=1|color=basic}}
|}
 
 
{| class="wikitable"
|Open=1 using syntaxhighlight and recoloring:
|-
|<pre>{{Get|Command show|open=1|color=blue-white|example=
&lt;syntaxhighlight lang="text" highlight="4"&gt;
cli> dns show
# | id | addresses
----+------+-------------
1 | DNS1 | 10.24.27.42
| | 10.24.27.41
&lt;/syntaxhighlight&gt;}}</pre>
|-
|{{Get|Command show|color=blue-white|open=1|example=
<syntaxhighlight lang="text" highlight="4">
cli> dns show
# | id | addresses
----+------+-------------
1 | DNS1 | 10.24.27.42
| | 10.24.27.41
cli>
</syntaxhighlight>}}
|}
 
 
Line 34 ⟶ 189:
"required": true
},
"2alt-text": {
"label": "Alternative Command Description",
"description": "Either Alternate Description of Command or an Example",
Line 40 ⟶ 195:
"type": "string"
},
"3example": {
"label": "Sample output",
"description": "An example output of runing this command",
Line 49 ⟶ 204:
"label": "Pre Color",
"description": "Color of Pre-formatted Example",
"example": "basic, black-green, blue-white, black-white, net, esx",
"type": "string"
},
Line 69 ⟶ 224:
"example": "1",
"type": "boolean"
},
"example": {
"label": "Sample output",
"description": "An example output of runing this command",
"example": "<pre>volume show where status = offline</pre>",
"type": "string"
},
"alt-text": {
"label": "Alternative Command Description",
"description": "Either Alternate Description of Command or an Example",
"example": "volume show where status = offline",
"type": "string"
}
},
Retrieved from "https://pool.calebcooper.ie/Template:Get"