Különbségek

A kiválasztott változat és az aktuális verzió közötti különbségek a következők.

--- hu:wiki:syntax [2018/09/23 17:25]
bahnfrank65 létrehozva
+++ hu:wiki:syntax [2018/09/23 17:26] (aktuális)
bahnfrank65 létrehozva
@@ Sor 1: / Sor 1: @@
+====== 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:**
+FIXME
+===== 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~~

Eisenbahn-Bildschirmschoner-Wiki

Felhasználói eszközök

Eszközök a webhelyen

Különbségek

Eszközök az oldalon