====== Formázási jelölésmód ======

A [[DokuWiki]]-ben néhány egyszerű jelöléssel olvashatóbbá tehetjük oldalainkat.
Ezen az oldalon bemutatjuk az összes szinktaktikai jelölést, melyeket az oldalak szerkesztésénél használhatunk.
Az oldal forrása egyszerűen megtekinthető a lap felső vagy alsó részén található az //Oldal szerkesztése// vagy //Oldalforrás megtekintése// gomb megnyomásával.
A formázások kipróbálásához a [[playground:playground|játszótér]] oldal használható. A legegyszerűbb formázások könnyen elérhetők szerkesztés közben a [[doku>toolbar|gyorsgombok]] segítségével is.

===== Egyszerű szövegformázások =====

A DokuWiki támogatja a  **félkövér**, //dőlt//, __aláhúzott__ és ''írógép'' betűformákat. Ezek természetesen **__//''kombinálhatók''//__** egymással.

  A DokuWiki támogatja a  **félkövér**, //dőlt//, __aláhúzott__ és ''írógép'' betűformákat.
  Ezek természetesen **__//''kombinálhatók''//__** egymással.

Használható a <sub>süllyesztett, alsó index</sub> és az <sup>emelt, felső index</sup> mód is.

  Használható a <sub>süllyesztett, alsó index</sub> és az <sup>emelt, felső index</sup> mód is.

Lehet <del>töröltnek</del> is jelölni a szöveget.

  Lehet <del>töröltnek</del> is jelölni a szöveget.

Új **bekezdés** üres sor után kezdődik. Ha **erőltetett sortörést** szeretnénk új bekezdés kezdése nélkül, írjunk két visszaper (backslash) jelet szóközzel, tabulátorral vagy sorvégjellel követve.

Itt van egy szöveg sortörésekkel.\\ Ügyeljünk arra,
hogy a két visszaper jelet csak szóköz, tabulátor vagy sorvégjel\\
előtt értelmezi\\ sortörésnek, \\egyébként ilyen lesz.

  Itt van egy szöveg sortörésekkel.\\ Ügyeljünk arra,
  hogy a két visszaper jelet csak szóköz, tabulátor vagy sorvégjel\\
  előtt értelmezi\\ sortörésnek, \\egyébként ilyen lesz.

Az erőltetett sortörést lehetőleg csak szükség esetén használjuk.  

===== Hivatkozások =====

A DokuWiki többféle módot támogat a hivatkozások készítéséhez.

==== Külső hivatkozások ====

A külső hivatkozásokat automatikusan felismeri: http://www.google.com 
vagy egyszerűbben www.google.com - Beállíthatunk alternatív nevet is: 
[[http://www.google.com|Ez a hivatkozás a google-ra mutat]]. 
Az email címeket is felismeri, például: <andi@splitbrain.org>.

  A külső hivatkozásokat automatikusan felismeri: http://www.google.com
  vagy egyszerűbben www.google.com - Beállíthatunk alternatív nevet is: 
  [[http://www.google.com|Ez a hivatkozás a google-ra mutat]]. 
  Az email címeket is felismeri, például: <andi@splitbrain.org>.

==== Belső hivatkozások ====

Belső hivatkozásokat szögletes zárójellel készíthetünk. Egyszerűen 
megadhatunk egy oldalnevet: [[doku>pagename]] vagy alternatív névvel: 
[[doku>pagename|Cím szöveg]]. A wiki oldalnevek automatikusan 
kisbetűssé alakulnak, speciális jelek nem megengedettek. 

  Belső hivatkozásokat szögletes zárójellel készíthetünk. Egyszerűen 
  megadhatunk egy oldalnevet: [[doku>pagename]] vagy alternatív névvel: 
  [[doku>pagename|Cím szöveg]]. A wiki oldalnevek automatikusan 
  kisbetűssé alakulnak, speciális jelek nem megengedettek. 

[[.:namespaces|Névtereket]] használhatunk, ha a hivatkozásba kettőspontot teszünk.

  [[.:namespaces|Névtereket]] használhatunk, ha a hivatkozásba kettőspontot teszünk.

További infó (angolul) a névterekről itt: [[doku>namespaces|Namespaces]].

Hivatkozhatunk az oldal egy meghatározott szakaszára is. Egyszerűen utána kell fűzni egy kettőskeresztet és a szakasz nevét, úgy, mint HTML-ben.
Ez [[syntax#belso_hivatkozasok|erre a szakaszra]] hivatkozik.

  Ez [[syntax#belso_hivatkozasok|erre a szakaszra]] hivatkozik.

Megjegyzések:

  * [[.:syntax|Létező oldal]] hivatkozása más stílusú lesz, mint egy [[nonexisting|nem létező]] oldalé.
  * A DokuWiki alapesetben nem használja a [[wp>CamelCase]] módot a hivatkozások automatikus elkészítéséhez, de ez a mód bekapcsolható a [[doku>config|konfigurációnál]]. Tipp: Ha a DokuWiki szó hivatkozás lett, akkor be van kapcsolva ez a mód.
  * Ha a szakasz fejléce (címe) megváltozik, a hivatkozási neve is változik, így a korábban készített hivatkozások elromolhatnak. Emiatt nem lehetünk biztosak abban, hogy a szakasz hivatkozásaink mindig helyesek lesznek.

==== Interwiki ====

A DokuWiki támogatja az [[doku>interwiki|Interwiki]] típusú, azaz egyéb Wikik közötti gyors hivatkozásokat. 
Például itt egy hivatkozás a Wikipedia wikikről szóló oldalára: [[wp>Wiki]].

  A DokuWiki támogatja az [[doku>interwiki|Interwiki]] típusú, azaz egyéb Wikik közötti gyors hivatkozásokat. 
  Például itt egy hivatkozás a Wikipedia wikikről szóló oldalára: [[wp>Wiki]].


==== Windows-os megosztások ====

A windows-os megosztások is haználhatók, mint például [[\\server\share|ez]].
Megjegyezzük, hogy ilyen használatának csak homogén felhasználói csoportok esetében van értelme, például egy vállalati hálózaton belül. [[wp>Intranet]].

  A windows-os megosztások is használhatók, mint például [[\\server\share|ez]].

Megjegyzések:

  * Bizonsági okokból a windows-os megosztások közvetlen böngészése csak Microsoft Internet Explorerrel működik alapbeállításként (és csak a "local intranet/helyi hálózat" biztonsági tartományban).
  * Mozilla és Firefox használók engedélyezhetik a következő beállítással:  [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]], de nem ajánlott.
  * Lásd még további infóért: [[bug>151]].

==== Kép hivatkozások ====

Képeket is használhatunk belső és külső hivatkozáshoz, a hivatkozások és [[#kepek_es_egyeb_allomanyok|képek]] (lásd később) szintakszisának kombinálásával, például:

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

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

Megjegyzés: A kép beillesztés az egyetlen megengedett formázási eset a hivatkozások álneveinél.

Az összes [[#kepek_es_egyeb_allomanyok|kép]] és [[#hivatkozasok|hivatkozás]] formázási szintaxis megengedett (beleértve a kép átméretezést, belső és külső képeket, URL-eket, interwiki hivatkozásokat).

===== Lábjegyzet =====

Lábjegyzetet ((Ez egy lábjegyzet)) kettős zárójel használatával készíthetünk.

  Lábjegyzetet ((Ez egy lábjegyzet)) kettős zárójel használatával készíthetünk.

===== Szakaszok =====

A tartalmak tagolására ötféle főcím stílus használható. Háromnál több főcím használata esetén tartalomjegyzék generálódik -- ez letiltható, ha a ''<nowiki>~~NOTOC~~</nowiki>'' szöveget elhelyezzük az oldal forrásában.

==== 3. szintű főcím ====
=== 4. szintű főcím ===
== 5. szintű főcím ==

  ==== 3. szintű főcím ====
  === 4. szintű főcím ===
  == 5. szintű főcím ==

Vizszintes vonalat sor eleji 4 vagy több kötőjel segítségével kapunk:

----



===== Képek és egyéb állományok =====

Külső vagy belső [[doku>images|képeket]] kapcsos zárójellel szúrhatunk az oldalba. Ha akarjuk, megadhatjuk a méretet is.

Valós méret:                        {{wiki:dokuwiki-128.png}}

Átméretezve a megadott szélességre: {{wiki:dokuwiki-128.png?50}}

Átméretezve a megadott szélességre és magasságra: {{wiki:dokuwiki-128.png?200x50}}

Átméretezett külső kép:             {{http://de3.php.net/images/php.gif?200x50}}

  Valós méret:                        {{wiki:dokuwiki-128.png}}
  Átméretezve a megadott szélességre: {{wiki:dokuwiki-128.png?50}}
  Átméretezve a megadott szélességre és magasságra: {{wiki:dokuwiki-128.png?200x50}}
  Átméretezett külső kép:             {{http://de3.php.net/images/php.gif?200x50}}

Bal vagy jobb oldalon elhelyezett szóközzel tudjuk az oldalhoz igazítást megadni:

{{ wiki:dokuwiki-128.png}}

{{wiki:dokuwiki-128.png }}

{{ wiki:dokuwiki-128.png }}

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

Természetesen megadható a kép címe is. (A legtöbb böngésző tooltip-ként mutatja.)

{{ wiki:dokuwiki-128.png |Ez a kép címe}}

  {{ wiki:dokuwiki-128.png |Ez a kép címe}}

Ha olyan (külső vagy belső) állománynevet adunk meg, amely nem kép (''gif, jpeg, png''), az hivatkozásként fog megjelenni.

Ha képekkel más oldalakra szeretnénk mutatni, akkor a fenti [[#kép hivatkozások]] szakasz tanulmányozása ajánlott.


===== Felsorolások =====

A Dokuwikiben sorszámozott és nem sorszámozott felsorolásokat használhatunk. Felsorolás elem készítéséhez a sort két szóközzel kell kezdeni, utána ''*''-ot kell írni a nem sorszámozott felsoroláshoz, illetve ''-''-et a sorszámozott felsoroláshoz, majd következhet a szöveg.

  * Ez egy felsorolás
  * A második elem
    * Többszintű is lehet
  * További elem

  - Hasonló felsorolás, de sorszámozva
  - További elem
    - További szintekhez több szóközzel kell kezdeni
  - Ez az!

<code>
  * Ez egy felsorolás
  * A második elem
    * Többszintű is lehet
  * További elem

  - Hasonló felsorolás, de sorszámozva
  - További elem
    - További szintekhez több szóközzel kell kezdeni
  - Ez az!
</code>

===== Smiley-k =====

A DokuWiki átalakítja az ismert [[wp>emoticon]]-okat képecskékké. További smiley-képeket a ''smiley'' könyvtárba lehet helyezni és a ''conf/smileys.conf'' állományba kell írni az új konverziós szabályokat. Itt egy áttekintés a DokuWiki beépített smiley-airól:

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


===== Jelek tipográfiája =====

A DokuWiki képes átkonvertálni a karakterekből rajzolt jeleket a tipográfiai megfelelőjükké. Itt egy példa a felismert karakterekről:

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."

<code>
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."
</code>

Megjegyzés: Ez a konverzió kikapcsolható a [[doku>config|konfigurációs beállításoknál (typography)]] és a [[doku>entities|konverziót leíró állományban]].

===== Válasz, idézés jelölése =====

Előfordulhat, hogy jelezni kell, hogy az adott szöveg egy válasz valamire vagy megjegyzés. A következő formát használhatjuk:

  I think we should do it
  
  > No we shouldn't
  
  >> Well, I say we should
  
  > Really?
  
  >> Yes!
  
  >>> Then lets do it!

I think we should do it

> No we shouldn't

>> Well, I say we should

> Really?

>> Yes!

>>> Then lets do it!


===== Táblázatok =====

A DokuWikivel egyszerűen lehet táblázatot készíteni.

^ 1. fejléc         ^ 2. fejléc         ^ 3. fejléc         ^
| 1. sor 1. oszlop  | 1. sor 2. oszlop  | 1. sor 3. oszlop  |
| 2. sor 1. oszlop  | oszlop osszevonás (dupla vonal!)     ||
| 3. sor 1. oszlop  | 3. sor 2. oszlop  | 3. sor 3. oszlop  |

A táblázat normál sorait ''|'' jellel, a fejléc sorokat ''^'' kell kezdeni és zárni 

  ^ 1. fejléc         ^ 2. fejléc         ^ 3. fejléc         ^
  | 1. sor 1. oszlop  | 1. sor 2. oszlop  | 1. sor 3. oszlop  |
  | 2. sor 1. oszlop  | oszlop osszevonás (dupla vonal!)     ||
  | 3. sor 1. oszlop  | 3. sor 2. oszlop  | 3. sor 3. oszlop  |

Ahhoz, hogy a mezők vízszintesen illeszkedjenek, a következő mezőt teljesen üresen kell hagyni, mint ahogy a következő példában látható. Ügyeljünk rá, hogy mindig ugyanannyi mező-elválasztó legyen.

Függőlegesen is használhatunk fejléceket.

|            ^ 1. fejléc                    ^ 2. fejléc          ^
^ 3. fejléc  | 1. sor 2. oszlop             | 1. sor 3. oszlop   |
^ 4. fejléc  | most nincs oszlop összevonás |                    |
^ 5. fejléc  | 3. sor 2. oszlop             | 3. sor 3. oszlop   |

Látható, hogy a mező előtti elválasztó típusa határozza meg a stílust:

  |            ^ 1. fejléc                    ^ 2. fejléc          ^
  ^ 3. fejléc  | 1. sor 2. oszlop             | 1. sor 3. oszlop   |
  ^ 4. fejléc  | most nincs oszlop összevonás |                    |
  ^ 5. fejléc  | 3. sor 2. oszlop             | 3. sor 3. oszlop   |

Megjegyzés: függőleges összevonás (sorok összevonása) nem lehetséges.

Természetesen a tábla tartalma is igazítható. Legalább két szóközt kell az ellentétes oldalra tenni: a szöveg jobb oldalára, ha balra, illetve a szöveg bal oldalára, ha jobbra szeretnénk igazítani a mező tartalmát. Középre rendezéshez mindkét végére tegyünk legalább két szóközt.

^              Igazított tábla             ^^^
|        jobbra|    középre   |balra         |
|balra         |        jobbra|    középre   |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

Ez így néz ki a forrásban:

  ^              Igazított tábla             ^^^
  |        jobbra|    középre   |balra         |
  |balra         |        jobbra|    középre   |
  | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |


===== Nem formázott blokkok =====

Ahhoz, hogy a DokuWiki ne formázza (értelmezze) az adott szöveget, vagy legalább két szóközzel kell kezdeni (mint ahogy az előző példákban is látható), vagy ''code'' illetve ''file'' cimkék közé kell tenni.

<code>
Ez egy előre formázott kódrészlet, minden szóközt megtart:            <- így.
</code>

<file>
Ez kinézetre hasonló, de ezzel kiemelhető, hogy egy fájl-részletet mutatunk.
</file>

Ahhoz, hogy egy részt teljesen kihagyjon az értelmező (például egyátalán ne formázza), az egészet zárjuk ''nowiki'' cimkébe, vagy egyszerűbben kettős százalékjel ''<nowiki>%%</nowiki>'' közé. 

<nowiki>
Ez egy olyan szöveg, amely URL-t: http://www.splitbrain.org és **formázási jeleket** tartalmaz, de nem történik vele semmi.
</nowiki>

Az oldal forrásában látható, hogyan kell ezeket a blokkokat használni.

===== Forráskód színezés =====

A [[DokuWiki]] képes színezni a forráskódot, hogy könnyebb legyen olvasni. A [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter-t használja -- így a GeSHi által támogatott nyelvek támogatottak itt is. 
A jelölésmód hasonló, mint az előző szakasz ''code'' blokkja esetén, csak itt a használni kívánt programnyelvet meg kell nevezni a cimkében. Például ''<nowiki><code java></nowiki>''.

<code 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.
    }
}
</code>

Jelenleg a következő (program)nyelvek esetében működik: //actionscript-french, actionscript, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, bnf, caddcl, cadlisp, cfdg, cfm, c_mac, c, cpp, cpp-qt, csharp, css, delphi, diff, div, dos, d, eiffel, fortran, freebasic, gml, groovy, html, idl, ini, inno, io, java5, java, javascript, latex, lisp, lua, matlab, mirc, mpasm, mysql, nsis, objc, ocaml-brief, ocaml, oobas, oracle8, pascal, perl, php-brief, php, plsql, python, qbasic, rails, reg, robots, ruby, sas, scheme, sdlbasic, smalltalk, smarty, sql, tcl, text, thinbasic, tsql, vbnet, vb, vhdl, visualfoxpro, winbatch, xml, xpp, z80//


===== RSS/ATOM folyam beillesztés =====
A [[DokuWiki]] képes külső XML folyamból származó adatok beillesztésére. Az XML folyamok értelmezéséhez a [[http://simplepie.org/|SimplePie]]-t használja. A SimplePie által értelmezett formázások használhatók a DokuWikiben is. Az értelmezés és megjelenítés a következő paraméterekkel befolyásolható (szóközzel kell elválasztani őket):

^ Paraméter  ^ Leírás ^
| bármilyen szám | legfeljebb ennyi elemet mutat, az alapérték 8 |
| reverse    | a folyam utolsó elemét mutatja elsőként |
| author     | mutatja az elem szerzőjének nevét |
| date       | mutatja az elem dátumát |
| description| mutatja az elem leíró mezőjét. A HTML cimkék kiszedésre kerülnek, ha a [[doku>config|konfigurációs beállításoknál]]  a HTML értelmezése (''htmlok'' kapcsoló) le van tiltva |
| //n//[dhm] | frissítési idő, ahol a d=napokat, h=órákat, m=perceket jelent. (Pl. 12h = 12 óra). |

A frissítési idő alapesetben 4 óra. 10 percnél kisebb érték esetén is 10 percenként lesz a frissítés. A DokuWiki általában a lapok gyorstárolóban elhelyezett verzióját szolgáltatja, de ez nyilvánvalóan nem megfelelő, amikor a lap külső dinamikus adatokat is tartalmaz. Ez a paraméter tudatja a DokuWikivel, hogy újra dolgozza fel az oldalt, ha az utolsó feldolgozás óta letelt a //frissítési idő//.

**Példa:**

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

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

===== Beágyazott HTML és PHP =====

Nyers HTML vagy PHP kód is beilleszthető az oldalainkba a ''html'' illetve ''php'' cimke használatával:
<code>
<html>
Ez egy <font color="red" size="+1">HTML</font> kód.
</html>
</code>

<html>
Ez egy <font color="red" size="+1">HTML</font> kód.
</html>

<code>
<php>
echo 'Ezt a logót PHP-val generáltuk:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo!" />';
</php>
</code>

<php>
echo 'Ezt a logót PHP-val generáltuk:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo!" />';
</php>

**Megjegyzés**: a HTML és PHP beágyazás alapértelmezetten tiltott a konfigurációs beállításban. Ha tiltott, maga a kód jelenik meg, ahelyett, hogy végrehajtódna.


===== Jelölésmód bővítmények (Syntax Plugins) =====

A DokuWiki által értelmezett jelölésmód kibővíthető [[doku>plugins|Plugin]]-okkal. A telepített bővítmények használata azok leírásában szerepel. A következő jelölésmód bővítmények érhetők el ebben a konkrét DokuWiki telepítésben:

~~INFO:syntaxplugins~~