ச்பின்க்சைப் பயன்படுத்தி ஆவணங்களை மொழிபெயர்த்தல்

Sphinx என்பது அழகான ஆவணங்களை உருவாக்குவதற்கான ஒரு கருவியாகும். இது எளிய மறுகட்டமைக்கப்பட்ட உரை தொடரியல் பயன்படுத்துகிறது மற்றும் பல வடிவங்களில் வெளியீட்டை உருவாக்க முடியும். நீங்கள் ஒரு உதாரணத்தைத் தேடுகிறீர்களானால், இந்த ஆவணமும் அதைப் பயன்படுத்தி உருவாக்கப்பட்டுள்ளது. ச்பிங்க்சைப் பயன்படுத்துவதற்கு மிகவும் பயனுள்ள துணையாக Read the Docs பணி உள்ளது, இது உங்கள் ஆவணங்களை இலவசமாக உருவாக்கி வெளியிடும்.

ஆவணங்களை எழுதுவதில் நான் கவனம் செலுத்த மாட்டேன், அதற்கான வழிகாட்டுதல் உங்களுக்குத் தேவைப்பட்டால், Sphinx இணையதளத்தில் உள்ள வழிமுறைகளைப் பின்பற்றவும். நீங்கள் ஆவணங்களைத் தயாரானதும், சூரரிமாச்சிலை இதற்கான ஆதரவுடன் வருவதால், அதை மொழிபெயர்ப்பது மிகவும் எளிதானது மற்றும் இது அவர்களின் Internationalization இல் மிகவும் அழகாக உள்ளடக்கப்பட்டுள்ளது. இது சில உள்ளமைவு வழிமுறைகள் மற்றும் ச்பிங்க்ச்-இன்ட்ல் கருவியை செயல்படுத்துவது.

நீங்கள் ரீட் தி டாக்ச் சேவையைப் பயன்படுத்துகிறீர்கள் என்றால், ரீட் தி டாக்சில் மொழிபெயர்க்கப்பட்ட ஆவணங்களை உருவாக்கத் தொடங்கலாம். அவர்களின் Localization and Internationalization உங்களுக்கு தேவையான அனைத்தையும் உள்ளடக்கியது - மற்றொரு திட்டத்தை உருவாக்கி, அதன் மொழியை அமைத்து, முக்கிய திட்டத்திலிருந்து மொழிபெயர்ப்பாக இணைக்கவும்.

இப்போது உங்களுக்கு தேவையானது ஆவண உள்ளடக்கத்தை மொழிபெயர்ப்பதுதான். சூரரிமாச்சிலை ஒவ்வொரு கோப்பகத்திற்கும் அல்லது உயர்மட்ட கோப்பிற்கும் PO கோப்பை உருவாக்குகிறது, இது நிறைய கோப்புகளை மொழிபெயர்க்க வழிவகுக்கும் (gettext_compact அமைப்புகளைப் பொறுத்து). நீங்கள் index.po ஐ வலைபெயர்ப்பு இல் தொடக்கக் கூறுகளாக இறக்குமதி செய்து, பிறவற்றைத் தானாகக் கண்டறியும் வகையில் கூறு கண்டுபிடிப்பு செருகு நிரலை உள்ளமைக்கலாம்.

கூறு கண்டுபிடிப்பு உள்ளமைவு

மொழிபெயர்ப்பு கோப்புகளை எதிர்த்து பொருத்த வழக்கமான வெளிப்பாடு

docs/locales/(?P<language>[^/.]*)/LC_MESSAGES/(?P<component>[^/]*)\.po

கூறு பெயரைத் தனிப்பயனாக்குங்கள்

Documentation: {{ component|title }}

புதிய மொழிபெயர்ப்புகளுக்கான அடிப்படை கோப்பை வரையறுக்கவும்

docs/locales/{{ component }}.pot

Hint

ஒற்றை பிஓ கோப்பை உருவாக்க ச்பின்க்ச் விரும்புகிறீர்களா? ச்பின்க்ச் 3.3.0 என்பதால் நீங்கள் இதைப் பயன்படுத்தி இதை அடையலாம்:

gettext_compact = "docs"

இந்த அணுகுமுறையைப் பயன்படுத்தி பல ஆவணத் திட்டங்கள் மொழிபெயர்க்கப்படுவதை நீங்கள் காணலாம்: