Commit ea67a0f3 by Alexander Makarov

Merge pull request #5326 from faxriddin/master

[skip ci] changed symbols and added internals-uz
parents e309ba4b eab3ebd1
Yii 2.0 bo`yicha to`liq qo`llanma
Yii 2.0 bo'yicha to'liq qo'llanma
=============================
Ushbu qo`llanma [Yii qo`llanmalarining holati bilan](http://www.yiiframework.com/doc/terms/) bilan mos holda yo`lga qo`yildi.
Ushbu qo'llanma [Yii qo'llanmalarining holati bilan](http://www.yiiframework.com/doc/terms/) bilan mos holda yo'lga qo'yildi.
All Rights Reserved.
......@@ -17,11 +17,11 @@ Kirish
Birinchi tanishuv
-----------------
* [Yii ni o`rnatish](start-installation.md)
* [Yii ni o'rnatish](start-installation.md)
* [Ilovani ishga tushirish](start-workflow.md)
* [«Salom» deymiz](start-hello.md)
* [Formalar bilan ishlash](start-forms.md)
* [Ma`lumotlar ombori bilan ishlash](start-databases.md)
* [Ma'lumotlar ombori bilan ishlash](start-databases.md)
* [Gii yordamida kodlarni generatsiya qilish](start-gii.md)
* [Keyin nima?](start-looking-ahead.md)
......@@ -33,26 +33,26 @@ Ilova strukturasi
* [Kirish skriptlari](structure-entry-scripts.md)
* [Ilova](structure-applications.md)
* [Ilova komponentlari](structure-application-components.md)
* [Kontrollerlar](structure-controllers.md)
* [Kontrollyorlar](structure-controllers.md)
* [Namoyish](structure-views.md)
* [Modellar](structure-models.md)
* **TBD** [Filtrlar](structure-filters.md)
* **TBD** [Vidjetlar](structure-widgets.md)
* **TBD** [Modullar](structure-modules.md)
* [Ресурсы](structure-assets.md)
* [Resurslar](structure-assets.md)
* **TBD** [Kengaytmalar](structure-extensions.md)
So`rovlarni qayta ishlash
So'rovlarni qayta ishlash
-------------------------
* **TBD** [Bootstrapping](runtime-bootstrapping.md)
* **TBD** [Routing](runtime-routing.md)
* **TBD** [So`rovlar](runtime-requests.md)
* **TBD** [So'rovlar](runtime-requests.md)
* **TBD** [Javoblar](runtime-responses.md)
* **TBD** [Sessiyalar va kuklar](runtime-sessions-cookies.md)
* [URL ni tahlil va generatsiya qilish](runtime-url-handling.md)
* [Xatolilarni qayta ishlash](runtime-handling-errors.md)
* [Xatoliklarni qayta ishlash](runtime-handling-errors.md)
* [Jurnallarga yozish](runtime-logging.md)
......@@ -62,28 +62,28 @@ Asosiy tushunchalar
* [Komponentlar](concept-components.md)
* [Xususiyat](concept-properties.md)
* [Xodisa](concept-events.md)
* [O`zini tutish](concept-behaviors.md)
* [Muxim sozlashlar](concept-configurations.md)
* [O'zini tutish](concept-behaviors.md)
* [Muhim sozlashlar](concept-configurations.md)
* [Taxalluslar](concept-aliases.md)
* [Sinflarni avtoyuklash](concept-autoloading.md)
* [Service Locator](concept-service-locator.md)
* [Dependency Injection Container](concept-di-container.md)
Ma`lumotlar ombori bilan ishlash
Ma'lumotlar ombori bilan ishlash
--------------------------------
* [Ma`lumotlarga imkon beruvchi obektlar(DAO)](db-dao.md) - Ma`lumotlar ombori bilan bog`lanish, oddiy so`rovlar, tranzaksiya va sxema bilan ishlash.
* [So`rovlarni yaratuvchi](db-query-builder.md) - Ma`lumotlar omboriga abstraksiyaning oddiy qatlamidan so`rovlar.
* [Active Record](db-active-record.md) - AR obektlarini olish, ular bilan ishlash va bog`lanishlarni aniqlash.
* [Migratsiyalar](db-migrations.md) - Komandada ishlaganda ma`lumotlar sxemasini talqinlarini boshqarish.
* [Ma'lumotlar bilan ishlashga imkon beruvchi obektlar(DAO)](db-dao.md) - Ma'lumotlar ombori bilan bog'lanish, oddiy so'rovlar, tranzaksiya va sxema bilan ishlash.
* [So'rovlarni yaratuvchi](db-query-builder.md) - Ma'lumotlar omboriga abstraksiyaning oddiy qatlamidan so'rovlar.
* [Active Record](db-active-record.md) - AR obektlarini olish, ular bilan ishlash va bog'lanishlarni aniqlash.
* [Migratsiyalar](db-migrations.md) - Komandada (jamoada) ishlaganda ma'lumotlar sxemasini talqinlarini boshqarish.
* **TBD** [Sphinx](db-sphinx.md)
* **TBD** [Redis](db-redis.md)
* **TBD** [MongoDB](db-mongodb.md)
* **TBD** [ElasticSearch](db-elastic-search.md)
Foydalanuvchidan ma`lumotlarni qabul qilish
Foydalanuvchidan ma'lumotlarni qabul qilish
-------------------------------------------
* [Formani yaratish](input-forms.md)
......@@ -92,14 +92,14 @@ Foydalanuvchidan ma`lumotlarni qabul qilish
* **TBD** [Bir nechta modellar bilan ishlash](input-multiple-models.md)
Ma`lumotlarni namoyish etish
Ma'lumotlarni namoyish etish
----------------------------
* **TBD** [Ma`lumotlarni formatlash](output-formatting.md)
* **TBD** [Sahifalar bo`yicha bo`ajratish](output-pagination.md)
* **TBD** [Ma'lumotlarni formatlash](output-formatting.md)
* **TBD** [Sahifalar bo'yicha ajratish](output-pagination.md)
* **TBD** [Saralash](output-sorting.md)
* [Ma`lumotlar provayderlari](output-data-providers.md)
* [Ma`lumotlar uchun vidjetlar](output-data-widgets.md)
* [Ma'lumotlar provayderlari](output-data-providers.md)
* [Ma'lumotlar uchun vidjetlar](output-data-widgets.md)
* [Mavzulashtirish](output-theming.md)
......@@ -107,9 +107,9 @@ Xavfsizlik
----------
* [Autentifikatsiya](security-authentication.md)
* [Mualliflikka tekshiruvi](security-authorization.md)
* [Avtorizatsiya](security-authorization.md)
* [Parollar bilan ishlash](security-passwords.md)
* **TBD** [Mualliflikka tekshiruvlar mijozlari](security-auth-clients.md)
* **TBD** [Avtorizatsiya mijozlari](security-auth-clients.md)
* **TBD** [Eng yaxshi amaliyotlar](security-best-practices.md)
......@@ -117,35 +117,35 @@ Keshlash
--------
* [Sharh](caching-overview.md)
* [Ma`lumotlarni keshlash](caching-data.md)
* [Fragmentlasrni keshlash](caching-fragment.md)
* [Ma'lumotlarni keshlash](caching-data.md)
* [Fragmentlarni keshlash](caching-fragment.md)
* [Sahifalarni keshlash](caching-page.md)
* [HTTP ni keshlash](caching-http.md)
REST veb-xizmatlari
REST web-xizmatlari
-------------------
* [Tezkor boshlash](rest-quick-start.md)
* [Resurslar](rest-resources.md)
* [Kontrollerlar](rest-controllers.md)
* [Kontrollyorlar](rest-controllers.md)
* [Routing](rest-routing.md)
* [Javoblarni formatlash](rest-response-formatting.md)
* [Autentifikatsiya](rest-authentication.md)
* [So`rovlarni chastotasini chegaralash](rest-rate-limiting.md)
* [So'rovlarni chastotasini chegaralash](rest-rate-limiting.md)
* [Talqin yaratish](rest-versioning.md)
* [Xatoliklarni qayta ishlash](rest-error-handling.md)
Ishlab chiquvchi uskunalari
Ishlab chiquvchining uskunalari
---------------------------
* [Sozlashlar paneli va sozlovchi](tool-debugger.md)
* [Qayta ishlash paneli va qayta ishlovchi](tool-debugger.md)
* [Gii bilan kodni generatsiya qilish](tool-gii.md)
* **TBD** [API qo`llanmani generatori](tool-api-doc.md)
* **TBD** [API qo'llanmani generatori](tool-api-doc.md)
Test o`tkazish
Test o'tkazish
--------------
* [Sharh](test-overview.md)
......@@ -160,7 +160,7 @@ Yii kengaytmalari
* [Kengaytmani yaratish](extend-creating-extensions.md)
* [Freymvork kodini kengaytirish](extend-customizing-core.md)
* [Tashqi kutubxonalarni qo`llash](extend-using-libs.md)
* [Tashqi kutubxonalarni qo'llash](extend-using-libs.md)
* **TBD** [Tashqi tizimlarda Yii integratsiyasi](extend-embedding-in-others.md)
* **TBD** [Yii 1.1 va 2.0 larni bir vaqtda ishlatish](extend-using-v1-v2.md)
* [Composer ni ishlatish](extend-using-composer.md)
......
O'zbekchaga tarjima qilish bilan qanday ishlash kerak
=====================================================
Yii juda ko'p tillarga tarjima qilinayabdi shu jumladan o'zbekchaga ham. Tarjima qo'llanma va habarlarni o'z ichiga oladi.
Freymvork habari
----------------
Ikki turdagi habarlar bor: istisnolar, qaysiki ishlab chiquvchi nazarda tutgan va ular tarjima qilinmaydi va habarlar, qaysiki foydalanuvchilarga ko'rsatiladigan. Masalan, validatsiyaning xatoliklari.
Tarjimani yangilash uchun:
1. Konsolda `framework` direktoriyani ochamiz, `yii message/extract messages/config.php` ni ishga tushiramiz.
3. Habarlarni `framework/messages/uz/yii.php` ga ko`chiramiz. Muhimi fayllar UTF-8 kodlashda bo'lishi kerak.
4. `uz` dagi tarjimalar bilan [pull request qilamiz](https://github.com/yiisoft/yii2/blob/master/docs/internals/git-workflow.md), qolgan tillarga tegmaymiz.
Tarjima fayllarda massiv joylashgan. Uning kalitlari - boshlang'ich kodlar, qiymatlari - tarjima. Agar qiymat bo'sh bo'lsa habar tarjima qilinmagan hisoblanadi. Kodda boshqa uchramaydigan habarlar tarjimasi '@@' ga o'ralgan. Ayrim habarlar uchun [sonlar bilan qo'llanilishini qo'llab-quvvatlash uchun maxsus format](../guide/i18n.md) ni ishlatish zarur.
Qo'llanma
---------
Qo'llanamani tarjimasi `docs/<original>-uz` da joylashgan, bu yerda <original> - original direktoriyalarga mos keladi, masalan,
`guide` yoki `internals`.
Agar qo'llanma tarjimasi tugagan bo'lsa, build direktoriyasida konsolni ochib va quyidagini bajarib, originaldagi oxirgi tarjimadan keyingi diff o'zgarishlarni olish mumkin:
```
php build translation "../docs/guide" "../docs/guide-uz" "Uzbek guide translation report" > report_guide_uz.html
```
Agar composer uchun urushsa, bosh direktoriyada `composer install` ni bajaring.
Tarjima qilishdan oldin hech kim shug'ullanmayotganligini tekshiring va o'zingizga [barcha tarjima qilinayotgan hujjatlarni ro'yhatini] yozib oling
//Ushbu manzilni ulardan olgandan keyin o'zgartirib qo'yish kerak bo'ladi.
(https://docs.google.com/spreadsheets/d/10dS7VB_3jSxUorryRlplB7nhA59e3i2vLYmTwn_1d3I/edit?usp=sharing).
Barcha o'zgarishlarni quyidagi ko'rinishda olib boramiz [pull request](https://github.com/yiisoft/yii2/blob/master/docs/internals/git-workflow.md).
### Umumiy qoidalar
- Ko'p terminlar o'zbekchada bitta ma'noga ega emas va o'zbekchada ko'p qo'llanilmaydigandir, shu sababli agar matnda
shunday terminlar uchrasa ularni birinchi bor qo'llanilgan joyida qavs ichida ingliz tilidagi varianti
ko'rsatilishi kerak; (terminlarning tarjimasini qo'llanilish variantlari quyida keltirilgan);
- Agar tarjima vaqtida matnning qaysidir qismi mazmuni o'zgarayotgan bo'lsa va siz uni shunday tarjima qilish
kerakligiga ishonchingiz komil bo'lmayotganday tuyulsa ushbu qismni * ichiga oling(ichidagi matn qiya holatga keladi).
Bu olib tashlash/to'g'rilashlar vaqtida ushbu matnlarga alohida e'tibor qaratishga imkon beradi;
- Tarjima vaqtida fakt xatoliklarni qilmang!
- Matnda tashqi manbalarga murojaatlar uchraydi, agar murojaat terminni izohlash maqolasiga olib boradigan bo'lsa, u holda
o'zbekchada tarjimasi bo'r bo'lgan vaziyatda o'zbekchasiga murojaat qilinadi.
Masalan `http://en.wikipedia.org/wiki/Captcha` → `http://uz.wikipedia.org/wiki/Captcha`.
- Sharhlar kodda tarjima qilinadi, agarda birinchi holatdagi mazmunini o'zgartirmasa; Matndagi vaqtinchalik sharhlarni
imkon qadar faqat *lokal*da ishlatish kerak! Aks holda uni reliz ga tushib qolish ehtimoli bor;
- Bo'limlarni tarjima qilish vaqtida `README.md` dagi tarjimani olib ketamiz;
- Shaxsiy qo'shimcha-sharhlarni qo'shish imkoni bor, lekin xaosdan qochish uchun original bitta bo'lishi kerak. Bunga zarurat vaqtida sharh oxiriga
"tar. shar." ni qo'shish kerak;
- Hujjatni umumiy to'g'rilashni o'tkazgandan so'ng mustaqil ravishda faqat ushbu bo'limga tegsihli bo'lgan grammatikadagi, fakt xatoliklardagi o'zgarishlarni kiritish talab darajasida tavsiya etiladi. Boshqa holatlarda gaplarni to'g'rilash, yaxshilash uchun va zarur hollarda o'zgarishlarni markazlashgan tarzda barcha bo'limlar uchun amalga oshirish uchun ularni tahlilga qo'yish zarur.
### Qo'llanma strukturasi
Tarjima qilish vaqtida hujjatning struktura birligini to'g'ri nomlash muhim. Quyida keltirilgan strukturaga amal qilamiz :
- Bob 1
- Bo'lim 1
- Bo'lim 2
- Qism bo'lim 1
- ...
- Bo'lim N
- Bob 2
- ...
- Bob N
### Maxsus habarlarni tarjimasi
- Tip → Ko'rsatma
- Note → Eslatma
- Info → Ma'lumot
### Rasmlarni tarjima qilish
Qo'llanma uchun rasmlar `images` qism katalogida joylashgan. Ularning barchasi [yED](http://www.yworks.com/en/products_yed_about.html) da yaratilgan.
Zarurat tug'ilgan vaqtda fayl tarjima qilinayotgan katalogning `images` katalogiga nusxalanadi va tarjima qilinib png formatida saqlanadi.
Rasmlardagi yozuvlar tarjima qilinadi.
### Grammatika
Oxirgi variantni tashlashdan oldin uni umumiy stilini, orfografiyasini, punktlarini tekshiring. Tarjimani o'zbek tili uchun orfografiyani Wordda tekshirish imkoni bo'lmasada uning yordamida tayyorlashingiz mumkin;
### Terminlar ro'yhati
- action — amal.
- active record — tarjimasiz.
- attach handler — «qayta ishlovchini tayinlash».
- attribute of the model — model atributi.
- camel case — tarjimasiz.
- customization — (nozik) sozlash
- column — ustun (agar MO haqida gap ketayotgan bo'lsa).
- content — tashkil etuvchilari.
- controller — kontrollyor.
- debug (mode) — kod sozlash (tartibi) (production mode ga qarang).
- eager loading — ziqna yuklash uslubi/ziqna yuklash (lazy loading ga qarang).
- PHP extension — PHP kengaytmasi.
- field (of the table) — jadval (yoki atribut) maydoni.
- framework — freymvork.
- front-controller — front-kontrollyor.
- getter — getter.
- (event) handler — qayta ishlovchi (hodisa).
- hash — xesh.
- helper - yordamchi.
- id — qiymatlovchi(identifikatsiyalovchi).
- instance — nusxa.
- lazy loading — chetga olingan yuklash (qanday kerak bo'lsa shunday yuklasymiz va erta emas).
- method — metod (obektniki) //Diqqat! Obekt/klaslarda funksiyasi yo'q, faqat metodlari bor.
- model — model, ma`lumotlar modeli.
- model form — formalar modeli.
- parameter — parametr (metod yoki funksiyada va lekin klasda emas).
- to parse — qayta ishlash, agar *kontekst* tushunarsiz bo'lsa *parsing* qilish.
- placeholder — marker.
- production (mode) — ishlab chiqarish (rejimi) (см. debug mode).
- property — xususiyati (obekt).
- to render — *render* qilish, formallashtirish.
- related, relation — bog'langan, bog'lanish.
- resolve request — so'rovni oldindan qayta ishlash.
- route — marshrut.
- row (of the table) — satr(jadvallarniki).
- setter — setter.
- tabular input — tabli kiritish.
- to validate — tekshirish.
- valid — mos.
- validator — validator.
- validator class — validator klasi.
- view — namoyish.
- query builder — so'rovlar konstruktori.
\ No newline at end of file
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment