====== Markada Sintakso ====== [[Dokuwiki]] eltenas kelkajn simplajn markajxojn, kiuj provas igi la datendosierojn plejeble facile legeblaj. Tiu cxi pagxo enhavas cxiujn sintakserojn oni povas uzi dum redaktado de la pagxoj. Simple rigardu la fontkodon de tiu cxi pagxo preminte la butonon //Redakti pagxon// en la supro de la pagxo. Se vi emas provi ion, simple aliru la pagxon nomata [[ludejo:ludejo]]. Krome, la simplaj markajxoj estas facile uzebligitaj de la [[doku>wiki:quickbuttons|tuj-butonojn]]. ===== Baza formatado de teksto ===== DokuWiki disponigas **dikecajn**, //italecajn//, __substrekitajn__ kaj ''samspacitajn'' tekstojn. Kompreneble oni povas **__//''kombini''//__** cxiujn tiujn. DokuWiki disponigas **dikecajn**, //italecajn//, __substrekitajn__ kaj ''samspacitajn'' tekstojn. Kompreneble oni povas **__//''kombini''//__** cxiujn tiojn. Vi povas uzi suban indicon kaj supran indicon. Vi povas uzi suban indicon kaj supran indicon. Vi povas marki ion kiel forvisxita ankaux. Vi povas marki ion kiel forviŝita 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. Cxi tiu estas teksto kun linisaltoj\\ Notu ke la du deklivaj streketoj estas obeitaj nur kune kun linifino, aux spaceto \\Cxi 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. Vi devus uzi devigatajn novajn liniojn nur kiam vere bezonitaj. (La tradukanto diras "Ignoru, uzu kiam ajn vi volas!" ;-)) ===== Ligiloj ===== DokuWiki subtenas plurajn manierojn por krei ligilon. ==== Ekstera ==== Eksteraj ligiloj estas konataj auxtomate: http://www.google.com aux nur www.google.com - Vi povas enskribi nomon por la ligilo ankaux: [[http://www.google.com|Ĉi tiu ligilo almontras al google]]. Retpoŝtadresoj estas konataj ankaux: DokuWiki subtenas plurajn rimedojn por krei ligilon. Eksteraj ligiloj estas konataj 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 kiel: estas konataj ankaŭ. ==== Interna ==== Oni kreas internajn ligilojn per rektaj krampoj. Vi povas uzi aux [[doku>wiki:pagename|paĝnomo]] aux [[doku>wiki:pagename|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 [[vikio:nomspacon]] per dupunkto en la nomo. Vi povas uzi [[vikio:nomspaco]] per dupunkto en la nomo. Por detaloj vidu (angle) [[doku>wiki:namespaces]]. Vi povas krei ligilon al aparta sekcio. Aldonu la sekcian nomon malantaux kradon kiel en HTML. Cxi tiu ligas al [[dokuvikia_sintakso#interna|ĉi tiu sekcio]]. Ĉi tiu ligas al [[dokuvikia_sintakso#interna|ĉi tiu sekcio]]. Notoj: * Ligiloj al [[dokuvikia_sintakso|jamaj paĝoj]] montras sin malsamaj ol [[wiki:ne jam kreitaj]] paĝoj. * DokuWiki ne uzas [[wp>CamelCase]] por auxtomate krei ligilojn defaŭlte, sed tia ja povas esti sxaltita en la [[doku>wiki: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 [[vikio:terminaro:intervikio|intervikiajn ligilojn]]. Ili estas praktikaj (ordinare mallongaj) ligiloj al aliaj vikioj. Ekzemple: Jen ligilo al Vikipedia pagxo pri Vikioj:[[vp>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 [[dokuvikia_sintakso#bildoj kaj aliaj dosieroj]] (vidu sube) tiele: [[http://www.linux.org/|{{vikio:tux_joda.png}}]] [[http://www.linux.org/|{{vikio:tux_joda.png}}]] Notu: la bildaj arangxaj komandoj estas la nura arangxa sintakso akceptita en ligilaj nomoj. Ĉiuj [[dokuvikia sintakso#bildoj kaj aliaj dosiero|bildaj]] kaj [[dokuvikia_sintakso#ligiloj|ligilaj]] sintaksoj estas akceptitaj (inkluzive bilda regrandigo, internaj kaj eksteraj bildoj, URL-aj kaj intervikiaj ligiloj). ===== Piednotoj ===== Vi povas aldoni piednotojn per ((Ĉi tio estas piednoto)) duoblaj krampoj. Vi povas aldoni piednotojn per ((Ĉi tio estas piednoto)) duoblaj krampoj. //noto 1: Strange, nur sxvebu super la piednoto, ne klaku.// //noto 2: Tio estas misfunkcio de Joomla: gxi ne sukcesas ligi cxion korekte en la interna DokuWiki. Same okazas al la ligiloj de la enhavo de cxiu pagxo, en la supra dekstra parto...// ===== 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 uso de kvar aux pli strekoj, vi povas fari horizontalan linion: ---- Ekzemple: ---- ===== Bildoj kaj aliaj dosieroj ===== Oni povas inkluzivi eksterajn kaj internajn [[vikio:bildo]]jn ([[doku>wiki:images]] angle) per kunigaj krampoj ({{bildo}}). Opcie, oni povas difini ilian grandecon. Reala grandeco: {{vikio:tux_joda.png}} Regrandigi laux largxeco: {{vikio:tux_joda.png?50}} Regrandigi laux largxeco kaj alteco: {{vikio:tux_joda.png?200x50}} Regrandigita ekstera bildo: {{http://de3.php.net/images/php.gif?200x50}} Reala grandeco: {{vikio:tux_joda.png}} Regrandigi laux largxeco: {{vikio:tux_joda.png?50}} Regrandigi laux largxeco kaj alteco: {{vikio:tux_joda.png?200x50}} Regrandigita ekstera bildo: {{http://de3.php.net/images/php.gif?200x50}} Uzante dekstrajn aux maldekstrajn blankspacojn, oni povas difini la dispozicion. {{vikio:tux_joda.png }} {{ vikio:tux_joda.png}} {{ vikio:tux_joda.png }} {{vikio:tux_joda.png }} {{ vikio:tux_joda.png}} {{ vikio:tux_joda.png }} Kompreneble, oni povas ankaux aldoni apudskribon (montrite kiel konsileto de plejparto el la foliumiloj). {{ vikio:tux_joda.png |Tio cxi estas apudskribo}} {{ vikio:tux_joda.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 [[vp>miensimbolo|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 %% * RIPARUMIN %% RIPARUMIN %% * PARTOPRENU %% PARTOPRENU %% ===== Kromformatoj por signaĵoj ===== Dokuwiki povas konverti kumetitajn simplajn signajxojn al iliaj gxustaj unuopaj formoj. Jen ekzemplo de rekoneblaj kromformatoj: -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "Li pensis 'Estas homeca mondo'..." -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "Li pensis 'Estas homeca mondo'..." rim.: tiuj konvencioj povas esti malebligitaj per [[doku>wiki:config#typography|agord-opcio]] kaj per [[doku>wiki:entities|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 [[http://qbnz.com/highlighter/|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.: ''''. 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: Tio estas iom da HTML-ajxo Tio estas iom da HTML-ajxo echo 'Bildo naskita de PHP:'; echo 'PHP Logo!'; echo 'Bildo naskita de PHP:'; echo 'PHP Logo!'; **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 [[doku>wiki:plugins|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: ~~INFO:syntaxplugins~~ ====== Diskuto ====== ===== Bonega laboro! ===== Eble post provlegado ni povas sendi al la auxtoro de la Dokuvikio?--Denizo ---mi vere ne estas komforta pri ebligi PHPon, sed mi faris tion.--Cindy > Mi ne estus komforta ecx pli ebligo de HTML! Laux mi, nek unu nek la alia devus esti disponigataj, vikia sintakso devus suficxi. --Felipo >> Mi pensas ke la vikia sintakso limigas oni. La kromajxoj: Outliner kaj Discussion tute ne funkcias; Menu Popup ne funkcias gxuste; Pagelist kolapsas. Sed, jes, oni povas enmeti malbonan kodon. --cindy