Template:Software documentation index/doc: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
|||
(2 intermediate revisions by the same user not shown) | |||
Line 18: | Line 18: | ||
! width = "15%" | Parameter | ! width = "15%" | Parameter | ||
! width = "40%" | Description | ! width = "40%" | Description | ||
! | ! Example | ||
! width = "8%" | Preview | ! width = "8%" | Preview | ||
|- | |- | ||
Line 24: | Line 24: | ||
| Comment above the software banner. | | Comment above the software banner. | ||
{{note|Created mainly for the to-do list, so that it doesn't look too bad next to the table.}} | {{note|Created mainly for the to-do list, so that it doesn't look too bad next to the table.}} | ||
| <pre style="margin:0">| comment = Gordon Freeman was here.</pre> | | style="background-color:#1f1f1f" | <pre style="margin:.25em 0">| comment = Gordon Freeman was here.</pre> | ||
| bgcolor="#262626" rowspan="23" align="center" style="vertical-align:top" | See [[#Preview]]. | | bgcolor="#262626" rowspan="23" align="center" style="vertical-align:top" | See [[#Preview]]. | ||
|- | |- | ||
| style="text-align:center" | <code>{{param|banner}}</code> | | style="text-align:center" | <code>{{param|banner}}</code> | ||
| Software banner. | | Software banner. | ||
| <pre style="margin:0">| banner = Placeholder for SDI banner.jpg</pre> | | style="background-color:#1f1f1f" | <pre style="margin:.25em 0">| banner = Placeholder for SDI banner.jpg</pre> | ||
|- | |- | ||
| style="text-align:center" | <code>{{param|desc}}</code> | | style="text-align:center" | <code>{{param|desc}}</code> | ||
| Software description. | | Software description. | ||
| <pre style="margin:0">| desc = '''Sweet Tools''' is free software distributed through {{steamicon|1}}.</pre> | | style="background-color:#1f1f1f" | <pre style="margin:.25em 0">| desc = '''Sweet Tools''' is free software distributed through {{steamicon|1}}.</pre> | ||
|- | |- | ||
| style="text-align:center" | <code>{{param|link<1-6>}}</code> | | style="text-align:center" | <code>{{param|link<1-6>}}</code> | ||
| Link above the table. Maximum 6. | | Link above the table. Maximum 6. | ||
| <pre style="margin:0">| link4 = '''[[Source SDK Release Notes|Release Notes]]'''</pre> | | style="background-color:#1f1f1f" | <pre style="margin:.25em 0">| link4 = '''[[Source SDK Release Notes|Release Notes]]'''</pre> | ||
|- | |- | ||
| style="text-align:center" | <code>{{param|toc}}</code> | | style="text-align:center" | <code>{{param|toc}}</code> | ||
| Table of Contents. Useful if the content is divided into headers. | | Table of Contents. Useful if the content is divided into headers. | ||
| <pre style="margin:0">| toc = [[#Something about mapping|[#Something about mapping]] · [[#Something about scripting|[#Something about scripting]]</pre> | | style="background-color:#1f1f1f" | <pre style="margin:.25em 0">| toc = [[#Something about mapping|[#Something about mapping]] · [[#Something about scripting|[#Something about scripting]]</pre> | ||
|- | |- | ||
| style="text-align:center" | <code>{{param|button<1-48>}}</code> | | style="text-align:center" | <code>{{param|button<1-48>}}</code> | ||
| The displayed name of the specified button. | | The displayed name of the specified button. | ||
| <pre style="margin:0">| button11 = Level design</pre> | | style="background-color:#1f1f1f" | <pre style="margin:.25em 0">| button11 = Level design</pre> | ||
|- | |- | ||
| style="text-align:center" | <code>{{param|button<1-48>link}}</code> | | style="text-align:center" | <code>{{param|button<1-48>link}}</code> | ||
| Link to the page for the specified button. | | Link to the page for the specified button. | ||
| <pre style="margin:0">| button16link = Half-Life: Alyx Workshop Tools/ | | style="background-color:#1f1f1f" | <pre style="margin:.25em 0">| button16link = Half-Life: Alyx Workshop Tools/Addon Sounds</pre> | ||
|- | |- | ||
| style="text-align:center" | <code>{{param|button<1-48>desc}}</code> | | style="text-align:center" | <code>{{param|button<1-48>desc}}</code> | ||
| Description of the page linked to by the specified button. | | Description of the page linked to by the specified button. | ||
| <pre style="margin:0">| button5desc = About creating cool maps</pre> | | style="background-color:#1f1f1f" | <pre style="margin:.25em 0">| button5desc = About creating cool maps</pre> | ||
|- | |- | ||
| style="text-align:center" | <code>{{param|button<1-48>header}}</code> | | style="text-align:center" | <code>{{param|button<1-48>header}}</code> | ||
| Adds a heading above the specified button. This is useful if the software page prefers an option without redirects to guide pages, such as the page about [[:Category:Level Design|level design in Source]]. | | Adds a heading above the specified button. This is useful if the software page prefers an option without redirects to guide pages, such as the page about [[:Category:Level Design|level design in Source]]. | ||
| <pre style="margin:0">| button45header = Something about mapping</pre> | | style="background-color:#1f1f1f" | <pre style="margin:.25em 0">| button45header = Something about mapping</pre> | ||
|- | |- | ||
| style="text-align:center" | <code>{{param|button<1-48>redlink}}</code> | | style="text-align:center" | <code>{{param|button<1-48>redlink}}</code> | ||
| If the page does not exist, use this parameter to remove the custom link color. {{important|The custom color should not replace red links, so as not to confuse the user.}} | | If the page does not exist, use this parameter to remove the custom link color. {{important|The custom color should not replace red links, so as not to confuse the user.}} | ||
| <pre style="margin:0">| button6redlink = true</pre> | | style="background-color:#1f1f1f" | <pre style="margin:.25em 0">| button6redlink = true</pre> | ||
|- | |- | ||
| style="text-align:center" | <code>{{param|button<2-48>radius}}</code> | | style="text-align:center" | <code>{{param|button<2-48>radius}}</code> | ||
Line 68: | Line 68: | ||
* start - the default is specified for the first button. | * start - the default is specified for the first button. | ||
* end - specify if the button is the last one. | * end - specify if the button is the last one. | ||
| <pre style="margin:0">| button2radius = end</pre> | | style="background-color:#1f1f1f" | <pre style="margin:.25em 0">| button2radius = end</pre> | ||
|- | |- | ||
| colspan="3" style="background:#949494; color:#262626; text-align:center" | '''Style''' | | colspan="3" style="background:#949494; color:#262626; text-align:center" | '''Style''' | ||
Line 74: | Line 74: | ||
| style="text-align:center" | <code>{{param|topindent}}</code> | | style="text-align:center" | <code>{{param|topindent}}</code> | ||
| Top indent for the entire table. | | Top indent for the entire table. | ||
| <pre style="margin:0">| topindent = 2em</pre> | | style="background-color:#1f1f1f" | <pre style="margin:.25em 0">| topindent = 2em</pre> | ||
|- | |- | ||
| align="center" | <code>{{param|width}}</code> | | align="center" | <code>{{param|width}}</code> | ||
| Table width. | | Table width. | ||
| <pre style="margin:0">| width = 600px</pre> | | style="background-color:#1f1f1f" | <pre style="margin:.25em 0">| width = 600px</pre> | ||
|- | |- | ||
| style="text-align:center" | <code>{{param|bannerwidth}}</code> | | style="text-align:center" | <code>{{param|bannerwidth}}</code> | ||
| Banner width. | | Banner width. | ||
| <pre style="margin:0">| bannerwidth = 560px</pre> | | style="background-color:#1f1f1f" | <pre style="margin:.25em 0">| bannerwidth = 560px</pre> | ||
|- | |- | ||
| style="text-align:center" | <code>{{param|descwidth}}</code> | | style="text-align:center" | <code>{{param|descwidth}}</code> | ||
| Software description width. Used when you need to make the text look nicer. | | Software description width. Used when you need to make the text look nicer. | ||
| <pre style="margin:0">| descwidth = 550px</pre> | | style="background-color:#1f1f1f" | <pre style="margin:.25em 0">| descwidth = 550px</pre> | ||
|- | |- | ||
| style="text-align:center" | <code>{{param|commentStyle}}</code> | | style="text-align:center" | <code>{{param|commentStyle}}</code> | ||
| Custom Comment CSS. | | Custom Comment CSS. | ||
{{Warning|Overwrites the original style!}} | {{Warning|Overwrites the original style!}} | ||
| <pre style="margin:0">| commentStyle = background:#000; border-radius:.3em</pre> | | style="background-color:#1f1f1f" | <pre style="margin:.25em 0">| commentStyle = background:#000; border-radius:.3em</pre> | ||
|- | |- | ||
| style="text-align:center" | <code>{{param|borderColor}}</code> | | style="text-align:center" | <code>{{param|borderColor}}</code> | ||
| Table border color. | | Table border color. | ||
| <pre style="margin:0">| borderColor = #F2A52B4a</pre> | | style="background-color:#1f1f1f" | <pre style="margin:.25em 0">| borderColor = #F2A52B4a</pre> | ||
|- | |- | ||
| style="text-align:center" | <code>{{param|headerGradColors}}</code> | | style="text-align:center" | <code>{{param|headerGradColors}}</code> | ||
| The colors of the gradient for the background of the header. | | The colors of the gradient for the background of the header. | ||
| <pre style="margin:0">| headerGradColors = #594027,#312717</pre> | | style="background-color:#1f1f1f" | <pre style="margin:.25em 0">| headerGradColors = #594027,#312717</pre> | ||
|- | |- | ||
| style="text-align:center" | <code>{{param|buttonTextColor}}</code> | | style="text-align:center" | <code>{{param|buttonTextColor}}</code> | ||
| The color of the link button text. | | The color of the link button text. | ||
| <pre style="margin:0">| buttonTextColor = #E3C798</pre> | | style="background-color:#1f1f1f" | <pre style="margin:.25em 0">| buttonTextColor = #E3C798</pre> | ||
|- | |- | ||
| style="text-align:center" | <code>{{param|buttonBG}}</code> | | style="text-align:center" | <code>{{param|buttonBG}}</code> | ||
| The color of the background behind the link button. | | The color of the background behind the link button. | ||
| <pre style="margin:0">| buttonBG = #2F2A26</pre> | | style="background-color:#1f1f1f" | <pre style="margin:.25em 0">| buttonBG = #2F2A26</pre> | ||
|- | |- | ||
| style="text-align:center" | <code>{{param|rowColor1}}</code> | | style="text-align:center" | <code>{{param|rowColor1}}</code> | ||
| Color of the first row of the table.<br>Default value is <code>#252525</code>. | | Color of the first row of the table.<br>Default value is <code>#252525</code>. | ||
| <pre style="margin:0">| rowColor1 = #303030</pre> | | style="background-color:#1f1f1f" | <pre style="margin:.25em 0">| rowColor1 = #303030</pre> | ||
|- | |- | ||
| style="text-align:center" | <code>{{param|rowColor2}}</code> | | style="text-align:center" | <code>{{param|rowColor2}}</code> | ||
| Color of the second row of the table.<br>Default value is <code>#202020</code>. | | Color of the second row of the table.<br>Default value is <code>#202020</code>. | ||
| <pre style="margin:0">| rowColor1 = #252525</pre> | | style="background-color:#1f1f1f" | <pre style="margin:.25em 0">| rowColor1 = #252525</pre> | ||
|} | |} | ||
Latest revision as of 14:04, 22 September 2025

This is a documentation subpage for Template:Software documentation index.
Don't forget to purge the contents of the base page upon creating or editing this subpage.
Don't forget to purge the contents of the base page upon creating or editing this subpage.
Table for use in software documentation indexes, such as Source SDK Index.
Usage
This template is usually written in a column. To use it, insert {{Software documentation index}}
on the desired page and specify the parameters under the template name in the following format:
{{Software documentation index | parameter 1 = value | parameter 2 = value }}
Parameters and Examples
Parameter | Description | Example | Preview |
---|---|---|---|
{{{comment}}}
|
Comment above the software banner.
![]() |
| comment = Gordon Freeman was here. |
See #Preview. |
{{{banner}}}
|
Software banner. | | banner = Placeholder for SDI banner.jpg | |
{{{desc}}}
|
Software description. | | desc = '''Sweet Tools''' is free software distributed through {{steamicon|1}}. | |
{{{link<1-6>}}}
|
Link above the table. Maximum 6. | | link4 = '''[[Source SDK Release Notes|Release Notes]]''' | |
{{{toc}}}
|
Table of Contents. Useful if the content is divided into headers. | | toc = [[#Something about mapping|[#Something about mapping]] · [[#Something about scripting|[#Something about scripting]] | |
{{{button<1-48>}}}
|
The displayed name of the specified button. | | button11 = Level design | |
{{{button<1-48>link}}}
|
Link to the page for the specified button. | | button16link = Half-Life: Alyx Workshop Tools/Addon Sounds | |
{{{button<1-48>desc}}}
|
Description of the page linked to by the specified button. | | button5desc = About creating cool maps | |
{{{button<1-48>header}}}
|
Adds a heading above the specified button. This is useful if the software page prefers an option without redirects to guide pages, such as the page about level design in Source. | | button45header = Something about mapping | |
{{{button<1-48>redlink}}}
|
If the page does not exist, use this parameter to remove the custom link color. ![]() |
| button6redlink = true | |
{{{button<2-48>radius}}}
|
The radius of the table row with the button. Available values:
|
| button2radius = end | |
Style | |||
{{{topindent}}}
|
Top indent for the entire table. | | topindent = 2em | |
{{{width}}}
|
Table width. | | width = 600px | |
{{{bannerwidth}}}
|
Banner width. | | bannerwidth = 560px | |
{{{descwidth}}}
|
Software description width. Used when you need to make the text look nicer. | | descwidth = 550px | |
{{{commentStyle}}}
|
Custom Comment CSS.
![]() |
| commentStyle = background:#000; border-radius:.3em | |
{{{borderColor}}}
|
Table border color. | | borderColor = #F2A52B4a | |
{{{headerGradColors}}}
|
The colors of the gradient for the background of the header. | | headerGradColors = #594027,#312717 | |
{{{buttonTextColor}}}
|
The color of the link button text. | | buttonTextColor = #E3C798 | |
{{{buttonBG}}}
|
The color of the background behind the link button. | | buttonBG = #2F2A26 | |
{{{rowColor1}}}
|
Color of the first row of the table. Default value is #252525 .
|
| rowColor1 = #303030 | |
{{{rowColor2}}}
|
Color of the second row of the table. Default value is #202020 .
|
| rowColor1 = #252525 |
Preview
Gordon Freeman was here.
Introduction | Introduction to using this amazing toolkit. |
Something about mapping | |
Level Design | Create levels with an incredibly cute map editor. |
Materials | Learn how to add a character's face to a texture that will only be seen many years later. |
|
Components
This template uses components to simplify working with repetitive code. Below is a list of all components included in the template.
See also
- {{DIP topicon}}