mirror of
https://github.com/adambard/learnxinyminutes-docs.git
synced 2024-12-18 21:01:52 +03:00
252 lines
7.7 KiB
Markdown
252 lines
7.7 KiB
Markdown
|
---
|
|||
|
|
language: markdown
|
|||
|
|
contributors:
|
|||
|
|
- ["Dan Turkel", "http://danturkel.com/"]
|
|||
|
|
translators:
|
|||
|
|
- ["Eray AYDIN", "http://erayaydin.me/"]
|
|||
|
|
lang: tr-tr
|
|||
|
|
filename: markdown-tr.md
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
Markdown, 2004 yılında John Gruber tarafından oluşturuldu. Asıl amacı kolay okuma ve yazmayı sağlamakla beraber kolayca HTML (artık bir çok diğer formatlara) dönüşüm sağlamaktır.
|
|||
|
|
|
|||
|
|
|
|||
|
|
```markdown
|
|||
|
|
<!-- Markdown, HTML'i kapsar, yani her HTML dosyası geçerli bir Markdown dosyasıdır, bu demektir
|
|||
|
|
ki Markdown içerisinde HTML etiketleri kullanabiliriz, örneğin bu yorum elementi, ve
|
|||
|
|
markdown işleyicisinde etki etmezler. Fakat, markdown dosyası içerisinde HTML elementi oluşturursanız,
|
|||
|
|
bu elementin içeriğinde markdown söz dizimlerini kullanamazsınız. -->
|
|||
|
|
|
|||
|
|
<!-- Markdown ayrıca işleyiciden işleyiciye farklılık gösterebilir. Bu rehberde
|
|||
|
|
evrensel özelliklere uygun anlatımlar olacaktır. Bir çok işleyici bu rehberdeki
|
|||
|
|
anlatımları destekler -->
|
|||
|
|
|
|||
|
|
<!-- Başlıklar -->
|
|||
|
|
<!-- Kolayca <h1>'den <h6>'ya HTML etiketleri oluşturabilirsiniz.
|
|||
|
|
Kare (#) sayısı bu elementin numarasını belirleyecek ve devamında getirdiğiniz
|
|||
|
|
yazı bu elementin içeriği olacaktır
|
|||
|
|
-->
|
|||
|
|
# Bu bir <h1>
|
|||
|
|
## Bu bir <h2>
|
|||
|
|
### Bu bir <h3>
|
|||
|
|
#### Bu bir <h4>
|
|||
|
|
##### Bu bir <h5>
|
|||
|
|
###### Bu bir <h6>
|
|||
|
|
|
|||
|
|
<!-- Markdown ayrıca h1 ve h2 için 2 alternatif yol daha taşır -->
|
|||
|
|
Bu bir h1
|
|||
|
|
=========
|
|||
|
|
|
|||
|
|
Bu bir h2
|
|||
|
|
---------
|
|||
|
|
|
|||
|
|
<!-- Basit yazı stilleri -->
|
|||
|
|
<!-- Markdown ile yazılar kolayca italik ve kalın belirtilebilir -->
|
|||
|
|
*Bu yazı italik.*
|
|||
|
|
_Bu yazı da italik._
|
|||
|
|
|
|||
|
|
**Bu yazı kalın.**
|
|||
|
|
__Bu yazı da kalın.__
|
|||
|
|
|
|||
|
|
***Bu yazı hem kalın hem italik.***
|
|||
|
|
**_Bu da öyle!_**
|
|||
|
|
*__Hatta bu bile!__*
|
|||
|
|
|
|||
|
|
<!-- Github Flavored Markdown'da ayrıca üstü çizgili karakter de desteklenir: -->
|
|||
|
|
~~Bu yazı üstü çizili olarak gözükecek.~~
|
|||
|
|
|
|||
|
|
<!-- Paragraflar bir veya daha fazla boş satırla ayrılır. -->
|
|||
|
|
|
|||
|
|
Bu bir paragraf. Paragrafın içeriğine devam ediyorum, eğlenceli değil mi?
|
|||
|
|
|
|||
|
|
Şimdi 2. paragrafıma geçtim.
|
|||
|
|
Hala 2. paragraftayım, çünkü boş bir satır bırakmadım.
|
|||
|
|
|
|||
|
|
Bu da 3. paragrafım!
|
|||
|
|
|
|||
|
|
<!-- HTML'de her satır için <br /> etiketi kullanmak ister misiniz, Bir
|
|||
|
|
paragrafı bitirdikten sonra 2 veya daha fazla boşluk bırakın ve yeni paragrafa
|
|||
|
|
başlayın, bu bir <br /> etiketi sayılacaktır -->
|
|||
|
|
|
|||
|
|
Bu yazının sonunda 2 boşluk var (bu satırı seçerek kontrol edebilirsiniz).
|
|||
|
|
|
|||
|
|
Bir üst satırda <br /> etiketi var!
|
|||
|
|
|
|||
|
|
<!-- Blok yazılarının yapımı oldukça kolay, (>) karakteri ile yapabilirsiniz -->
|
|||
|
|
|
|||
|
|
> Bu bir blok etiketi. Satırlara ayırmak için
|
|||
|
|
> her satırın başında `>` karakter yerleştirmeli veya tek satırda bütün içeriği yazabilirsiniz.
|
|||
|
|
> Satır `>` karakteri ile başladığı sürece sorun yok.
|
|||
|
|
|
|||
|
|
> Ayrıca alt alta da blok elementi açabilirsiniz
|
|||
|
|
>> iç içe yani
|
|||
|
|
> düzgün değil mi ?
|
|||
|
|
|
|||
|
|
<!-- Listeler -->
|
|||
|
|
<!-- Numarasız listeler için yıldız, artı, veya tire kullanabilirsiniz -->
|
|||
|
|
|
|||
|
|
* Nesne
|
|||
|
|
* Nesne
|
|||
|
|
* Bir başka nesne
|
|||
|
|
|
|||
|
|
veya
|
|||
|
|
|
|||
|
|
+ Nesne
|
|||
|
|
+ Nesne
|
|||
|
|
+ Bir başka nesne
|
|||
|
|
|
|||
|
|
veya
|
|||
|
|
|
|||
|
|
- Nesne
|
|||
|
|
- Nesne
|
|||
|
|
- Son bir nesne
|
|||
|
|
|
|||
|
|
<!-- Numaralı liste için başına sıralı bir şekilde sayı eklemeniz yeterli -->
|
|||
|
|
|
|||
|
|
1. İlk nesne
|
|||
|
|
2. İkinci nesne
|
|||
|
|
3. Üçüncü nesne
|
|||
|
|
|
|||
|
|
<!-- İsterseniz sıralı bir şekilde yazmak zorunda değilsiniz, markdown
|
|||
|
|
biçimlendirirken sizin için sıralayacaktır, fakat bunu önermiyorum. Markdown dosyasının
|
|||
|
|
düzgün gözükmesi için önerilen metodu uygulamanızı tavsiye ederim -->
|
|||
|
|
|
|||
|
|
1. İlk nesne
|
|||
|
|
1. İkinci nesne
|
|||
|
|
1. Üçüncü nesne
|
|||
|
|
|
|||
|
|
<!-- (Bunun çıktısı ile, sıralı olarak yazdığımız örneğin çıktısı aynı olacaktır) -->
|
|||
|
|
|
|||
|
|
<!-- Ayrıca alt alta liste oluşturabilirsiniz -->
|
|||
|
|
|
|||
|
|
1. İlk nesne
|
|||
|
|
2. İkinci nesne
|
|||
|
|
3. Üçüncü nesne
|
|||
|
|
* Alt nesne
|
|||
|
|
* Alt nesne
|
|||
|
|
4. Dördüncü nesne
|
|||
|
|
|
|||
|
|
<!-- Ayrıca görev listeleri de bulunmakta. HTML seçim kutusu(checkbox) oluşturacaktır. -->
|
|||
|
|
Kutunun içerisinde `x` yoksa eğer seçim kutusu boş olacaktır.
|
|||
|
|
- [ ] Yapılacak ilk görev.
|
|||
|
|
- [ ] Yapılması gereken bir başka görev
|
|||
|
|
Aşağıdaki seçim kutusu ise içi dolu olacaktır.
|
|||
|
|
- [x] Bu görev başarıyla yapıldı
|
|||
|
|
|
|||
|
|
<!-- Kod blokları -->
|
|||
|
|
<!-- Kod bloklarını(<code> elementi) belirtmek için 4 adet boşluk veya bir
|
|||
|
|
tab karakterini kullanabilirsiniz -->
|
|||
|
|
|
|||
|
|
Bu bir kod
|
|||
|
|
öyle mi?
|
|||
|
|
|
|||
|
|
<!-- Ayrıca kod içerisinde girinti kullanmak istiyorsanız tekrar `tab` veya `4 boşluk`
|
|||
|
|
kullanabilirsiniz -->
|
|||
|
|
|
|||
|
|
my_array.each do |item|
|
|||
|
|
puts item
|
|||
|
|
end
|
|||
|
|
|
|||
|
|
<!-- Yazı içerisinde kod belirtmek için sorgu tırnağı (`) kullanabilirsiniz -->
|
|||
|
|
|
|||
|
|
Ahmet `go_to()` fonksiyonun ne yaptığını bilmiyor!
|
|||
|
|
|
|||
|
|
<!-- Github Flavored Markdown'da, kod içerisinde aydınlatma kullanabilirsiniz -->
|
|||
|
|
|
|||
|
|
\`\`\`ruby <!-- buradaki ters slaş (\) işaretlerini kullanmayın, sadece ```ruby ! -->
|
|||
|
|
def foobar
|
|||
|
|
puts "Hello world!"
|
|||
|
|
end
|
|||
|
|
\`\`\` <!-- burada da (\) işaretlerini kullanmayın, sadece ``` -->
|
|||
|
|
|
|||
|
|
<!-- Yukarıdaki örnekte girinti kullanmanıza gerek yok, Github da
|
|||
|
|
``` işaretinden sonra belirttiğiniz yazılım diline göre gerekli
|
|||
|
|
syntax aydınlatmaları uygulanacaktır -->
|
|||
|
|
|
|||
|
|
<!-- Düz çizgi (<hr />) -->
|
|||
|
|
<!-- Düz çizgiler 3 veya daha fazla yıldız/çizgi ile yapılabilir. Boşluklar önemsiz. -->
|
|||
|
|
|
|||
|
|
***
|
|||
|
|
---
|
|||
|
|
- - -
|
|||
|
|
****************
|
|||
|
|
|
|||
|
|
<!-- Linkler -->
|
|||
|
|
<!-- Markdown'daki en güzel şeylerden biri kolayca link oluşturmaktır.
|
|||
|
|
Linkte göstermek istediğiniz yazıyı [] içerisine yerleştirin ve sonuna parantezler içerisinde ()
|
|||
|
|
gideceği adresi belirtin -->
|
|||
|
|
|
|||
|
|
[Bana tıkla!](http://test.com)
|
|||
|
|
|
|||
|
|
<!-- Ayrıca linke `title` özelliği eklemek için tırnakları kullanabilirsiniz -->
|
|||
|
|
|
|||
|
|
[Bana tıkla!](http://test.com "Test.com'a gider")
|
|||
|
|
|
|||
|
|
<!-- Bağıl yollar da çalışıyor. -->
|
|||
|
|
[Müzik dinle](/muzik/).
|
|||
|
|
|
|||
|
|
<!-- Markdown ayrıca referans linklerini de destekler -->
|
|||
|
|
|
|||
|
|
[Bu linke tıklayarak][link1] daha detaylı bilgi alabilirsiniz!
|
|||
|
|
[Ayrıca bu linki de inceleyin][foobar] tabi istiyorsanız.
|
|||
|
|
|
|||
|
|
[link1]: http://test.com/ "harika!"
|
|||
|
|
[foobar]: http://foobar.biz/ "okey!"
|
|||
|
|
|
|||
|
|
<!--Başlık ayrıca tek tırnak veya parantez içinde olabilir, veya direk yazılabilir.
|
|||
|
|
Referans döküman içerisindeki herhangi bir yer olabilir ve referans IDsi
|
|||
|
|
benzersiz olduğu sürece sorunsuz çalışacaktır. -->
|
|||
|
|
|
|||
|
|
<!-- Ayrıca "dolaylı adlandırma" bulunmaktadır, "dolaylı adlandırma", linkin yazısının
|
|||
|
|
aynı zamanda onun idsi olmasıdır -->
|
|||
|
|
|
|||
|
|
[Bu][] bir link.
|
|||
|
|
[bu]: http://bubirlink.com
|
|||
|
|
|
|||
|
|
<!-- Fakat bu çok tercih edilen bir yöntem değil. -->
|
|||
|
|
|
|||
|
|
<!-- Resimler -->
|
|||
|
|
<!-- Resimler aslında linklere çok benziyor fakat başında ünlem bulunuyor! -->
|
|||
|
|
|
|||
|
|
|
|||
|
|
<!-- Referanslar resimler için de geçerli -->
|
|||
|
|
![Bu alt etiketi.][resmim]
|
|||
|
|
|
|||
|
|
[resmim]: bagil/linkler/de/calisiyor.jpg "Başlık isterseniz buraya girebilirsiniz"
|
|||
|
|
|
|||
|
|
<!-- Çeşitli -->
|
|||
|
|
<!-- Oto-linkler -->
|
|||
|
|
|
|||
|
|
<http://testwebsite.com/> ile
|
|||
|
|
[http://testwebsite.com/](http://testwebsite.com) aynı şeyler
|
|||
|
|
|
|||
|
|
<!-- Oto-linkler epostaları da destekler -->
|
|||
|
|
|
|||
|
|
<foo@bar.com>
|
|||
|
|
|
|||
|
|
<!-- Kaçış karakterleri -->
|
|||
|
|
|
|||
|
|
Bu yazının *yıldızlar arasında gözükmesini* istiyorum fakat italik olmamasını istiyorum,
|
|||
|
|
bunun için, şu şekilde: \*bu yazı italik değil, yıldızlar arasında\*.
|
|||
|
|
|
|||
|
|
<!-- Tablolar -->
|
|||
|
|
<!-- Tablolar sadece Github Flavored Markdown'da destekleniyor ve açıkçası
|
|||
|
|
performansı çok yoruyorlar, fakat illa ki kullanmak isterseniz: -->
|
|||
|
|
|
|||
|
|
| Sütun1 | Sütun 2 | Sütün 3 |
|
|||
|
|
| :----------- | :------: | ------------: |
|
|||
|
|
| Sola dayalı | Ortalı | Sağa dayalı |
|
|||
|
|
| test | test | test |
|
|||
|
|
|
|||
|
|
<!-- ayrıca, bunun aynısı -->
|
|||
|
|
|
|||
|
|
Sütun 1 | Sütun 2 | Sütun 3
|
|||
|
|
:-- | :-: | --:
|
|||
|
|
Çok çirkin göözüküyor | değil | mi?
|
|||
|
|
|
|||
|
|
<!-- Bitiş! -->
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Daha detaylı bilgi için, John Gruber'in resmi söz dizimi yazısını [buradan](http://daringfireball.net/projects/markdown/syntax) veya Adam Pritchard'ın mükemmel hatırlatma kağıdını [buradan](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) inceleyebilirsiniz.
|