/
syntax.texy
142 lines (87 loc) · 4.94 KB
/
syntax.texy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
Wiki Sözdizimi
**************
Wiki, çeşitli geliştirmelerle birlikte Markdown ve [Texy sözdizimini |https://texy.info/en/syntax] kullanır.
Bağlantılar .[#toc-links]
=========================
Dahili referanslar için köşeli parantez içindeki gösterim `[link]` kullanılır. Bu ya dikey çubuk şeklinde olur `[link text |link target]`veya kısaltılmış biçimde `[link text]` hedef metinle aynıysa (küçük harfe ve tire işaretlerine dönüştürüldükten sonra):
- `[Page name]` -> `<a href="/en/page-name">Page name</a>`
- `[link text |Page name]` -> `<a href="/en/page-name">link text</a>`
Başka bir dile veya başka bir bölüme bağlantı verebiliriz. Bir bölüm bir Nette kütüphanesidir (örneğin `forms`, `latte`, vb.) veya `best-practices`, `quickstart`, vb. gibi özel bölümlerdir:
- `[cs:Page name]` -> `<a href="/en/page-name">Page name</a>` (aynı bölüm, farklı dil)
- `[tracy:Page name]` -> `<a href="//tracy.nette.org/en/page-name">Page name</a>` (farklı bölüm, aynı dil)
- `[tracy:cs:Page name]` -> `<a href="//tracy.nette.org/en/page-name">Page name</a>` (farklı bölüm ve dil)
Ayrıca `#` ile sayfadaki belirli bir başlığı hedeflemek de mümkündür.
- `[#Heading]` -> `<a href="#toc-heading">Heading</a>` (geçerli sayfadaki başlık)
- `[Page name#Heading]` -> `<a href="/en/page-name#toc-heading">Page name</a>`
Bölümün ana sayfasına bağlantı: (`@home` bölümün ana sayfası için kullanılan özel bir terimdir)
- `[link text |@home]` -> `<a href="/en/">link text</a>`
- `[link text |tracy:]` -> `<a href="//tracy.nette.org/en/">link text</a>`
API Dokümantasyonuna Bağlantılar .[#toc-links-to-api-documentation]
-------------------------------------------------------------------
Her zaman aşağıdaki notasyonları kullanın:
- `[api:Nette\SmartObject]` -> [api:Nette\SmartObject]
- `[api:Nette\Forms\Form::setTranslator()]` -> [api:Nette\Forms\Form::setTranslator()]
- `[api:Nette\Forms\Form::$onSubmit]` -> [api:Nette\Forms\Form::$onSubmit]
- `[api:Nette\Forms\Form::Required]` -> [api:Nette\Forms\Form::Required]
Tam nitelikli adlar yalnızca ilk bahiste kullanılır. Diğer bağlantılar için basitleştirilmiş bir ad kullanın:
- `[Form::setTranslator() |api:Nette\Forms\Form::setTranslator()]` -> [Form::setTranslator() |api:Nette\Forms\Form::setTranslator()]
PHP Belgelerine Bağlantılar .[#toc-links-to-php-documentation]
--------------------------------------------------------------
- `[php:substr]` -> [php:substr]
Kaynak Kodu .[#toc-source-code]
===============================
Kod bloğu <code>```lang</code> ile başlar ve <code>```</code> ile biter. Desteklenen diller `php`, `latte`, `neon`, `html`, `css`, `js` ve `sql`. Girinti için her zaman sekme kullanın.
```
```php
public function renderPage($id)
{
}
```
```
Dosya adını <code>```php .{file: ArrayTest.php}</code> olarak da belirtebilirsiniz ve kod bloğu bu şekilde oluşturulacaktır:
```php .{file: ArrayTest.php}
public function renderPage($id)
{
}
```
Başlıklar .[#toc-headings]
==========================
Üst başlık (sayfa adı) yıldızlarla altı çizili (`*`). For normal headings use equal signs (`=`) and then hyphens (`-`).
```
MVC Applications & Presenters
*****************************
...
Link Creation
=============
...
Links in Templates
------------------
...
```
Kutular ve Stiller .[#toc-boxes-and-styles]
===========================================
Sınıf ile işaretlenmiş baş paragraf `.[perex]` .[perex]
Sınıf ile işaretlenmiş notlar `.[note]` .[note]
Sınıf ile işaretlenmiş uç `.[tip]` .[tip]
Sınıf ile işaretlenmiş uyarı `.[caution]` .[caution]
Sınıf ile işaretlenmiş güçlü uyarı `.[warning]` .[warning]
Sürüm numarası `.{data-version:2.4.10}` .{data-version:2.4.10}
Sınıflar ilgili satırdan önce yazılmalıdır:
```
.[note]
This is a note.
```
Lütfen aşağıdaki gibi kutulara dikkat edin `.[tip]` dikkat çeker ve bu nedenle daha az önemli bilgiler için değil, vurgulamak için kullanılmalıdır.
İçindekiler .[#toc-table-of-contents]
=====================================
Sayfa 4 000 bayttan uzun olduğunda içindekiler tablosu (kenar çubuğundaki bağlantılar) otomatik olarak oluşturulur. Bu varsayılan davranış bir `{{toc}}` [meta etiketi |#meta-tags]. TOC için metin varsayılan olarak başlıktan alınır, ancak farklı bir metin kullanmak mümkündür. `.{toc}` değiştirici. Bu özellikle uzun başlıklar için kullanışlıdır.
```
Long and Intelligent Heading .{toc: A Different Text for TOC}
=============================================================
```
Meta Etiketler .[#toc-meta-tags]
================================
- kendi sayfa başlığınızı ayarlama (içinde `<title>` ve ekmek kırıntıları) `{{title: Another name}}`
- yeniden yönlendirme `{{redirect: pla:cs}}` - [bağlantılara bakınız|#links]
- zorlama `{{toc}}` veya devre dışı bırakma `{{toc: no}}` i̇çeri̇k tablosu
{{priority: -1}}