İçindekiler

Biçimlendirme Sentaksı

MeeGo Türkiye'de basit bir biçimlendirme sentaksı mevcuttur, bu sentaksın kullanılması dökümanların okunabilirliği ve kalitesini arttıracaktır. DokuWiki tabanlı sentaksa aşinaysanız, burada da çok benzer bir sentaks kullanılmaktadır. Kaynağı göster butonuna basarak bu sayfanın kaynağını görebilirsiniz. Birşeyler denemek için playground sayfasını kullanabilirsiniz.

Basit Metin Biçimlendirmesi

Dökümanlar servisi kalın, italik, altıçizili ve monospace metinleri destekler. Elbette hepsini birden kullanmak mümkündür. 

Dökümanlar servisi **kalın**, //italik//, __altıçizili__ ve ''monospace'' metinleri destekler.
Elbette hepsini birden  kullanmak **__//''mümkündür''//__**.

Metinlerde subscript ve superscript kullanılabilir. 

Metinlerde <sub>subscript</sub> ve <sup>superscript</sup> kullanılabilir.

Bir şeyi silinmiş işaretleyebilirsiniz. 

Bir şeyi <del>silinmiş</del> işaretleyebilirsiniz.

Paragraflar boş satırlarla oluşturulur. Bir paragraf açmadan yeni bir satıra zorlamak istiyorsanız, iki ters eğik çizgi ve bir boş karakter, veya çizgilerden sonra satır sonu yapabilirsiniz.

Bu satır aralıkları olan bir metindir
Sadece satır sonunda olduklarında dikkate alındıklarına
veya
boş bir karakter gerektirdiklerine dikkat edin \\boş satır olmazsa böyle görünür. 

Bu satır aralıkları olan bir metindir\\ Sadece satır sonunda
olduklarında dikkate alındıklarına\\
veya\\ boş bir karakter gerektirdiklerine dikkat edin \\boş satır olmazsa böyle görünür.

Bunu sadece gerçekten gerekiyorsa kullanın.

Bağlantılar

Dökümanlar servisinde pek çok farklı bağlantı şekli desteklenir.

Harici

Harici bağlantılar otomatik algılanır: http://www.google.com veya sadece www.google.com - Bağlantıya bir metin de atanabilir: Bu bağlantı Google için. Bunun gibi e-posta adresleri de algılanır: andi@splitbrain.org 

Harici bağlantılar otomatik algılanır: http://www.google.com veya sadece www.google.com - 
Bağlantıya bir metin de atanabilir: [[http://www.google.com|Bu bağlantı Google için]]. Bunun gibi e-posta adresleri de algılanır: <andi@splitbrain.org>

Dahili

Dahili bağlantılar kare parantezlerle verilir. Sadece sayfa adı verebilir veya ekstra metin kullanabilirsiniz. 

Dahili bağlantılar kare parantezlerle verilir.
Sadece [[sayfa adı]] verebilir veya ekstra [[sayfa adı|metin kullanabilirsiniz]].

Wiki sayfa adları otomatik olarak küçük harflere dönüştürülür, özel karakterlere izin verilmez.

İki nokta koyarak isim alanları oluşturabilirsiniz. 

İki nokta koyarak [[deneme:isim alanları]] oluşturabilirsiniz.

Detaylı bilgi için, namespaces. 1)

Spesifik bir bölüme de bağlantı verilebilir. HTML'deki gibi bölüm adını bir diyez işaretiyle eklemelisiniz. Bu bölümün bağlantısı şöyle olabilir. 

Bu bölümün bağlantısı [[syntax#harici|şöyle olabilir]].

Notlar:

  • Varolan sayfaların bağlantıları, var olmayanlardan farklı görünür.
  • DokuWiki, varsayılan olarak CamelCase kullanmaz, ancak bu sonradan aktifleştirilebilir. İpucu: DokuWiki kelimesi bir bağlantıysa, demek ki aktifleştirilmiş.
  • Bir bölümün başlığı değiştirilince, ona giden yol da değişir. Bu sebeple bölümlere bağlantı vermekten kaçınmalısınız.

Interwiki

Dökümanlar servisi Interwiki bağlantıları destekler. Bunlar diğer Wikilere hızlı bağlantılardır. Örneğin Wikipedia'nın Wiki sayfası: Wiki. 

Dökümanlar servisi [[doku>Interwiki]] bağlantıları destekler. Bunlar diğer Wikilere hızlı bağlantılardır. Örneğin Wikipedia'nın Wiki sayfası: [[wp>Wiki]].

Windows Paylaşımları

Windows paylaşımları, bu gibi, desteklenir. Lütfen sadece mantıklı bir kullanımı varsa bunu kullanın. 

Windows paylaşımları, [[\\server\share|bu]] gibi, desteklenir.

Notlar:

  • Güvenlik nedeniyle varsayılan olarak windows paylaşımlarına sadece Microsoft Internet Explorer bağlanır.
  • Mozilla ve Firefox'da ayrıca etkinleştirmeleri gerekir, inceleyin: Mozilla Knowledge Base. Yine de bir JavaScript uyarısı gösterilecektir. Bu uyarıyı kaldırmak için, şu satırı conf/local.protected.php dosyasına ekleyebilirsiniz:
$lang['js']['nosmblinks'] = '';

Resim Bağlantıları

Resim ve bağlantı sentakslarını birleştirerek bir resimden harici veya dahili bağlantı verebilirsiniz: 

[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]

Lütfen dikkat: Resim biçimleri bağlantı isimlerinde kabul edilen tek biçimleme sentaksıdır.

Tüm resim ve bağlantı sentaksı desteklenir, resim boyutlandırma, harici ve dahili resim ve URL'ler ve interwiki bağlantılar dahil.

Dipnotlar

Servise dipnotlar 2) eklemek için çift parantez kullanın. 

Servise dipnotlar ((Mesela bu bir dipnottur)) eklemek için çift parantez kullanın.

Bölümleme

İçeriği düzenlemek için 5 farklı ağırlıkla sıralama yapılabilir. Üçten fazla başlığınız varsa bir İçindekiler kutusu oluşturulur – dökümana ~~NOTOC~~ ekleyerek bu kutunun oluşmasını önleyebilirsiniz.

Başlık Seviye 3

Başlık Seviye 4

Başlık Seviye 5
==== Başlık Seviye 3 ====
=== Başlık Seviye 4 ===
== Başlık Seviye 5 ==

Dört veya daha fazla çizgi kullanırsanız, bir düz çizgi oluşur:

Resimler ve Diğer Dosyalar

Harici ve dahili resimler, süslü parantezlerle oluşturulur. Opsiyonel olarak bir boyut belirtebilirsiniz.

Gerçek boyut:

Verilen genişliğe yeniden boyutlu:

Verilen genişlik ve yüksekliğe yeniden boyutlu 3):

Harici yeniden boyutlu: 

Gerçek boyut:                        {{wiki:dokuwiki-128.png}}
Verilen genişliğe yeniden boyutlu:            {{wiki:dokuwiki-128.png?50}}
Verilen genişlik ve yüksekliğe yeniden boyutlu: {{wiki:dokuwiki-128.png?200x50}}
Harici yeniden boyutlu:           {{http://de3.php.net/images/php.gif?200x50}}

Sağ ve sol boşluklar vererek resmi hizalayabilirsiniz: 

{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}

Elbette bir başlık eklemek (çoğu tarayıcı resmin üzerine gelince dipnot olarak verir) mümkündür.

Bu bir altyazıdır 

{{ wiki:dokuwiki-128.png |Bu bir altyazıdır}}

Eğer (harici veya dahili) resim olmayan bir bağlantı (gif, jpeg, png) verirseniz, bağlantı olarak gösterilir.

Listeler

Sıralı ve sırasız listeler oluşturmanız mümkündür. Bir liste öğesi oluşturmak için, iki boşluk bırakarak metninizi girintileyin ve sırasız listeler için *, sıralılar için - kullanın.

  • Bu bir listedir
  • İkinci öğe
    • Farklı seviyeler verebilirsiniz
  • Başka bir öğe
  1. Aynı liste ama sıralı
  2. Diğer öğe
    1. Daha alt bir seviye
  3. İşte böyle
  * Bu bir listedir
  * İkinci öğe
    * Farklı seviyeler verebilirsiniz
  * Başka bir öğe

  - Aynı liste ama sıralı
  - Diğer öğe
    - Daha alt bir seviye
  - İşte böyle

Metin Dönüştürme

Bazı önceden belirlenmiş karakterler ve satırlar, resim, metin veya HTML'e dönüştürülebilir.

Metinden resime dönüştürmeler çoğunlukla gülücük (smiley) için kullanılır. Metinden HTML'e dönüştürme ise genellikle tipografi değiştirmeleri için, fakat başka HTML'ler kullanmak için de ayarlanabilir.

Metinden Resime Dönüşüm

Sık kullanılan gülücükler grafik olanlara dönüştürülür, bu gülücük ve diğer resimlerin sayısı arttırılabilir. Bazı gülücükler:

  • 8-) 8-)
  • 8-O 8-O
  • :-( :-(
  • :-) :-)
  • =) =)
  • :-/ :-/
  • :-\ :-\
  • :-? :-?
  • :-D :-D
  • :-P :-P
  • :-O :-O
  • :-X :-X
  • :-| :-|
  • ;-) ;-)
  • ^_^ ^_^
  • :?: :?:
  • :!: :!:
  • LOL LOL
  • FIXME FIXME
  • DELETEME DELETEME

Metinden HTML'e Dönüşüm

Typography: Basit metin karakterleri tipografik olarak doğru şekillere dönüştürülebilir. Tanınan bazı karakterler:

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® “Herkes için 'özgür yazılım'…” 

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"Herkes için 'özgür yazılım'..."

Üç istisna vardır: çarpım işareti (640×480), 'tek tırnak' ve “çift tırnak”. Bunlar ihtiyaca göre kapatılmış olabilirler.

Alıntılama

Bazen bir metnin cevap veya yorum olduğunu göstermek istersiniz, şu biçim kullanılabilir: 

Bence yapmalıyız

> Hayır yapmamalıyız

>> Ben de yapılması gerekir diyorum

> Gerçekten mi?

>> Evet!

>>> O zaman yapalım!

Bence yapmalıyız

Hayır yapmamalıyız
Ben de yapılması gerekir diyorum
Gerçekten mi?
Evet!
O zaman yapalım!

Tablolar

Basit bir biçimle tablo oluşturmak mümkündür:

Başlık 1 Başlık 2 Başlık 3
Satır 1 Sütun 1 Satır 1 Sütun 2 Satır 1 Sütun 3
Satır 2 Sütun 1 birleşmiş satır (çift boru ile yapılır)
Satır 3 Sütun 1 Satır 3 Sütun 2 Satır 3 Sütun 3

Tablo satırlar | ile başlamalıdır, normal satırlarda başlık için ^ kullanılır. 

^ Başlık 1      ^ Başlık 2       ^ Başlık 3          ^
| Satır 1 Sütun 1    | Satır 1 Sütun 2     | Satır 1 Sütun 3        |
| Satır 2 Sütun 1    | birleşmiş satır (çift boru ile yapılır) ||
| Satır 3 Sütun 1    | Satır 3 Sütun 2     | Satır 3 Sütun 3        |

Hücreleri yatay olarak birleştirmek için, yukarıda görüntülendiği üzere, sonraki hücreyi tamamen boş bırakın. Her zaman aynı sayıda hücre ayracınız olması önemlidir!

Dikey tablo başlıkları da mümkündür.

Başlık 1 Başlık 2
Başlık 3 Satır 1 Sütun 2 Satır 1 Sütun 3
Başlık 4 bu sefer birleşmemiş satır
Başlık 5 Satır 2 Sütun 2 Satır 2 Sütun 3

Gördüğünüz üzere, hücreden önce hücre ayracı biçimi belirler: 

|              ^ Başlık 1            ^ Başlık 2          ^
^ Başlık 3    | Satır 1 Sütun 2          | Satır 1 Sütun 3        |
^ Başlık 4    | bu sefer birleşmemiş satır |                    |
^ Başlık 5    | Satır 2 Sütun 2          | Satır 2 Sütun 3        |

Satır birleşimleri (dikey birleşmiş hücreler) mümkündür, alttakı hücreye ::: eklemelisiniz.

Başlık 1 Başlık 2 Başlık 3
Satır 1 Sütun 1 bu hücre dikey olarak uzar Satır 1 Sütun 3
Satır 2 Sütun 1 Satır 2 Sütun 3
Satır 3 Sütun 1 Satır 3 Sütun 3

Satır ayrımı sentaksı dışında bu satırlarda hiçbir şey olmamalıdır: 

^ Başlık 1      ^ Başlık 2                  ^ Başlık 3          ^
| Satır 1 Sütun 1    | bu hücre dikey olarak uzar | Satır 1 Sütun 3        |
| Satır 2 Sütun 1    | :::                        | Satır 2 Sütun 3        |
| Satır 3 Sütun 1    | :::                        | Satır 3 Sütun 3        |

Tablo içerikleri de hizalanabilir. Sadece metnin karşı tarafına en az 2 boşluk bırakın: Sağa yaslamak için sola 2 boşluk, sola yaslamak için sağa 2 boşluk, ortalamak için her iki taraftan 2 boşluk.

Hizalı Tablo
sağ orta sol
sol sağ orta
xxxxxxxxxxxx xxxxxxxxxxxx xxxxxxxxxxxx

Kaynakta böyle görünür: 

^           Hizalı Tablo           ^^^
|         sağ|    orta    |sol          |
|sol          |         sağ|    orta    |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

Not: Dikey hizalama desteklenmez.

Biçimlendirmesiz

Metni olduğu gibi görüntüleyip, biçimlendirme kullanmak istemiyorsanız o alanı <nowiki> etiketiyle, veya basitçe 2 yüzde işaretiyle göstermeniz gerekir: %%.

Bu metinde adres: http://www.splitbrain.org ve **biçimlendirme**, vardır ama kullanılmaz. Aynısı bu //__metin__ için// de geçerli, gülücükler dahil ;-). 

<nowiki>
Bu metinde adres: http://www.splitbrain.org ve **biçimlendirme**, vardır ama kullanılmaz.
</nowiki>
Aynısı bu %%//__metin__ için// de geçerli, gülücükler dahil ;-)%%.

Kod Blokları

Dökümanlarınızda kod blokları verebilirsiniz, bunun için iki boşluk ile girintileme (önceki örnekler için kullanıldığı gibi) veya <code> ve <file> etiketleri kullanılabilir.. 

İki boşlukla girintilenmiş metin.
Bu kod bloğunda tüm boşluklar saklanır: bunun              <-gibi
Bu da az çok aynıdır, fakat dosya olduğunu belirtir.

Bu kutular şu şekilde oluşturulur: 

  İki boşlukla girintilenmiş metin.
<code>
Bu kod bloğunda tüm boşluklar saklanır: bunun              <-gibi
</code>
<file>
Bu da az çok aynıdır, fakat dosya olduğunu belirtir.
</file>

Sentaks Belirtme

Dökümanlarda kaynak kod belirtilebilir, daha kolay okuma sağlanabilir. Bunun için GeSHi Genel Sentaks Belirtici kullanılır – böylece GeSHi destekli tüm diller desteklenir. Sentaks, geçen bölümdeki kod ve dosya bloklarına benzerdir, ancak bu sefer dil ismini de etikette belirtiriz. Örn. <code java> or <file java>. 

/**
 * The HelloWorldApp class implements an application that
 * simply displays "Hello World!" to the standard output.
 */
class HelloWorldApp {
    public static void main(String[] args) {
        System.out.println("Hello World!"); //Display the string.
    }
}

Desteklenen diller: 4cs, abap, actionscript-french, actionscript, actionscript3, ada, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, cpp, cpp-qt, csharp, css, cuesheet, d, dcs, delphi, diff, div, dos, dot, ecmascript, eiffel, email, erlang, fo, fortran, freebasic, fsharp, gambas, genero, genie, gdb, glsl, gml, gnuplot, groovy, gettext, gwbasic, haskell, hicest, hq9plus, html, icon, idl, ini, inno, intercal, io, j, java5, java, javascript, jquery, kixtart, klonec, klonecpp, latex, lisp, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, newlisp, nsis, oberon2, objc, ocaml-brief, ocaml, oobas, oracle8, oracle11, oxygene, oz, pascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender, plsql, postgresql, povray, powerbuilder, powershell, progress, prolog, properties, providex, purebasic, python, q, qbasic, rails, rebol, reg, robots, rpmspec, rsplus, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, systemverilog, tcl, teraterm, text, thinbasic, tsql, typoscript, unicon, vala, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, winbatch, whois, xbasic, xml, xorg_conf, xpp, z80

İndirilebilir Kod Blokları

Kodunuz için <code> veya <file> sentaksı kullandığınızda, gösterilen kodu indirilebilir yapmak isteyebilirsiniz. Bunun için, dil kodundan sonra bir dosya adı vermek yeterlidir: 

<file php ornek.php>
<?php echo "hello world!"; ?>
</file>
ornek.php
<?php echo "hello world!"; ?>

Kodda bir sentaks belirtimi istemiyor ancak indirilebilir olsun istiyorsanız, dil kodu yerine (-) kullanın: <code - dosyam.foo>.

RSS/ATOM Beslemeleri

Harici XML beslemeler desteklenir. Bunun için, SimplePie kullanılır. SimplePie tarafından anlaşılan tüm biçimler dökümanlarda kullanılabilir, gösterimi çok sayıda opsiyonel parametreyi boşluklarla ayırarak etkileyebilirsiniz:

Parametre Açıklama
herhangi sayı maksimum kaç öğe gösterilecek, varsayılan 8
reverse son öğeyi ilk gösterir
author öğeyi oluşturan yazarı gösterir
date öğe tarihi gösterir
description öğe açıklamasını gösterir, etiketler ayrıştırılabilir
n[dhm] yenileme süresi, d=gün, h=saat, m=dakika. (örn. 12h = 12 saat).

Yenileme süresi varsayılanı 4 saattir. 10 dakikadan az tüm değerler 10 dakika olarak uygulanır. Dökümanların önbellekli sürümleri verilmeye çalışılır, ancak dinamik harici içerikten tolayı, yenileme süresi dolunca sayfanın bir sonraki gösteriminde sayfa yeniden oluşturulur. Lütfen beslemeleri sadece gerekiyorsa kullanınız.

Örnek: 

{{rss>http://slashdot.org/index.rss 5 author date 1h }}

Kontrol Makroları

Bazı sentakslar doğrudan bir çıktı yaratmazken, sayfanın nasıl gösterileceğini düzenlerler:

Makro Açıklama
~~NOTOC~~ İçindekiler kutusunun oluşmasını önler
~~NOCACHE~~ Normalde tüm çıktılar önbelleklenir. Bazen bu durum istenmeyebilir, bu makro kullanılırsa sayfa her çağrıda yeniden oluşturulur

Sentaks Eklentileri

Bazı eklentiler mevcuttur:

1) İngilizce
2) Mesela bu bir dipnottur
3) Verilen genişlik ve yükseklikle resmin genişlik ve yükseklik oranı uymazsa, boyutlandırmadan önce resim kesilir

İz: • Başlangıç • baslangıc • calısma_grupları • meego_transifex_ceviri_grubu • meego_tuerkiye_harmattan_uygulama_ceviri_grubu • istatistikler • syntax