.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 .

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 ብሎግ አብነቶች

የብሎግ አብነት ለህትመት ጊዜ በቅደም ተከተል የጽሑፎችን ዝርዝር (ርዕሶች እና ረቂቅ ጽሑፎች) ያሳያል።

→ ስለ ልዩ ውቅር ለማወቅ እዚህ ጠቅ ያድርጉ

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 እንደ ስርወ መንገድ / ማዋቀርን አይደግፍም። nav:__ __conf.yml nav: ይህ ንድፍ የፕሮጀክት ሰነዶችን, ብሎጎችን እና ሌሎች ይዘቶችን በማውጫዎች በኩል በተሻለ ሁኔታ ለመለየት ነው. አንድ ነጠላ ፋይል እና አንድ ገጽ እንደ መነሻ ገጽ ለመጠቀም ይመከራል.

[!TIP] url ካልተፃፈ፣ url ነባሪው ለ i18n እሴት ነው። ይህ ህግ ለሌሎች አብነቶችም ይሠራል።

የTOC ማውጫ ማውጫ

አብነት use: Doc በማዋቀሪያው ውስጥ ከነቃ፣እባክዎ plug-in i18n.addon/toc in .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

ደረጃዎችን ለማመልከት መግባቱን ይጠቀሙ

ከላይ ባለው en/blog/TOC የመጀመሪያ ረድፍ ላይ README.md ከታች በምስሉ ላይ ካለው i18n.site ጋር ይዛመዳል ይህም የፕሮጀክቱ ስም ነው።

የሚቀጥሉት ሁለት መስመሮች ከታች ባለው ቅጽበታዊ ገጽ እይታ ላይ እንደሚታየው ናቸው.

news/README.md ከ News ጋር ይዛመዳል ፣ news/begin.md ከ Our Product is Online ! ጋር ይዛመዳል

TOC ፋይሎች የዝርዝሩ ተዋረዳዊ ግንኙነትን ለመጠቆም፣ ባለብዙ ደረጃ ውስጠትን የሚደግፉ እና ከ # የሚጀምሩ የመስመር አስተያየቶችን ለማመልከት ገብተዋል።

የወላጅ ደረጃ የሚጽፈው ርዕሱን ብቻ እንጂ ይዘቱን አይደለም።

ብዙ የመግቢያ ደረጃዎች ሲኖሩ፣ የወላጅ ደረጃ የሚጽፈው ርዕሱን ብቻ እንጂ ይዘቱን አይደለም። አለበለዚያ የፊደል አጻጻፍ ይበላሻል።

ፕሮጀክት README.md

ይዘቱ በንጥል README.md ሊጻፍ ይችላል, ለምሳሌ en/demo2/README.md .

የዚህ ፋይል ይዘት የይዘት ዝርዝርን እንደማያሳይ ልብ ይበሉ, ስለዚህ ርዝመቱን ለመገደብ እና አጭር መግቢያን ለመጻፍ ይመከራል.

የፕሮጀክት መፈክር

Deme Two ከተቆልቋይ ምናሌው በታች የራሱ የፕሮጀክት መለያ መስመር እና ካታሎግ የፕሮጀክት ስም Your Project slogan እንዳለው ማየት ይችላሉ :

ይህ ከ 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 ገጽ ይታያል።