ਇੰਸਟਾਲ ਕਰੋ ਅਤੇ ਵਰਤੋ

ਵਿੰਡੋਜ਼ ਨੂੰ ਪਹਿਲਾਂ ਗਿਟ ਬੈਸ਼ ਇੰਸਟਾਲ ਕਰੋ

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