ምትካልን ምጥቃምን።

ዊንዶውስ መጀመርታ git bash ይተክል

windows ፡ መጀመርታ git bash ንምውራድን ንምጽዓንን ኣብዚ ጠውቑ .

ስዒቡ ዝመጽእ ስርሓት ኣብ git bash ኣካይድ።

ምግጣም

bash <(curl -sS https://i.i18n.site) i18

ናይ ትርጉም ምልክት ምውቃር

Visit i18n.site/token ቶከን ንምቕዳሕ ጠውቑ

~/.config/i18n.site.yml ምፍጣር ፣ ዝተቐድሐ ትሕዝቶ ኣብኡ ምልጣፍ፣ ትሕዝቶ ከምዚ ዝስዕብ እዩ፤

token: YOUR_API_TOKEN

i18n.site/payBill , ንኽፍሊት ክረዲት ካርድ ክትኣስር ኣለካ (ዳግማይ ምኽፋል ኣየድልን እዩ፣ እቲ መርበብ ሓበሬታ ብመሰረት ኣጠቓቕማ ብኣውቶማቲክ ክፍሊት ክጎድል እዩ፣ ንዋጋ ኣብ መእተዊ ገጽ ርአ )።

ጥቅሚ

ዲሞ ፕሮጀክት

ናይ i18 ትርጉም ውቅር ንምፍላጥ በጃኹም ኣብቲ ናይ ዲሞ ፕሮጀክት ተወከሱ github.com/i18n-site/demo.i18

ኣብ ቻይና ዘለዉ ተጠቀምቲ ክሎን ክገብሩ ይኽእሉ atomgit.com/i18n/demo.i18

ድሕሪ ክሎኒንግ ኣብቲ ማህደር ኣቲና i18 ብምጉያይ ትርጉም ንውድእ።

ኣቃውማ ማህደር

እቲ ናይ ቅጥዒ መኽዘን ማህደር ኣቃውማ ከምዚ ዝስዕብ እዩ።

┌── .i18n
│  └── conf.yml
└── en
   ├── _IgnoreDemoFile.md
   ├── i18n.yml
   └── README.md

ኣብ en ማህደር ዝርከቡ ዝተተርጎሙ ዲሞ ፋይላት ኣብነት ጥራይ ኮይኖም ክስረዙ ይኽእሉ።

ትርጉም ኣካይድ

ኣብቲ ማህደር ኣቲኻ i18 ብምጉያይ ክትትርጉሞ።

ብዘይካ እቲ ትርጉም እቲ ፕሮግራም .i18n/data ፎልደር እውን ክፈጥር እዩ፣ በጃኹም ናብቲ መኽዘን ወስኹዎ።

ድሕሪ ምትርጓም ሓድሽ ፋይል ኣብዚ ማህደር ሓድሽ ዳታ ፋይል ክፍጠር እዩ git add . ክትውስኽ ኣይትረስዕ።

ናይ ውቅር ፋይል

.i18n/conf.yml ናይቲ i18 ናይ ትእዛዝ መስመር ትርጉም መሳርሒ ናይ ውቅር ፋይል እዩ።

ትሕዝቶኡ ከምዚ ዝስዕብ ይመስል፤

i18n:
  fromTo:
    en: zh ja ko de fr
    # en:

ignore:
  - _*

ምንጪ ቋንቋ &

ኣብቲ ናይ ውቅር ፋይል፡ እቲ ትሕተ-ቅርጺ ናይ fromTo :

en ምንጪ ቋንቋ እዩ፣ zh ja ko de fr ዕላማ ቋንቋ ናይቲ ትርጉም እዩ።

ኮድ ቋንቋ ርአ i18n.site/i18/LANG_CODE

ንኣብነት ንቻይንኛ ናብ እንግሊዝኛ ክትትርጉሞ እንተደሊኻ ነዛ መስመር zh: en ዳግማይ ጽሓፋ።

ናብ ኩሎም ዝድገፉ ቋንቋታት ክትትርጉም እንተደሊኻ፡ በጃኻ ድሕሪ : ባዶ ግደፎ። ንኣብነት

i18n:
  fromTo:
    en:

ንዝተፈላለዩ ንኡሳን ማህደር ዝተፈላለዩ fromTo ክትውቅሩ ትኽእሉ ኢኹም መርኣያ ከምዚ ዝስዕብ ይጽሓፍ : /

i18n:
  fromTo:
    en:
  path:
    blog:
      fromTo:
        zh:
    blog/your_file_name.md:
      fromTo:
        ja:

ኣብዚ ናይ ውቅር ሰሌዳ፡ ምንጪ ቋንቋ ናይ ካታሎግ blog ትርጉም zh ክኸውን ከሎ፡ ምንጪ ቋንቋ ናይ ካታሎግ blog/your_file_name.md ትርጉም ድማ ja እዩ።

ብዙሕ ቋንቋታት ዘለዎም ምስልታት/መላግቦታት

ኣብ ስእልታት ዝርከቡ URLsን ኣብ replace: ን MarkDown ዘለዉ መላግቦታትን (ከምኡ’ውን ናይ embedded HTML src ን href ን ባህርያት) በዚ ቅድመ-ጥብቆ ኣብ .i18n/conf.yml ምስ ዝውነኑ፡ እቲ ኣብቲ URL ዘሎ ምንጪ ቋንቋ ኮድ ብናይ ቋንቋ ኮድ ናይቲ ትርጉም ( ቋንቋ) ይትካእ ዝርዝር ኮድ ).

ንኣብነት ውቅርካ ከምዚ ዝስዕብ እዩ፤

i18n:
  fromTo:
    fr: ko de en zh zh-TW uk ru ja
  replace:
    https://fcdoc.github.io/img/ : ko de uk>ru zh-TW>zh >en

replace: መዝገበ ቃላት እዩ፣ እቲ መፍትሕ እቲ ክትካእ ዘለዎ ቅድመ-ጥብቆ URL እዩ፣ እቲ ዋጋ ድማ እቲ ናይ ምትካእ ሕጊ እዩ።

ኣብ ላዕሊ ዘሎ ሕጊ ko de uk>ru zh-TW>zh >en ምትካእ ትርጉም ko de ናይ ገዛእ ርእሶም ናይ ቋንቋ ኮድ ስእሊ ይጥቀሙ፣ zh-TW ን zh ን ናይ zh ስእሊ ይጥቀሙ፣ uk ናይ ru ስእሊ ይጥቀሙ፣ ካልኦት ቋንቋታት (ከም ja ) ድማ ነቲ ስእሊ ይጥቀሙ ናይ en ብነባሪ።

ንኣብነት ናይ ፈረንሳ ( fr ) ምንጪ ፋይል MarkDown ከምዚ ዝስዕብ :

![xx](//i18n-img.github.io/fr/1.avif)
<video src="https://i18n-img.github.io/fr/1.mp4"></video>
[xx](//i18n-img.github.io/fr/README.md)
<a style="color:red" href="https://i18n-img.github.io/fr/i18n.site.gz">xx</a>

እቲ ዝተተርጎመን ዝተፈጠረን ናይ እንግሊዝኛ ( en ) ፋይል ከምዚ ዝስዕብ ኢዩ :

![xx](//i18n-img.github.io/en/1.avif)
<video src="https://i18n-img.github.io/en/1.mp4"></video>
[xx](//i18n-img.github.io/en/README.md)
<a style="color:red" href="https://i18n-img.github.io/en/i18n.site.gz">xx</a>

ኣብዚ፡ ኣብቲ ምንጪ ቋንቋ ኮድ ዘለዉ /en/ ፡ ኣብቲ ዕላማ ዝኾነ ቋንቋ ብ /zh/ ይትክኡ።

መተሓሳሰቢ : ኣብቲ URL ቅድሚን ድሕሪን ናይ ቋንቋ ኮድ ናይቲ ዝተተክአ ጽሑፍ / ክህሉ ኣለዎ።

[!TIP] - / ኣብ url: እንተተዋቒሩ፡ ተዛማዲ መንገድታት ጥራይ ክመዓራረዩ እዮም፡ ብ // ዝጅምሩ URL ግን ኣይመሳሰሉን እዮም።

ገለ መላግቦታት ናይ ሓደ ስም ዓውዲ ክቕየሩ እንተደልዮም ገሊኦም ድማ ክቕየሩ እንተዘይደልዩ፡ ንምፍላይ ዝተፈላለዩ ቅድመ-ጥብቆታት ከም [x](//x.com/en/) ን [x](//x.com/en/) ን ክትጥቀም ትኽእል ኢኻ።

ፋይል ሸለል ምባል

ብነባሪ መልክዑ፡ ኩሎም ኣብቲ ምንጪ ቋንቋ ማህደር ብ .md ን .yml ን ዝጅምሩ ፋይላት ክትርጎሙ እዮም።

ንገለ ፋይላት ሸለል ኢልካ ዘይትትርጉሞም እንተደሊኻ (ከም ዘይተዛዘሙ ረቂቕ)፡ በቲ ignore ዓውዲ ክትውቅሮ ትኽእል ኢኻ።

ignore ከምቲ ናይ .gitignore ፋይል ስነ-ቓል ይጥቀም globset

ንኣብነት ኣብዚ ኣብ ላዕሊ ዘሎ ናይ ውቅር ፋይል _* ማለት ብ _ ዝጅምሩ ፋይላት ኣይትርጎሙን ማለት እዩ።

ሕግታት ትርጉም

ኣዳለውቲ ትርጉም መስመራት ክውስኹ ወይ ክድምስሱ የብሎምን።

እቲ ትርጉም ክእረም ዝኽእል እዩ። ነቲ መበቆላዊ ጽሑፍ ኣመሓይሽዎን እንደገና ብማሽን ተርጒምዎን፡ እቲ ብኢድ ዝግበር ምምሕያሻት ናይቲ ትርጉም ኣይክጽሓፍን እዩ (እዚ ሕጡበ-ጽሑፍ ናይቲ መበቆላዊ ጽሑፍ እንተዘይተቐይሩ)።

[!WARN] መስመራት እቲ ትርጕምን እቲ መበቈላዊ ጽሑፍን ሓደ ምስ ሓደ ኺሰማማዕ ኣለዎ። ማለት ነቲ ትርጉም ክትጥርንፎ ከለኻ መስመራት ኣይትውስኽ ወይ ኣይትድምስሶ። እንተዘይኮይኑ ኣብቲ ናይ ትርጉም ኣርትዖት መኽዘን ምድንጋር ከስዕብ እዩ።

ገለ ነገር እንተተጋግዩ ፡ መፍትሒታት ንምርካብ በጃኹም ኣብቲ FAQ ተወከሱ።

YAML ትርጉማት

እቲ ናይ ትእዛዝ መስመር መሳርሒ ንኹሎም ብ .yml ዝውድኡ ፋይላት ኣብቲ ምንጪ ቋንቋ ፋይል ማህደር ረኺቡ ይትርጉሞም።

• ኣስተውዕል እቲ ድሕረ-ቃል ስም ፋይል .yml ( .yaml ዘይኮነ) ክኸውን ኣለዎ።

እቲ መሳርሒ ነቶም ናይ መዝገበ ቃላት ክብርታት ኣብ .yml ጥራይ እዩ ዝትርጉሞም እምበር ነቶም ናይ መዝገበ ቃላት መፍትሕታት ኣይትርጉሞምን።

ንኣብነት i18n/en/i18n.yml

apiToken: API Token
defaultToken: Default Token

i18n/zh/i18n.yml ተባሂሉ ክትርጎም እዩ።

apiToken: 接口令牌
defaultToken: 默认令牌

ትርጉም YAML ብኢድ እውን ክቕየር ይኽእል እዩ (ግን ኣብቲ ትርጉም መፍትሕ ወይ መስመራት ኣይትውስኹ ወይ ኣይትድምስሱ)።

ኣብ YAML ትርጉም ተመርኲስካ ንዝተፈላለዩ ቋንቋታት ፕሮግራሚንግ ብቐሊሉ ዓለምለኻዊ መፍትሒታት ክትሃንጽ ትኽእል ኢኻ።

ምዕቡል ኣጠቓቕማ

ንኡስ ማህደር ትርጉም

.i18n/conf.yml ክሳብ ዝፍጠር (ኣብ ነፍሲ ወከፍ ግዜ ካብ ዲሞ ፕሮጀክት ቴምፕሌት ምጅማር ኣየድልን) i18 ጽቡቕ ጌሩ ክሰርሕ እዩ።

እቲ መሳርሒ መስመር ትእዛዝ ኣብ ኩሎም ንኡሳን ማህደርታት .i18n/conf.yml ውቅርታት ረኺቡ ክትርጉሞም እዩ።

monorepo

ብሕታዊ ናይ ምትካል ማህደር

ብነባሪ ናብ /usr/local/bin ክተክል እዩ።

/usr/local/bin ናይ ምጽሓፍ ፍቓድ እንተዘይብሉ ናብ ~/.bin ክተክል እዩ።

ምቕማጥ ተለዋዋጢ ከባቢ TO ነቲ ናይ ምትካል ማህደር ክገልጾ ይኽእል እዩ፣ ንኣብነት :

TO=/bin sudo bash <(curl -sS https://i.i18n.site) i18