Enhavtabelo
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.
- 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.
Regrandigi laux largxeco kaj alteco:
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).
{{ 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
- La sama listo, nun ordigite
- Alia listero
- Simple uzu krommargxenon por pli subaj niveloj
- 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-O
:-(
:-)
=)
:-/
:-\
:-?
:-D
:-P
:-O
:-X
:-|
;-)
^_^
:?:
:!:
LOL
FIXME
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:
- Du blankaj spacoj en la komenco de linio;
- Etikedo “code”;
- 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:
- Gallery Plugin 2023-12-08 de Andreas Gohr
Creates a gallery of images from a namespace or RSS/ATOM feed - Repository plugin 2024-02-09 de Andreas Gohr/Håkan Sandell
Helps organizing the plugin and template repository