11# PHP Belgeleri NASIL çevrilir?
22
3- Çeviriye katkıda bulunmanız 3 şekilde mümkündür:
4- * PHP karmanız vardır,
3+ Çeviriye katkıda bulunmanız 2 şekilde mümkündür:
54* PR yapabilirsiniz,
65* Çevirilerinizi ekip liderine gönderirsiniz.
76
87Hangi yöntemi kulanırsanız kullanın, çevirmenlerimizin birçok dilde ama
98mutlaka PHP ile kodlama yapabildiğini, komut satırından git kullanabildiğini,
109GitHub kullanabildiğini, HTML ve XML belgeler üretmekte ve düzenlemekte zorluk
11- çekmeyeceğini, iyi ingilizce ve türkçe bildiğini ama en önemlisi "öğrenmeyi"
12- bildiğini (herşeyi bilemeyiz ama öğrenebiliriz) varsayıyoruz. Aşağıdaki
10+ çekmeyeceğini, iyi ingilizce ve türkçe bildiğini varsayıyoruz. Aşağıdaki
1311bilgiler Linux kullananlara göre düzenlenmiştir.
1412
1513Bir GitHub hesabınız olması önerilir.
1614Örnek: https://github.com/nilgun
1715
1816PR yapacaksanız GitHub hesabınızda oturum açtıktan sonra
1917https://github.com/php/doc-tr adresine gidip bu depoya bir "fork" açın.
20- Hesap sayfanızda yeni bir deponuz oldu. PR yapmayanlardan farklı olarak
21- ` tr ` deposu olarak bu depoyu kullanacaksınız.
18+ Böylece GitHub hesap sayfanızda yeni bir deponuz olacak.
2219
23- Bizim çalışacağımız modülün ismi: ` tr `
24-
25- Önce çalışma dizininizi oluşturun: ` phpdoc `
20+ Bilgisayarınızda önce çalışma dizininizi oluşturun: ` phpdoc `
2621Dizine geçin ve şu komutları girin:
2722
2823GitHub PR'ları yapacaklar için komutlar:
2924``` bash
30- git clone git@github.com:< github-user> /doc-tr.git tr
31- git clone https://github.com/php/doc-en.git en
32- git clone https://github.com/php/doc-base.git doc-base
33- ```
25+ $ git clone git@github.com:< github-user> /doc-tr.git tr
26+ $ git clone https://github.com/php/doc-en.git en
27+ $ git clone https://github.com/php/doc-base.git doc-base` ` `
28+
3429Liderle çalışacaklar için komutlar:
3530` ` ` bash
36- git clone https://github.com/php/doc-tr.git tr
37- git clone https://github.com/php/doc-en.git en
38- git clone https://github.com/php/doc-base.git doc-base
39- ```
31+ $ git clone https://github.com/php/doc-tr.git tr
32+ $ git clone https://github.com/php/doc-en.git en
33+ $ git clone https://github.com/php/doc-base.git doc-base` ` `
4034
4135PHP karması olanların https://github.com/php/doc-base/README.md dosyasını
4236okuduktan sonra buraya dönmesini öneririm.
@@ -47,8 +41,7 @@ dizininden bahsederken "çalışma dizini" diyeceğiz. Bunu yaptıktan sonra yen
4741bir çeviriye başlamaya karar vermeden önce bu üç dizinde de daima
4842
4943` ` ` bash
50- git pull
51- ```
44+ $ git pull` ` `
5245
5346komutunu vermelisiniz. Bu komut çalışma dizininizi son haline getirir.
5447` tr` dizininde sadece çevrilmiş ve çevirisi sürmekte olan dosyalar vardır.
@@ -57,7 +50,7 @@ Yani çevireceğiniz dosya `tr` altında varsa başka bir dosya seçmeniz gereke
5750kopyalayacaksınız. Örneğin, ` en/reference/apache/book.xml` dosyasını
5851gözünüze kestirdiniz diyelim. Yapacağınız, çalışma dizininizin içinde
5952` ` ` bash
60- cp en/reference/apache/book.xml tr/reference/apache/book.xml
53+ $ cp en/reference/apache/book.xml tr/reference/apache/book.xml
6154```
6255komutunu vermeye eşdeğer bir işlem olacak.
6356
@@ -89,7 +82,7 @@ tamamlandığında `ready` yazacaksınız.
8982Böylece özgün belgenin sürüm numarası değiştiğinde ` en ` dizini altındaki
9083dosya için
9184``` bash
92- git diff < EN-revision> < en/dizin/dosya>
85+ $ git diff < EN-revision> < en/dizin/dosya>
9386```
9487komutuyla eski ve yeni sürümler arasındaki farkı kolayca görebilecek,
9588tüm dosyayı yeni baştan çevirircesine elden geçirmekten kurtulacağız.
@@ -100,13 +93,13 @@ Güncelleme sırasında `123456` yerine özgün belgenin yeni commit hash'ini
10093yazmayı unutmuyoruz. Bunu elde etmek için özgün belgenin bulunduğu dizinde
10194şu komutu verin:
10295```
103- cmhash <dosya.xml>
96+ $ cmhash <dosya.xml>
10497```
10598
10699Bu başta çalışmayacak çünkü ` cmhash ` bir bash alias.
107100Ev dizinizde ` .bashrc ` dosyasının sonuna şu satırı ekleyin:
108101``` bash
109- alias cmhash=' git log -n1 --format=format:"%H"'
102+ $ alias cmhash=' git log -n1 --format=format:"%H"'
110103```
111104ve aynı satırı bir defalık komut satırından da girin ki oturum aç/kapa
112105yapmak gerekmesin. Böylece her dosya için bu alengirli komutu yazmaktan
@@ -169,22 +162,25 @@ sayfasında o tırnağı bulamayabilirsiniz.
169162Linux kullananların çeviriyi kate üzerinde yapmasını öneririm.
170163Windows kullananlara notepad++ öneririm.
171164
165+ Özellikle dikkat edilmesi gereken husus, internetteki çeviri motorlarını
166+ yardımcı olması için kullanabilirsiniz ama o çevirileri elden geçirmeden
167+ buraya göndermeyin. Hatasız çeviri yapanı (yıl: 2026) hala yok.
168+
172169Son olarak dosyayı teslim etmeden önce
173170` phpdoc/doc-base ` dizininde şu komutunu kullanın:
174171``` bash
175172$ php configure.php --with-lang=tr --enable-force-dom-save --disable-segfault-error --enable-xml-details
176173```
177- Komut hata vermemişse ve bir GiT hesabınız varsa veya GitHub PR'ı
178- yapacaksanız dosyayı depoya gönderebilirsiniz.
179- Aksi takdirde, dosyayı ekip liderine göndermelisiniz.
174+ Komut hata vermemişse ve GitHub PR'ı yapacaksanız dosyayı depoya
175+ gönderebilirsiniz. Aksi takdirde, dosyayı ekip liderine göndermelisiniz.
180176Verdiği hatayı nasıl gidereceğinizi bilmiyorsanız listedekilere sorunuz.
181177(Burada artık esr'nin ünlü belgesinden söz etmeyelim.) Hatalı dosyayı bana
182- gönderebilirsiniz ama ASLA ve ASLA depoya teslim etmeyin .
178+ gönderebilirsiniz.
183179
184180Git hesabı olanlar için teslimat işlemleri:
185181``` bash
186- git commit -m" açıklamayı buraya yazın" < dosya.xml>
187- git push
182+ $ git commit -m" açıklamayı buraya yazın" < dosya.xml>
183+ $ git push
188184```
189185PR yapacak olanlar bu işlemden sonra artık GitHub hesaplarında
190186Pull Request oluşturabilir.
@@ -193,10 +189,10 @@ Pull Request oluşturabilir.
193189aşağıdaki komutu verin ve ` revcheck.html ` dosyasını tarayıcınız ile açın.
194190Çevirmenler için çok yararlı bir araçtır.
195191``` bash
196- php doc-base/scripts/revcheck.php tr > revcheck.html
192+ $ php doc-base/scripts/revcheck.php tr > revcheck.html
197193```
198194Veya http://doc.php.net/revcheck.php?p=filesummary&lang=tr adresine bakın
199- (4 saatte bir güncellenmektedir).
195+ (saatte bir güncellenmektedir).
200196
201197
202198### Sözlük
@@ -232,7 +228,7 @@ Constants Sabitler (Değişmezler değil!)
232228Contravariance Az Özgüllük (bu ikisi tam karşılık değil, kullanıma uygunluk sağlar)
233229Covariance Çok Özgüllük
234230Control Structure Denetim Yapısı
235- Default Öntanımlı
231+ Default Ön tanımlı
236232Detail Ayrıntı (lütfen "detay" diye çevirmeyin)
237233Digest Özet
238234Directive Yönerge
@@ -263,6 +259,7 @@ Interpreter Yorumlayıcı
263259integer tamsayı
264260Label Yafta
265261Matrix Dizey
262+ Mechanism Düzenek
266263Method Yöntem
267264mixed karışık
268265Module Modül
0 commit comments