.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 ର ଚାବିକୁ ଯୋଡନ୍ତୁ କିମ୍ବା ବିଲୋପ କରନ୍ତୁ ନାହିଁ |

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 ଟେମ୍ପଲେଟ୍ ଏକକ କିମ୍ବା ଏକାଧିକ ପ୍ରୋଜେକ୍ଟ ପାଇଁ ଡକ୍ୟୁମେଣ୍ଟ୍ ବାହ୍ୟରେଖା ସୃଷ୍ଟି କରିବାକୁ ଏକାଧିକ MarkDown ଏକତ୍ର କରିବାକୁ ସମର୍ଥନ କରେ |

ଏକାଧିକ ପ୍ରୋଜେକ୍ଟ ଏବଂ ଏକାଧିକ ଫାଇଲ୍ |

i18n:doc ରେ .i18n/conf.yml ର ବିନ୍ୟାସ ହେଉଛି ମଲ୍ଟି ପ୍ରୋଜେକ୍ଟ ମଲ୍ଟି ଫାଇଲ୍ ରେଣ୍ଡରିଂ ମୋଡ୍ |

ଏଠାରେ, menu: NB demo1,demo2 , ଡ୍ରପ୍ ଡାଉନ୍ ମେନୁକୁ ରେଣ୍ଡର୍ କରିବା ପାଇଁ NB ଟେମ୍ପଲେଟ୍ ବ୍ୟବହାର କରିବା |

NB , ଯାହାକି Name Breif ର ସଂକ୍ଷିପ୍ତ ଅର୍ଥ, ଡ୍ରପ୍ ଡାଉନ୍ ମେନୁ ପ୍ରକଳ୍ପର ନାମ ଏବଂ ସ୍ଲୋଗାନ୍ ପ୍ରଦର୍ଶନ କରିପାରିବ |

NB ଏହାକୁ ପାରାମିଟର demo1,demo2 ଦ୍ followed ାରା ଅନୁସରଣ କରାଯାଇଛି |

ଟିପନ୍ତୁ : ** demo1,demo2 ରେ କମା , ପୂର୍ବରୁ ଏବଂ ପରେ କ ** ଣସି ସ୍ପେସ୍ ରହିବା ଉଚିତ୍ ନୁହେଁ |

ଉପରୋକ୍ତ ପାରାମିଟରଗୁଡିକ ପାଇଁ, ସଂପୃକ୍ତ ଡିରେକ୍ଟୋରୀ ଇଣ୍ଡେକ୍ସ ଫାଇଲ୍ ହେଉଛି:

• en/demo1/TOC
• en/demo2/TOC

ଏକକ ପ୍ରୋଜେକ୍ଟ ଏକାଧିକ ଫାଇଲ୍ |

ଯଦି ଆପଣଙ୍କର କେବଳ ଗୋଟିଏ ପ୍ରୋଜେକ୍ଟ ଅଛି, ଆପଣ ଏହାକୁ ନିମ୍ନଲିଖିତ ଭାବରେ ବିନ୍ୟାସ କରିପାରିବେ |

  - i18n: doc
    url: flashduty
    use: Doc

[!WARN] ଏକାଧିକ ଫାଇଲ୍ ସହିତ ଏକକ ପ୍ରୋଜେକ୍ଟ url ମୂଳ ପଥ / ଭାବରେ ବିନ୍ୟାସ କରିବାକୁ ସମର୍ଥନ କରେନାହିଁ | ଯଦି conf.yml nav: କ root ଣସି ମୂଳ ପଥ ବିନ୍ୟାସିତ ହୋଇନାହିଁ, ଯେତେବେଳେ ୱେବସାଇଟର ମୂଳପୃଷ୍ଠାକୁ ପ୍ରବେଶ କରେ, ଏହା ସ୍ୱୟଂଚାଳିତ ଭାବରେ nav: ସଂରଚନା ଅନ୍ତର୍ଗତ ପ୍ରଥମ URL କୁ ପୁନ r ଲିଖିତ ହେବ | ଏହି ଡିଜାଇନ୍ ହେଉଛି ଡିରେକ୍ଟୋରୀ ମାଧ୍ୟମରେ ପ୍ରୋଜେକ୍ଟ ଡକ୍ୟୁମେଣ୍ଟ୍, ବ୍ଲଗ୍ ଏବଂ ଅନ୍ୟାନ୍ୟ ବିଷୟବସ୍ତୁକୁ ଭଲ ଭାବରେ ପୃଥକ କରିବା | ମୂଳପୃଷ୍ଠା ଭାବରେ ଗୋଟିଏ ଫାଇଲ୍ ଏବଂ ଗୋଟିଏ ପୃଷ୍ଠା ବ୍ୟବହାର କରିବାକୁ ପରାମର୍ଶ ଦିଆଯାଇଛି |

[!TIP] ଯଦି url ଲେଖାଯାଏ ନାହିଁ, url ର ମୂଲ୍ୟ i18n କୁ ଡିଫଲ୍ଟ କରେ | ଏହି ନିୟମ ଅନ୍ୟ ଟେମ୍ପଲେଟ୍ ପାଇଁ ମଧ୍ୟ କାର୍ଯ୍ୟକାରୀ ହୁଏ |

ବିଷୟବସ୍ତୁ ସୂଚୀର TOC ସାରଣୀ |

ଯଦି ଟେମ୍ପଲେଟ୍ use: Doc ବିନ୍ୟାସନରେ ସକ୍ଷମ ହୋଇଛି, ଦୟାକରି .i18n/conf.yml ରେ ପ୍ଲଗ୍-ଇନ୍ i18n.addon/toc ସକ୍ଷମ କରନ୍ତୁ | ବିନ୍ୟାସ ନିମ୍ନଲିଖିତ ଅଟେ :

addon:
  - i18n.addon/toc

i18n.site ସ୍ୱୟଂଚାଳିତ ଭାବରେ ଏହି ପ୍ଲଗ୍-ଇନ୍ ସଂସ୍ଥାପନ ଏବଂ ଏକଜେକ୍ୟୁଟ୍ କରିବ, TOC ଡିରେକ୍ଟୋରୀ ଇଣ୍ଡେକ୍ସ ଫାଇଲ୍ ପ read ିବ ଏବଂ json ଡିରେକ୍ଟୋରୀ ଆଉଟଲାଇନ୍ ସୃଷ୍ଟି କରିବ |

ଯଦି ଏହା ଏକାଧିକ ଫାଇଲ୍ ସହିତ ଏକକ ପ୍ରୋଜେକ୍ଟ, ମୂଳ ଡିରେକ୍ଟୋରୀ TOC ହେଉଛି ଉତ୍ସ ଭାଷା ଡିରେକ୍ଟୋରୀରେ ଥିବା url: ସହିତ ଥିବା ଡିରେକ୍ଟୋରୀ | ଉଦାହରଣ ସ୍ୱରୂପ, ଯଦି ଉତ୍ସ ଭାଷା ଚାଇନିଜ୍ ଅଟେ: url: flashduty ସହିତ ଥିବା ଫାଇଲ୍ ହେଉଛି zh/flashduty/TOC |

ଯଦି ଏହା ଏକାଧିକ ପ୍ରୋଜେକ୍ଟ ଏବଂ ଏକାଧିକ ଫାଇଲ୍, url: ବିନ୍ୟାସ କରିବାର କ is ଣସି ଆବଶ୍ୟକତା ନାହିଁ | 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 ପୃଷ୍ଠା ପ୍ରଦର୍ଶିତ ହେବ |