You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Buradaki belgeler [reStructuredText](http://docutils.sourceforge.net/rst.html) formatında yazılmış ve [Sphinx](http://www.sphinx-doc.org/) kullanılarak derlenmiştir.
4
-
Belgeleri derlemek için öncelikle Sphinx'i kurmalısınız. Sphinx, Python'un 3.6 ve daha yukarı versiyonlarını desteklemektedir.
3
+
Buradaki belgeler [reStructuredText](http://docutils.sourceforge.net/rst.html) formatında yazılmış ve [Sphinx](http://www.sphinx-doc.org/) kullanılarak derlenmiştir. Belgeleri derlemek için öncelikle Sphinx'i kurmalısınız. Sphinx, Python'un 3.10 ve daha yukarı versiyonlarını desteklemektedir.
4
+
5
5
Belgelere katkıda bulunmayı planlıyorsanız önce [`CONTRIBUTING.md`](CONTRIBUTING.md) dosyasına başvurun.
6
6
7
7
## Debian/Ubuntu
8
8
9
-
Bir Python3.6+ sürümünün, `pip`'in ve `make`'in sisteminizde kurulu olduğundan emin olduktan sonra projenin kök dizinine gidip bu komut ile gerekli kütüphaneleri kurabilirsiniz:
9
+
Bir Python3.10+ sürümünün, `pip`'in ve `make`'in sisteminizde kurulu olduğundan emin olduktan sonra projenin kök dizinine gidip bu komut ile gerekli kütüphaneleri kurabilirsiniz:
10
10
11
11
```shell
12
-
$ python3 -m pip install -r requirements.txt
12
+
python3 -m pip install -r requirements.txt
13
13
```
14
14
15
15
Daha sonra yine projenin kök dizinde bu komutu çalıştırarak belgeleri inşa edebilirsiniz:
16
16
17
17
```shell
18
-
$ make html
18
+
make html
19
19
```
20
20
21
21
Belgeleri inşa ettikten sonra `/scripts/move_documents.py` betiği `/build/` içindeki gerekli dosya ve klasörleri `/docs/` içine taşıyacaktır:
22
22
23
23
```shell
24
-
$ python3 ./scripts/move_documents.py
24
+
python3 ./scripts/move_documents.py
25
25
```
26
26
27
27
Bu şekilde inşa ettiğiniz dökümanı görüntülemek için `/docs/index.html` dosyasını tarayıcınız ile açabilirsiniz.
28
28
29
29
## Windows
30
30
31
-
Python'un 3.6 veya daha yüksek bir sürümünün bilgisayarınızda kurulu olduğundan ve `python.exe`'nin PATH'de bulunduğundan emin olduktan sonra projenin kök dizinine gidip bu kodu ``cmd.exe``'de çalıştırarak gerekli kütüphaneleri kurabilirsiniz:
31
+
Python'un 3.10 veya daha yüksek bir sürümünün bilgisayarınızda kurulu olduğundan ve `python.exe`'nin PATH'de bulunduğundan emin olduktan sonra projenin kök dizinine gidip bu kodu ``cmd.exe``'de çalıştırarak gerekli kütüphaneleri kurabilirsiniz:
32
32
33
33
```shell
34
-
>python -m pip install -r requirements.txt
34
+
python -m pip install -r requirements.txt
35
35
```
36
36
37
37
Yükleme işlemi başarıyla gerçekleşmiş ise şu komut size Sphinx'in versiyonunu verecektir:
38
38
39
39
```shell
40
-
>sphinx-build --version
40
+
sphinx-build --version
41
41
```
42
42
43
43
Daha sonra yine projenin kök dizinde bu komutu çalıştırarak belgeleri inşa edebilirsiniz:
44
44
45
45
```shell
46
-
>make.bat html
46
+
make.bat html
47
47
```
48
48
49
49
Belgeleri inşa ettikten sonra `/scripts/move_documents.py` betiği `/build/` içindeki gerekli dosya ve klasörleri `/docs/` içine taşıyacaktır:
50
50
51
51
```shell
52
-
>python scripts/move_documents.py
52
+
python scripts/move_documents.py
53
53
```
54
54
55
55
Bu şekilde inşa ettiğiniz dökümanı görüntülemek için `/docs/index.html` dosyasını tarayıcınız ile açabilirsiniz.
@@ -58,6 +58,8 @@ Bu şekilde inşa ettiğiniz dökümanı görüntülemek için `/docs/index.html
58
58
59
59
Diğer işletim sistemlerinde Sphinx kurulumu ve ayrıntılı bilgi için [buraya](https://www.sphinx-doc.org/en/master/usage/installation.html) bakabilirsiniz.
60
60
61
+
---
62
+
61
63
## Belgeleri diğer formatlarda inşa etme
62
64
63
65
Önce yukarıdaki adımları takip edip Sphinx'in kurulumunu gerçekleştirin.
@@ -66,52 +68,59 @@ Belgeleri diğer formatlarda inşa ettikten sonra da `/scripts/move_documents.py
66
68
67
69
### Tek parça HTML olarak inşa etme
68
70
69
-
Windows'ta:
71
+
Debian/Ubuntu'da:
70
72
71
73
```shell
72
-
>make.bat singlehtml
74
+
make singlehtml
73
75
```
74
76
75
-
Debian/Ubuntu'da:
77
+
Windows'ta:
76
78
77
79
```shell
78
-
$ make singlehtml
80
+
make.bat singlehtml
79
81
```
80
82
81
83
HTML dosyası `/build/singlehtml/` dizininde `index.html` adı ile oluşacaktır.
82
84
83
85
### EPUB olarak inşa etme
84
86
85
-
Windows'ta:
87
+
Debian/Ubuntu'da:
86
88
87
89
```shell
88
-
>make.bat epub
90
+
make epub
89
91
```
90
92
91
-
Debian/Ubuntu'da:
93
+
Windows'ta:
92
94
93
95
```shell
94
-
$ make epub
96
+
make.bat epub
95
97
```
96
98
97
99
EPUB dosyası `/build/epub/` dizininde `Yazbel Python Belgeleri.epub` adı ile oluşacaktır.
98
100
99
101
### PDF olarak inşa etme
100
102
101
-
Belgeleri PDF olarak inşa edebilmek için ``pdflatex`` uygulamasına ihtiyacınız olacak. [MikTeX](https://miktex.org/) veya [TeX Live](https://www.tug.org/texlive/) gibi bir TeX dağıtımını indirerek bu uygulamayı edinebilirsiniz. Bu dağıtımların belgerin inşası için gerekli eklentiler ile birlikte 800 megabyte gibi bir disk alanı kaplayabileceğini unutmayın. TeX dağıtımının kurulumunda bir problem yaşarsanız [buraya](https://www.sphinx-doc.org/en/master/usage/builders/index.html#sphinx.builders.latex.LaTeXBuilder) başvurabilirsiniz.
103
+
Belgeleri PDF olarak inşa edebilmek için ``pdflatex`` uygulamasına ihtiyacınız olacak. [MikTeX](https://miktex.org/) veya [TeX Live](https://www.tug.org/texlive/) gibi bir TeX dağıtımını indirerek bu uygulamayı edinebilirsiniz. Bu dağıtımların belgerin inşası için gerekli eklentiler ile birlikte 800 Megabyte gibi bir disk alanı kaplayabileceğini unutmayın. TeX dağıtımının kurulumunda bir problem yaşarsanız [buraya](https://www.sphinx-doc.org/en/master/usage/builders/index.html#sphinx.builders.latex.LaTeXBuilder) başvurabilirsiniz.
104
+
105
+
> Eğer Windows kullanıyorsanız ve [`winget`](https://github.com/microsoft/winget-cli) CLI uygulamasına sahipseniz MikTeX dağıtımını indirmek için bu yolu da izleyebilirsiniz:
106
+
>
107
+
> ```shell
108
+
> winget install MiKTeX.MiKTeX
109
+
> winget install StrawberryPerl.StrawberryPerl # MiKTeX aynı zamanda bir Perl kurulumu gerektirir
110
+
>```
102
111
103
112
Uygun bir TeX dağıtımını kurduktan sonra `pdflatex`'in bulunduğu dizinin PATH'de bulunduğundan emin olun.
104
113
105
-
Windows'ta:
114
+
Debian/Ubuntu'da:
106
115
107
116
```shell
108
-
>make.bat latexpdf> nul
117
+
make latexpdf
109
118
```
110
119
111
-
Debian/Ubuntu'da:
120
+
Windows'ta:
112
121
113
122
```shell
114
-
$ make latexpdf> /dev/null
123
+
make.bat latexpdf
115
124
```
116
125
117
126
Herhangi bir hata oluşmazsa PDF dosyası `/build/latex/` dizininde `yazbelpythonbelgeleri.pdf` adı ile oluşacaktır.
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+3-1Lines changed: 3 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,9 @@ Bu belgeler topluluk desteğiyle geliştirilmektedir. Bu sebeple katkılarınız
2
2
3
3
### Belgelere Katkıda Bulunmak
4
4
5
-
Katkıda bulunmak için veri havuzunu bilgisayarınıza indirtikten sonra [source](source) dizini altındaki ***.rst*** uzantılı dosyaları değiştirmelisiniz. HTML dosyalarını elle *değiştirmemelisiniz*, HTML dosyaları .rst uzantılı dosyalar işlenerek otomatik olarak oluşturulmaktadır. Belgeler reStructuredText formatında yazılmıştır, bu format hakkında bilginiz yoksa [buraya](https://www.sphinx-doc.org/en/master/usage/restructuredtext/index.html) başvurabilirsiniz.
5
+
Katkıda bulunmak için veri havuzunu bilgisayarınıza indirtikten sonra [source](source) dizini altındaki ***.rst*** uzantılı dosyaları değiştirmelisiniz. HTML dosyalarını elle ***değiştirmemelisiniz***. HTML dosyaları, ``.rst`` uzantılı dosyalar işlenerek otomatik olarak oluşturulmaktadır.
6
+
7
+
Belgeler reStructuredText formatında yazılmıştır, bu format hakkında bilginiz yoksa [buraya](https://www.sphinx-doc.org/en/master/usage/restructuredtext/index.html) başvurabilirsiniz.
6
8
7
9
Belgelere katkıda bulunduktan sonra dilerseniz isminizi ve yaptığınız eklemeleri [``source/katkida_bulunanlar.rst``](source/katkida_bulunanlar.rst) dosyasına uygun bir şekilde yazabilirsiniz.
Copy file name to clipboardExpand all lines: README.md
+18-8Lines changed: 18 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,29 +18,37 @@ Hatta bu gelişime siz de dahil olabilirsiniz!
18
18
19
19
Bu arada proje sonlandığında bu belgede istihza.com'a verilen bağlantıların çalışmayabileceğini de unutmamalısınız.
20
20
21
+
---
22
+
21
23
## Belgeleri inşa etmek
22
24
23
25
Belgelerde bir değişiklik yapmak ve belgeleri inşa etmek için [``BUILDING.md``](BUILDING.md) dosyasına başvurun.
24
26
27
+
---
28
+
25
29
## Belgelerden çevrimdışı iken faydalanmak
26
30
27
31
Çevrimdışı olarak kullandığınız belgelerin zaman ile güncelliğini yitirip https://python-istihza.yazbel.com/ adresindeki belgelerin gerisinde kalabileceğini unutmayın.
28
32
29
-
### PDF olarak indirme
33
+
<details>
34
+
<summary>PDF olarak indirme</summary>
30
35
31
36
[`/docs/YazbelPythonProgramlamaDiliBelgeleri.pdf`](/docs/YazbelPythonProgramlamaDiliBelgeleri.pdf) dosyasını [bu](https://python-istihza.yazbel.com/YazbelPythonProgramlamaDiliBelgeleri.pdf) link aracılığı ile indirip kullanabilirsiniz.
37
+
</details>
32
38
33
-
### EPUB olarak indirme
34
-
35
-
[`/docs/YazbelPythonProgramlamaDiliBelgeleri.epub`](/docs/YazbelPythonProgramlamaDiliBelgeleri.epub) dosyasını [bu](https://python-istihza.yazbel.com/YazbelPythonProgramlamaDiliBelgeleri.epub) link aracılığı ile indirip kullanabilirsiniz.
36
-
37
-
### Tek parça HTML olarak indirme
39
+
<details>
40
+
<summary>Tek parça HTML olarak indirme</summary>
38
41
39
42
[`/docs/YazbelPythonProgramlamaDiliBelgeleri.html`](/docs/YazbelPythonProgramlamaDiliBelgeleri.html) dosyasını [bu](https://python-istihza.yazbel.com/YazbelPythonProgramlamaDiliBelgeleri.html) link aracılığı ile indirip kullanabilirsiniz.
43
+
</details>
40
44
41
-
### Siteyi kaynaktan indirme
45
+
<details>
46
+
<summary>Siteyi kaynaktan indirme</summary>
42
47
43
48
Bu veri havuzunu cihazınıza indirebilir ve [`/docs/index.html`](/docs/index.html) dosyasını tarayıcınız ile açabilirsiniz. Bu size belgeleri çevrimiçi olarak kullanmak ile aynı deneyimi sunacaktır.
49
+
</details>
50
+
51
+
---
44
52
45
53
## Nasıl yardım alabilirim?
46
54
@@ -64,8 +72,10 @@ yardım edebilirsiniz. Bunun için veri havuzunun [konular (issues)](https://git
64
72
dizininde bir konu açın, başlık ve açıklama kısmına ilgili metinleri yazın ve gönderin. Başlık kısmının kısa ve öz
65
73
olmasına dikkat edin.
66
74
75
+
---
76
+
67
77
## Lisans
68
78
69
-
[`LICENSE`](LICENSE) dosyasında da belirtildiği üzere bu
79
+
[`LICENSE`](LICENSE.md) dosyasında da belirtildiği üzere bu
0 commit comments