8954fa3ad7
Native CLI i18n: The TrustGraph CLI has built-in translation support that dynamically loads language strings. You can test and use different languages by simply passing the --lang flag (e.g., --lang es for Spanish, --lang ru for Russian) or by configuring your environment's LANG variable. Automated Docs Translations: This PR introduces autonomously translated Markdown documentation into several target languages, including Spanish, Swahili, Portuguese, Turkish, Hindi, Hebrew, Arabic, Simplified Chinese, and Russian.
3.6 KiB
| layout | title | parent |
|---|---|---|
| default | स्वचालित रूप से दस्तावेज़ उत्पन्न करना | Hindi (Beta) |
महत्वपूर्ण निर्देश:
- सभी Markdown फॉर्मेटिंग, हेडर, लिंक और HTML टैग को बरकरार रखें।
- बैक टिक (
- केवल अनुवादित पाठ प्रस्तुत करें, बिना किसी प्रारंभिक या स्पष्टीकरण के।
अनुवाद करने के लिए पाठ:
स्वचालित रूप से दस्तावेज़ उत्पन्न करना
Beta Translation: This document was translated via Machine Learning and as such may not be 100% accurate. All non-English languages are currently classified as Beta.
REST और WebSocket API दस्तावेज़
specs/build-docs.sh- OpenAPI और AsyncAPI विनिर्देशों से REST और WebSocket दस्तावेज़ बनाता है।
पायथन API दस्तावेज़
पायथन API दस्तावेज़, trustgraph.api पैकेज का विश्लेषण करके एक कस्टम पायथन स्क्रिप्ट का उपयोग करके docstrings से उत्पन्न होते हैं।
पूर्व आवश्यकताएँ
trustgraph पैकेज आयात करने योग्य होना चाहिए। यदि आप एक विकास वातावरण में काम कर रहे हैं, तो:
cd trustgraph-base
pip install -e .
दस्तावेज़ उत्पन्न करना
दस्तावेज़ निर्देशिका से:
cd docs
python3 generate-api-docs.py > python-api.md
यह एक एकल Markdown फ़ाइल उत्पन्न करता है जिसमें संपूर्ण API दस्तावेज़ शामिल है, जिसमें निम्नलिखित शामिल हैं:
- स्थापना और त्वरित शुरुआत गाइड
- प्रत्येक वर्ग/प्रकार के लिए आयात कथन
- पूर्ण docstrings के साथ उदाहरण
- श्रेणियों द्वारा व्यवस्थित सामग्री तालिका
दस्तावेज़ शैली
सभी docstrings Google-शैली का पालन करते हैं:
- संक्षिप्त एक-पंक्ति सारांश
- विस्तृत विवरण
- पैरामीटर विवरण के साथ Args अनुभाग
- रिटर्न अनुभाग
- प्रासंगिक होने पर Raises अनुभाग
- उचित सिंटैक्स हाइलाइटिंग के साथ उदाहरण कोड ब्लॉक
उत्पन्न दस्तावेज़ सार्वजनिक API को ठीक उसी तरह दिखाता है जैसे उपयोगकर्ता इसे trustgraph.api से आयात करते हैं, आंतरिक मॉड्यूल संरचना को उजागर किए बिना।