Template:ArticleMetaData
This template provides users with information that helps them determine whether an article is likely to still be accurate and relevant. It should be applied to all articles.
Contents |
Usage
The template is automatically included in new articles. To add to an existing article, copy-paste the text below and replace the html comments with your own values. Note that empty values (and HTML comments) are not displayed, so there is no need to delete unused values.
{{ArticleMetaData <!-- v1.3 -->
|sourcecode= <!-- Link to example source code e.g. [[Media:The Code Example ZIP.zip]] -->
|installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.wgt]]) -->
|devices= <!-- Devices tested against - e.g. Nokia Lumia 928, Nokia Asha 501) -->
|sdk= <!-- SDK(s) built and tested against (e.g. Windows Phone 8.0 SDK) -->
|platform= <!-- Compatible platforms - e.g. Nokia Asha Platform 1.0 and later -->
|dependencies= <!-- Any other/external dependencies e.g.: Google Maps Api v1.0 -->
|signing=<!-- Special Signing requirements -->
|capabilities= <!-- Required capabilities for code (e.g. ID_CAP_LOCATION, ID_CAP_NETWORKING) -->
|keywords= <!-- APIs, classes and methods (e.g. IsolatedStorageSettings, Geoposition, etc -->
|language= <!-- Language category code for non-English topics - e.g. Lang-Chinese -->
|translated-by= <!-- [[User:XXXX]] -->
|translated-from-title= <!-- Title only - not link -->
|translated-from-id= <!-- Id of translated revision -->
|review-by=<!-- After re-review: [[User:username]] -->
|review-timestamp= <!-- After re-review: YYYYMMDD -->
|update-by= <!-- After significant update: [[User:username]]-->
|update-timestamp= <!-- After significant update: YYYYMMDD -->
|creationdate= <!-- Format YYYYMMDD -->
|author= <!-- Enter link [[User:username]] -->
}}The parameters are documented in more detail below. Note that only the Creation parameters are mandatory.
Article Information
Creation
These parameters record the original article author. They are intended to give the author credit for their work, and to make it easy for readers to find out more about the author:
- creationdate=Article creation date, format YYYYMMDD.
- author=Original article author, format [[User:hamishwillee]].
Review
The (optional) review parameters allow end-users to see the last date that an article was known to be accurate. With this information readers can still "trust" older articles.
The parameters can be updated by any wiki user who is technically competent in the article area.
- review-by=Reviewer user id, in format [[User:hamishwillee]]
- review-timestamp=Timestamp of review, in format YYYYMMDD
Update
Articles may periodically receive a significant update. These parameters allow the author of the update to be recognised for their work, and alongside the #Review parameters, help end-users determine how likely it is that the content is still relevant.
- update-by=Update author in format [[User:hamishwillee]]
- update-timestamp=Update timestamp, format YYYYMMDD
Translation
Translated articles should use the following additional parameters to record the translator and translation version information. Note that these create links to the actual translated version of the topic:
- translated-by= Link to the translator user id - e.g. [[User:hamishwillee|hamishwillee]]
- translated-from-title= Name of original article: "Article Title"
- translated-from-id= Id of translated page. If the URL of the revision in History tab ends in &oldid=111747, the id is 111747
If (and ONLY if) article an article is translated from an off-wiki topic fill in:
- translated-from-title= Name of original article: "Article Title"
- translated-from-url= Url of translated article
Miscellaneous
- language: Category code for the natural language (e.g. Lang-Portuguese, Lang-Chinese) to display the template in that language. Default is English.
- keywords: APIs, classes and methods of related articles
Testing
These option parameters allow you to specify the actual devices and platforms you tested against (and know it to work for) and the ones you expect it to work against. To make it easier for users, also provide link to the SDK you used to build this against.
- devices: Devices actually tested against. For example Nokia Lumia 920. We prefer the full name of the device, but shorthand is "better than nothing".
- sdk: Actual SDK(s) built and tested against, most recent first
Compatibility
- platform: Compatible platforms - e.g. Windows Phone 8 and later, Nokia Asha Platform 1.0 and later
- dependencies: Any other compatibility/dependency information not captured by above. For example dependency on an external API like Google Maps or a particular non-Nokia framework library.
Platform Security
Applies to secure platforms only (e.g. Symbian)
- signing: What level of signing is required, if any
- capabilities: Security "Capabilities" required by the article/code example (e.g. ID_CAP_LOCATION, ID_CAP_NETWORKING, NetworkServices).
Downloads
These parameters provide direct links to downloads (source or installation files) associated with the article.
- sourcecode: Link to example source code e.g. Media:The Code Example ZIP.zip
- installfile: Link to installation file (e.g. Media:The Installation File.sis)
Deprecated
These parameters are deprecated, and will not be displayed even if declared
- category
- subcategory
- id: Knowledge-base identifier. No longer used
|devicecompatability= - never used properly
Articles which use this template
Note, this depends on Template:ArticleMetaData.dpl
Translations
This template passes all the template parameters to an underlying "template". If a particular translation exists then it will be selected. Otherwise the /default page is used. Below are the current translation pages.
- Template:ArticleMetaData/default
- Template:ArticleMetaData/id
- Template:ArticleMetaData/pt
- Template:ArticleMetaData/ru
- Template:ArticleMetaData/zh-hans
To translate this template:
- add a sub page to this template (by convention (only) the sub page should be named with the language code (ie de for German).
- Copy the content of the /default page into your new page and translate the visible strings.
- Open this page and add a new value to the switch indicating the mapping between the language category and your sub page name
Template appearance
When added to an article, the header is displayed on the top right of the article, along with any information entered when the template was created. Note that parameters with no content are not displayed.
(no comments yet)