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

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

I will not focus on writing documentation itself, if you need guidance with that, just follow instructions on the Sphinx website. Once you have documentation ready, translating it is quite easy as Sphinx comes with support for this and it is quite nicely covered in their Internationalization. It's matter of a few configuration directives and invoking the sphinx-intl tool.

If you are using Read the Docs service, you can start building translated documentation on Read the Docs. Their Localization and Internationalization covers pretty much everything you need - creating another project, setting its language, and linking it from the main project as a translation.

Now all you need is translating the documentation content. Sphinx generates PO file for each directory or top-level file, which can lead to quite a lot of files to translate (depending on gettext_compact settings). You can import the index.po into Weblate as an initial component and then configure கூறு கண்டுபிடிப்பு add-on to automatically discover all others.

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

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

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

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

Documentation: {{ component|title }}

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

docs/locales/{{ component }}.pot

Hint

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

gettext_compact = "docs"

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