.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 ಮತ್ತೆ ರನ್ ಮಾಡಬಹುದು, ತದನಂತರ ಮುಖಪುಟದಲ್ಲಿನ ಬದಲಾವಣೆಗಳನ್ನು ವೀಕ್ಷಿಸಲು ಅಭಿವೃದ್ಧಿ ಪೂರ್ವವೀಕ್ಷಣೆ 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 ರಲ್ಲಿ ಅಲ್ಪವಿರಾಮ , ** ಮೊದಲು ಮತ್ತು ನಂತರ ಯಾವುದೇ ಜಾಗಗಳು ಇರಬಾರದು .

ಮೇಲಿನ ನಿಯತಾಂಕಗಳಿಗಾಗಿ, ಅನುಗುಣವಾದ ಡೈರೆಕ್ಟರಿ ಸೂಚ್ಯಂಕ ಫೈಲ್:

ಏಕ ಪ್ರಾಜೆಕ್ಟ್ ಬಹು ಫೈಲ್ಗಳು

ನೀವು ಕೇವಲ ಒಂದು ಯೋಜನೆಯನ್ನು ಹೊಂದಿದ್ದರೆ, ನೀವು ಅದನ್ನು ಈ ಕೆಳಗಿನಂತೆ ಕಾನ್ಫಿಗರ್ ಮಾಡಬಹುದು.

  - i18n: doc
    url: flashduty
    use: Doc

[!WARN] ಬಹು ಫೈಲ್ಗಳನ್ನು ಹೊಂದಿರುವ ಏಕ ಯೋಜನೆಯು url ರೂಟ್ ಪಾತ್ / ಆಗಿ ಕಾನ್ಫಿಗರ್ ಮಾಡುವುದನ್ನು ಬೆಂಬಲಿಸುವುದಿಲ್ಲ conf.yml nav: nav: ಈ ವಿನ್ಯಾಸವು ಡೈರೆಕ್ಟರಿಗಳ ಮೂಲಕ ಪ್ರಾಜೆಕ್ಟ್ ಡಾಕ್ಯುಮೆಂಟ್ಗಳು, ಬ್ಲಾಗ್ಗಳು ಮತ್ತು ಇತರ ವಿಷಯವನ್ನು ಉತ್ತಮವಾಗಿ ಪ್ರತ್ಯೇಕಿಸುತ್ತದೆ. ಒಂದೇ ಫೈಲ್ ಮತ್ತು ಒಂದೇ ಪುಟವನ್ನು ಮುಖಪುಟವಾಗಿ ಬಳಸಲು ಶಿಫಾರಸು ಮಾಡಲಾಗಿದೆ.

[!TIP] url ಬರೆಯದಿದ್ದರೆ, i18n ರ ಮೌಲ್ಯಕ್ಕೆ url ಡೀಫಾಲ್ಟ್ ಆಗುತ್ತದೆ. ಈ ನಿಯಮವು ಇತರ ಟೆಂಪ್ಲೇಟ್ಗಳಿಗೂ ಸಹ ಪರಿಣಾಮ ಬೀರುತ್ತದೆ.

TOC ಪರಿವಿಡಿ ಸೂಚ್ಯಂಕ

ಕಾನ್ಫಿಗರೇಶನ್ನಲ್ಲಿ ಟೆಂಪ್ಲೇಟ್ use: Doc ಅನ್ನು ಸಕ್ರಿಯಗೊಳಿಸಿದ್ದರೆ, ದಯವಿಟ್ಟು .i18n/conf.yml ರಲ್ಲಿ ಪ್ಲಗ್-ಇನ್ i18n.addon/toc ಸಕ್ರಿಯಗೊಳಿಸಿ. ಕಾನ್ಫಿಗರೇಶನ್ ಈ ಕೆಳಗಿನಂತಿರುತ್ತದೆ :

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

en/demo2/README.md ನಂತಹ ಐಟಂ 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 ಪುಟವನ್ನು ಪ್ರದರ್ಶಿಸಲಾಗುತ್ತದೆ.