Skip to content

सीएलआई — दस्तावेज़ ​

translate-docs ​

सारांश: ai-i18n-tools translate-docs [options]

प्रत्येक docs ब्लॉक के लिए मार्कडाउन, एमडीएक्स, .astro, वैकल्पिक डॉक्युसॉरस कैटलॉग JSON (docusaurusCatalogDir), वैकल्पिक नेक्सट्रा _meta.ts/डिक्शनरी .ts, और वैकल्पिक वाइटप्रेस थीम कैटलॉग का अनुवाद करें।

मुख्य विकल्प: -l, -j, -b, --prompt-format, --force, --force-update, --check-cache, --recheck-glossary-warnings, -p / -f, --dry-run

-j: अधिकतम समानांतर स्थानीय; -b: प्रति फ़ाइल अधिकतम समानांतर बैच एपीआई कॉल। --prompt-format: बैच वायर फ़ॉर्मेट (xml | json-array | json-object)।

यह भी देखें: कैश व्यवहार और translate-docs फ़्लैग, बैच प्रॉम्प्ट फ़ॉर्मेट


write-heading-ids ​

सारांश: ai-i18n-tools write-heading-ids [options]

कम से कम एक docs[] ब्लॉक की आवश्यकता है। प्रत्येक ब्लॉक के contentPaths के तहत .md / .mdx एकत्र करता है (.translate-ignore का सम्मान करता है)। डिफ़ॉल्ट रूप से, प्रत्येक फ़्लैट ATX # शीर्षक से ठीक पहले एक HTML एंकर लाइन <a id="slug"></a> सम्मिलित करता है (फ़ेंस्ड कोड ब्लॉक के अंदर के शीर्षकों को छोड़ देता है)। किसी भी रूप के मौजूदा शीर्षक आईडी (HTML एंकर लाइन, क्लासिक {#id} सफ़िक्स, MDX {/* #id */} कमेंट) को चयनित शैली से बदल दिया जाता है; स्लग हमेशा वर्तमान शीर्षक टेक्स्ट से प्राप्त होता है। जब एक शीर्षक के ऊपर कई HTML एंकर स्टैक किए जाते हैं, तो केवल वर्तमान शीर्षक टेक्स्ट के लिए एंकर रखा जाता है, और हटाए गए आईडी की ओर इशारा करने वाले इन-रेपो मार्कडाउन लिंक को शेष आईडी में अपडेट किया जाता है। एक <a id> जो सीधे शीर्षक के ऊपर नहीं है, उसे वहीं छोड़ दिया जाता है। --slug-style mdx-comment के साथ, शीर्षक लाइन पर एक Docusaurus MDX कमेंट सफ़िक्स लिखता है (वही github-शैली स्लग एल्गोरिथम) और मौजूद होने पर पूर्ववर्ती HTML-एंकर ब्लॉक को हटा देता है। --remove उन सभी शीर्षक-आईडी रूपों को हटा देता है और उनके स्थान पर कुछ भी नहीं लिखता है।

स्रोत फ़ाइलों को अपडेट करने के बाद, कमांड प्रत्येक लोकले के मौजूदा अनुवादित मार्कडाउन को भी स्कैन करता है (translate-docs के समान docsOutput पाथ मैपिंग)। यह दस्तावेज़ क्रम में मिलान करने वाली ATX हेडिंग पर स्रोत-लोकले हेडिंग आईडी को कॉपी करता है — यह कभी भी अनुवादित शीर्षक को स्लग नहीं करता है — और एक मध्य-हेडिंग {#id} / {/* #id */} (या भटके हुए HTML <a id>) को वापस उस रूप में ले जाता है जिसकी Docusaurus / चुनी हुई शैली अपेक्षा करती है। स्रोत भाषा sourceLocale है और कोई भी भाषा हो सकती है। गुम अनुवादित फ़ाइलों को छोड़ दिया जाता है। --remove उन अनुवादित फ़ाइलों से हेडिंग आईडी को भी हटा देता है, जिसमें गलत जगह पर रखे गए मध्य-लाइन टोकन भी शामिल हैं।

जब किसी अनुवादित फ़ाइल की हेडिंग आईडी को फिर से स्थापित या मरम्मत किया जाता है, तो मिलान करने वाला कैश किया गया अनुवादित सेगमेंट (स्रोत-सेगमेंट हैश द्वारा कुंजीबद्ध) भी अपडेट हो जाता है, यदि स्रोत और पुराना तथा नया अनुवादित कंटेंट में सेगमेंट की संख्या समान है। संख्या में बेमेल होने पर उस फ़ाइल और लोकले को छोड़ दिया जाता है। बाद में एक sync --force-update फिर अपडेट की गई कैश पंक्ति से फ़ाइल को फिर से जोड़ता है।

मुख्य विकल्प: -p / --path, -f / --file, --slug-style, --remove, --dry-run

--slug-style: github (डिफ़ॉल्ट; doctoc / anchor-markdown-header), bitbucket, gitlab, pymdown, azure-devops, mdx-comment (Docusaurus {/* #… */} प्रत्यय)। pymdown के साथ, वैकल्पिक --pymdown-case, --pymdown-normalize, --pymdown-percent-encode / --no-pymdown-percent-encode। --remove को --pymdown-* के साथ नहीं जोड़ा जा सकता है।

यह भी देखें: एंकर लिंक


check-markdown ​

सारांश: ai-i18n-tools check-markdown [options]

प्रत्येक docs[] ब्लॉक के contentPaths के तहत मार्कडाउन/एमडीएक्स को स्कैन करता है (translate-docs के समान खोज, .translate-ignore का सम्मान करता है): डीलिमिटर पेयरिंग, अनक्लोज्ड इनलाइन कोड, और STRONG_OUTSIDE_LINK जब **/__ एक [text](url) लिंक को रैप करते हैं।

relativePath:line: [ISSUE_CODE] message लाइनें stderr पर प्रिंट करता है; यदि कोई समस्या पाई जाती है तो कोड 1 के साथ बाहर निकलता है। --json: stdout पर JSON रिपोर्ट। cacheDir में markdown_source_issues लिखता है जब तक कि --no-cache न हो। -v stderr लाइनों में स्रोत हैश जोड़ता है।

मुख्य विकल्प: -p / --path, -f / --file, --json, --no-cache

यह भी देखें: मार्कडाउन समस्याएँ

MIT लाइसेंस के तहत जारी किया गया।