Changes between Version 4 and Version 5 of i18n/tok/StyleGuide
- Timestamp:
- Nov 24, 2021, 8:51:52 PM (3 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
i18n/tok/StyleGuide
v4 v5 12 12 1. We **DO** use lower case in all cases except for proper nouns and loan words. Yes, even at the beginning of phrases. 13 13 2. 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). 14 4. We **DO** use words from the Official Toki Pona Dictionary (''ku'') whereever applicable. 15 5. 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) 14 3. 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) 16 15 17 == 3. Grammar Conventions == 16 == 3. Canonical Language == 17 For the purpose of this translation, the following sources make up the entire canonical Toki Pona language: 18 1. Toki Pona - Language of Good by Sonja Lang (the original book, pu) 19 2. The Official Toki Pona Dictionary by Sonja Lang (the dictionary, ku) 20 3. As a writing system, linja pona by janSame (https://github.com/janSame/linja-pona/) 21 22 Nothing else is canonical. 23 24 Toki Ma is explicitly **not** part of the Toki Pona canon, and neither are "nimisin"/words not found in pu or ku. 25 26 == 4. Grammar Conventions == 18 27 1. Progressive: li <verb>\\// Example: "searching..." > "li alasa..." 19 28 2. Lonely transitive verbs: <verb> e\\// Example: "contains" > "jo e" 20 29 3. 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 30 22 == 4. Numbers, dates, times ==31 == 5. Numbers, dates, times == 23 32 1. 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" 24 33 2. 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"), representing the 22nd of March, 2020. If that's too long for a string, go ahead and use standard YYYY/MM/DD formats. 25 34 3. 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 35 27 == 5. Terminology ==28 You can find a list of established terminology at https://dev.haiku-os.org/wiki/i18n/tok/Terminology 36 == 6. Terminology == 37 You 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.