ఇన్స్టాల్ చేసి ఉపయోగించుకోండి

విండోస్ మొదట గిట్ బాష్ను ఇన్స్టాల్ చేయండి

windows సిస్టమ్, దయచేసి ముందుగా git bash డౌన్లోడ్ చేసి, ఇన్స్టాల్ చేయడానికి ఇక్కడ క్లిక్ చేయండి .

తదుపరి కార్యకలాపాలను git bash లో అమలు చేయండి.

ఇన్స్టాల్ చేయండి

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

అనువాద టోకెన్ని కాన్ఫిగర్ చేయండి

టోకెన్ను కాపీ చేయడానికి క్లిక్ 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 .

బహుభాషా చిత్రాలు/లింకులు

replace: మరియు MarkDown లోని చిత్రాలు మరియు లింక్లలోని URLలు (మరియు ఎంబెడెడ్ 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 లో.

ఉదాహరణకు, MarkDown యొక్క ఫ్రెంచ్ ( fr ) సోర్స్ ఫైల్ క్రింది విధంగా ఉంది :

![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] అనువాదం మరియు అసలు వచనం యొక్క పంక్తులు తప్పనిసరిగా ఒకదానికొకటి అనుగుణంగా ఉండాలి. అంటే, అనువాదాన్ని కంపైల్ చేసేటప్పుడు పంక్తులను జోడించవద్దు లేదా తొలగించవద్దు. లేకపోతే, ఇది అనువాద సవరణ కాష్లో గందరగోళాన్ని కలిగిస్తుంది.

ఏదైనా తప్పు జరిగితే, దయచేసి పరిష్కారాల కోసం తరచుగా అడిగే ప్రశ్నలను చూడండి.

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