.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 ދިމާވަނީ en/i18n.yml އިން home: Home އަށް (މިތަނުގައި 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 އާއި، މި ފައިލް ނަމަށް ބޭނުންވަނީ ބޮޑު އަކުރުގެ ޕްރިފިކްސް އާއި ކުޑަ އަކުރު ސުފިކްސް އެއް) އެވެ.

0އައުޓްލައިން ނެތި use: Md ޑޮކިއުމަންޓް ޓެމްޕްލޭޓް

Md ޓެމްޕްލޭޓާއި Toc ޓެމްޕްލޭޓް އެއްގޮތް ކަމަށާއި މި ދެ ޓެމްޕްލޭޓް ވެސް ބޭނުންކުރަނީ އެއް Markdown ފައިލް ރެންޑަރ ކުރުމަށެވެ. އެކަމަކު Md ޓެމްޕްލޭޓް އިން ސައިޑްބާރ ގައި އައުޓްލައިން ނުފެނެއެވެ.

މަތީގައިވާ ކޮންފިގްރޭޝަންގައިވާ use: Toc use: Md އަށް ބަދަލުކޮށް، އަނެއްކާވެސް md ޑައިރެކްޓަރީގައި i18n.site ހިންގައި، ހޯމްޕޭޖުގައިވާ ބަދަލުތައް ބެލުމަށް ޑިވެލޮޕްމަންޓް ޕްރިވިއު ޔޫ.އާރ.އެލް އަށް ޒިޔާރަތް ކުރެވިދާނެއެވެ.

use: Blog ބްލޮގް ޓެމްޕްލޭޓްސް

ބްލޮގް ޓެމްޕްލޭޓްގައި ޝާއިޢުކުރާ ވަގުތުގެ ތަރުތީބުން ލިޔުންތަކުގެ ލިސްޓެއް (ސުރުޚީތަކާއި ޚުލާޞާތައް) ދައްކާފައިވެއެވެ.

→ ވަކި ކޮންފިގްރޭޝަނެއް ދަސްކުރުމަށް މިތަނަށް ފިތާލާށެވެ

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: އެއްވެސް ރޫޓް މަގެއް ކޮންފިގްރޭޓް ނުކުރެވިއްޖެނަމަ، ވެބްސައިޓްގެ ހޯމްޕޭޖަށް ވަންނައިރު، nav: ކޮންފިގްރޭޝަންގެ ދަށުން ފުރަތަމަ ޔޫ.އާރ.އެލް އަށް އޮޓޮމެޓިކުން އަލުން ލިޔެވޭނެއެވެ. މި ޑިޒައިން އަކީ ޕްރޮޖެކްޓް ޑޮކިއުމަންޓްތަކާއި ބްލޮގްތަކާއި އެހެނިހެން ކޮންޓެންޓްތައް ޑައިރެކްޓަރީތަކުގެ ތެރެއިން ރަނގަޅަށް ތަފާތުކުރުމަށެވެ. ހޯމް ޕޭޖެއްގެ ގޮތުގައި އެއް ފައިލަކާއި އެއް ޕޭޖެއް ބޭނުން ކުރުން ރަނގަޅެވެ.

[!TIP] url ނުލިޔެއްޖެނަމަ، url ޑިފޯލްޓް ވާނީ i18n ގެ އަގަކަށެވެ.މި އުސޫލު އެހެން ޓެމްޕްލޭޓްތަކަށް ވެސް އަމަލުކުރަން ފަށައެވެ.

ޓީއޯސީ ޓޭބަލް އޮފް ކޮންޓެންޓްސް އިންޑެކްސް

ކޮންފިގްރޭޝަންގައި ޓެމްޕްލޭޓް use: Doc އެނެބަލް ކުރެވިފައިވާނަމަ .i18n/conf.yml ގައި ޕްލަގް-އިން i18n.addon/toc އެނެބަލް ކޮށްލައްވާ ކޮންފިގްރޭޝަން ތިރީގައި މިވަނީ :

addon:
  - i18n.addon/toc

i18n.site އޮޓޮމެޓިކުން މި ޕްލަގް-އިން އިންސްޓޯލްކޮށް އެގްޒެކެޓްކޮށް، TOC ޑައިރެކްޓަރީ އިންޑެކްސް ފައިލް ކިޔައި، json ޑައިރެކްޓަރީ އައުޓްލައިން ޖެނެރޭޓް ކުރާނެއެވެ.

އެއީ ގިނަ ފައިލްތަކެއް ހުންނަ އެއް ޕްރޮޖެކްޓެއްނަމަ، ރޫޓް ޑައިރެކްޓަރީ TOC އަކީ ސޯސް ލޭންގުއޭޖް ޑައިރެކްޓަރީގައިވާ url: އަށް ދިމާވާ ޑައިރެކްޓަރީ މިސާލަކަށް ސޯސް ލޭންގުއޭޖް އަކީ ޗައިނީސް ބަހެއްނަމަ: url: flashduty އަށް ދިމާވާ ފައިލަކީ zh/flashduty/TOC .

އެއީ ގިނަ ޕްރޮޖެކްޓްތަކާއި i18n ފައިލްތަކެއްނަމަ url: ކޮންފިގްރޭޓް ކުރަން ނުޖެހޭނެއެވެ.1 ގެ ރޫޓް ޑައިރެކްޓަރީއަކީ TOC ގެ އަގަށް ދިމާވާ ޑައިރެކްޓަރީއެވެ.

ތަފްސީލީ ކޮންޓެންޓް ބަޔާންކުރުން

en/blog/TOC ތިރީގައި މިވަނީ :

README.md

news/README.md
  news/begin.md

ލެވެލްތައް ދައްކާލުމަށް އިންޑެންޓޭޝަން ބޭނުންކުރުން

މަތީގައިވާ en/blog/TOC ގެ ފުރަތަމަ ސަފުގައިވާ README.md ތިރީގައިވާ ތަސްވީރުގައިވާ i18n.site އާއި ދިމާވާއިރު، މިއީ ޕްރޮޖެކްޓްގެ ނަމެވެ.

ދެން އޮތް ދެ ސަފުހާ އޮތީ ތިރީގައިވާ ސްކްރީންޝޮޓުން ފެންނަ ގޮތަށެވެ.

news/README.md ދިމާވަނީ News , . news/begin.md ދިމާވަނީ Our Product is Online ! އާއެވެ

TOC ފައިލް އިންޑެންޓް ކުރެވިފައިވަނީ އައުޓްލައިންގެ ހައިރާރކިކަލް ރިލޭޝަންޝިޕް ދައްކުވައިދިނުމަށާއި، މަލްޓި ލެވެލް އިންޑެންޓޭޝަން އަށް ސަޕޯޓް ދިނުމަށާއި، # އިން ފެށިގެން ލައިން ކޮމެންޓްސް ކުރުމަށެވެ.

ބެލެނިވެރިންގެ ފެންވަރުގައި ލިޔަނީ ހަމައެކަނި ސުރުޚީ، ކޮންޓެންޓް ނޫނެވެ.

އިންޑެންޓޭޝަންގެ އެތައް ލެވެލްއެއް ހުންނައިރު، ބެލެނިވެރި ލެވެލްގައި ލިޔަނީ ހަމައެކަނި ސުރުޚީ ކަމަށާއި ކޮންޓެންޓް ލިޔެފައި ނުވާ ކަމަށެވެ. އެހެން ނޫނީ ޓައިޕޮގްރަފީ ގޯސްވާނެއެވެ.

ޕްރޮޖެކްޓް README.md

ކޮންޓެންޓް ލިޔެވޭނީ en/demo2/README.md ފަދަ އައިޓަމް README.md ގައެވެ .

މި ފައިލްގެ ކޮންޓެންޓްގައި ޓޭބަލް އޮފް ކޮންޓެންޓްސް އައުޓްލައިނެއް ނުފެންނަ ކަމުން ދިގުމިން ލިމިޓްކޮށް ކުރު ތަޢާރަފެއް ލިޔުމަކީ ރަނގަޅު ގޮތެކެވެ.

މަޝްރޫއުގެ ޝިއާރު

Deme Two ގެ ޕްރޮޖެކްޓް ޓެގްލައިން ޑްރޮޕް ޑައުން މެނޫ އާއި ކެޓަލަގް އައުޓްލައިން ޕްރޮޖެކްޓް ނަން Your Project slogan ތިރީގައި ހުރިކަން ފެންނާނެއެވެ :

މިއީ en/demo2/README.md ގެ ފުރަތަމަ ސަފު އާއި ދިމާވާ ކަމެކެވެ :

# Demo Two : Your Project slogan

ޕްރޮޖެކްޓް README.md ގެ ފުރަތަމަ ލެވެލްގެ ސުރުޚީގެ ފުރަތަމަ ކޮލޮން : ގެ ފަހުން ކޮންޓެންޓް ޕްރޮޖެކްޓް ޝިއާރެއްގެ ގޮތުގައި ބަލާނެއެވެ.

ޗައިނާ، ޖަޕާން އަދި ކޮރެއާގެ ޔޫޒަރުން ފާހަގަކޮށްލަންޖެހޭ ކަމަކީ ފުލް ވިޑްތް ކޮލޮންގެ ބަދަލުގައި ހާފް ވިޑްތް ކޮލޮން : ބޭނުން ކުރަން ޖެހޭނެ ކަމަށެވެ.

ޓީއޯސީ ބަލްކްކޮށް ބަދަލުކުރާނީ ކިހިނެއް ހެއްޔެވެ؟

ސޯސް ލޭންގުއޭޖްގެ ޑައިރެކްޓަރީގައި 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 ޞަފްޙާ ފެންނާނެއެވެ.