.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 ክትቅይሮ ትኽእል ኢኻ፣ ኣብቲ md ማህደር i18n.site እንደገና ክትጎዪ ትኽእል ኢኻ፣ ድሕሪኡ ናብቲ ናይ ምዕባለ ቅድመ-ምርኢት URL ብምኻድ ኣብቲ መበገሲ ገጽ ዘሎ ለውጢ ክትዕዘብ ትኽእል።

use: Blog ናይ ብሎግ ቅጥዕታት

እቲ ናይ ብሎግ ቅጥዒ ዝርዝር ጽሑፋት (ኣርእስታትን ጽማቝ ጽሑፋትን) ብመስርዕ ናይ ሕትመት ግዜ የቕርብ።

→ ብዛዕባ እቲ ፍሉይ ውቅር ንምፍላጥ ኣብዚ ጠውቑ

use: Doc ፋይል ሰነድ ቅጥዕታት

ኣብቲ ናይ ውቅር ፋይል፤

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

ንመቕረጺ ቅጥዒ Doc ምጥቃም የመልክት።

Doc template ንሓደ ወይ ንብዙሓት ፕሮጀክትታት ሰነድ ኣውታር ንምፍጣር ብዙሓት 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

ደረጃታት ንምምልካት ኢንደንቴሽን ተጠቐም

ኣብ ላዕሊ ኣብ ቀዳማይ መስርዕ en/blog/TOC README.md ምስቲ ኣብ ታሕቲ ዘሎ ስእሊ ዘሎ i18n.site ይሰማማዕ፡ እዚ ድማ ስም ፕሮጀክት እዩ።

እተን ዝቕጽላ ክልተ መስመራት ከምቲ ኣብ ታሕቲ ዘሎ ስእሊ ስክሪን ዝረኣያ እየን።

news/README.md ምስ News , 10 ይሰማማዕ። 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 ገጽ ክረአ እዩ።