Touhou Patch Center:Tutorial: Difference between revisions
(What, this hasn't been translatable?!) |
(Marked this version for translation) |
||
Line 2: | Line 2: | ||
<languages /> | <languages /> | ||
<translate> | <translate> | ||
<!--T:1--> | |||
Since translators are by far the most important people in this fandom, we made the process as simple as possible. | Since translators are by far the most important people in this fandom, we made the process as simple as possible. | ||
==Register/Logging in== | ==Register/Logging in== <!--T:2--> | ||
#First, [{{fullurl:Special:UserLogin|type=signup}} create an account] by going towards the top right link (or clicking the hyperlink).<br />If you already have an account, skip to step two. | #First, [{{fullurl:Special:UserLogin|type=signup}} create an account] by going towards the top right link (or clicking the hyperlink).<br />If you already have an account, skip to step two. | ||
#[[Special:UserLogin|Log into your account]] with your username and password which will be located in the same place the registration was. <br /> (or click the hyperlink) | #[[Special:UserLogin|Log into your account]] with your username and password which will be located in the same place the registration was. <br /> (or click the hyperlink) | ||
===Changing the site language=== | ===Changing the site language=== <!--T:3--> | ||
The language of the site ''interface'' automatically defaults to the preferred content language set in your browser settings. This setting is also used to set the initial target language in the translation menu. Thus, we recommend changing it to the language you want to translate into - this way, you won't accidentally overwrite existing translations for another language. | The language of the site ''interface'' automatically defaults to the preferred content language set in your browser settings. This setting is also used to set the initial target language in the translation menu. Thus, we recommend changing it to the language you want to translate into - this way, you won't accidentally overwrite existing translations for another language. | ||
<!--T:4--> | |||
To change this setting, click the Language Selector (the <span class="field"><span id="pt-kieli"></span> {{int:kieli-load}}</span> button at the top of the page) and enter the native name of your language, or its [[w:List_of_ISO_639-1_codes|ISO 639-1 code]]. | To change this setting, click the Language Selector (the <span class="field"><span id="pt-kieli"></span> {{int:kieli-load}}</span> button at the top of the page) and enter the native name of your language, or its [[w:List_of_ISO_639-1_codes|ISO 639-1 code]]. | ||
<!--T:5--> | |||
This setting is stored as a cookie and saved to your user account if you're logged in. | This setting is stored as a cookie and saved to your user account if you're logged in. | ||
==Starting a translation into a language not yet on the site== | ==Starting a translation into a language not yet on the site== <!--T:6--> | ||
Most of the time, this is no problem. Just select the language like you normally would, and the administration will create the necessary links and portal pages for integration into the [[Touhou Community Reliant Automatic Patcher]] shortly after. | Most of the time, this is no problem. Just select the language like you normally would, and the administration will create the necessary links and portal pages for integration into the [[Touhou Community Reliant Automatic Patcher]] shortly after. | ||
<!--T:7--> | |||
In case your desired language is not present in the list, simply leave a message on the [[Talk:{{ns:4}}#Language requests|main talk page]]. Setting up a new language is a very quick process. | In case your desired language is not present in the list, simply leave a message on the [[Talk:{{ns:4}}#Language requests|main talk page]]. Setting up a new language is a very quick process. | ||
==Editing text translations== | ==Editing text translations== <!--T:8--> | ||
<div style="float:right;">{{{{ns:4}}:Translation progress}}</div> | <div style="float:right;">{{{{ns:4}}:Translation progress}}</div> | ||
#Go to [[{{ns:4}}|the main page]] which can accessed at anytime by clicking the logo.<br /> (Or again, click the hyperlink) | #Go to [[{{ns:4}}|the main page]] which can accessed at anytime by clicking the logo.<br /> (Or again, click the hyperlink) | ||
Line 31: | Line 35: | ||
#Then, just follow steps 6 + 7 for the remainder of the boxes. | #Then, just follow steps 6 + 7 for the remainder of the boxes. | ||
<!--T:9--> | |||
<div style="clear: both;"></div> | <div style="clear: both;"></div> | ||
===Things to know=== | ===Things to know=== <!--T:10--> | ||
* If you're translating from another translation (most likely English), be sure to add the wiki page of this translation to your watchlist by clicking the star next to the search bar on the top. This will send you a notification whenever something has been changed and needs to be reflected in your language. | * If you're translating from another translation (most likely English), be sure to add the wiki page of this translation to your watchlist by clicking the star next to the search bar on the top. This will send you a notification whenever something has been changed and needs to be reflected in your language. | ||
* If '''any''' text of an existing translation (again, most likely English) would not change in your translation, '''leave the respective box empty''' and don't copy-paste the text. This way, everyone can take full advantage of [[Project:Patch stacking|patch stacking]]. | * If '''any''' text of an existing translation (again, most likely English) would not change in your translation, '''leave the respective box empty''' and don't copy-paste the text. This way, everyone can take full advantage of [[Project:Patch stacking|patch stacking]]. | ||
Line 43: | Line 48: | ||
Since these do not show up in replays, the patcher can provide an unlimited amount of text lines here. | Since these do not show up in replays, the patcher can provide an unlimited amount of text lines here. | ||
<!--T:11--> | |||
* There can always be a maximum of 5 lines at the screen at any time. | * There can always be a maximum of 5 lines at the screen at any time. | ||
** For {{GameLabel|th06}}, {{GameLabel|th07}}, {{GameLabel|th08}}, and {{GameLabel|th09}}, automatic line breaks are inserted in case the line doesn't fit. | ** For {{GameLabel|th06}}, {{GameLabel|th07}}, {{GameLabel|th08}}, and {{GameLabel|th09}}, automatic line breaks are inserted in case the line doesn't fit. | ||
Line 48: | Line 54: | ||
** Trying to print a 6th line {{GameLabel|th10}} and later automatically clears all lines and displays the new one in the first line. No wait instruction is inserted when this happens - anything in that translation segment before this new first line will effectively not be visible. | ** Trying to print a 6th line {{GameLabel|th10}} and later automatically clears all lines and displays the new one in the first line. No wait instruction is inserted when this happens - anything in that translation segment before this new first line will effectively not be visible. | ||
<!--T:12--> | |||
Character name translations are automatically taken from the [{{fullurl:Special:Translate|group=chars}} respective translation group]. | Character name translations are automatically taken from the [{{fullurl:Special:Translate|group=chars}} respective translation group]. | ||
==Editing graphics== | ==Editing graphics== <!--T:13--> | ||
Compared to the simple translation of plain text, multilingual image translation requires a rather involved workflow: | Compared to the simple translation of plain text, multilingual image translation requires a rather involved workflow: | ||
* (Optimally, the original text should be transcribed first.) | * (Optimally, the original text should be transcribed first.) | ||
Line 58: | Line 65: | ||
* Finally, the translated text needs to be edited into the base image, taking possible sprite boundary limits imposed by the game into account. (As of now, we couldn't change those limits without including the whole ANM file with all its original uncompressed image data, which would unnecessarily bloat the size of the patches.) | * Finally, the translated text needs to be edited into the base image, taking possible sprite boundary limits imposed by the game into account. (As of now, we couldn't change those limits without including the whole ANM file with all its original uncompressed image data, which would unnecessarily bloat the size of the patches.) | ||
=== Fonts === | === Fonts === <!--T:14--> | ||
Fonts should ideally have a sufficiently large Unicode coverage so that the same template can be used across multiple languages. | Fonts should ideally have a sufficiently large Unicode coverage so that the same template can be used across multiple languages. | ||
<!--T:15--> | |||
Unfortunately, the most appropriate fonts often happen to have a rather limited coverage - and finding one that looks similar and has a wider coverage can be an arduous, if not impossible task. | Unfortunately, the most appropriate fonts often happen to have a rather limited coverage - and finding one that looks similar and has a wider coverage can be an arduous, if not impossible task. | ||
<!--T:16--> | |||
:''Hence, you don't '''need''' to care about this for any other language than your own (but other translators would certainly appreciate it if you did).'' | :''Hence, you don't '''need''' to care about this for any other language than your own (but other translators would certainly appreciate it if you did).'' | ||
<!--T:17--> | |||
A consistent appearance across the languages would surely be nice thing to have, but this is '''not''' a requirement or official policy - each language is still free to choose whatever fonts the editors prefer. | A consistent appearance across the languages would surely be nice thing to have, but this is '''not''' a requirement or official policy - each language is still free to choose whatever fonts the editors prefer. | ||
<!--T:18--> | |||
If you ''do'' care, here's a test string with characters from some of our active languages which might be problematic, for your convenience: | If you ''do'' care, here's a test string with characters from some of our active languages which might be problematic, for your convenience: | ||
<!--T:19--> | |||
<pre> | <pre> | ||
áéíóúàèìòùâêäëïöüãñõőűąęłż | áéíóúàèìòùâêäëïöüãñõőűąęłż | ||
Line 77: | Line 89: | ||
</pre> | </pre> | ||
== Efficiently testing translations in-game == | == Efficiently testing translations in-game == <!--T:20--> | ||
Select the <tt>skipgame</tt> patch in addition to your translation to remove all gameplay sections and reduce spell cards to a few seconds. This leaves only the dialogue and spell card names and allows you to quickly proofread everything without spending time on dodging bullets. | Select the <tt>skipgame</tt> patch in addition to your translation to remove all gameplay sections and reduce spell cards to a few seconds. This leaves only the dialogue and spell card names and allows you to quickly proofread everything without spending time on dodging bullets. | ||
<!--T:21--> | |||
The separate <tt>instant_ending</tt> allows you to access all endings by making one single gameplay choice in one stage. | The separate <tt>instant_ending</tt> allows you to access all endings by making one single gameplay choice in one stage. | ||
</translate> | </translate> | ||
[[Category:Project overview]] | [[Category:Project overview]] |
Revision as of 08:41, 17 August 2018
Project overview | ||||||
---|---|---|---|---|---|---|
About | Tutorial | FAQ | Download | Patch servers | Bug tracker | Wiki security |
Since translators are by far the most important people in this fandom, we made the process as simple as possible.
Register/Logging in
- First, create an account by going towards the top right link (or clicking the hyperlink).
If you already have an account, skip to step two. - Log into your account with your username and password which will be located in the same place the registration was.
(or click the hyperlink)
Changing the site language
The language of the site interface automatically defaults to the preferred content language set in your browser settings. This setting is also used to set the initial target language in the translation menu. Thus, we recommend changing it to the language you want to translate into - this way, you won't accidentally overwrite existing translations for another language.
To change this setting, click the Language Selector (the ⧼kieli-load⧽ button at the top of the page) and enter the native name of your language, or its ISO 639-1 code.
This setting is stored as a cookie and saved to your user account if you're logged in.
Starting a translation into a language not yet on the site
Most of the time, this is no problem. Just select the language like you normally would, and the administration will create the necessary links and portal pages for integration into the Touhou Community Reliant Automatic Patcher shortly after.
In case your desired language is not present in the list, simply leave a message on the main talk page. Setting up a new language is a very quick process.
Editing text translations
Other translatable content | Languages with >95% coverage | Languages started & in progress |
• Hardcoded strings | ||
• Hardcoded ASCII strings | ||
• Game titles | ||
Music titles (overview) • (translation) | ||
Page interface | ||
Character names (transliterations) |
- Go to the main page which can accessed at anytime by clicking the logo.
(Or again, click the hyperlink) - Choose a game you wish to translate.
On the right, you can see the list of translatable games, their progress in the respective languages, and whether they are finished. - Choose a piece of translatable content you want to work on.
Click on the small Translate this page label at the top of that page (Translate this page in your language).
If the page you are on already has a translation, it will instead say
This page is a translated version of the page X and the translation is X% complete.
In that case, the first link will bring you to the translation interface.
- Verify that the correct language you want to translate into is selected in the Language drop-down menu.
This will automatically be set to the language of the site interface. If you had to change it, don't forget clicking Fetch afterwards. - Double-click the message boxes and begin typing your translation in.
- Hit Save.
- Then, just follow steps 6 + 7 for the remainder of the boxes.
Things to know
- If you're translating from another translation (most likely English), be sure to add the wiki page of this translation to your watchlist by clicking the star next to the search bar on the top. This will send you a notification whenever something has been changed and needs to be reflected in your language.
- If any text of an existing translation (again, most likely English) would not change in your translation, leave the respective box empty and don't copy-paste the text. This way, everyone can take full advantage of patch stacking.
- Refer to your language's portal page for stylistic guidelines.
Dialog
- Line breaks are never done automatically. It's up to you to make sure that the text fits into the dialog box.
- You can always use a maximum of two lines for every message box, even if there is only one line in the original. The opposite is also true. We went to great lengths to make this possible, so please do make use of this. ☺
Endings
Since these do not show up in replays, the patcher can provide an unlimited amount of text lines here.
- There can always be a maximum of 5 lines at the screen at any time.
- For Embodiment of Scarlet Devil, Perfect Cherry Blossom, Imperishable Night, and Phantasmagoria of Flower View, automatic line breaks are inserted in case the line doesn't fit.
- Trying to print a 6th line these games will also insert a wait instruction and page break.
- Trying to print a 6th line Mountain of Faith and later automatically clears all lines and displays the new one in the first line. No wait instruction is inserted when this happens - anything in that translation segment before this new first line will effectively not be visible.
Character name translations are automatically taken from the respective translation group.
Editing graphics
Compared to the simple translation of plain text, multilingual image translation requires a rather involved workflow:
- (Optimally, the original text should be transcribed first.)
- A basic image editing project needs to be created, erasing the original text, recreating possible backgrounds and selecting appropriate fonts.
- The required fonts should be noted down so that the editors for other languages can obtain them.
- The original text needs to be translated.
- Finally, the translated text needs to be edited into the base image, taking possible sprite boundary limits imposed by the game into account. (As of now, we couldn't change those limits without including the whole ANM file with all its original uncompressed image data, which would unnecessarily bloat the size of the patches.)
Fonts
Fonts should ideally have a sufficiently large Unicode coverage so that the same template can be used across multiple languages.
Unfortunately, the most appropriate fonts often happen to have a rather limited coverage - and finding one that looks similar and has a wider coverage can be an arduous, if not impossible task.
- Hence, you don't need to care about this for any other language than your own (but other translators would certainly appreciate it if you did).
A consistent appearance across the languages would surely be nice thing to have, but this is not a requirement or official policy - each language is still free to choose whatever fonts the editors prefer.
If you do care, here's a test string with characters from some of our active languages which might be problematic, for your convenience:
áéíóúàèìòùâêäëïöüãñõőűąęłż ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩ αβγδεζηθικλμνξοπρστυφχψω АБВГДЕЖЗИЙКЛМНОӨПРСТУҮФХЦЧШЩЪЫЬЭЮЯ абвгдежзийклмноөпрстуүфхцчшщъыьэюя
Efficiently testing translations in-game
Select the skipgame patch in addition to your translation to remove all gameplay sections and reduce spell cards to a few seconds. This leaves only the dialogue and spell card names and allows you to quickly proofread everything without spending time on dodging bullets.
The separate instant_ending allows you to access all endings by making one single gameplay choice in one stage.