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

פֿאַר די אויבן פּאַראַמעטערס, די קאָראַספּאַנדינג Directory אינדעקס טעקע איז:

• 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 די Directory אינדעקס טעקע, און דזשענערייט json די וועגווייַזער אַוטליין.

אויב עס איז אַ איין פּרויעקט מיט קייפל טעקעס, דער וואָרצל וועגווייַזער TOC איז דער וועגווייַזער קאָראַספּאַנדינג צו url: אין די מקור שפּראַך וועגווייַזער, פֿאַר בייַשפּיל, אויב די מקור שפּראַך איז כינעזיש: די טעקע קאָראַספּאַנדינג צו url: flashduty איז zh/flashduty/TOC .

אויב עס איז קייפל פּראַדזשעקס און קייפל טעקעס, עס איז ניט דאַרפֿן צו קאַנפיגיער url: דער וואָרצל וועגווייַזער פון TOC איז דער וועגווייַזער קאָראַספּאַנדינג צו די ווערט פון i18n .

דעטאַילעד אינהאַלט דערקלערונג

en/blog/TOC דער אינהאַלט איז ווי גייט :

README.md

news/README.md
  news/begin.md

ניצן ינדענטיישאַן צו אָנווייַזן לעוועלס

README.md אין דער ערשטער רודערן פון en/blog/TOC אויבן קאָראַספּאַנדז צו 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 בלאַט וועט זיין געוויזן.