This article describes how to set up a Whats New page for all languages. Working on the Whats New pages can count towards your Scribe tier (see Contributor Tier & Rewards). If you require assistance, please ask in the Wizards of the Wiki guild.
- 1 Layout & Text Requirements
- 2 Setting up
- 3 Contributor Tier Process
- 4 See Also
Layout & Text Requirements[edit | edit source]
For the English version, the text is in American English, which should be copied to exactly match the Bailey announcements.
All Linguists should be fluent in the language they are translating to. It is better to have no translation (the English version is the default) than a bad translation because poor quality translations result in complaints and can damage Habitica's reputation. Please do not supply translations by using Google Translate or similar services.
When translating text, please refer to Weblate for items within Habitica, e.g. equipment, backgrounds, hatching potions, quests, etc. If no version exists within Weblate, please add it and the translation. This will hopefully ensure the translation is uniform from within the game and wiki.
Dates[edit | edit source]
For the English version, dates should appear in the American Format: mm/dd/yyyy. The date should match the date of the announcement. GitHub. For non-English formats, base the date on the culturally relevant format.
Images[edit | edit source]
Image names must match the names used in the GitHub (Promo Images). Images for the English version must also match the same position as the Bailey announcement, with the TOC closed. For all other languages, it is best to match as closely as possible within reason, given the translated text.
Note that if the newest images are not available in the development tree (linked in the paragraph above), you may be able to find them in the release tree, particularly in the case of minor updates.
Spacing[edit | edit source]
- Wording should appear immediately after headings, except for months and dividing breaks.
- The title for the news appear after the date in ALL CAPS.
- A space always appears before heading.
- A space always appears after a line break (
- Comments/onlyinclude and other tags are counted as a space.
- Images should be included on the first line directly under the header.
- For the English version, ensure to only have one post in the onlyinclude section. The onlyinclude section is not included in translated news.
Month Sections[edit | edit source]
Once the first article of the new month appears, a new month section is required. For January, see the New Year Checklist Section below. A sample of code for November 2016 is below:
<div class="mw-collapsible mw-collapsed" data-expandtext="See November 2016 News" data-collapsetext="Hide November 2016 News">
LAST CHANCE FOR NOVEMBER SUBSCRIBER ITEMS, AND HABITICA T-SHIRTS AND MUGS REMINDER-
====Last Chance for Cornucopia Set====-
Lot of text for each section
by the Habitica Team-
News By[edit | edit source]
The NewsBy template is used to ensure correct formatting when including who an announcement was created by, who the included writing was written by (if any), and who the included art was drawn by (if any). For languages other than English the template name is
Template:NewsBy [two letter language code]. For example, the French template name is Template:NewsBy fr.
The template should be included wherever the original announcement includes who the content was created by (usually at the end of a section or the entire announcement). To include the template, copy and paste the template code on the respective template page and insert the appropriate names in place of the examples.
When translating, the only thing that will need to be changed when copying the English announcement is to change the NewsBy template name to your language by adding the two letter code, and translating the and.
| by = Beffymaroo and SabreCat
| ArtBy = Uncommon Criminal, InspectorCaracal, Leephon, aurakami, FuzzyTrees, PainterProphet, and plumilla
| WritingBy = Daniel the Bard, Flutter Bee, and Lemoness
Only needs to be changed to this:
| by = Beffymaroo et SabreCat
| ArtBy = Uncommon Criminal, InspectorCaracal, Leephon, aurakami, FuzzyTrees, PainterProphet, et plumilla
| WritingBy = Daniel the Bard, Flutter Bee, et Lemoness
To show this:
par Beffymaroo et SabreCat
Ecriture par Daniel the Bard, Flutter Bee, et Lemoness
Art par Uncommon Criminal, InspectorCaracal, Leephon, aurakami, FuzzyTrees, PainterProphet, et plumilla
That is, the by, ArtBy and WritingBy were not translated.
Finding Historic Bailey Announcements[edit | edit source]
Bailey messages after October 6, 2020 are available through the Application Programming Interface, in raw HTML format:
- The most recent Baily announcement is available at: https://habitica.com/api/v3/news
- Older messages are available through the following format:
At the time of this posting, these are all pages available, but in the future, increasing the page number in the link format should obtain older messages.
Setting up[edit | edit source]
English[edit | edit source]
The current year is
Whats New [YYYY], e.g. Whats New 2019.
Other Languages Than English[edit | edit source]
The name of the pages for non-English pages is
Whats new [two letter language code] [YYYY], e.g. Whats new fr 2017. Please note the new uses a lowercase n, not an uppercase N as per the English version.
Please see this reference for the two letter language codes.
A redirect may need to be set up for
Whats new [two letter language code] to point to the latest year that is translated, e.g. Whats new fr.
Creating year template[edit | edit source]
At the top of each Whats New page a template shows all the years available. For example, the English one is: Template:List of News Pages. Each year template should have all years. If there is not yet a translated page for that year, point to the English version for the time being.
The naming convention for non-English templates is
Template:List of News Pages [two letter language code], e.g. Template:List of News Pages de.
Adding a Language to the Language Templates[edit | edit source]
Each year has it own language bar to represent the languages translated.
For the new year, a new language bar is required, showing the languages that need to be translated.
- All languages flag files are in the format of
Language_[two letter language code].png
- The name of the country is in its own language, not English.
Index[edit | edit source]
Category[edit | edit source]
All news pages are added to the Category:News
New Year Checklist[edit | edit source]
- On the previous year, remove the current news section and create the December month section, with the show/hide option.
- Create a new Whats New page for the new year in your language.
- Add it to the Category:News.
- Add the new page to the Index.
- Create/update the language template for the year with your language.
- Update the Template:List of News Pages with the new year.
- Update the redirect Whats New page(s), i.e. Whats New/Whats new or
Whats new [two letter language code]to point to the new year.
- Update all previous years in that language to reflect the new year created in the Bailey message.
Creating a NewsBy template[edit | edit source]
To create a NewsBy template for a new language, first click the Add button in the top right of any wiki page. The page title should follow the format
Template:NewsBy [two letter language code] (see this reference for the two letter language codes). For example, the French template name is Template:NewsBy fr. When prompted, choose the blank page layout and the Design template type. Once the page is created, open the English NewsBy template and click the Edit button at the top right. Select and copy all of the text and paste it into the new template.
On the new template, translate the text directly after
<font size="2"> into your language. Change
NewsBy [two letter language code]. Translate all instances of the word "and" into your language. Leave the rest of the code intact, and then click Publish when you are finished.