.i18n/conf.yml

Файли конфигуратсия барои i18n.site .i18n/conf.yml аст ва мундариҷа чунин аст :

i18n:
  fromTo:
    en:
upload:
  ext:
    - md
nav:
  - i18n: home
    use: Toc
    url: /
  - i18n: doc
    menu: NB demo1,demo2
    use: Doc
  - i18n: blog
    use: Blog
addon:
  - i18n.addon/toc

Дар байни онҳо, upload то ext: адад конфигуратсия маънои онро дорад, ки ҳангоми нашр танҳо .md бор карда мешавад.

Навигарии Боло

nav: имконоти конфигуратсия, ки ба менюи паймоиш дар болои саҳифаи асосӣ мувофиқ аст.

Дар байни онҳо, i18n: home ба home: Home дар en/i18n.yml мувофиқат мекунад (дар он ҷо en забони аслии тарҷумаи лоиҳа аст).

en/i18n.yml мундариҷа матнест, ки дар менюи паймоиш нишон дода мешавад, ки мувофиқи fromTo дар конфигуратсия тарҷума карда мешавад, масалан, ба zh/i18n.yml тарҷума карда мешавад.

Пас аз анҷоми тарҷума, шумо метавонед арзиши тарҷумаи yml -ро тағир диҳед, аммо калиди тарҷумаи yml илова ё нест накунед.

0Шаблони Ҳуҷҷати `use: Toc` Бо Нақша

nav :

  - i18n: home
    use: Toc
    url: /

use: Toc маънои намоиш додани истифодаи қолаби Toc мебошад, ки як қолаби ягонаи Markdown пешкаш мекунад.

TOC ихтисораи Table of Contents аст. Вақте ки ин қолаб дода мешавад, контури ин Markdown файл дар панели паҳлӯ намоиш дода мешавад.

url: роҳи файли Markdown -ро ифода мекунад ( / ба директорияи решавӣ /README.md мувофиқат мекунад, ин номи файл префикси калон ва суффикси хурдро талаб мекунад).

`use: Md` Бидуни Нақша

Шаблони Md ва қолаби Toc якхелаанд ва ҳарду барои намоиш додани файли ягонаи Markdown истифода мешаванд. Аммо қолаби Md контурро дар панели паҳлӯ нишон намедиҳад.

Шумо метавонед use: Toc дар конфигуратсияи дар боло овардашуда ба use: Md тағир диҳед, i18n.site дар директорияи md дубора иҷро кунед ва сипас ба URL-и пешнамоиши рушд дидан кунед, то тағиротро дар сафҳаи асосӣ мушоҳида кунед.

`use: Blog` Шаблонҳои Блог

Шаблони блог рӯйхати мақолаҳоро (унвонҳо ва рефератҳо) бо тартиби вақти нашр нишон медиҳад.

→ Барои гирифтани маълумот дар бораи конфигуратсияи мушаххас ин ҷо клик кунед

0Шаблонҳои Ҳуҷҷатҳои Файлии `use: Doc`

Дар файли конфигуратсия:

  - i18n: doc
    menu: NB demo1,demo2
    use: Doc

Истифодаи Doc барои намоиши қолаб нишон медиҳад.

Шаблон Doc якҷоя кардани якчанд MarkDown барои тавлиди контурҳои ҳуҷҷат барои лоиҳаҳои як ё якчанд лоиҳа дастгирӣ мекунад.

Лоиҳаҳои Сершумор Ва Файлҳои Сершумор

Конфигуратсияи .i18n/conf.yml дар i18n:doc реҷаи намоиши бисёрфайлҳои бисёр лоиҳа мебошад.

Дар ин ҷо, menu: NB demo1,demo2 маънои истифодаи қолаби NB ро барои намоиш додани менюи афтанда дорад.

NB , ки ихтисораи Name Breif аст, маънои онро дорад, ки менюи афтанда метавонад ном ва шиори лоиҳаро нишон диҳад.

NB пас аз параметри demo1,demo2 ки ба он дода шудааст.

Эзоҳ : ** Пеш ва пас аз вергул , дар demo1,demo2 набояд фосилаи ** мавҷуд бошад.

Барои параметрҳои дар боло зикршуда файли индекси директорияи мувофиқ ин аст:

en/demo1/TOC
en/demo2/TOC

Лоиҳаи Ягонаи Файлҳои Сершумор

Агар шумо танҳо як лоиҳа дошта бошед, шумо метавонед онро ба таври зерин танзим кунед.

  - i18n: doc
    url: flashduty
    use: Doc

[!WARN] Лоиҳаи ягона бо файлҳои сершумор танзими url ҳамчун роҳи решавӣ / дастгирӣ намекунад Агар conf.yml nav: Роҳи реша танзим нашуда бошад, ҳангоми дастрасӣ ба саҳифаи асосии вебсайт, он ба таври худкор ба URL-и аввал зери конфигуратсияи nav: навишта мешавад. Ин тарҳ барои беҳтар фарқ кардани ҳуҷҷатҳои лоиҳа, блогҳо ва мундариҷаи дигар тавассути директорияҳо мебошад. Тавсия дода мешавад, ки як файл ва як саҳифа ҳамчун саҳифаи асосӣ истифода шавад.

[!TIP] Агар url навишта нашуда бошад, url ба арзиши i18n муқаррар карда мешавад. Ин қоида барои дигар қолабҳо низ эътибор пайдо мекунад.

Индекси Ҷадвали Мундариҷаи TOC

Агар дар конфигуратсия шаблон use: Doc фаъол бошад, лутфан плагини i18n.addon/toc дар .i18n/conf.yml фаъол созед. Конфигуратсия чунин аст :

addon:
  - i18n.addon/toc

i18n.site ба таври худкор ин плагинро насб ва иҷро мекунад, TOC файли индекси директорияро мехонад ва json контури директорияро тавлид мекунад.

Агар он як лоиҳаи ягона бо файлҳои сершумор бошад, директорияи решавӣ TOC феҳристи мувофиқи url: дар директорияи забони ибтидоӣ мебошад, масалан, агар забони манбаъ чинӣ бошад: файли мувофиқ ба url: flashduty zh/flashduty/TOC аст.

Агар он лоиҳаҳои сершумор ва файлҳои сершумор бошад, зарурати танзим кардани url: вуҷуд надорад. Директорияи решаи TOC директорияест, ки ба арзиши i18n мувофиқ аст.

Тавсифи Муфассали Мундариҷа

en/blog/TOC он чунин аст :

README.md

news/README.md
  news/begin.md

Барои Нишон Додани Сатҳҳо Абзорро Истифода Баред

README.md дар сатри якуми en/blog/TOC дар боло ба i18n.site дар расми зер мувофиқат мекунад, ки номи лоиҳа аст.

Ду сатри навбатӣ тавре ки дар скриншот дар зер нишон дода шудаанд.

news/README.md ба News мувофиқат мекунад, news/begin.md ба Our Product is Online ! мувофиқат мекунад

Файлҳои TOC барои нишон додани робитаи иерархивии контур, пуштибонии қафомонии бисёрсатҳӣ ва шарҳҳои сатрӣ аз # сар карда мешаванд.

Сатҳи Волидайн Танҳо Унвонро Менависад, На Мундариҷа.

Ҳангоме ки сатҳҳои сершумор вуҷуд доранд, сатҳи волидайн танҳо унвонро менависад, на мундариҷа. Дар акси ҳол, матбаа вайрон мешавад.

Лоиҳаи README.md

Мундариҷаро дар банди README.md , ба мисли en/demo2/README.md навиштан мумкин аст.

Дар хотир доред, ки мундариҷаи ин файл ҷадвали мундариҷаро нишон намедиҳад, аз ин рӯ тавсия дода мешавад, ки дарозиро маҳдуд кунед ва сарсухани кӯтоҳ нависед.

Шиори Лоиҳа

Шумо мебинед Your Project slogan ки Deme Two дар зери менюи афтанда ва номи контури лоиҳа : дорад.

Ин ба сатри якуми en/demo2/README.md рост меояд :

# Demo Two : Your Project slogan

Мундариҷае, ки пас аз ду нуқтаи аввали : унвони дараҷаи якуми лоиҳаи README.md навишта шудааст, шиори лоиҳа ҳисобида мешавад.

Истифодабарандагон аз Чин, Ҷопон ва Корея, лутфан қайд кунед, ки шумо бояд ба ҷои ду нуқтаи пурраи паҳнои : ро истифода баред.

Чӣ Тавр TOC-Ро Ба Таври Оммавӣ Интиқол Додан Мумкин Аст?

TOC файлҳо бояд дар феҳристи забони сарчашма ҷойгир карда шаванд.

Масалан, агар забони аслӣ чинӣ бошад, пас TOC дар боло zh/blog/TOC аст.

Агар забони манбаъ тағир дода шавад, шумо бояд файлҳои TOC -и забони муайянро дар лоиҳа ба забони дигар интиқол диҳед.

Шумо метавонед ба фармонҳои зерин муроҷиат кунед:

rsync -av --remove-source-files --include='*/' \
--include='TOC' --exclude='*' en/ zh/

Лутфан en/ ва zh/ дар фармони боло ба рамзи забони худ тағир диҳед.

Боркунии Пешфарз Бидуни Роҳи Конфигуратсия

Барои роҳи муайяне, ки дастрас мешавад, агар префикси роҳ дар nav: танзим нашуда бошад, файли MarkDown мувофиқ ба роҳ ба таври нобаёнӣ бор карда мешавад ва бо истифода аз қолаби Md намоиш дода мешавад.

Масалан, агар ба /test дастрасӣ дошта бошад ва nav: бе префикси ин роҳ танзим карда шуда бошад ва забони дидани ҷории англисӣ (код en ) бошад, /en/test.md ба таври нобаёнӣ бор карда мешавад ва бо истифода аз қолаби Md намоиш дода мешавад.

Агар /en/test.md ин файл мавҷуд набошад, саҳифаи пешфарз 404 намоиш дода мешавад.