DokuWiki

It's better when it's simple

Uzantaj iloj

Retejaj iloj


eo:wiki:syntax

Markada Sintakso

Dokuwiki uzas kelkajn simplajn markaĵojn, kiuj provas igi la datendosierojn plejeble facile legeblaj. Tiu ĉi paĝo enhavas ĉiujn sintakserojn kiujn oni povas uzi dum redaktado de la paĝoj. Simple rigardu la fontkodon de tiu ĉi paĝo preminte la butonon Redakti paĝon en la supro de la paĝo. Se vi emas provi ion, simple aliru la paĝon ludejo. Krome, la markaĵoj estas uzeblaj de la tuj-butonoj.

Baza formatado de teksto

DokuWiki disponigas dikecajn, italecajn, substrekitajn kaj samspacitajn tekstojn. Kompreneble oni povas kombini ĉiujn tiujn.

DokuWiki disponigas **dikecajn**, //italecajn//,
 __substrekitajn__ kaj ''samspacitajn'' tekstojn.
Kompreneble oni povas **__//''kombini''//__** ĉiujn tiojn.

Vi povas uzi suban indicon kaj supran indicon.

Vi povas uzi <sub>suban</sub> indicon kaj
<sup>supran</sup> indicon.

Vi povas marki ion kiel forviŝita ankaŭ.

Vi povas marki ion kiel <del>forviŝita</del> ankaŭ.

Alineoj estas kreitaj de malplenaj linioj. Se vi volas devigi novan linion sen komenci novan alineon, vi povas enskribi du deklivajn streketojn sekvitaj de spaceto, aux la fino de la linio.

Ĉi tiu estas teksto kun linisaltoj
Notu ke la du deklivaj streketoj estas obeitaj nur kune kun linifino, aux spaceto \\Ĉi tiu okazas sen fino aux spaceto.

Ĉi tiu estas teksto kun linifinigoj\\ Notu ke la 
du deklivaj streketoj estas  obeitaj nur kune kun
linifino, aŭ spaceto \\Ĉi tiu okazas sen fino aŭ spaceto.

Uzu novajn liniojn nur kiam estas vere bezonata.

Ligiloj

DokuWiki subtenas plurajn manierojn por krei ligilon.

Ekstera

Eksteraj ligiloj estas akceptataj aŭtomate: http://www.google.com aŭ nur www.google.com - Vi povas enskribi nomon por la ligilo ankaŭ: Ĉi tiu ligilo almontras al google. Retpoŝtadresoj estas akceptataj ankaŭ: andi [at] splitbrain [dot] org

DokuWiki subtenas plurajn rimedojn por krei ligilon. Eksteraj ligiloj
estas akceptataj aŭtomate: http://www.google.com aŭ nur www.google.com
- Vi povas enskribi nomon por la ligilo, se vi volas:
[[http://www.google.com|Ĉi tiu ligilo almontras al google]]
Retpoŝtadresoj estas akceptataj ankaŭ: <andi@splitbrain.org>

Interna

Oni kreas internajn ligilojn per rektaj krampoj. Vi povas uzi aux paĝnomo aux Titola Teksto. Vikiaj pagxnomoj estas sxangxitaj al minusklaj literoj auxtomate; bedauxrinde, vi ne povas uzi la X-sistemon cxi tie – ene de la krampoj, la X-sistemo ne estas sxangxita al la cxapelitaj literoj.

Oni kreas internajn ligilojn per rektaj krampoj. Vi povas uzi aŭ
[[paĝnomo]] aŭ [[paĝnomo|Titolo]]. Vikiaj paĝnomoj estas ŝanĝitaj al
minusklaj literoj aŭtomate; bedaŭrinde, vi ne povas uzi la X-sistemon
ĉi tie -- ene de la krampoj, la X-sistemo ne estas ŝanĝita al la 
ĉapelitaj literoj.

Vi povas uzi nomspacon per dupunkto en la nomo.

Vi povas uzi [[vikio:nomspaco]] per dupunkto en la nomo.

Por detaloj vidu (angle) namespaces.

Vi povas krei ligilon al aparta sekcio. Aldonu la sekcian nomon malantaux kradon kiel en HTML. Cxi tiu ligas al ĉi tiu sekcio.

Ĉi tiu ligas al [[dokuvikia_sintakso#interna|ĉi tiu sekcio]].

Notoj:

  • Ligiloj al jamaj paĝoj montras sin malsamaj ol ne jam kreitaj paĝoj.
  • DokuWiki ne uzas CamelCase por auxtomate krei ligilojn defaŭlte, sed tia ja povas esti sxaltita en la config dosiero. Konsileto: Se DokuWiki estas ligilo, vere jam estas ebligita.
  • Kiam oni sxangxas la titolon de sekcio, sekve la legosigno ankaux estas sxangxita. Do ne dependu de sekcia ligilo.

Intervikio

DokuWiki disponigas intervikiajn ligilojn. Ili estas praktikaj (ordinare mallongaj) ligiloj al aliaj vikioj. Ekzemple:

Jen ligilo al Vikipedia pagxo pri Vikioj:Vikio.

Jen ligilo al Vikipedia pagxo pri vikioj:[[vp>Vikio]].

Bildaj Ligiloj

Vi povas uzi bildon kiel ligilon al alia pagxo (interna aux ekstera). Vi kombinas la sintakson por ligiloj kaj bildoj kaj aliaj dosieroj (vidu sube) tiele:

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

Notu: la bildaj arangxaj komandoj estas la nura arangxa sintakso akceptita en ligilaj nomoj.

Ĉiuj bildaj kaj ligilaj sintaksoj estas akceptitaj (inkluzive bilda regrandigo, internaj kaj eksteraj bildoj, URL-aj kaj intervikiaj ligiloj).

Piednotoj

Vi povas aldoni piednotojn per 1) duoblaj krampoj.

Vi povas aldoni piednotojn per ((Ĉi tio estas piednoto)) duoblaj krampoj.

Sekciigo

Vi povas uzi gxis kvin malsamajn nivelojn de titoloj por strukturigi vian enhavon. Se estas pli ol tri titoloj, indeksa tabelo estas auxtomate kreita – tio povas esti malebligata uzante la cxenon ~~NOTOC~~ en la dokumento.

Titolo - Nivelo 3

Titolo - Nivelo 4

Titolo - Nivelo 5
==== Titolo - Nivelo 3 ====
=== Titolo - Nivelo 4 ===
== Titolo - Nivelo 5 ==

Per uzo de kvar aux pli strekoj, vi povas fari horizontalan linion:


Ekzemple: ----

Bildoj kaj aliaj dosieroj

Oni povas inkluzivi eksterajn kaj internajn bildojn (angle) per kunigaj krampoj ({{bildo}}). Opcie, oni povas difini ilian grandecon.

Reala grandeco:

Regrandigi laux largxeco:

Regrandigi laux largxeco kaj alteco:

Regrandigita ekstera bildo:

Reala grandeco:                        {{wiki:dokuwiki-128.png}}
Regrandigi laux largxeco:            {{wiki:dokuwiki-128.png?50}}
Regrandigi laux largxeco kaj alteco: {{wiki:dokuwiki-128.png?200x50}}
Regrandigita ekstera bildo: {{http://de3.php.net/images/php.gif?200x50}}

Uzante dekstrajn aux maldekstrajn blankspacojn, oni povas difini la dispozicion.

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

Kompreneble, oni povas ankaux aldoni apudskribon (montrite kiel konsileto de plejparto el la foliumiloj).

Tio cxi estas apudskribo

{{ wiki:dokuwiki-128.png |Tio cxi estas apudskribo}}

Se oni enmetas eksteran aux internan dosiernomon, kiu ne estas bildo (gif, jpg, png), tiel gxi estos anstatauxe montrata kiel ligilo.

Por ligigi bildon al alia pagxo, legu Bildaj Ligiloj supre.

Listoj

Dokuwiki eltenas ordigantajn kaj neordigantajn listojn. Por krei listeron, krommargxenu vian tekston per du blankspacoj kaj prefiksu steleton (*) por neordigantaj listoj aux strekon (-) por ordigantaj.

  • Tio estas listo
  • La dua listero
    • Eblas malsamaj niveloj
  • Plia listero
  1. La sama listo, nun ordigite
  2. Alia listero
    1. Simple uzu krommargxenon por pli subaj niveloj
  3. Estas tio.
  * Tio estas listo
  * La dua listero
    * Eblas malsamaj niveloj
  * Plia listero

  - La sama listo, nun ordigite
  - Alia listero
    - Simple uzu krommargxenon por pli subaj niveloj
  - Estas tio.

Smileys

DokuWiki konvertas ofte uzatajn miensimbolojn al iliaj grafikaj ekvivalentoj. Pli miensimboloj povas enesti la dosierujon “smiley” kaj tiel ili povas esti inkluzivitaj per la dosiero conf/smileys.conf. Jen listo de la Miensimboloj disponeblaj en cxi tiu vikio.

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

Kromformatoj por signaĵoj

Dokuwiki povas konverti kumetitajn simplajn signajxojn al iliaj gxustaj unuopaj formoj. Jen ekzemplo de rekoneblaj kromformatoj:

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ®

“Li pensis 'Estas homeca mondo'…”

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)

"Li pensis 'Estas homeca mondo'..."

rim.: tiuj konvencioj povas esti malebligitaj per agord-opcio kaj per dosiero de sxablonetoj.

Citiloj

Kelkfoje oni deziras marki tekston por montri, ke gxi estas respondo aux komento. Por fari tion, oni povas uzi la jenan sintakson:

Mi pensas, ke ni devus fari tion.
  
> Ne, ni ne devus.

>> Bone, mi insistas, ke ni devus.

> Cxu?

>> Jes!

>>> Do ni faru!

Mi pensas, ke ni devus fari tion.

Ne, ni ne devus.
Bone, mi insistas, ke ni devus.
Cxu?
Jes!
Do ni faru!

Tabeloj

DokuWiki eltenas simplan sintakson por krei tabelojn.

Titolo 1 Titolo 2 Titolo 3
Linio 1 Kolumno 1 Linio 1 Kolumno 2 Linio 1 Kolumno 3
Linio 2 Kolumno 1 iom da sxovo (rimarku la duopan vertikalan strekon)
Linio 3 Kolumno 1 Linio 3 Kolumno 2 Linio 3 Kolumno 3

Linioj en tabeloj ekigxas kaj finigxas per “|” por normalaj linioj aux per “^” por titolaj.

^ Titolo 1      ^ Titolo 2       ^ Titolo 3      ^
| Linio 1 Kolumno 1 | Linio 1 Kolumno 2 | Linio 1 Kolumno 3 |
| Linio 2 Kolumno 1  | iom da sxovo (rimarku la duopan vertikalan strekon) ||
| Linio 3 Kolumno 1 | Linio 3 Kolumno 2 | Linio 3 Kolumno 3 |

Por horizontale interligi cxelojn, simple malplenigu sekvantan cxelon, kiel supre montrite. Certigxu, ke cxiam estu sama kvanto da apartigiloj!

Ankaux eblas vertikalaj tabeltitoloj.

Titolo 1 Titolo 2
Titolo 3 Linio 1 Kolumno 2 Linio 1 Kolumno 3
Titolo 4 cxi tiel nenia sxovo
Titolo 5 Linio 2 Kolumno 2 Linio 2 Kolumno 3

Kiel observeble, estas apartigilo gxuste antaux cxelo, kiu regas la formaton:

|              ^ Titolo 1            ^ Titolo 2          ^
^ Titolo 3    | Linio 1 Kolumno 2          | Linio 1 Kolumno 3        |
^ Titolo 4    | cxi tiel nenia sxovo |                    |
^ Titolo 5    | Linio 2 Kolumno 2          | Linio 2 Kolumno 3        |

rim.: vertikalaj sxovoj ne eblas.

Oni ankaux povas lauxliniigi la enhavojn de tabeloj. Nur aldonu almenaux du blankajn spacojn en la kontrauxa ekstremo de la teksto: du spacoj maldekstre lauxliniigas dekstre, du spacoj dekstre lauxliniigas maldekstre kaj du spacoj ambauxflanke centrigas la tekston.

Tabelo kun lauxliniigo
dekstre centre maldekstre
maldekstre dekstre centre
xxxxxxxxxxxx xxxxxxxxxxxx xxxxxxxxxxxx

Observu la vikitekston:

^  Tabelo kun lauxliniigo  ^^^
|  dekstre|  centre  |maldekstre  |
|maldekstre  |  dekstre|  centre  |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

Ne-analizitaj blokoj

Oni povas inkluzivi ne-analizitajn blokojn en dokumentoj per:

  1. Du blankaj spacoj en la komenco de linio;
  2. Etikedo “code”;
  3. Etikedo “file”.
En formatita kodo, cxiuj spacoj
estas tenataj: kiel              <-tio cxi
Tio cxi estas preskaux la samo, sed vi povas uzi gxin
por montri, ke vi citas dosieron.

Se oni deziras, ke la vikia analizilo preterlasu tutan areon (t.e., ne formatinte gxin), oni cxirkauxu tiun areon per etikedoj “nowiki” aux, ecx pli simple, per duopaj percentajxoj: “%%”.

Tio cxi estas teksto, kiu enhavas retadreson: http://www.splitbrain.org kaj **markitajxon**, sed nenio rezultas el tio.

Observu la vikitekston de tiu cxi pagxero por scii kiel oni difinas tiujn blokojn.

Kolorigo de Sintakso

Dokuwiki povas kolorigi fontkodojn, faciligante legi ilin. Gxi uzas la programon GeSHi (Gxenerala Sintaks-Kolorigilo) – tiel, ke iu ajn lingvajxo eltenata de GeSHi ankaux tie cxi estas rekonata. La markajxo por uzi tiun rimedon estas la sama ol en la kodbloko, de la antauxa sekcio, sed tie cxi la nomo de la lingvajxo estas inkluzivita en la etikedo. Ekz.: <code C>.

C:

int
main (int argc, char *argv[])
{
#ifdef ENABLE_NLS
        bindtextdomain (GETTEXT_PACKAGE, PACKAGE_LOCALE_DIR);
        bind_textdomain_codeset (GETTEXT_PACKAGE, "UTF-8");
        textdomain (GETTEXT_PACKAGE);
#endif
}

mysql:

mysql_dosierujo/bin/mysql -u root -p
help;
show databases;
use datumbazon;
show tables;
delete from users where nickname = 'malbonulo';
SET PASSWORD FOR 'mi'@'hostname' = PASSWORD ('pasvorto');

La jenaj komputilaj lingvajxoj estas aktuale rekonataj:

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, reg, robots, ruby, sas, scheme, sdlbasic, smalltalk, smarty, sql, tcl, text, thinbasic, tsql, vbnet, vb, vhdl, visualfoxpro, winbatch, xml

Enigante HTML-on kaj PHP-on

Oni povas enigi krudan HTML-an aux PHP-an kodon en dokumentoj per uzo de etikedoj “html” aux “php”, kiel jene:

<html>
Tio estas iom da <font color="red" size="+1">HTML-ajxo</font>
</html>

<html> Tio estas iom da <font color=“red” size=“+1”>HTML-ajxo</font> </html>

<php>
echo 'Bildo naskita de PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo!" />';
</php>

<php> echo 'Bildo naskita de PHP:'; echo '<img src=“' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '” alt=“PHP Logo!” />'; </php>

Rimarku: enigi HTML-on kaj PHP-on estas malebligata de la apriora (defauxlta) agordo. Se ili tenadus tiel, la kodo estus nur montritaj anstataux aplikitaj.

Kromajxoj por Sintakso

La sintakso en DokuWiki povas esti ampleksigita de Kromajxoj. Kiel oni devas uzi la instalitajn kromajxojn, tio estas priskribite en ties propraj retpagxoj. En tiu cxi specifa instalo de Dokuwiki, jen la disponigataj kromajxoj:

1)
Ĉi tio estas piednoto
eo/wiki/syntax.txt · Lastaj ŝanĝoj: 2017-09-02 14:24 de 212.76.31.147

Krom kie rekte indikite, enhavo de tiu ĉi vikio estas publikigita laŭ la jena permesilo: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki