Changes: Asphalt Wiki:New news item

Revision as of 12:08, 4 October 2019

This page is a how-to guide detailing a practice or process on Asphalt Wiki.

You've done that before? Go ahead:

As news can appear at different places on Asphalt Wiki, they are stored in a modular template system. Every news item has its own template which contains the relevant data. The Create news button above uses the name given in the input box to create a predefined template where you can fill in title, text, author (you) and categories.

When you click the button, you will be asked to specifiy a template type. Choose "Design". (Asphalt Wiki does not use this feature.)

Naming conventions

Every template is named

News YYYY-MM-DD ##

YYYY-MM-DD: Date of the news item. Month (MM) and day (DD) are always zero-padded, for example
2019-08-05.
##: Number of the news item on that day, two digits, zero-padded. The first item of a day has 01, the second 02, and so on.

This page automatically checks if previous numbers already exist and suggests the next possible number in the input box at the top.

This works up to 10. If 10 is suggested, editors should use the Check manually link to see if there are even more than 10 items in the News templates category for that day.
To add a news item of a past day, change the name in the input box manually.
If the Create news button leads to a template that is already filled with content, a template with this name already exists. Go back to this page and check manually for the next available number of that day.

When you are on the newly generated template page with a valid template name, copy the name without the "Template:" prefix to the templatename parameter. This is important because the date of the news item is calculated from this parameter as well as some other features.

Guidelines

Be responsible! Once you have published the template, your news item goes live immediately and will be visible on all news pages throughout the wiki.
Use of links:
- A news item should contain one link that leads to a page with further details, for example, the Update page if a new update is announced.
- Links in titles are ignored. Provide them in the text parameter.
- A link should be placed within the first 200 characters of the text parameter if you want it to remain visible in the compact news feed view where the text is cut off after 250 characters.
Categorization:
- ASPHALT 8 (a8 = 1): New Asphalt 8 updates, events, gameplay changes etc.
- ASPHALT 9 (a9 = 1): New Asphalt 9 updates, events, gameplay changes etc.
- STATISTICS (statistics = 1): Pro Kit Box changes, new studies, statistics topics etc.
- ASPHALT WIKI (wiki = 1): New wiki articles, new or changed wiki features
- EDITORS (editors = 1): New or changed wiki editing and coding features

Technical details

After you click the Publish button for the first time, the news will not be displayed correctly on the template page, and it will appear in all categories instead of the ones you have chosen. You always have to click the Edit button again and publish the template a second time.

@@ Line 1: / Line 1: @@
 {{how-to}}
+{|
-{| style="vertical-align:top;"
 | style="vertical-align:top;" | You've done that before? Go ahead:
 | style="vertical-align:top;" |
@@ Line 38: / Line 38: @@
 }}
 prefix=Template:
-preload=Template:New A8box
+preload=Template:New news item
 </inputbox>
-<small>[{{Purge|Refresh}}] &#91;[[:Category:News|Check manually]]]</small>
+<small>[{{Purge|Refresh}}] &#91;[[:Category:News templates|Check manually]]]</small>
 |}
+As news can appear at different places on {{SITENAME}}, they are stored in a [[Help:News modular system|modular template system]]. Every news item has its own template which contains the relevant data. The ''Create news'' button above uses the name given in the input box to create a predefined template where you can fill in title, text, author (you) and categories.
-If you want to add a Pro Kit Box to Asphalt Wiki, you should consider not only to mention it on one page, but to fully integrate the box into the [[Help:Pro Kit Box modular system|modular system]]. This can be done by creating a template which contains all the relevant data on your Pro Kit Box.
+When you click the button, you will be asked to specifiy a template type. Choose "Design". ({{SITENAME}} does not use this feature.)
-The advantage of creating a template: Pro Kit Boxes can appear at different occasions on Asphalt Wiki:
-* They can be mentioned in the flow of an article text, for instance: {{Champion Kit Box}}.
-* They can be listed in overviews like the [[Pro Kit Box]] article or in tables.
-* They can be used on Championship, R&D, and other event pages.
+== Naming conventions ==
-If you find that some given information on your Pro Kit Box was incorrect or if the data changes (new [[drop rate]]s, for example), you would have to search the whole {{SITENAME}} for pages where your box is listed or mentioned—a procedure that means a lot of work and is highly error-prone. If templates are used, it is sufficient to change the data in the template, and all {{SITENAME}} pages will display the changes.
+Every template is named
+: <code> News YYYY-MM-DD ##</code>
+* <code>YYYY-MM-DD</code>: Date of the news item. Month (<code>MM</code>) and day (<code>DD</code>) are always zero-padded, for example<br><code>2019-08-05</code>.
-There are predefined "half-ready" pages that help you. You can use the buttons below to go through the steps and follow the instructions given on the respective new page.
+* <code>##</code>: Number of the news item on that day, two digits, zero-padded. The first item of a day has <code>01</code>, the second <code>02</code>, and so on.
+This page automatically checks if previous numbers already exist and suggests the next possible number in the input box at the top.
-== '''Template''' ==
+* This works up to <code>10</code>. If <code>10</code> is suggested, editors should use the ''Check manually'' link to see if there are even more than 10 items in the News templates category for that day.
-This special template is the "data container" for your Pro Kit Box. Before creating a template, you may want to check the [[:Category:Pro kit box templates|Pro kit box templates category]] if the template already exists. Editors can insert your box in an article by typing the box name surrounded by curly brackets <nowiki>{{ }}</nowiki> which will retrieve the data directly from the template you are creating now. Your template will also be used as a source for Pro Kit Box overviews. If you need to change the data of the box later, change this template.
+* To add a news item of a past day, change the name in the input box manually.
+* If the ''Create news'' button leads to a template that is already filled with content, a template with this name already exists. Go back to this page and check manually for the next available number of that day.
+When you are on the newly generated template page with a valid template name, copy the name without the "Template:" prefix to the <code>templatename</code> parameter. This is important because the date of the news item is calculated from this parameter as well as some other features.
-* Use the input box below to create a new template for your Pro Kit Box.
-* When you click the '''Create Pro Kit Box template''' button, you will be asked to specifiy a template type. Choose "Design".
+== Guidelines ==
-* On the new template page, change the parameters you want and click the '''Publish''' button. You do not have to fill in all box data now; you can do it later. Return to this page when you are done.
-* Follow the next step.
+* Be responsible! Once you have published the template, your news item goes live immediately and will be visible on <!-- the {{SITENAME}} main page as well as--> all news pages throughout the wiki.
+* Use of links:
+** A news item should contain one link that leads to a page with further details, for example, the Update page if a new update is announced.
+** Links in titles are ignored. Provide them in the <code>text</code> parameter.
+** A link should be placed within the first 200 characters of the <code>text</code> parameter if you want it to remain visible in the compact news feed view where the text is cut off after 250 characters.
+* Categorization:
+** <span style="background:{{cc|bg a8}};">'''&nbsp;ASPHALT 8&nbsp;'''</span> (<code>a8 = 1</code>): New Asphalt 8 updates, events, gameplay changes etc.
+** <span style="background:{{cc|a9highlight}}; color:black;">'''&nbsp;ASPHALT 9&nbsp;'''</span> (<code>a9 = 1</code>): New Asphalt 9 updates, events, gameplay changes etc.
+** <span style="background:{{cc|bg statistics}}; ">'''&nbsp;STATISTICS&nbsp;'''</span> (<code>statistics = 1</code>): Pro Kit Box changes, new studies, statistics topics etc.
+** <span style="background:{{cc|bg wiki}}; color:black;">'''&nbsp;ASPHALT WIKI&nbsp;'''</span> (<code>wiki = 1</code>): New wiki articles, new or changed wiki features
+** <span style="background:grey; color:black;">'''&nbsp;EDITORS&nbsp;'''</span> (<code>editors = 1</code>): New or changed wiki editing and coding features
+== Technical details ==
+* After you click the '''Publish''' button for the first time, the news will not be displayed correctly on the template page, and it will appear in '''all''' categories instead of the ones you have chosen. You always have to click the '''Edit''' button again and publish the template a second time.
 == See also ==