Viewer Help Templates
General notes
Category: All Viewer help templates are in Category:Viewer Help Templates.
Special CSS style: The special style to use when you want to see something in the wiki, but not in help content is
<div class="help-hidden">.... <div/>
Transclusion issue:
If you change a template or any page, but don't change a page that uses (transcludes) that page, the help app will not recognize that the page content has changed and so will not pick up the change. You MUST either edit the page to make it update or request a rebuild via Rebuild Request.
See http://jira.secondlife.com/browse/EXT-4054
Work in progress templates
- Template:Help Placeholder - Use to add text to articles for help app testing purposes. Also puts the article in Category:Missing Help Articles, which we may use for management.
- Template:tbd - Use to denote a section that has missing information. Use it with no parameter just to highlight the section; use with a single parameter to comment. Puts the article in Category:Help Articles with Missing Information. Examples:
- Blah - Does foo Information needed! .
- Blah - Does foo Information needed! There is some info missing here! xxxx.
- Template:red - Somewhat overlaps with "tbd" but is a lot more time-sensitive, Torley uses it to SCREAM AT HIM for followup research notes, Issue Tracker bug-reporting, and soforth. Some of these may stabilize to tbd; else, they should be cleared ASAP.
- Template:redbug - Specifically used for issues you want to report on the Issue Tracker. Once reported, change the template instance to link to the specific bug so we can keep track.
Obsolete articles
Use this one for articles that were moved/renamed, and are being kept around temporarily "just in case" they are needed for some reason:
- Template:Obsolete Help Article - puts article in Category:Obsolete Help Articles
Categorization / Workflow templates
When you add the following templates to an article, the article is placed into the "corresponding category".
| Template | Description | Corresponding Category |
|---|---|---|
| Template:Help Placeholder | Temporary placeholder until "real" content is added. | Category:Missing Help Articles |
| Template:Help WIP | Article is a work in progress. Writing and editing is ongoing.
Also use this during review process to "send an article back" to the author. |
Category:Help Articles in Progress |
| Template:Help Article Ready for Review | Article is ready for content review / tech edit. | Category:Help Articles Ready for Review |
| Template:Help Article Ready for Copy Edit | Article is ready for copy edit | Category:Help Articles Ready for Copy Edit |
| Template:Help Article Ready for Translation | Use to handoff article for localization. | |
| Template:FROZEN Help Article - In Translation | Indicates the article is being translated and should not be modified. | Category:FROZEN Help Articles |
| Template:Translated Help Article | English articles: indicates article has been returned from localization; Translated articles adds "lang" variable used by other templates and categorizes by language. | * For English articles (with no parameter), adds article to Category:Translated Help Articles
|
| Template:Modified Translated Help Article | Indicates an article that has been edited since it was returned from translation. When handed off to localization again, move to FROZEN state. | Category:Modified Translated Help Articles |
Linking, layout, and formatting templates
- Template:UIref - Used for UI reference articles. No internationalization required.
- Template:Xref - Link to Glossary term. Internationalized.
- Template:Vh - Link to another help article, without capitalization (e.g. for task articles, contents, etc.) Internationalized.
- Template:Win - Display name of Viewer window (CAPITALIZES). Not internationalized.
- Template:Winlink - Link to an help UI ref article on a Viewer window (CAPITALIZES). Internationalized.
- Template:Report Bug - Displays link to report bug Viewer help article. To be internationalized.
- Template:SLlink - Link to a page on secondlife.com (or other LL-owned site) that has localized versions. Internationalized.
New:
- Transclusion template: Template: Help Transclusion (This is not really being used currently).
- Template:Advanced Feature - Use for windows that have a help button but are not to be documented.
- Template:Signpost
Localization of templates
For the above templates to work with localized articles, we must include the following template at the TOP of each translated article. For example:
{{Translated Help Article|de|<date of import>}}
Indicates that the article is a German translation and defines a variable that is used to localize other templates. Also puts the article into a category called "De/<date>" for example, Category:De/17 Feb 2010 Import.
See Template:Translated Help Article.
- Localization Viewer Help Template Test Page
Icon templates (2.0.0 and 2.0.1)
See also Category:Viewerhelp Icons
General UI Icons
Bottom bar icons
Camera & Movement Icons
Sidebar Icons
Media Icons
| Error creating thumbnail: Unable to save thumbnail to destination Power Off | Template:Icon_Power_Off |
| Error creating thumbnail: Unable to save thumbnail to destination Power On | Template:Icon_Power_On |
Content Permissions Icons
Note: These are very similar to the Inventory icons and names, but the differences were great enough that I decided they needed to be a separate set.
Inventory Icons
Note: These are very similar to the Content Permissions icons, but there are ultimately more of them, and they are named differently.
Build Tools Icons
Adult Content
Please talk to Torley if you want to make changes to these. Per CR-8179, they're dependent on Adult Content team's work! Eventually they should be localized like other templates.
Icon templates (2.0.2)
General UI Icons
Bottom bar icons
Camera & Movement Icons
Sidebar Icons
Media Icons
| Error creating thumbnail: Unable to save thumbnail to destination Power Off | Template:Icon_Power_Off |
| Error creating thumbnail: Unable to save thumbnail to destination Power On | Template:Icon_Power_On |
Content Permissions Icons
Note: These are very similar to the Inventory icons and names, but the differences were great enough that I decided they needed to be a separate set.
Inventory Icons
Note: These are very similar to the Content Permissions icons, but there are ultimately more of them, and they are named differently.
Inventory Link Icons
This is a totally new set of icons to go with the new Appearance Editor and Outfits
Build Tools Icons
Icon templates (2.3.0)
General UI Icons
| Error creating thumbnail: Unable to save thumbnail to destination Copy to clipboard | Template:Icon_CopyToClipboard |
CONVERSATIONS window icons (CHUI 3.5.0+)
FUI templates (3.x)
These are not templates.
| Error creating thumbnail: Unable to save thumbnail to destination | Green back button | File:Green back btn.jpg |
| Error creating thumbnail: Unable to save thumbnail to destination | Green forward button | File:Green fwd btn.jpg |
| Error creating thumbnail: Unable to save thumbnail to destination | Green info "i" | File:Green info btn.jpg |
| Error creating thumbnail: Unable to save thumbnail to destination | Snapshot window advanced options | File:Snapshot Advanced Options.jpg |
Other
- Template:Helplang - Used in map file to create links to localized articles.
- Template:Map File Row - A template for a smaller map file row.
- Template:Report Bug - This should really be in the Viewerhelp namespace.
- Template:Separator - Horizontal line centered that is half width of page.