1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
|
\part{Contributor Guide}
At the time of writing, \advtrains{} uses a mostly email-based workflow. It is therefore recommended to format patches with \texttt{git-format-patch} and send them with \texttt{git-send-email}. Alternatively, if you are unable to send patches via email, you can also post patches onto the forum thread.
When sending patches, please include binary files as well instead of linking those to external sources.
\section{Code changes}
\advtrains{} uses \texttt{busted}\footnote{\url{https://olivinelabs.com/busted/}} and \texttt{mineunit}\footnote{\url{https://github.com/S-S-X/mineunit}} for unittesting. Please include unittests along with your changes if possible.
If you want to make significant changes to \advtrains{}, it is recommended to first discuss your proposal with the developers or, at least, with people who have sufficient knowledge of the part of \advtrains{} that you want to work on.
\section{Localization}
Localization files can be found in the \texttt{advtrains/locale} directory.
If there is a translation file for the target language (e.g. German), you can edit the file directly or by using the GUI included in the directory. If the translation file for the target language is absent, you can create the file by copying \texttt{template.txt} to \texttt{advtrains.\textit{XX}.tr}, with \texttt{XX} replaced by the language code of the target language.
An exception to the language code is Chinese, which has \texttt{zh\_TW} for the traditional variant and \texttt{zh\_CN} for the simplified variant.
When translating, please keep in mind that
\begin{itemize}
\item Translations should be consistent. You can look at other entries or the translation in Minetest as a reference. If you know a third language (other than English and the target language), you can also use the translation file for that language as a reference.
\item Translations do not have to fully correspond to the original text - they only need to provide the same information. In particular, translations do not have to have the same linguistical structure as the original text.
\item Abbreviations or names may or may not need to be translated. This depends on certain aspects of the target language, such as (in particular) the script used for the written form.
\item Native speakers are generally preferred. For non-native speakers, the CEFR level B2 is recommended as a reference. This is, of course, not mandatory.
\end{itemize}
At the moment, the \texttt{l10n} branch is used for managing localization. Please refer to \texttt{advtrains/locale/README.md} file in that branch for more information.
%%% Local Variables:
%%% TeX-master: "a4manual"
%%% End:
|
