Kapsamlı Asciidoc Notları ve İpuçları

Temel Biçimlendirme

Kalın ve İtalik

• Kalın: kalın metin veya kalın metin
• İtalik: italik metin veya italik metin
• Kalın ve İtalik: kalın ve italik veya kalın ve italik

Örnek: Bu kalın, bu italik, ve bu kalın ve italik.

Sabit Genişlikli

Satır içi sabit genişlikli metin için ters tırnakları kullanın: sabit genişlikli metin

Örnek: Bu sabit genişlikli metindir.

Üstü Çizili

Çift tire kullanın: [line-through]#üstü çizili metin#

Örnek: Bu [line-through]#üstü çizili# metindir.

Üst Simge ve Alt Simge

• Üst Simge: ^üst simge^
• Alt Simge: alt simge

Örnek: H2O su ve E = mc^2^ Einstein'ın ünlü denklemidir.

Başlıklar

Başlıklar için eşittir işareti (=) kullanın. Eşittir işaretlerinin sayısı başlığın seviyesini belirler.

= Belge Başlığı (Seviye 0) == Seviye 1 Bölüm === Seviye 2 Bölüm ==== Seviye 3 Bölüm ===== Seviye 4 Bölüm ====== Seviye 5 Bölüm

Listeler

Sırasız Listeler

Sırasız listeler için yıldız (*), tire (-) veya artı (+) işareti kullanın.

• Öğe 1
• Öğe 2 ** Alt öğe 2.1 ** Alt öğe 2.2
• Öğe 3

Örnek:

• Meyveler ** Elma ** Muz
• Sebzeler ** Havuç ** Brokoli

Sıralı Listeler

Sıralı listeler için nokta (.) kullanın.

. Birinci öğe . İkinci öğe .. Alt öğe 2.1 .. Alt öğe 2.2 . Üçüncü öğe

Örnek: . Malzemeleri karıştır . 20 dakika pişir .. 15 dakika sonra kontrol et .. Gerekirse 5 dakika daha ekle . Soğumasını bekle . Servis yap

Tanım Listeleri

Tanım listeleri için çift iki nokta üst üste (::) kullanın.

Terim 1:: Tanım 1 Terim 2:: Tanım 2 Terim 3:: Tanım 3

Örnek: CPU:: Merkezi İşlem Birimi RAM:: Rastgele Erişimli Bellek GPU:: Grafik İşlem Birimi

Bağlantılar ve Çapraz Referanslar

Harici Bağlantılar

Harici bağlantılar için köşeli parantez ve normal parantez kullanın: Bağlantı metni

Örnek: Daha fazla bilgi için Asciidoctor adresini ziyaret edin.

İç Çapraz Referanslar

İç çapraz referanslar için çift açılı parantez ve bölüm kimliğini kullanın: <<bolum-kimligi,Özel Etiket>>

Örnek: Daha fazla ayrıntı için <<temel-bicimlendirme,Temel Biçimlendirme>> bölümüne bakın.

Kod Blokları

Kod bloğu oluşturmak için dört tire (----) kullanın:

---

def merhaba_dunya(): print("Merhaba, Dünya!")

Sözdizimi vurgulaması için, açılış tirelerinden sonra dili belirtin:

[source,python]

def merhaba_dunya(): print("Merhaba, Dünya!")

Tablolar

Tablo oluşturmak için boru karakterini (|) kullanın:

|=== | Başlık 1 | Başlık 2 | Başlık 3

| Satır 1, Hücre 1 | Satır 1, Hücre 2 | Satır 1, Hücre 3

| Satır 2, Hücre 1 | Satır 2, Hücre 2 | Satır 2, Hücre 2 |===

Örnek: |=== | Ad | Yaş | Meslek

| Ahmet Yılmaz | 30 | Yazılım Geliştirici

| Ayşe Demir | 28 | Veri Bilimci

| Mehmet Kaya | 35 | Proje Yöneticisi |===

Resimler

Resim eklemek için resim makrosunu kullanın:

image::resim/yolu/resim.jpg[Alternatif metin]

Örnek: image::https://ornek.com/asciidoc-logo.png[Asciidoc Logo]

Uyarılar

Uyarılar için aşağıdaki sözdizimini kullanın:

NOTE: Bu bir not uyarısıdır.

TIP: Bu bir ipucu uyarısıdır.

IMPORTANT: Bu önemli bir uyarıdır.

WARNING: Bu bir uyarı notu uyarısıdır.

CAUTION: Bu bir dikkat uyarısıdır.

Alıntılar

Blok alıntılar için aşağıdaki sözdizimini kullanın:

[quote, Yazar Adı, Kaynak]

---

Bu bir blok alıntıdır. Birden fazla satıra yayılabilir.

---

Örnek: [quote, Albert Einstein]

---

İki şey sonsuzdur: evren ve insan aptallığı; ve ben evrenden emin değilim.

---

Dipnotlar

Dipnotlar için köşeli parantez içinde şapka (^) işareti kullanın:

Bu dipnotlu bir cümledir.¹

Yatay Çizgiler

Tek başına bir satırda üç veya daha fazla tire, yıldız veya alt çizgi kullanın:

---

---

---

Yorumlar

Tek satırlı yorumlar için çift eğik çizgi kullanın:

// Bu tek satırlı bir yorumdur

Çok satırlı yorumlar için dört eğik çizgi kullanın:

//// Bu çok satırlı bir yorumdur ////

Matematiksel Denklemler

Satır içi denklemler için stem makrosunu kullanın:

stem:[sqrt{x^2 + y^2}]

Blok denklemler için şunu kullanın:

[stem] ++++ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} ++++

Dosya Ekleme

Başka dosyaları eklemek için include yönergesini kullanın:

include::dosya/yolu/dosya.adoc[]

Koşullu İşleme

Koşullu işleme için ifdef ve ifndef yönergelerini kullanın:

ifdef::özellik-adı[] Bu içerik yalnızca 'özellik-adı' tanımlanmışsa görünecektir. endif::özellik-adı[]

ifndef::özellik-adı[] Bu içerik yalnızca 'özellik-adı' tanımlanmamışsa görünecektir. endif::özellik-adı[]

Özel Özellikler

Özel özellikler tanımlamak için :ad: sözdizimini kullanın:

:yazar: Ahmet Yılmaz :versiyon: 1.0.0

Özellikleri {ad} sözdizimi ile kullanın:

Bu belge {yazar} tarafından yazılmıştır (versiyon {versiyon}).

Footnotes

1. Bu dipnot içeriğidir. ↩