Skip to content

Commit 32c7eb7

Browse files
committed
Update README.md
1 parent c604fcb commit 32c7eb7

1 file changed

Lines changed: 29 additions & 32 deletions

File tree

README.md

Lines changed: 29 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -1,42 +1,36 @@
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

87
Hangi yöntemi kulanırsanız kullanın, çevirmenlerimizin birçok dilde ama
98
mutlaka PHP ile kodlama yapabildiğini, komut satırından git kullanabildiğini,
109
GitHub 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
1311
bilgiler Linux kullananlara göre düzenlenmiştir.
1412

1513
Bir GitHub hesabınız olması önerilir.
1614
Örnek: https://github.com/nilgun
1715

1816
PR yapacaksanız GitHub hesabınızda oturum açtıktan sonra
1917
https://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`
2621
Dizine geçin ve şu komutları girin:
2722

2823
GitHub 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+
3429
Liderle ç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
4135
PHP karması olanların https://github.com/php/doc-base/README.md dosyasını
4236
okuduktan sonra buraya dönmesini öneririm.
@@ -47,8 +41,7 @@ dizininden bahsederken "çalışma dizini" diyeceğiz. Bunu yaptıktan sonra yen
4741
bir çeviriye başlamaya karar vermeden önce bu üç dizinde de daima
4842
4943
```bash
50-
git pull
51-
```
44+
$ git pull```
5245
5346
komutunu 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
5750
kopyalayacaksınız. Örneğin, `en/reference/apache/book.xml` dosyasını
5851
gö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
```
6255
komutunu vermeye eşdeğer bir işlem olacak.
6356

@@ -89,7 +82,7 @@ tamamlandığında `ready` yazacaksınız.
8982
Böylece özgün belgenin sürüm numarası değiştiğinde `en` dizini altındaki
9083
dosya için
9184
```bash
92-
git diff <EN-revision> <en/dizin/dosya>
85+
$ git diff <EN-revision> <en/dizin/dosya>
9386
```
9487
komutuyla eski ve yeni sürümler arasındaki farkı kolayca görebilecek,
9588
tü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
10093
yazmayı 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

10699
Bu başta çalışmayacak çünkü `cmhash` bir bash alias.
107100
Ev 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
```
111104
ve aynı satırı bir defalık komut satırından da girin ki oturum aç/kapa
112105
yapmak gerekmesin. Böylece her dosya için bu alengirli komutu yazmaktan
@@ -169,22 +162,25 @@ sayfasında o tırnağı bulamayabilirsiniz.
169162
Linux kullananların çeviriyi kate üzerinde yapmasını öneririm.
170163
Windows 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+
172169
Son 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.
180176
Verdiğ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

184180
Git 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
```
189185
PR yapacak olanlar bu işlemden sonra artık GitHub hesaplarında
190186
Pull Request oluşturabilir.
@@ -193,10 +189,10 @@ Pull Request oluşturabilir.
193189
aş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
```
198194
Veya 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!)
232228
Contravariance Az Özgüllük (bu ikisi tam karşılık değil, kullanıma uygunluk sağlar)
233229
Covariance Çok Özgüllük
234230
Control Structure Denetim Yapısı
235-
Default Öntanımlı
231+
Default Ön tanımlı
236232
Detail Ayrıntı (lütfen "detay" diye çevirmeyin)
237233
Digest Özet
238234
Directive Yönerge
@@ -263,6 +259,7 @@ Interpreter Yorumlayıcı
263259
integer tamsayı
264260
Label Yafta
265261
Matrix Dizey
262+
Mechanism Düzenek
266263
Method Yöntem
267264
mixed karışık
268265
Module Modül

0 commit comments

Comments
 (0)