Changes between Version 1 and Version 2 of i18n/tok/StyleGuide


Ignore:
Timestamp:
Nov 24, 2021, 7:38:49 PM (3 years ago)
Author:
LianBg
Comment:

Basic information and style guide

Legend:

Unmodified
Added
Removed
Modified

  • i18n/tok/StyleGuide

    v1 v2  
    1 ''Template for i18n/LANG/StyleGuide. Translate, adjust and improve as you see fit.''
     1= Rules for translating and style in Toki Pona =
    22
    3 ----
    4 
    5 = Rules for translating and style =
     3Welcome to the Toki Pona translation of Haiku!
    64
    75To achieve a consistent result, all translators have to respect a few rules.
     6For a language as context-dependent as Toki Pona, this is especially important.
    87
    98== 1. Don't change the formatting ==
    109 All HTML tags used in the English Original, like <span class="menu">, <i>, <b>, as well as links etc. have to be used as well. Only the contents within these tags have to be translated.
    1110
    12 == 2. Addressing the reader ==
    13  ''Do you use formal language or more casual? Do you use active or passive? Are there other things specific to your language? Discuss on the mailing list and give examples for every rule. Like:''
     11== 2. Golden Rules of Toki Pona Translation for Haiku ==
     121. We **DO** use lower case in all cases except for proper nouns and loan words. Yes, even at the beginning of phrases.
     132. We do **NOT** tokiponize app names, loan words or proper nouns/monikers in general. Names of countries and languages use the Toki Pona version though (e.g. toki Tosi = German). This includes very tech-specific terms like file formats (sitelen Bitmap) or units (nanpa Byte).
     144. We **DO** use words from the Official Toki Pona Dictionary (''ku'') whereever applicable.
     155. Multiple variations for the same lexicon entry are **fine to use** interchangeably based on sentence flow or string length limitations (e.g. sin/namako, lukin/oko)
    1416
    15 ||'''Bad:'''||"Yo, mofu, check this crazy ass shit out..."||
    16 ||'''Good:'''||"Let's have a look at this extraordinary feature, old chap."||
     17== 3. Grammar Conventions ==
     181. Progressive: li <verb>\\// Example: "searching..." > "li alasa..."
     192. Lonely transitive verbs: <verb> e\\// Example: "contains" > "jo e"
     203. Imperatives/Choices: o <word>\\// Example: "Continue" > "o pali" or "Delete" > "o weka"    >> This only applies when the action results in direct action, like in "Delete". Otherwise, like in "OK", just write the word.
     21
     22== 4. Numbers, dates, times ==
     231. In general, we use numerics, not the cumbersome counting system (luka luka luka luka luka... no.). So, "3 files in this directory" gets translated as "lipu 3 lon poki ni"
     242. The date format is as follows: "t.sk. #2020; t.s. #22; t.m. #3" (or long: "tenpo suno #22 pi tenpo mun #3 pi tenpo sike #2020" represents the 22nd of March, 2020. If that's too long for a string, go ahead and use standard YYYY/MM/DD formats.
     253. The time format is similar: "tenpo 8 pini" = 8 minutes; "tenpo 11:52" = 11:52 AM (we use a 24 hour clock, so tenpo 22:52 = 10:52pm)
     26
     27== 5. Terminology ==
     28You can find a list of established terminology at https://dev.haiku-os.org/wiki/i18n/tok/Terminology . Please always refer to that wiki page before translating something non-trivial. It helps using CTRL+F.