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
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 at all (the English version is used as 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, (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.
For the English version, dates should appear in the American Format: mm/dd/yyyy. For non-English formats, base the date on the culturally relevant format.
The date should match the UTC date of the announcement (at least in the English version). If you are in a different time zone, this may not be the same date as the one you see on the announcement. Bailey shows the date at publication time in the user's time zone, so users in different time zones may see different dates on the same announcement. The exact publication times can be found in the sources given in subsection Finding Historic Bailey Announcements.
In older announcements (before October 6, 2020), the date was not yet adapted to time zones. (All users saw the same date, it was simply part of the written text.) For these cases, the date should match the date written in the announcement.
For newer Bailey messages, the announcement code contains the full image URLs from which the images can be downloaded and uploaded to the wiki. For Bailey messages published before October 6, 2020, the announcement code contains only the filenames, and the image files can usually be found in the repository history on GitHub in the directory for promo images. (The path of this directory was different before October 12, 2017.) If the images are not available in the development tree, you may be able to find them in the release tree, particularly in the case of minor updates.
Image filenames on the wiki must match the filenames used in the announcement code, except for the differences generated automatically by the wiki (which turns underscores in filenames into spaces and capitalizes the first letter of the filename).
If using the same name is not possible because different images in different Bailey announcements use the same filenames in the announcement code, the year when the image version was first used should be appended to the name. (Examples: File:Promo spooky sparkles 2016.png, File:Promo spooky sparkles 2019.png, with the original filename in the announcement code being promo_spooky_sparkles.png for both 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.
- 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.
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-
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
To check for the original code or to find historical Bailey announcements on or prior to January 30, 2015, check GitHub here. Dates after January 30, 2015, but on or before September 19, 2017, can be found on GitHub here. Dates between July 20, 2017, and November 15, 2017, can also be accessed here. For dates between January 31, 2018 and October 6, 2020, check here.
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.
The current year is
Whats New [YYYY], e.g. Whats New 2019.
Other Languages Than English
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
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
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.
All news pages are added to the Category:News
New Year Checklist
- 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
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.