Docs: Globalize documentation navigation (#473)

This commit is contained in:
Minseok Song
2026-07-01 16:22:43 +09:00
committed by GitHub
parent 727357a866
commit 2416083413
4147 changed files with 151617 additions and 137381 deletions
+135 -130
View File
@@ -1,30 +1,32 @@
# Co-op Translator
_உங்கள் கல்வி GitHub உள்ளடக்கங்களை பல மொழிகளில் எளிதில் தானாக மொழி மாற்றங்களையும் பராமரிக்கவும், உங்கள் திட்டம் மாறிக்கொண்டிருக்கும்போது._
_Easily automate and maintain translations for your educational GitHub content across multiple languages as your project evolves._
![Python 3.10–3.12](https://img.shields.io/badge/python-3.10--3.12-blue)
![பைதான் 3.10–3.12](https://img.shields.io/badge/python-3.10--3.12-blue)
[![Python package](https://img.shields.io/pypi/v/co-op-translator?color=4BA3FF)](https://pypi.org/project/co-op-translator/)
[![License: MIT](https://img.shields.io/github/license/azure/co-op-translator?color=4BA3FF)](https://github.com/azure/co-op-translator/blob/main/LICENSE)
[![Downloads](https://static.pepy.tech/badge/co-op-translator)](https://pepy.tech/project/co-op-translator)
[![Downloads](https://static.pepy.tech/badge/co-op-translator/month)](https://pepy.tech/project/co-op-translator)
[![Container: GHCR](https://img.shields.io/badge/Container-GHCR-2496ED?logo=docker&logoColor=fff)](https://github.com/azure/co-op-translator/pkgs/container/co-op-translator)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![உரிமம்: MIT](https://img.shields.io/github/license/azure/co-op-translator?color=4BA3FF)](https://github.com/azure/co-op-translator/blob/main/LICENSE)
[![பதிவிறக்கங்கள்](https://static.pepy.tech/badge/co-op-translator)](https://pepy.tech/project/co-op-translator)
[![பதிவிறக்கங்கள்](https://static.pepy.tech/badge/co-op-translator/month)](https://pepy.tech/project/co-op-translator)
[![கண்டெயினர்: GHCR](https://img.shields.io/badge/Container-GHCR-2496ED?logo=docker&logoColor=fff)](https://github.com/azure/co-op-translator/pkgs/container/co-op-translator)
[![குறியீடு முறைமை: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![GitHub contributors](https://img.shields.io/github/contributors/azure/co-op-translator.svg)](https://GitHub.com/azure/co-op-translator/graphs/contributors/)
[![GitHub issues](https://img.shields.io/github/issues/azure/co-op-translator.svg)](https://GitHub.com/azure/co-op-translator/issues/)
[![GitHub pull-requests](https://img.shields.io/github/issues-pr/azure/co-op-translator.svg)](https://GitHub.com/azure/co-op-translator/pulls/)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)
[![GitHub பங்களிப்பாளர்கள்](https://img.shields.io/github/contributors/azure/co-op-translator.svg)](https://GitHub.com/azure/co-op-translator/graphs/contributors/)
[![GitHub பிரச்சினைகள்](https://img.shields.io/github/issues/azure/co-op-translator.svg)](https://GitHub.com/azure/co-op-translator/issues/)
[![GitHub புல் கோரிக்கைகள்](https://img.shields.io/github/issues-pr/azure/co-op-translator.svg)](https://GitHub.com/azure/co-op-translator/pulls/)
[![PR-கள் வரவேற்கப்படுகின்றன](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)
### 🌐 பல மொழி ஆதரவு
**இங்கே தொடங்கவும்:** [உங்கள் வேலைஅடைவை தேர்வு செய்யவும்](https://azure.github.io/co-op-translator/workflows/) | [கட்டமைப்பு](https://azure.github.io/co-op-translator/configuration/) | [CLI](https://azure.github.io/co-op-translator/cli/) | [Python API](https://azure.github.io/co-op-translator/api/) | [MCP Server](https://azure.github.io/co-op-translator/mcp/)
#### [Co-op Translator](https://github.com/Azure/Co-op-Translator) மூலம் ஆதரிக்கப்படுகிறது
### 🌐 பல-மொழி ஆதரவு
#### ஆதரிக்கப்படுகிறது: [Co-op Translator](https://github.com/Azure/co-op-translator)
<!-- CO-OP TRANSLATOR LANGUAGES TABLE START -->
[Arabic](../ar/README.md) | [Bengali](../bn/README.md) | [Bulgarian](../bg/README.md) | [Burmese (Myanmar)](../my/README.md) | [Chinese (Simplified)](../zh-CN/README.md) | [Chinese (Traditional, Hong Kong)](../zh-HK/README.md) | [Chinese (Traditional, Macau)](../zh-MO/README.md) | [Chinese (Traditional, Taiwan)](../zh-TW/README.md) | [Croatian](../hr/README.md) | [Czech](../cs/README.md) | [Danish](../da/README.md) | [Dutch](../nl/README.md) | [Estonian](../et/README.md) | [Finnish](../fi/README.md) | [French](../fr/README.md) | [German](../de/README.md) | [Greek](../el/README.md) | [Hebrew](../he/README.md) | [Hindi](../hi/README.md) | [Hungarian](../hu/README.md) | [Indonesian](../id/README.md) | [Italian](../it/README.md) | [Japanese](../ja/README.md) | [Kannada](../kn/README.md) | [Khmer](../km/README.md) | [Korean](../ko/README.md) | [Lithuanian](../lt/README.md) | [Malay](../ms/README.md) | [Malayalam](../ml/README.md) | [Marathi](../mr/README.md) | [Nepali](../ne/README.md) | [Nigerian Pidgin](../pcm/README.md) | [Norwegian](../no/README.md) | [Persian (Farsi)](../fa/README.md) | [Polish](../pl/README.md) | [Portuguese (Brazil)](../pt-BR/README.md) | [Portuguese (Portugal)](../pt-PT/README.md) | [Punjabi (Gurmukhi)](../pa/README.md) | [Romanian](../ro/README.md) | [Russian](../ru/README.md) | [Serbian (Cyrillic)](../sr/README.md) | [Slovak](../sk/README.md) | [Slovenian](../sl/README.md) | [Spanish](../es/README.md) | [Swahili](../sw/README.md) | [Swedish](../sv/README.md) | [Tagalog (Filipino)](../tl/README.md) | [Tamil](./README.md) | [Telugu](../te/README.md) | [Thai](../th/README.md) | [Turkish](../tr/README.md) | [Ukrainian](../uk/README.md) | [Urdu](../ur/README.md) | [Vietnamese](../vi/README.md)
[அரபு](../ar/README.md) | [பெங்காலி](../bn/README.md) | [பல்கேரியன்](../bg/README.md) | [புர்மீஸ் (மியான்மார்)](../my/README.md) | [சீனம் (எளிமைப்படுத்தப்பட்ட)](../zh-CN/README.md) | [சீனம் (பாரம்பரிய, ஹொங் காங்)](../zh-HK/README.md) | [சீனம் (பாரம்பரிய, மகாவ்)](../zh-MO/README.md) | [சீனம் (பாரம்பரிய, தைவான்)](../zh-TW/README.md) | [குரோஷியன்](../hr/README.md) | [செக்](../cs/README.md) | [டேனிஷ்](../da/README.md) | [டச்சு](../nl/README.md) | [எஸ்டோனியன்](../et/README.md) | [பின்ன்லாந்து](../fi/README.md) | [பிரஞ்சு](../fr/README.md) | [ஜெர்மன்](../de/README.md) | [கிரேக்கு](../el/README.md) | [ஹீப்ரூ](../he/README.md) | [ஹிந்தி](../hi/README.md) | [ஹங்கேரியன்](../hu/README.md) | [இந்தோனேஷியன்](../id/README.md) | [இத்தாலியன்](../it/README.md) | [ஜப்பானீஸ்](../ja/README.md) | [கன்னடம்](../kn/README.md) | [கெமர்](../km/README.md) | [கொரியன்](../ko/README.md) | [லிதுவேனியன்](../lt/README.md) | [மலாய்](../ms/README.md) | [மலையாளம்](../ml/README.md) | [மராத்தி](../mr/README.md) | [நேபாளி](../ne/README.md) | [நைஜீரியன் பிஜின்](../pcm/README.md) | [நார்வேஜியன்](../no/README.md) | [பெர்ஷியன் (ஃபார்ஸி)](../fa/README.md) | [போலிஷ்](../pl/README.md) | [போர்த்துகீசு (பிரேசில்)](../pt-BR/README.md) | [போர்த்துகீசு (போர்ச்சுமேண்டும்)](../pt-PT/README.md) | [பஞ்சாபி (குர்முகி)](../pa/README.md) | [ரொமானியன்](../ro/README.md) | [ரஷ்யன்](../ru/README.md) | [ஸெர்பியன் (சிரிலிக்)](../sr/README.md) | [ஸ்லோவாக்](../sk/README.md) | [ஸ்லோவேனியன்](../sl/README.md) | [ஸ்பானிஷ்](../es/README.md) | [ஸ்வாஹிலி](../sw/README.md) | [ஸ்வீடிஷ்](../sv/README.md) | [தகாலாக் (பிலிப்பைன்ஸ்)](../tl/README.md) | [தமிழ்](./README.md) | [தெலுங்கு](../te/README.md) | [தை](../th/README.md) | [துருக்கி](../tr/README.md) | [உக்ரைனியன்](../uk/README.md) | [உருது](../ur/README.md) | [வியட்நாமீஸ்](../vi/README.md)
> **உள்ளூரில் கிளோன் செய்ய விரும்புகிறீர்களா?**
> **உள்ளோடியாக கிளோன் செய்ய விருப்பமா?**
>
> இந்த ரெப்போசிடரி 50+ மொழி மொழிபெயர்ப்புகளை உள்ளடக்கியதால் பதிவிறக்கும் அளவை மிகவும் பெரிதாக்குகிறது. மொழிபெயர்ப்புகளின்றி கிளோன் செய்ய sparse checkout பயன்படுத்தவும்:
> இந்த சேமிப்பு மற்றும் மொழிபெயர்ப்புகள் 50+ மொழிகளைக் கொண்டுள்ளதாகக் காரணமாக பதிவிறக்க அளவை குறிப்பிடத்தக்கமாக அதிகரிக்கின்றன. மொழிபெயர்ப்புகள் இல்லாமல் கிளோன் செய்ய sparse checkout ஐப் பயன்படுத்தவும்:
>
> **Bash / macOS / Linux:**
> ```bash
@@ -40,140 +42,142 @@ _உங்கள் கல்வி GitHub உள்ளடக்கங்கள
> git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"
> ```
>
> இது பாடத்திட்டத்தை முடிக்க தேவையான அனைத்தையும் மிகவும் விரைவான பதிவிறக்கம் மூலம் உங்களுக்கு தரும்.
> இது பாடத்திட்டத்தை முடிக்க தேவையான அனைத்து கோப்புகளையும் மிகவும் வேகமான பதிவிறக்கத்துடன் தருகிறது.
<!-- CO-OP TRANSLATOR LANGUAGES TABLE END -->
[![GitHub watchers](https://img.shields.io/github/watchers/azure/co-op-translator.svg?style=social&label=Watch)](https://GitHub.com/azure/co-op-translator/watchers/)
[![GitHub forks](https://img.shields.io/github/forks/azure/co-op-translator.svg?style=social&label=Fork)](https://GitHub.com/azure/co-op-translator/network/)
[![GitHub stars](https://img.shields.io/github/stars/azure/co-op-translator.svg?style=social&label=Star)](https://GitHub.com/azure/co-op-translator/stargazers/)
[![GitHub வாட்சர்கள்](https://img.shields.io/github/watchers/azure/co-op-translator.svg?style=social&label=Watch)](https://GitHub.com/azure/co-op-translator/watchers/)
[![GitHub ஃபார்க்](https://img.shields.io/github/forks/azure/co-op-translator.svg?style=social&label=Fork)](https://GitHub.com/azure/co-op-translator/network/)
[![GitHub நட்சத்திரங்கள்](https://img.shields.io/github/stars/azure/co-op-translator?style=social&label=Star)](https://GitHub.com/azure/co-op-translator/stargazers/)
[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG)
[![Open in GitHub Codespaces](https://img.shields.io/static/v1?style=for-the-badge&label=Github%20Codespaces&message=Open&color=24292F&logo=github)](https://codespaces.new/azure/co-op-translator)
[![GitHub Codespaces-ல் திறக்கவும்](https://img.shields.io/static/v1?style=for-the-badge&label=Github%20Codespaces&message=Open&color=24292F&logo=github)](https://codespaces.new/azure/co-op-translator)
## மேலோட்டம்
## அவலோக்கனம்
**Co-op Translator** உங்களுக்கு உங்கள் கல்வி GitHub உள்ளடக்கங்களை பல மொழிகளில் எளிதில் உள்ளூராக்க உதவும்.
நீங்கள் உங்கள் Markdown கோப்புகள், படங்கள் அல்லது நோட்புக்க்களை புதுப்பிக்கும் போது, மொழிபெயர்ப்புகள் தானாக ஒத்திசைத்திருப்பதை உறுதிசெய்கிறது, இவ்வாறு உலகளாவிய மாணவர்களுக்கு உங்கள் உள்ளடக்கம் துல்லியமாகவும், புதுப்பிக்கப்பட்டதாகவும் இருக்கும்.
**Co-op Translator** உங்கள் கல்வி சார்ந்த GitHub உள்ளடக்கங்களை பல மொழிகளுக்கு எளிதில் உள்ளூராக்க உதவுகிறது.
நீங்கள் உங்கள் Markdown கோப்புகள், படங்கள் அல்லது நோட்புக்குகள் புதுப்பிக்கும் போதே, மொழிபெயர்ப்புகள் தானாக ஒரே சமயமாக ஒத்திசைக்கப்படக்கூடியவையாகி, உலகமுழுவதும் கற்கும் பயனாளிகளுக்காக உள்ளடக்கம் துல்லியமாகவும் புதுப்பிக்கப்பட்டதும் இருக்கும்.
மொழிபெயர்க்கப்பட்ட உள்ளடக்கம் எவ்வாறு அமைக்கப்படுகிறது என்ற ஒரு உதாரணம்:
இதை தொகுப்பகம் (CLI) மூலம் தங்கியிருப்பை மொழிபெயர்ப்பதற்காக, தன்னெழுச்சி కోసం Python API வழியாக அல்லது முகவரி/தொகுப்பாளர் வேலைபாடுகளுக்கு MCP சர்வர் வழியாகப் பயன்படுத்தலாம்.
![Example](../../imgs/translation-ex.png)
உருவாக்கப்பட்ட மொழிபெயர்க்கப்பட்ட உள்ளடக்கம் எவ்வாறு ஒழுங்குபடுத்தப்படுகிறது என்பதின் உதாரணம்:
![உதாரணம்](../../imgs/translation-ex.png)
## ஏன் Co-op Translator?
ஒரு கோப்பை மொழிபெயர்ப்பது எளிது. ஒரு முழு ஆவணத் தொகுப்பை
மொழிபெயர்க்கப்பட்டதாக, இணைக்கப்பட்டதாக மற்றும் புதுப்பிக்கப்பட்டதாக வைத்திருப்பதே கடினம்.
| பிரச்சனை | Co-op Translator எப்படி உதவுகிறது |
| --- | --- |
| நீளமான ஆவணங்கள் ஒரு மட்டும்தானான ப்ராம்ப்ட் அல்ல | பெரிய Markdown கோப்புகள் துண்டுகளாகப் பிரிக்கப்படுகின்றன, ஆகையால் ஒரு நீள README ஒரு ஒரே நெருக்கமான மாடல் பதிலையே சாரம்சம் கொள்ளாது. ஒரு துண்டு தோல்வியடைந்தால், Co-op Translator தோல்வியடைந்த பகுதியை மட்டும் மீண்டும் முயற்சிக்க மற்றும் மீண்டும் துண்டுகளை உருவாக்க முடியும். |
| முடிக்கப்படாத மொழிபெயர்ப்புகளை தற்போதையதாக குறிக்கக் கூடாது | குறைக்கப்பட்ட மொழிபெயர்ப்பு எந்த சந்ததியாகவும் up-to-date (தற்போதைய) என்று அடங்கிக் கொள்ளப்படக் கூடாது. Co-op Translator சேமிப்பதற்கு முன் மொழிபெயர்ப்பு முழுமையை சரிபார்க்கிறது மற்றும் அமைப்பு ரீதியாக непூர்த்தியான ஏற்குள்ள மொழிபெயர்ப்புகளை கண்டறிய முடியும். |
| இணைப்புகள் மொழிபெயர்க்கப்பட்ட சேமிப்பு கட்டமைப்புக்கு பொருந்த வேண்டும் | கைமுறை மொழிபெயர்ப்புகள் பெரும்பாலும் சார்ந்த இணைப்புகளை மூல மரத்திற்கு திருப்பிச் செலுத்தவைக்கின்றன. Co-op Translator Markdown, நோட்புக், படம் மற்றும் README இணைப்புகளை `translations/<lang>/...` கட்டமைப்பிற்கு பொருந்தும் விதமாக மறுஅமைத்துக் கொள்கிறது. |
| ஒரு முழு ரெப்போவில் மொழிபெயர்ப்பு பணிகள் இயங்க வேண்டும் | Co-op Translator README கோப்புகள், docs, நோட்புக்குகள் மற்றும் பட உரையை ஒரு தொகுப்பு வேலைபாட்டின் பகுதியாக கையாள்கிறது, ஒரே நேரத்தில் கோப்புகளை ஒற்றைவிதமாக மொழிபெயர்ப்பதைப்போல் அல்ல. |
| ஒருமுறை உருவாக்குவதைவிட மொழிபெயர்ப்புகளை பராமரிப்பதே முக்கியம் | மூல ஹாஷ் மற்றும் மொழிபெயர்ப்பு மெட்டாடேட்டா Co-op Translator-க்கு பழைய கோப்புகளை கண்டுபிடிக்க, மாற்றமில்லாத கோப்புகளைத் தவிர்க்க மற்றும் மூல ரெப்போ மேம்படும் போதெல்லாம் மொழிபெயர்ப்புகளை ஒத்திசைக்க வைத்து இருக்க உதவுகிறது. |
## மொழிபெயர்ப்பு நிலை எப்படி நிர்வகிக்கப்படுகிறது
Co-op Translator மொழிபெயர்க்கப்பட்ட உள்ளடக்கத்தை **பதிப்புச்செய்யப்பட்ட மென்பொருள் உருவாக்குதல்களாக** நிர்வகிக்கிறது,
நிரந்தர கோப்புகளாக அல்ல.
Co-op Translator மொழிபெயர்க்கப்பட்ட உள்ளடக்கத்தை **பதிப்பு செய்யப்பட்ட மென்பொருள் கலைப்பொருட்கள்** ஆகவும்,
நிறைவற்ற கோப்புகளாக அல்லாமல் நிர்வகிக்கின்றது.
இந்த கருவி மொழிபெயர்க்கப்பட்ட Markdown, படங்கள், நோட்புக் நிலையை
**மொழி-களஞ்சியத் தகவலுடன்** கண்காணிக்கிறது.
கருவி மொழிபெயர்ப்பு செய்யப்பட்ட Markdown, படங்கள் மற்றும் நோட்புக்குகளின்
நிலையை **மொழி-காலஅவரம் கொண்ட மெட்டாடேட்டா** மூலம் கண்காணிக்கிறது.
இந்த வடிவமைப்பு Co-op Translator இற்கு உதவுகிறது:
இந்த வடிவமைப்பு Co-op Translator-க்கு அனுமதிக்கிறது:
- பழைய மொழிபெயர்ப்புகளை நம்பகமாக கண்டறிதல்
- Markdown, படங்கள், மற்றும் நோட்புக் களை ஒரே மாதிரியான முறையில் கையாளுதல்
- வேகமாக நகரும், பெரிய மற்றும் பல மொழி உள்ள கன்டெய்னர் நிர்வாகத்தில் பாதுகாப்பாக விரிவாக்கம்
- காலாவதியான மொழிபெயர்ப்புகளை நம்பகமாக கண்டறிய
- Markdown, படங்கள் மற்றும் நோட்புக்குகள் அனைத்தையும் ஒரே விதமாக நடத்த
- பெரிய, வேகமாக நகரும் பல-மொழி ரெப்போக்களில் பாதுகாப்பாக அளவிட
மொழிபெயர்ப்புகளை நிர்வகிக்கப்படும் உருவாக்குதல்களாக வடிவமைச்சதால்,
மொழிபெயர்ப்பு பணிகள் சமகால
மென்பொருள் சார்பு மற்றும் உருவாக்குதல் நடைமுறைகளை இயல்பான முறையில் பின்பற்றுகின்றன.
மொழிபெயர்ப்புகளை நிர்வகிக்கப்படும் கலைப்பொருட்களாக பண்பமைத்தல் மூலம்,
மொழிபெயர்ப்பு வேலைபாடுகள் நவீன
மென்பொருள் பொறுப்பு மற்றும் கலைப்பொருள் நிர்வாக நடைமுறைகளுடன் இயல்பாக பொருந்துகின்றன.
→ [மொழிபெயர்ப்பு நிலை எப்படி நிர்வகிக்கப்படுகிறது](https://techcommunity.microsoft.com/blog/azuredevcommunityblog/rethinking-documentation-translation-treating-translations-as-versioned-software/4491755)
### தொடர்புடைய ஆழ்ந்த ஆய்வுகள்
## விரைவான தொடக்கம்
- [AI மொழிபெயர்ப்பில் உடைந்த Markdown சரி செய்வது: உற்பத்தி குழாய்முறையை வலுப்படுத்துதல்](https://techcommunity.microsoft.com/blog/azuredevcommunityblog/fixing-broken-markdown-in-ai-translation-hardening-a-production-pipeline/4511378)
## துவக்கம்
Co-op Translator-ஐ CLI, Python API, அல்லது MCP சர்வர் மூலம் பயன்படுத்தலாம். உள்ளக மொழிபெயர்ப்பு, தன்னேலச்செயல், CI மற்றும் முகவர்/தொகுப்பாளர் ஒருங்கிணைப்பு ஆகியவற்றில் தேர்வு செய்யும்போது வேலைஅடை வழிகாட்டியுடன் தொடங்குங்கள்.
- [உங்கள் வேலைஅடைவை தேர்வு செய்யவும்](../../docs/workflows.md)
- [அங்கீகாரங்களை அமைக்கவும்](../../docs/configuration.md)
- [CLI மூலம் மொழிபெயர்க்கவும்](../../docs/cli.md)
- [Python API மூலம் தன்னேலச்செயலாக்கம் செய்யவும்](../../docs/api.md)
- [MCP Server உடன் இணைக்கவும்](../../docs/mcp.md)
- [GitHub Actions-ல் இயக்கவும்](../../docs/github-actions.md)
கட்டமைப்புக்குப் பிறகு குறைந்தபட்ச CLI உதாரணம்:
```bash
# ஒரு மெய்நிகர் சூழலை உருவாக்கி செயல்படுத்தவும் (பரிந்துரைக்கப்படுகிறது)
python -m venv .venv
# விண்டோஸ்
.venv\Scripts\activate
# மேக்OS/லினக்ஸ்
# மெக் ஓஎஸ்/லினக்ஸ்
source .venv/bin/activate
# தொகுதியை நிறுவவும்
pip install co-op-translator
# மொழிபெயர்க்கவும்
translate -l "ko ja fr" -md
translate -l "ko" -md
co-op-review -l "ko"
```
Docker:
பெரிய ரெப்போக்களில் முதன்முறையாக இயக்கும்போது, மொழிபெயர்க்கப்பட்ட கோப்புகளை எழுதுவதற்கு முன் `--dry-run` ஐப் பயன்படுத்தவும். உள்ளடக்க வகை கொடிய்கள், பதிவுகள், மதிப்பாய்வு மற்றும் இணைப்பு இடமாற்றம் பற்றிய விவரங்களுக்கு [CLI குறிப்புரை](../../docs/cli.md) பார்க்கவும்.
Bash/Zsh உடன் பகட்டெரி விரைவு இயக்கம்:
```bash
# GHCR இல் இருந்து பொதுப்படத்தை எடு
docker pull ghcr.io/azure/co-op-translator:latest
# தற்போதைய கோப்புறை மவுண்ட் செய்யப்பட்டு .env கொடுக்கப்பட்டபடி இயக்கு (Bash/Zsh)
docker run --rm -it --env-file .env -v "${PWD}:/work" ghcr.io/azure/co-op-translator:latest -l "ko ja fr" -md
docker run --rm -it --env-file .env -v "${PWD}:/work" ghcr.io/azure/co-op-translator:latest -l "ko" -md
```
## குறைந்தபட்ச அமைப்பு
PowerShell உடன் பகட்டெரி விரைவு இயக்கம்:
1. உங்களிடம் ஆதரிக்கப்படும் Python பதிப்பு (தற்போது 3.10-3.12) இருப்பதை உறுதி செய்யுங்கள். poetry (pyproject.toml) இல் இது தானாக கையாளப்படுகிறது.
2. டெம்ப்ளேட் பயன்படுத்தி `.env` கோப்பை உருவாக்குங்கள்: [.env.template](../../.env.template)
3. ஒரு LLM வழங்கியாளரை ஒருமுறை அமைக்கவும் (Azure OpenAI அல்லது OpenAI)
4. (விருப்பமானது) பட மொழிபெயர்ப்புக்கு (`-img`), Azure AI Vision ஐ அமைக்கவும்
5. (விருப்பமானது) `_1`, `_2` போன்ற சப்ஸ்பீக்ஸ்களை பயன்படுத்தி பல போதுமான அங்கீகார தொகுதிகளை அமைக்கலாம். ஒரு தொகுதியில் அனைத்து மாறிலிகளும் அதே சப்ஸ்பீக்ஸை பகிர வேண்டும்.
6. (சிபார்சுகள்) முன் மொழிபெயர்ப்புகளை அழிந்து ஒத்திசைவற்றதைக் கையிருத்தல் (எ.கா., `translations/`)
7. (சிபார்சுகள்) உங்கள் README உள்நிலை மொழிபெயர்க்கும் பகுதியை [README languages template](./getting_started/README_languages_template.md) பயன்படுத்தி சேர்க்கவும்
8. பாருங்கள்: [Azure AI அமைப்பு](./getting_started/set-up-azure-ai.md)
## பயன்படுத்தும் முறை
அடையாளம் செய்யப்பட்ட அனைத்து ஆதரவு வகைகளையும் மொழிபெயர்க்கவும்:
```bash
translate -l "ko ja"
```powershell
docker run --rm -it --env-file .env -v ${PWD}:/work ghcr.io/azure/co-op-translator:latest -l "ko" -md
```
Markdown மட்டும்:
```bash
translate -l "de" -md
```
Markdown + படங்கள்:
```bash
translate -l "pt" -md -img
```
பட்டியல்கள் மட்டும்:
```bash
translate -l "zh" -nb
```
மேலும் கொடிகள்: [Command reference](./getting_started/command-reference.md)
## அம்சங்கள்
- Markdown, நோட்பூக்கள் மற்றும் படங்களுக்கான தானியங்கி மொழிபெயர்ப்பு
- மூல மாற்றங்களுடன் மொழிபெயர்ப்புகளை ஒத்திசைக்கிறது
- உள்ளூரிலும் (CLI) அல்லது CI (GitHub Actions) இலும் இயங்குகிறது
- Azure OpenAI அல்லது OpenAI பயன்படுத்துகிறது; படங்களுக்கு விருப்பமாக Azure AI Vision
- Markdown வடிவமைப்பையும் அமைப்பையும் பாதுகாக்கிறது
- Markdown, நோட்புக்குகள், மற்றும் படங்களுக்கு தானியக்க மொழிபெயர்ப்பு
- மூல மாற்றங்களுடன் மொழிபெயர்ப்புகளை ஒத்திசைக்க வைத்தல்
- உள்ளகமாக (CLI) அல்லது CI (GitHub Actions) இல் வேலை செய்யும்
- MCP மூலம் Markdown, நோட்புக், படம், மதிப்பாய்வு மற்றும் திட்ட மொழிபெயர்ப்பு கருவிகளை வெளிப்படுத்துகிறது
- Azure OpenAI அல்லது OpenAI ஐப் பயன்படுத்தி வழங்குநர் ஆதரவு மொழிபெயர்ப்பு
- MCP உதவியுடன் முகவர்கள் Co-op Translator LLM அங்கீகாரங்கள் இல்லாமல் Markdown மற்றும் நோட்புக் துண்டுகளை மொழிபெயர்க்க அனுமதிக்கிறது
- பட உரை எடுக்க மற்றும் மொழிபெயர்க்க Azure AI Vision பயன்படுத்துகிறது
- தீர்மானமான சரிபார்ப்புகளோடு மொழிபெயர்ப்பு அமைப்பு மற்றும் تازாத்துவத்தை மதிப்பாய்வு செய்கிறது
- Markdown வடிவமைப்பு மற்றும் அமைப்பை பாதுகாக்கிறது
## ஆவணங்கள்
- [கமாண்ட்-லைன் வழிகாட்டு](./getting_started/command-line-guide/command-line-guide.md)
- [GitHub செயலிகள் வழிகாட்டு (பொது ரெப்போசிடரிகள் & நிலையான ரகசியங்கள்)](./getting_started/github-actions-guide/github-actions-guide-public.md)
- [GitHub செயலிகள் வழிகாட்டு (Microsoft அமைப்பு ரெப்போசிடரிகள் & அமைப்புப் நிலை அமைப்புகள்)](./getting_started/github-actions-guide/github-actions-guide-org.md)
- [README மொழி டெம்ப்ளேட்](./getting_started/README_languages_template.md)
- [ஆதரவு மொழிகள்](./getting_started/supported-languages.md)
- [பங்களிப்பு](./CONTRIBUTING.md)
- [சிக்கல் தீர்க்கும் வழிகாட்டு](./getting_started/troubleshooting.md)
- [ஆவணங்கள் தளம்](https://azure.github.io/co-op-translator/)
- [உங்கள் வேலைஅடைவை தேர்வு செய்யவும்](../../docs/workflows.md)
- [கட்டமைப்பு](../../docs/configuration.md)
- [Azure AI அமைப்பு](../../docs/azure-ai-setup.md)
- [CLI குறிப்புரை](../../docs/cli.md)
- [Python API](../../docs/api.md)
- [MCP Server](../../docs/mcp.md)
- [GitHub Actions](../../docs/github-actions.md)
- [README மொழிகள் வார்ப்புரை](../../docs/readme-languages-template.md)
- [ஆதரிக்கப்படும் மொழிகள்](../../docs/supported-languages.md)
- [மகிழ்ச்சியளிக்கும் பங்களிப்பு](../../CONTRIBUTING.md)
- [பிரச்சனைகளை தீர்க்குதல்](../../docs/troubleshooting.md)
### Microsoft-க்கு சிறந்த வழிகாட்டு
### மைக்ரோசாஃப்ட்-சார்ந்த வழிகாட்டி
> [!NOTE]
> Microsoft “For Beginners” ரெப்போசிடரிகளை பராமரிப்பவர்களுக்கே.
> மைக்ரோசாஃப்ட் “For Beginners” ரெப்போக்களின் பராமரிப்பாளர்களுக்காக மட்டுமே.
- [“மற்ற பாடத்திட்டங்கள்” பட்டியலை புதுப்பித்தல் (MS Beginners ரெப்போசிடரிகளுக்கு மட்டும்)](./getting_started/update-other-courses.md)
- [“மற்ற பாடநெறிகள்” பட்டியலைப் புதுப்பித்தல் (MS Beginners ரெப்போக்களுக்காக மட்டுமே)](../../docs/microsoft-beginners.md)
## எங்களுக்கு ஆதரவாகவும், உலகளாவிய கற்றலையும் ஊக்கவும்
## எங்களை ஆதரிக்கவும் மற்றும் உலகளாவிய கல்வியை ஊக்குவிக்கவும்
கல்வி உள்ளடக்கம் உலகளாவியமாவ முறையில் பகிரப்படுவதை மாற்றுவோம்! [Co-op Translator](https://github.com/azure/co-op-translator) GitHub இல் ⭐ தரவும், கற்றலும் தொழில்நுட்பமுமுள்ள மொழி தடைகளை உடைக்க இது ஒரு முக்கிய பணி என்பதை ஆதரிக்கவும். உங்கள் ஆர்வம் மற்றும் பங்களிப்புகள் பெரிய தாக்கங்களை ஏற்படுத்துகின்றன! குறியீட்டு பங்களிப்புகள் மற்றும் அம்ச பரிந்துரைகள் எப்போதும் வரவேற்கப்படுகின்றன.
### Microsoft கல்வி உள்ளடக்கத்தை உங்கள் மொழியில் ஆராய்க
கல்வி உள்ளடக்கம் உலகளாவிய அளவில் பகிரப்படும் விதத்தை மாற்றுவதில் எங்களைச் சேர்ந்துகொள்வீர்கள்! [Co-op Translator](https://github.com/azure/co-op-translator) இல் GitHub-இல் ⭐ ஒன்றைப் பதியுங்கள் மற்றும் கற்றல் மற்றும் தொழில்நுட்பத்தில் மொழி தடைகளை அகற்றும் எங்கள் பணி மற்றும் ஐடியாக்களை ஆதரிக்கவும். உங்கள் ஆர்வமும் பங்களிப்புகளும் மிகப்பெரிய தாக்கத்தை உண்டாக்குகின்றன! குறியீடு பங்களிப்புகளும் அம்ச பரிந்துரைகளும் எப்போதும் வரவேற்கப்படுகின்றன.
### உங்கள் மொழியில் Microsoft கல்வி உள்ளடக்கங்களை ஆராயவும்
- [LangChain4j-for-Beginners](https://github.com/microsoft/LangChain4j-for-Beginners)
- [AZD for Beginners](https://github.com/microsoft/AZD-for-beginners)
- [Edge AI for Beginners](https://github.com/microsoft/edgeai-for-beginners)
@@ -190,54 +194,55 @@ translate -l "zh" -nb
- [IoT for Beginners](https://aka.ms/iot-beginners)
- [PhiCookBook](https://github.com/microsoft/PhiCookBook)
## வீடியோ ஆவணங்கள்
## Video presentations
👉 YouTube இல் பார்க்க கீழே உள்ள படத்தை அழுத்தவும்.
👉 YouTube-ல் பார்ப்பதற்காக கீழே உள்ள படத்தை கிளிக் செய்யவும்.
- **Microsoft இல் திறக்கவும்**: Co-op Translator பயன்பாட்டை விரைவாக அறிமுகம் செய்யும் 18 நிமிட குறும்படம்.
- **Open at Microsoft**: Co-op Translator-ஐ எப்படி பயன்படுத்துவது என்பதற்கான சுருக்கமான 18 நிமிட அறிமுகம் மற்றும் விரைவு வழிகாட்டி.
[![Open at Microsoft](../../imgs/open-ms-thumbnail.jpg)](https://www.youtube.com/watch?v=jX_swfH_KNU)
## பங்களிப்புகள்
## Contributing
இந்த திட்டம் பங்களிப்பும் பரிந்துரைகளையும் வரவேற்கிறது. Azure Co-op Translator யில் பங்களிக்க விருப்பர்கள், தயவுசெய்து எங்களது [CONTRIBUTING.md](./CONTRIBUTING.md) ஐப் பாருங்கள், எப்படி Co-op Translator ஐ மேலும் அணுகக்கூடியதாக மாற்றலாம் என்பதைப் பற்றி வழிகாட்டுதல்கள் உள்ளன.
இந்த திட்டம் பங்களிப்புகளையும் பரிந்துரைகளையும் வரவேற்கிறது. Azure Co-op Translator-க்கு பங்களிக்க ஆர்வமுடையவரா? Co-op Translator-ஐ மேலும் அணுகக்கூடியதாக ஆக்க நீங்கள் எப்படி உதவலாம் என்பதற்கான வழிகாட்டல்களுக்கு தயவுசெய்து எங்கள் [CONTRIBUTING.md](../../CONTRIBUTING.md) ஐப் பார்க்கவும்.
## Contributors
## பங்களிப்பாளர்கள்
[![co-op-translator contributors](https://contrib.rocks/image?repo=Azure/co-op-translator)](https://github.com/Azure/co-op-translator/graphs/contributors)
## நடத்துமுறை விதிகள்
## Code of Conduct
இந்த திட்டம் [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) ஐ ஏற்றுக்கொண்டுள்ளது. மேலும் தகவலுக்கு [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) ஐ பார்க்கவும் அல்லது கூடுதல் கேள்விகள் அல்லது கருத்துக்களுக்கு [opencode@microsoft.com](mailto:opencode@microsoft.com) ஐ தொடர்பு கொள்ளவும்.
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
## பொறுப்பான AI
## Responsible AI
Microsoft எங்கள் AI தயாரிப்புகளை பொறுப்புடன் பயன்படுத்த எங்கள் வாடிக்கையாளர்களுக்கு உதவுவதைப் பணியாளர் நியமனம் செய்திருக்கிறது, எங்கள் கற்றல்களை பகிர்ந்து, Transparency Notes மற்றும் Impact Assessments போன்ற கருவிகளின் மூலம் நம்பகமான கூட்டுதொடர்புகளை உருவாக்குகிறது. இந்த வளங்கள் பலவற்றையும் [https://aka.ms/RAI](https://aka.ms/RAI) இல் காணலாம். Microsoft-ன் பொறுப்பான AI அணுகுமுறை நீதி, நம்பகத்தன்மை மற்றும் பாதுகாப்பு, தனியுரிமை மற்றும் பாதுகாப்பு, உள்ளடக்கம், வெளிப்படைமை மற்றும் கணக்காய்வேற்பு ஆகிய AI கொள்கைகளில் அடிப்படையாக்கப்பட்டுள்ளது.
Microsoft is committed to helping our customers use our AI products responsibly, sharing our learnings, and building trust-based partnerships through tools like Transparency Notes and Impact Assessments. Many of these resources can be found at [https://aka.ms/RAI](https://aka.ms/RAI).
Microsoft's approach to responsible AI is grounded in our AI principles of fairness, reliability and safety, privacy and security, inclusiveness, transparency, and accountability.
இந்த மாதிரியில் பயன்படுத்தப்படும் பெரிய அளவிலான இயற்கை மொழி, படம் மற்றும் உரை மாதிரிகள் - அவை நியாயமில்லாத, நம்பிக்கையில்லாத அல்லது திடீரென அவமதிப்பான முறையில் நடந்துகொள்ளக்கூடும், இதனால் தீமைகள் ஏற்படலாம். ஆபத்துக்களும் வரம்புகளும் பற்றி அறிவதற்கு [Azure OpenAI சேவை Transparency note](https://learn.microsoft.com/legal/cognitive-services/openai/transparency-note?tabs=text) ஐ ஆலோசிக்கவும்.
Large-scale natural language, image, and speech models - like the ones used in this sample - can potentially behave in ways that are unfair, unreliable, or offensive, in turn causing harms. Please consult the [Azure OpenAI service Transparency note](https://learn.microsoft.com/legal/cognitive-services/openai/transparency-note?tabs=text) to be informed about risks and limitations.
இந்த ஆபத்துக்களை குறைக்க பரிந்துரைக்கப்படும் முறையானது உங்கள் கட்டமைப்பில் பளுவிழுப்பு நடந்துகொள்ளாததும் தீங்கான நடத்தை தடுக்கும் பாதுகாப்பு அமைப்பை உள்ளடக்குவதே ஆகும். [Azure AI Content Safety](https://learn.microsoft.com/azure/ai-services/content-safety/overview) ஒரு தனித்தனி பாதுகாப்பு அடுக்கை வழங்குகிறது, பயன்பாடுகள் மற்றும் சேவைகளில் தீங்கு தரும் பயனர் மற்றும் AI உருவாக்கிய உள்ளடக்கத்தை கண்டறியக்கூடியது. Azure AI Content Safety உரை மற்றும் பட API-களை உடையது, அதுவும் தீங்கு விளைவிக்கக்கூடிய உள்ளடக்கத்தை கண்டறிய உதவுகிறது. பல்வேறு முறைமைகளின் நீக்கம் சம்பந்தமான தீங்கு உள்ளடக்கத்தைக் கண்டறிய உதவுவதற்கான నమூனிக் குறியீடுகள் பார்க்க, சோதிக்க மற்றும் முயற்சிக்க இந்த இன்டரാക்டிவ் Content Safety Studio உள்ளது. சேவைக்கு கோரிக்கை செய்ய இந்த [quickstart ஆவணம்](https://learn.microsoft.com/azure/ai-services/content-safety/quickstart-text?tabs=visual-studio%2Clinux&pivots=programming-language-rest) உங்களை வழிநடத்தும்.
The recommended approach to mitigating these risks is to include a safety system in your architecture that can detect and prevent harmful behavior. [Azure AI Content Safety](https://learn.microsoft.com/azure/ai-services/content-safety/overview) provides an independent layer of protection, able to detect harmful user-generated and AI-generated content in applications and services. Azure AI Content Safety includes text and image APIs that allow you to detect material that is harmful. We also have an interactive Content Safety Studio that allows you to view, explore and try out sample code for detecting harmful content across different modalities. The following [quickstart documentation](https://learn.microsoft.com/azure/ai-services/content-safety/quickstart-text?tabs=visual-studio%2Clinux&pivots=programming-language-rest) guides you through making requests to the service.
மற்றொரு அம்சம் முழுமையான பயன்பாட்டு செயல்திறனை கணக்கில் கொள்வதே ஆகும். பல-முறைமையாகவும் பல மாதிரிகளாகவும் செயல்படும் பயன்பாடுகளில், செயல்திறன் என்பது உங்கள் மற்றும் உங்கள் பயனர்களின் எதிர்பார்ப்பைப் பூர்த்தி செய்ய உரிய முறையில் செயல்படுவதாக கருதியுள்ளது, அதாவது தீங்கு விளைவிக்கக்கூடிய வெளியீடுகளை உருவாக்காமல் இருக்குதல். உங்கள் முழுமையான பயன்பாட்டின் செயல்திறன் மதிப்பீடு செய்ய [generation quality and risk and safety metrics](https://learn.microsoft.com/azure/ai-studio/concepts/evaluation-metrics-built-in) பயன்படுத்துவது முக்கியம்.
Another aspect to take into account is the overall application performance. With multi-modal and multi-models applications, we consider performance to mean that the system performs as you and your users expect, including not generating harmful outputs. It's important to assess the performance of your overall application using [generation quality and risk and safety metrics](https://learn.microsoft.com/azure/ai-studio/concepts/evaluation-metrics-built-in).
உங்கள் AI பயன்பாட்டை உங்கள் வளர்ப்பு சூழலில் [prompt flow SDK](https://microsoft.github.io/promptflow/index.html) மூலம் மதிப்பீடு செய்யலாம். ஒரு சோதனை தரவுத்தொகையும் இலக்‌ஷியுமானவையும் கொடுக்கப்படும்போது, உங்கள் உருவாக்கும் AI பயன்பாட்டின் உருவாக்கங்கள் உள்நிலை மதிப்பீட்டாளர்களோ அல்லது உங்கள் விருப்பமான தனிப்பயன் மதிப்பீட்டாளர்களோ மூலம் மதிப்பிடப்படும். உங்கள் அமைப்பை மதிப்பீடு செய்ய prompt flow sdk உடன் தொடங்க, [quickstart கையேட்டை](https://learn.microsoft.com/azure/ai-studio/how-to/develop/flow-evaluate-sdk) பின்தொடரவும். மதிப்பீட்டு ஓட்டம் செயல்படுத்தியதற்கு பிறகு, [Azure AI Studio இல் முடிவுகளை காட்சி படுத்தலாம்](https://learn.microsoft.com/azure/ai-studio/how-to/evaluate-flow-results).
You can evaluate your AI application in your development environment using the [prompt flow SDK](https://microsoft.github.io/promptflow/index.html). Given either a test dataset or a target, your generative AI application generations are quantitatively measured with built-in evaluators or custom evaluators of your choice. To get started with the prompt flow sdk to evaluate your system, you can follow the [quickstart guide](https://learn.microsoft.com/azure/ai-studio/how-to/develop/flow-evaluate-sdk). Once you execute an evaluation run, you can [visualize the results in Azure AI Studio](https://learn.microsoft.com/azure/ai-studio/how-to/evaluate-flow-results).
## வர்த்தக அடையாளங்கள்
## Trademarks
இந்த திட்டத்தில் திட்டங்கள், தயாரிப்புகள் அல்லது சேவைகள் தொடர்பான வர்த்தக அடையாளங்கள் அல்லது லோகோக்கள் இருக்கலாம். Microsoft வர்த்தக அடையாளங்கள் அல்லது லோகோக்களின் அனுமதிக்கப்பட்ட பயன்படுத்தல் [Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general) என்பதை பின்பற்ற வேண்டும். Microsoft வர்த்தக அடையாளங்கள் அல்லது லோகோக்கள் திருத்தப்பட்ட பதிப்புகளில் பயன்படுத்தப்படுவதை Microsoft ஆதரவு என்று தவறாக ஊகிக்க கூடாது அல்லது குழப்பம் ஏற்படுத்த கூடாது. மூன்றாம் பக்கம் வர்த்தக அடையாளங்கள் அல்லது லோகோக்களின் பயன்பாடு அந்த மூன்றாம் பக்கம் கொள்கைகளுக்கு உட்பட்டது.
This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft
trademarks or logos is subject to and must follow
[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
Any use of third-party trademarks or logos are subject to those third-party's policies.
## உதவி பெறுதல்
## Getting Help
AI அப் தயாரிப்பில் சிக்கலானால் அல்லது கேள்விகள் இருந்தால், இணையுங்கள்:
If you get stuck or have any questions about building AI apps, join:
[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/nTYy5BXMWG)](https://discord.gg/nTYy5BXMWG)
தயாரிப்புக்கு பின்னூட்டம் அல்லது பிழைகள் உள்ளனவேண்டுமானால்:
If you have product feedback or errors while building visit:
[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum)
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**விரோதத்தைத் தவிர்ப்பு**:
இந்த ஆவணம் AI மொழிபெயர்ப்பு சேவை [Co-op Translator](https://github.com/Azure/co-op-translator) மூலம் மொழிபெயர்க்கப்பட்டதாகும். நாங்கள் துல்லியத்துக்காக உழைக்கிறோம் என்றாலும், தானியங்கி மொழிபெயர்ப்புகளில் பிழைகள் அல்லது தவறுகள் இருக்கக்கூடும் என்பதை தயவுசெய்து கவனியுங்கள். சுருக்கமான ஆவணம் அதன் உள்ளடக்க மொழியில் அதிகாரப்பூர்வ மூலமாக கருதப்பட வேண்டும். முக்கியமான தகவல்களுக்கு, தொழில்முறை மனித மொழிபெயர்ப்பு பரிந்துரைக்கப்படுகிறது. இந்த மொழிபெயர்ப்பின் பயன்படுத்தலால் ஏற்படும் எந்தவொரு தவறான புரிதலும் அல்லது தவறான விளக்கங்களுக்கும் நாங்கள் பொறுப்பேற்க மாட்டோம்.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->
[![Microsoft Foundry Developer Forum](https://img.shields.io/badge/GitHub-Microsoft_Foundry_Developer_Forum-blue?style=for-the-badge&logo=github&color=000000&logoColor=fff)](https://aka.ms/foundry/forum)