.i18n/conf.yml

ʻO ka faila hoʻonohonoho no i18n.site he .i18n/conf.yml a penei ka ʻike :

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

Ma waena o lākou, upload a ext: mea hoʻonohonoho hoʻonohonoho ʻo ia ka mea e hoʻouka ʻia ʻo .md wale nō i ka wā e paʻi ai.

Hoʻokele nav

nav: nā koho hoʻonohonoho, e pili ana i ka papa kuhikuhi ma ka piko o ka ʻaoʻao home.

Ma waena o lākou, pili i18n: home me home: Home i en/i18n.yml (ma kahi o en ka ʻōlelo kumu o ka unuhi papahana).

ʻO ka ʻikepili en/i18n.yml ka kikokikona i hōʻike ʻia ma ka papa kuhikuhi hoʻokele, e unuhi ʻia e like me fromTo i ka hoʻonohonoho ʻana, no ka laʻana, unuhi ʻia i zh/i18n.yml .

Ma hope o ka pau ʻana o ka unuhi, hiki iā ʻoe ke hoʻololi i ka waiwai o ka unuhi yml , akā mai hoʻohui a holoi paha i ke kī o ka unuhi yml .

use: Toc La'ana Palapala Ho'okahi Me Ka Outline

nav :

  - i18n: home
    use: Toc
    url: /

use: Toc o ia ho'i ka ho'ohana 'ana i ka la'ana Toc , 'o ia ho'i ka hana 'ana i ho'okahi Markdown template.

ʻO TOC ka pōkole o Table of Contents Ke hāʻawi ʻia kēia hoʻohālike, e hōʻike ʻia ka outline o kēia faila Markdown ma ka ʻaoʻao ʻaoʻao.

Hōʻike url: i ke ala faila o Markdown ( / pili i ka papa kuhikuhi kumu /README.md , pono kēia inoa faila i kahi prefix luna a me kahi suffix haʻahaʻa).

use: Md La'ana Palapala Ho'okahi Me Ka 'ole Outline

Ua like ka template Md a me ka template Toc a ua hoʻohana ʻia nā mea ʻelua e hāʻawi i kahi faila Markdown hoʻokahi. Akā, ʻaʻole hōʻike ʻia ka Md template i ka outline ma ka ʻaoʻao ʻaoʻao.

Hiki iā ʻoe ke hoʻololi i use: Toc i ka hoʻonohonoho ʻana i luna i use: Md , holo hou i i18n.site i ka papa kuhikuhi md , a laila e kipa i ka URL no ka hoʻomohala ʻana e nānā i nā loli ma ka ʻaoʻao home.

use: Blog Moʻomanaʻo Moʻomanaʻo

Hōʻike ka laʻana blog i ka papa inoa o nā ʻatikala (nā poʻo inoa a me nā abstracts) ma ke ʻano o ka manawa paʻi.

→ Kaomi ma aneʻi e aʻo e pili ana i ka hoʻonohonoho kikoʻī

use: Doc Nā Palapala Palapala Waihona

Ma ka waihona hoʻonohonoho:

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

Hōʻike i ka hoʻohana ʻana i ka Doc no ka hoʻohālikelike ʻana.

Doc kākoʻo i ka hoʻohui ʻana i nā MarkDown he nui e hoʻopuka i nā kikoʻī palapala no nā papahana hoʻokahi a nui paha.

Nui Nā Papahana a Me Nā Faila He Nui

ʻO ka hoʻonohonoho ʻana o .i18n/conf.yml i i18n:doc ʻo ia ke ʻano hoʻohālike multi-file.

Maʻaneʻi, menu: NB demo1,demo2 , ʻo ia ka hoʻohana ʻana i ka template NB e hāʻawi i ka papa kuhikuhi iho.

NB , ʻo ia ka pōkole o Name Breif , ʻo ia ka mea hiki ke hōʻike i ka papa kuhikuhi i ka inoa a me ka slogan o ka papahana.

NB hahai ʻia e ka ʻāpana demo1,demo2 i hāʻawi ʻia iā ia.

demo1,demo2 , : ** **

No nā ʻāpana i luna, ʻo ka faila kuhikuhi kuhikuhi e pili ana:

Pāhana Hoʻokahi Mau Faila

Inā hoʻokahi wale nō papahana kāu, hiki iā ʻoe ke hoʻonohonoho iā ia penei.

  - i18n: doc
    url: flashduty
    use: Doc

[!WARN] ʻAʻole kākoʻo ka papahana hoʻokahi me nā faila he nui i ka hoʻonohonoho ʻana i url ma ke ala kumu / Inā conf.yml → nav: ʻAʻohe ala kumu i hoʻonohonoho ʻia, ke komo ʻana i ka ʻaoʻao home o ka pūnaewele, e kākau hou ʻia i ka URL mua ma lalo o ka hoʻonohonoho nav: . ʻO kēia hoʻolālā e hoʻokaʻawale maikaʻi i nā palapala papahana, blogs a me nā mea ʻē aʻe ma o nā papa kuhikuhi. Manaʻo ʻia e hoʻohana i hoʻokahi faila a me kahi ʻaoʻao hoʻokahi e like me ka ʻaoʻao home.

[!TIP] Inā ʻaʻole i kākau ʻia url , hoʻopaʻa ʻia url i ka waiwai o i18n Hoʻohana pū ʻia kēia lula no nā mamana ʻē aʻe.

TOC Papa Kuhikuhi Kiko'ī

Inā hoʻohana ʻia ka template use: Doc i ka hoʻonohonoho, e ʻoluʻolu e hoʻā i ka plug-in i18n.addon/toc i .i18n/conf.yml Penei ka hoʻonohonoho ʻana :

addon:
  - i18n.addon/toc

i18n.site e hoʻokomo a hoʻokō i kēia plug-in, heluhelu TOC i ka waihona kuhikuhi kuhikuhi, a hoʻopuka json ka papa kuhikuhi papa kuhikuhi.

Inā he papahana hoʻokahi me nā faila he nui, ʻo ka papa kuhikuhi kumu TOC ka papa kuhikuhi e pili ana i url: ma ka papa kuhikuhi ʻōlelo kumu No ka laʻana, inā ʻo ka url: flashduty kumu he zh/flashduty/TOC .

Inā he nui nā papahana a me nā faila he nui, ʻaʻohe pono e hoʻonohonoho i url: ʻO ka papa kuhikuhi kumu o TOC ka papa kuhikuhi e pili ana i ka waiwai o i18n .

ʻO Ka Wehewehe Kikoʻī Kikoʻī

en/blog/TOC na mea i pili :

README.md

news/README.md
  news/begin.md
E Hoʻohana I Ka Indentation E Hōʻike I Nā Pae

README.md ma ka lālani mua o en/blog/TOC ma luna e pili ana i i18n.site ma ke kiʻi ma lalo, ʻo ia ka inoa o ka papahana.

ʻO nā laina ʻelua aʻe e like me ka mea i hōʻike ʻia ma ke kiʻi ma lalo nei.

news/README.md pili me News , news/begin.md pili me Our Product is Online !

TOC ua hoʻokomo ʻia nā faila e hōʻike i ka pilina hierarchical o ka outline, kākoʻo i ka indentation multi-level, a me nā manaʻo laina e hoʻomaka me # .

ʻO Ke Poʻo Inoa Wale Nō Ka Pae Makua, ʻaʻole Ka ʻike.

Inā nui nā pae o ka indentation, kākau wale ka pae makua i ke poʻo inoa a ʻaʻole ka ʻike. A i ʻole, e huikau ʻia ka typography.

Papahana README.md

Hiki ke kākau ʻia ma ka helu README.md , e like me en/demo2/README.md .

E hoʻomanaʻo ʻaʻole hōʻike ka ʻike o kēia faila i kahi papa kuhikuhi o nā kikoʻī, no laila makemake ʻia e kaupalena i ka lōʻihi a kākau i kahi hoʻolauna pōkole.

Slogan Papahana

Hiki iā ʻoe ke Your Project slogan aia ka Deme Two i kāna tagline papahana ma lalo o ka papa kuhikuhi i lalo a me ka papa inoa papa inoa o ka papahana :

Pili keia me ka lalani mua o en/demo2/README.md :

# Demo Two : Your Project slogan

ʻO ka ʻike ma hope o ke kolamu mua : o ke poʻo inoa pae mua o ka papahana README.md e manaʻo ʻia ʻo ia ka slogan papahana.

E ʻoluʻolu e nā mea hoʻohana mai Kina, Iapana a me Korea, pono ʻoe e hoʻohana i ka ʻāpana hapa-ākea : ma kahi o ke kolonā piha-ākea.

Pehea E Hoʻoneʻe Ai I Ka TOC I Ka Nui?

Pono e waiho ʻia nā TOC ma ka papa kuhikuhi o ka ʻōlelo kumu.

No ka laʻana, inā he Pākē ka ʻōlelo kumu, a laila ʻo TOC ma luna ka zh/blog/TOC .

Inā hoʻololi ʻia ka ʻōlelo kumu, pono ʻoe e hoʻoneʻe i nā faila TOC o kekahi ʻōlelo ma ka papahana i kahi ʻōlelo ʻē aʻe.

Hiki iā ʻoe ke kuhikuhi i kēia mau kauoha:

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

E ʻoluʻolu e hoʻololi i en/ a me zh/ ma ke kauoha i luna i kāu code ʻōlelo.

Hoʻouka Paʻamau Me Ke Ala Hoʻonohonoho ʻole

No ke komo ʻana i kekahi ala, inā ʻaʻole i hoʻonohonoho ʻia ka prefix ala ma nav: , e hoʻouka ʻia ka faila MarkDown e pili ana i ke ala e ka paʻamau a hāʻawi ʻia me ka hoʻohana ʻana i ka template Md .

No ka laʻana, inā loaʻa /test a hoʻonohonoho ʻia ʻo nav: me ka ʻole o ka prefix o kēia ala, a ʻo ka ʻōlelo mākaʻikaʻi o kēia manawa ʻo ka ʻōlelo Pelekania (code en ), e hoʻouka ʻia /en/test.md ma ke ʻano maʻamau a hoʻololi ʻia me ka hoʻohana ʻana i ka template Md .

Inā ʻaʻohe /en/test.md kēia faila, e hōʻike ʻia ka ʻaoʻao 404 paʻamau.