Difference between revisions of "Template:Outdent/doc"
m |
m |
||
Line 9: | Line 9: | ||
== Usage == | == Usage == | ||
− | <code><nowiki>{{outdent|optional param1|optional param2|reverse / indent / r / in =|test_line_width =}} </nowiki></code> | + | : <code><nowiki>{{outdent|optional param1|optional param2|reverse / indent / r / in =|test_line_width =}} </nowiki></code> |
<div style="border:thin grey solid; padding:8px; margin:4px"> | <div style="border:thin grey solid; padding:8px; margin:4px"> | ||
{{para|1}} | {{para|1}} | ||
Line 35: | Line 35: | ||
</div> | </div> | ||
− | The default number of colons is 10. | + | The default number of colons is 10. When the value specified is over 40, the module stops at 40 (for readability reasons). The template also recognizes the named parameter "reverse" - see {{section link|Template:Outdent/doc|Indent|nopage=yes}} below. |
− | |||
− | When the value specified is over 40, the module stops at 40 (for readability reasons). | ||
− | |||
− | The template also recognizes the named parameter "reverse" - see {{section link|Template:Outdent/doc|Indent|nopage=yes}} below. | ||
== Examples == | == Examples == | ||
Line 68: | Line 64: | ||
<pre>Alternatively: | <pre>Alternatively: | ||
:::::: This is the previous post, indented 6 levels | :::::: This is the previous post, indented 6 levels | ||
− | {{outdent}} Start of a new post. ''(Note that the bar is longer | + | {{outdent}} Start of a new post. ''(Note that the bar is longer - it is using the default value of 10.)''</pre> |
displays as | displays as | ||
:::::: This is the previous post, indented 6 levels | :::::: This is the previous post, indented 6 levels | ||
− | {{outdent}} Start of a new post. ''(Note that the bar is longer | + | {{outdent}} Start of a new post. ''(Note that the bar is longer - it is using the default value of 10.)'' |
</div> | </div> | ||
Line 99: | Line 95: | ||
</div> | </div> | ||
− | + | === More examples === | |
<div style="border:thin grey solid; padding:8px; margin:4px"> | <div style="border:thin grey solid; padding:8px; margin:4px"> | ||
<nowiki>{{outdent}} xxx </nowiki>{{outdent}}xxx<br> | <nowiki>{{outdent}} xxx </nowiki>{{outdent}}xxx<br> |
Revision as of 15:03, 16 June 2019
For outdenting a reply on a talk page when indention gets too deep.
Indenting on talk pages is done using colons and asterisks and hashes to produce "tabs"; this template produces a connector bar and (optionally) initial text to indicate an outdent, with the length of the bar specified by the number of colons used in the template. The left margin is sent to the position of the template. :: {{outdent}}
produces:
The template also has a named parameter to reverse the direction of the bar to indicate deeper indentation- see § Indent below. :: {{outdent|reverse=x}}
produces:
Usage
{{outdent|optional param1|optional param2|reverse / indent / r / in =|test_line_width =}}
|1=
- The number of tabs/indentations to outdent.
- Value may be colons, hashes (count for 2) and asterisks or just values.
- When using this you may copy the colons, hashes and asterisks from the start of the last message as the first parameter.
- If the first parameter is not used, the default value of 10 is used.
- A value of zero causes the template to return a pipe (|).
- Recommended
|2=
- If used, specifies that the string (outdent) is to be placed at the start of the new line's text.
- Can be any value.
|reverse=
(|indent=
, |r=
, |in=
)
- Can be set so:
{{outdent|reverse=''string''}}
where string can be any character or string of characters. It will also work with the optional unnamed parameters described previously. Its purpose is to allow for indention. See examples below. - Can be any value.
|test_line_width=
- Set to any string to test the line creating and reduction functions in the module.
- Not recommended
The default number of colons is 10. When the value specified is over 40, the module stops at 40 (for readability reasons). The template also recognizes the named parameter "reverse" - see § Indent below.
Examples
To outdent posts, insert the number of colons that were used for indenting in the previous post, or use an integer value for that number.
:::: This is the previous post, indented 4 levels {{outdent|::::}} Start of a new post
displays as
- This is the previous post, indented 4 levels
:::::: This is the previous post, indented 6 levels {{outdent|6}} Start of a new post
displays as
- This is the previous post, indented 6 levels
Alternatively: :::::: This is the previous post, indented 6 levels {{outdent}} Start of a new post. ''(Note that the bar is longer - it is using the default value of 10.)''
displays as
- This is the previous post, indented 6 levels
You can also have the template automatically add a linked tag, by adding any second parameter (its specific value is discarded):
:::::: This is the previous post, indented 6 levels {{outdent|6|link}} Start of a new post
displays as
- This is the previous post, indented 6 levels
To not outdent all the way to the left margin, the outdent template itself can be indented using one or more colons:
:::::: This is the previous post, indented 6 levels :: {{outdent|4}} Start of a new post
displays as
- This is the previous post, indented 6 levels
- Start of a new post
More examples
- {{outdent|1|anything}} xxxxxx
- {{outdent|1|anything}} xxx
- {{outdent|6|xxx}} xxx xxx
- {{outdent|6|xxx}} xxx
Indent
:::::: This is the previous post, indented 6 levels :: {{outdent|4}} Start of a new post indented 2 levels using a bar of length 6-2=4. :: {{outdent|5|reverse=yes}} ::::::: Indent 7 levels using a reversed bar of length 7-2=5.
displays as
- This is the previous post, indented 6 levels
- Start of a new post indented 2 levels using a bar of length 6-2=4.
- Indent 7 levels using a reversed bar of length 7-2=5.
:::::: Original conversation. :::::: {{outdent|3|reverse=x}} ::::::::: Afterthought. ::::::: {{outdent|2}} ::::::: Continuation of original conversation.
displays as
- Original conversation.
- Afterthought.
- Continuation of original conversation.
Link
:::::::::: Last post, indented 10 levels. "{{outdent|10}} xxx" New post
displays as
- Last post, indented 10 levels.
New post
Whereas:
:::::::::: Last post, indented 10 levels. "{{oudent|10|xxx}} xxx" New post
displays as
- Last post, indented 10 levels.
New post
CSS and hide
This template is contained in the CSS class "outdent-template". Users who would prefer not to see the template can add the following line to their custom CSS (Special:MyPage/common.css):
span.outdent-template { display: none; }