Template:InfoBox guide/doc
This page is a template. It contains some standardized, often used text, which can be transcluded inside other pages. As this template is widely used in our wiki, it may be protected in which case only staff members can change it. Use the discussion page to propose enhancements or fixes, or to voice your opinion.
Use this template inside an {{InfoBox stack}} to provide a link to a Guide article in a right-floated box.
No parameters need to be passed to the template in order to for to properly link to the guide article if the guide article is in the standard {{PAGENAME}}/Guide location.
A hard-coded
{{PAGENAME}}/Guide location has been used for this template in order to provide a predictable location for documents once maintained by the official Gentoo documentation project. To reference a guide internal to the wiki that has a location that is not {{PAGENAME}}/Guide, give the template the name of the guide page postpended with a hash, i.e. {{InfoBox guide|<title of guide page>#}}. External guides can be linked using the raw= parameter.Parameters
| Parameter name | Required? | Default value | Description |
|---|---|---|---|
Anonymous parameter 1 |
Yes | (n/a) | Page name (see below). |
header |
No | (n/a) | Set this to yes or true to display a Resources heading, but only if the infobox is the first one in an {{InfoBox stack}}.
|
text |
No | Guide |
Can be used to change the link text. |
raw |
No | (n/a) | If present, the anonymous parameter value is interpreted as a raw URL to link to using an external-style link. |
In ordinary usage, the value of the required anonymous parameter must match the title of an article that has a subpage named "/Guide". For example, the value Samba will give a link to Samba/Guide.
In rare cases, the guide may be at a page with a different title, in which case the value of the required anonymous parameter must be a raw URL (in the form http://example.com/path, http://example.com/path, or //example.com/path) and the raw parameter must be set to any value (yes is a good choice).
Usage
This template must be used inside of an {{InfoBox stack}}, as seen in the template's testcases:
Correct
header=true
raw
text{{InfoBox stack
| {{InfoBox guide|Samba|text=Other text}}
}}
Incorrect
{{InfoBox stack
| {{InfoBox guide}}
}}
1 parameter.unnamed parameter.
See also[edit]
The templates below are implemented using {{InfoBox}}. They should also appear in Category:InfoBox templates, which may be more complete than this list.
These templates should be used within an {{InfoBox stack}}. Each should provide its own header parameter, but if necessary {{InfoBox header}} can be used.
Underlined text indicates the default heading provided by header=true for each type of template.
- For use in articles
- Resources
- {{InfoBox homepage}} – Link to the official home page for a piece of software or hardware.
- {{InfoBox odoc}} – Link to official documentation, guides, how-tos, tutorials, etc. (not user-provided documentation).
- {{InfoBox package}} – Link to package information at Packages.Gentoo.org.
- {{InfoBox project}} – Link to the related Gentoo project (on this wiki).
- {{InfoBox guide}} – Link to a Gentoo guide (on this wiki).
- {{InfoBox wikipedia}} – Link to a Wikipedia article.
- {{InfoBox ohloh}} – Link to an Ohloh project.
- {{InfoBox github}} – Link to GitHub repository.
- {{InfoBox gitlab}} – Link to GitLab repository.
- {{InfoBox codeberg}} – Link to Codeberg repository.
- {{InfoBox gitweb}} – Link to source code repository.
- {{InfoBox manpage}} – Link to a man page.
- {{InfoBox irc}} – Link to an IRC channel.
- {{InfoBox blog}} – Link to a blog.
- {{InfoBox wiki}} – Link to an official project wiki.
- Article status
- {{InfoBox wikify}} – Article needs additional wiki-formatting.
- {{InfoBox todo}} – TODO list for the article.
- {{InfoBox dated}} – Article information is out of date.
- {{InfoBox delete}} – Article should be deleted. ({{Delete}} is more noticeable.)
- For use on talk pages
- Talk status
- (Note that the simpler {{Talk}} can be used in place of both of these.)
- For use on user pages
- User info
- {{InfoBox user}} – Basic user information. (special heading: username of user page owner)
- {{InfoBox user since}} – When user started using Gentoo.
- {{InfoBox user dev}} – User is a Gentoo developer.
- Babel (spoken-language indicators)