Tabla de Contenidos

Składnia formatowania

DokuWiki obsługuje prosty język znaczników, który ma na celu zapewnienie jak największej czytelności plików danych. Ta strona zawiera wszystkie możliwe składnie, z których można korzystać podczas edycji stron. Wystarczy zajrzeć do kodu źródłowego tej strony, klikając „Edytuj tę stronę”. Jeśli chcesz coś wypróbować, po prostu skorzystaj z strony testowej. Do prostszych elementów znaczników można łatwo uzyskać dostęp za pomocą przycisków szybkiego dostępu.

Podstawowe formatowanie tekstu

DokuWiki obsługuje pogrubienie, kursywę, podkreślenie oraz teksty o stałej szerokości . Oczywiście można połączyć wszystkie te opcje. 

DokuWiki obsługuje **pogrubienie**, //kursywę//, __podkreślenie__ oraz ''teksty o stałej szerokości'' .
Oczywiście można **__//''połączyć''//__** wszystkie te opcje.

Należy pamiętać, że znaczniki formatowania muszą bezpośrednio otaczać tekst, więc ** pogrubienie ** z odstępami wewnątrz znaczników nie zostanie sformatowany.

Można używać indeks dolny oraz indeks górny. 

Można również używać <sub>indeks dolny</sub> i <sup>indeks górny</sup>.

Można również oznaczyć coś jako usunięte . 

Można również oznaczyć coś jako <del>usunięte</del> .

Akapity tworzone są z pustych wierszy. Jeśli chcesz wymusić znak nowej linii bez tworzenia akapitu, możesz użyć dwóch znaków odwrotnego ukośnika, po których następuje spacja lub koniec linii.

To jest tekst z kilkoma znakami końca linii
Należy pamiętać, że dwa ukośniki odwrotne są rozpoznawane wyłącznie na końcu wiersza
lub po nich następuje
spacji \\bez nich dzieje się tak. 

Oto tekst z kilkoma znakami końca linii\\ Należy pamiętać, że
dwa ukośniki odwrotne są rozpoznawane wyłącznie na końcu wiersza\\
lub po nich następuje\\ spacji \\to dzieje się bez nich.

Z wymuszonych znaków końca linii należy korzystać tylko wtedy, gdy jest to naprawdę konieczne.

Linki

DokuWiki obsługuje wiele sposobów tworzenia linków.

Linki zewnętrzne

Linki zewnętrzne są rozpoznawane automatycznie: http://www.google.com lub po prostu www.google.com – Można również ustawić tekst linku: This Link prowadzi do strony google. Adresy e-mail, takie jak ten: andi@splitbrain.org są również rozpoznawane. 

DokuWiki obsługuje wiele sposobów tworzenia linków. Linki zewnętrzne są rozpoznawane
automatycznie: http://www.google.com lub po prostu www.google.com – Można również ustawić
tekst linku: [[http://www.google.com|This Link prowadzi do strony google]]. Adresy
e-mailowe, takie jak ten: <[email protected]> są również rozpoznawane.

Linki wewnętrzne

Linki wewnętrzne tworzy się za pomocą nawiasów kwadratowych. Można po prostu podać pagename lub użyć dodatkowego tekst linku. 

Linki wewnętrzne tworzy się za pomocą nawiasów kwadratowych. Można podać po prostu
adres [[de:wiki:pagename]] lub użyć dodatkowego [[de:wiki:pagename|tekst linku]].

Nazwy stron wiki są automatycznie zamieniane na małe litery; znaki specjalne są niedozwolone.

Można używać namespaces , umieszczając dwukropek w nazwie strony. 

Można używać adresu [[some:namespaces]] , umieszczając dwukropek w nazwie strony.

Szczegółowe informacje na temat przestrzeni nazw można znaleźć pod adresem namespaces .

Możliwe jest również tworzenie odnośników do konkretnej sekcji. Wystarczy dodać nazwę sekcji za znakiem krzyżyka, tak jak w HTML. Spowoduje to utworzenie odnośnika do tę sekcję. 

To prowadzi do [[de:wiki:syntax#internal|tę sekcję]].

Uwagi:

Interwiki

DokuWiki obsługuje linki typu Interwiki . Są to szybkie linki do innych wiki. Na przykład poniżej znajduje się link do strony Wikipedii poświęconej wiki: Wiki . 

DokuWiki obsługuje linki typu [[doku>Interwiki]] . Są to szybkie linki do innych wiki.
Na przykład poniżej znajduje się link do strony Wikipedii poświęconej wiki: [[wp>Wiki]] .

Udostępnienia w systemie Windows

Rozpoznawane są również udostępnienia w systemie Windows, takie jak ten są również rozpoznawane. Należy pamiętać, że mają one sens tylko w przypadku jednorodnej grupy użytkowników, takiej jak sieć korporacyjna Intranet . 

Udostępnione zasoby systemu Windows, takie jak [[\\server\share|ten]] są również rozpoznawane.

Uwagi:

Linki graficzne

Można również użyć obrazka do utworzenia linku do innej strony wewnętrznej lub zewnętrznej, łącząc składnię linków z obrazów (patrz poniżej) w następujący sposób: 

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

Uwaga: W nazwach linków akceptowana jest wyłącznie składnia formatowania obrazów.

Cały images_and_other_files obrazu oraz links linków jest obsługiwana (w tym zmiana rozmiaru obrazu, obrazy wewnętrzne i zewnętrzne, adresy URL oraz linki międzywiki).

Przypisy

Przypisy 1) można dodawać, używając podwójnych nawiasów. 

Przypisy ((To jest przypis)) można dodawać, używając podwójnych nawiasów.

Podział na sekcje

Do strukturyzowania treści można używać maksymalnie pięciu różnych poziomów nagłówków. Jeśli nagłówków jest więcej niż trzy, automatycznie generowany jest spis treści — można to wyłączyć, dodając ciąg znaków ~~NOTOC~~ w dokumencie.

Nagłówek poziomu 3

Nagłówek poziomu 4

Nagłówek poziomu 5

Nagłówek poziomu 3

Nagłówek poziomu 4

Nagłówek poziomu 5

Używając czterech lub więcej myślników, można utworzyć poziomą linię:

Pliki multimedialne

Można dołączać zewnętrzne i wewnętrzne obrazów, filmów i plików audio za pomocą nawiasów klamrowych. Opcjonalnie można określić ich rozmiar.

Rozmiar rzeczywisty:

Zmiana rozmiaru do podanej szerokości:

Zmiana rozmiaru do podanej szerokości i wysokości (gdy proporcje podanej szerokości i wysokości nie odpowiadają proporcjom obrazu, zostanie on przycięty do nowych proporcji przed zmianą rozmiaru):

Obraz zewnętrzny po zmianie rozmiaru:           

Rzeczywisty rozmiar:                       {{wiki:dokuwiki-128.png }} 
Zmiana rozmiaru do podanej szerokości:           {{wiki:dokuwiki-128.png?50 }} 
Zmiana rozmiaru do podanej szerokości i wysokości: {{wiki:dokuwiki-128.png?200x50}} 
Obraz zewnętrzny po zmianie rozmiaru:           {{https://www.php.net/images/php.gif?200x50}}

Używając spacji po lewej lub prawej stronie, możesz wybrać wyrównanie.

Możesz również jawnie ustawić wyrównanie za pomocą ?left, ?right lub ?center . Ma to pierwszeństwo przed powyższym wyrównaniem do spacji i można je połączyć z rozmiarem. Oczywiście można również dodać tytuł (wyświetlany jako podpowiedź przez większość przeglądarek).

Oto podpis 

{{ wiki:dokuwiki-128.png |Oto podpis}}

Aby umieścić link do obrazu prowadzący na inną stronę, zobacz Image Links powyżej.

Obsługiwane formaty multimedialne

DokuWiki może bezpośrednio osadzać następujące formaty multimedialne.

Obraz gif, jpg, png
Wideo webm, ogv, mp4
Dźwięk ogg, mp3, wav
Flash swf

Jeśli podasz nazwę pliku, która nie jest obsługiwanym formatem multimedialnym, zostanie ona wyświetlona jako link.

Dodając ?linkonly podajesz link do pliku multimedialnego bez wyświetlania go bezpośrednio w treści

dokuwiki-128.png

dokuwiki-128.png To jest po prostu link do obrazu.

Formaty rezerwowe

Niestety nie wszystkie przeglądarki obsługują wszystkie formaty wideo i audio. Aby złagodzić ten problem, możesz przesłać plik w różnych formatach, aby zapewnić maksymalną kompatybilność z przeglądarkami.

Weźmy na przykład ten osadzony film w formacie mp4: 

{{de:wiki:video.mp4|Zabawny filmik}}

Po przesłaniu video.webm oraz video.ogv obok pliku, do którego odwołuje się video.mp4, DokuWiki automatycznie doda je jako alternatywy, tak aby przeglądarka mogła odczytać jeden z tych trzech plików.

Ponadto DokuWiki obsługuje obraz „plakatu”, który będzie wyświetlany przed rozpoczęciem odtwarzania filmu. Obraz ten musi mieć taką samą nazwę pliku jak film i być plikiem w formacie jpg lub png. W powyższym przykładzie plik video.jpg .

Listy

Dokuwiki obsługuje listy uporządkowane i nieuporządkowane. Aby utworzyć pozycję na liście, należy wciąć tekst o dwie spacje i użyć znacznika * w przypadku list nieuporządkowanych lub - w przypadku list uporządkowanych.

  1. Ta sama lista, ale uporządkowana
  2. Kolejna pozycja
    1. Aby uzyskać głębsze poziomy, wystarczy użyć wcięcia
  3. To wszystko
  * This is a list
  * The second item
    * You may have different levels
  * Another item

  - The same list but ordered
  - Another item
    - Just use indention for deeper levels
  - That's it

Zajrzyj również do FAQ dotyczące pozycji listy.

Konwersje tekstu

DokuWiki może konwertować określone, z góry zdefiniowane znaki lub ciągi znaków na obrazy, inny tekst lub kod HTML.

Konwersja tekstu na obraz służy głównie do wyświetlania emotikonów. Konwersja tekstu na kod HTML jest wykorzystywana do zastępowania elementów typograficznych, ale można ją skonfigurować tak, aby używała również innego kodu HTML.

Konwersje tekstu na obrazy

DokuWiki konwertuje powszechnie używane emoticon na ich graficzne odpowiedniki. Te Smileys i inne obrazy można konfigurować i rozszerzać. Oto przegląd emotikonów zawartych w DokuWiki:

Konwersja tekstu na HTML

Typografia: dokuwiki umożliwia konwersję prostych znaków tekstowych na ich typograficznie poprawne odpowiedniki. Oto przykład rozpoznanych znaków.

→ ← ↔⇒ ⇐ ⇔ » « – — 640×480 © ™ ® “He thought 'It's a man's world'…” 

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

To samo można zrobić, aby wygenerować dowolny kod HTML – wystarczy dodać go do plik wzorca.

Istnieją trzy wyjątki, które nie pochodzą z tego pliku wzorca: znak mnożenia (640×480), „pojedyncze” i „podwójne cudzysłowy”. Można je wyłączyć za pomocą opcji opcję konfiguracyjną.

Cytowanie

Czasami chcesz zaznaczyć fragment tekstu, aby pokazać, że jest to odpowiedź lub komentarz. Możesz użyć następującej składni: 

I think we should do it

> No we shouldn't

>> Well, I say we should

> Really?

>> Yes!

>>> Then lets do it!

Myślę, że powinniśmy to zrobić

Nie, nie powinniśmy
Cóż, ja uważam, że powinniśmy
Naprawdę?
Tak!
W takim razie zróbmy to!

Tabele

DokuWiki obsługuje prostą składnię do tworzenia tabel.

Nagłówek 1 Nagłówek 2 Nagłówek 3
Wiersz 1 Kolumna 1 Wiersz 1 Kolumna 2 Wiersz 1 Kolumna 3
Wiersz 2, kolumna 1 some colspan (zwróć uwagę na podwójną rurkę) Wiersz 3 Kolumna 1 Wiersz 3 Kolumna 2 Wiersz 3 Kolumna 3

Wiersze tabeli muszą zaczynać się i kończyć znakiem | w przypadku wierszy zwykłych lub znakiem ^ w przypadku nagłówków. 

^ Nagłówek 1      ^ Nagłówek 2       ^ Nagłówek 3          ^
| Wiersz 1 Kolumna 1    | Wiersz 1 Kolumna 2     | Wiersz 1, kolumna 3        |
| Wiersz 2 Kolumna 1    | jakieś colspan (zwróć uwagę na podwójną rurkę) || 
| Wiersz 3 Kolumna 1    | Wiersz 3 Kolumna 2     | Wiersz 3, kolumna 3        |

Aby połączyć komórki w poziomie, wystarczy, że następna komórka będzie całkowicie pusta, jak pokazano powyżej. Należy pamiętać, aby zawsze stosować taką samą liczbę separatorów komórek!

Możliwe jest również stosowanie pionowych nagłówków tabeli.

Nagłówek 1 Nagłówek 2
Nagłówek 3 Wiersz 1 Kolumna 2 Wiersz 1 Kolumna 3
Nagłówek 4 tym razem bez colspan
Nagłówek 5 Wiersz 2, kolumna 2 Wiersz 2, kolumna 3

Jak widać, to właśnie separator komórki przed daną komórką decyduje o jej formatowaniu: 

|              ^ Nagłówek 1            ^ Nagłówek 2          ^
^ Nagłówek 3    | Wiersz 1 Kolumna 2          | Wiersz 1, kolumna 3        |
^ Nagłówek 4    | tym razem bez colspan |                    |
^ Nagłówek 5    | Wiersz 2, kolumna 2          | Wiersz 2, kolumna 3        |

Można utworzyć połączone komórki w pionie (rowspans), dodając ::: w komórkach znajdujących się poniżej tej, z którą mają się łączyć.

Nagłówek 1 Nagłówek 2 Nagłówek 3
Wiersz 1 Kolumna 1 ta komórka rozciąga się w pionie Wiersz 1 Kolumna 3
Wiersz 2 Kolumna 1 Wiersz 2, kolumna 3
Wiersz 3, kolumna 1 Wiersz 2, kolumna 3

Poza składnią rowspan komórki te nie powinny zawierać żadnych innych elementów. 

^ Nagłówek 1      ^ Nagłówek 2                  ^ Nagłówek 3          ^
| Wiersz 1 Kolumna 1    | ta komórka rozciąga się w pionie | Wiersz 1 Kolumna 3        |
| Wiersz 2, kolumna 1    | :::                        | Wiersz 2, kolumna 3        |
| Wiersz 3 Kolumna 1    | :::                        | Wiersz 2, kolumna 3        |

Można również wyrównać zawartość tabeli. Wystarczy dodać co najmniej dwie spacje na przeciwległym końcu tekstu: dwie spacje po lewej stronie, aby wyrównać tekst do prawej, dwie spacje po prawej stronie, aby wyrównać tekst do lewej, oraz co najmniej dwie spacje na obu końcach, aby wyśrodkować tekst.

Tabela z wyrównaniem
na prawo wyśrodkowany lewa
lewa right center
xxxxxxxxxxxx xxxxxxxxxxxx xxxxxxxxxxxx

Tak to wygląda w kodzie źródłowym: 

^           Tabela z wyrównaniem           ^^^
|         po prawej|    wyśrodkowane    |lewa          |
|left          |         prawy|    środek    |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

Uwaga: Wyrównanie pionowe nie jest obsługiwane.

Brak formatowania

Jeśli chcesz wyświetlić tekst dokładnie tak, jak został wpisany (bez żadnego formatowania), otocz ten fragment tagami <nowiki> lub, co jest jeszcze prostsze, podwójnymi znakami procentu %%.

Oto fragment tekstu zawierający adresy w następującej postaci: http://www.splitbrain.org oraz **formatowanie**, ale nic się z tym nie dzieje. To samo dotyczy //__ten__ tekst// z emotikonem ;-). 

<nowiki>
Oto fragment tekstu zawierający adresy w następującej postaci: http://www.splitbrain.org oraz **formatowanie**, ale nic się z tym nie dzieje.
</nowiki>
To samo dotyczy %%//__ten__ tekst// z emotikonem ;-)%%.

Bloki kodu

Bloki kodu można umieścić w dokumentach, wcinając je o co najmniej dwie spacje (tak jak w poprzednich przykładach) lub używając tagów <code> or <file>. 

This is text is indented by two spaces.
This is preformatted code all spaces are preserved: like              <-this
This is pretty much the same, but you could use it to show that you quoted a file.

Bloki te zostały utworzone na podstawie tego źródła: 

  Ten tekst jest wcięty o dwie spacje.
<code>
This is preformatted code all spaces are preserved: like              <-this
</code>
<file>
This is pretty much the same, but you could use it to show that you quoted a file.
</file>

Podświetlanie składni

dokuwiki może podświetlać kod źródłowy, co ułatwia jego czytanie. Wykorzystuje on GeSHi Generic Syntax Highlighter — dzięki czemu obsługiwany jest każdy język obsługiwany przez GeSHi. Składnia wykorzystuje ten sam kod i bloki plików opisane w poprzedniej sekcji, ale tym razem nazwa składni języka, który ma zostać podświetlony, jest umieszczona wewnątrz tagu, np. <code java> or <file 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.
    }
}

The following language strings are currently recognized: 4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 actionscript ada aimms algol68 apache applescript apt_sources arm asm asp asymptote autoconf autohotkey autoit avisynth awk bascomavr bash basic4gl batch bf biblatex bibtex blitzbasic bnf boo caddcl cadlisp ceylon cfdg cfm chaiscript chapel cil c_loadrunner clojure c_mac cmake cobol coffeescript c cpp cpp-qt cpp-winapi csharp css cuesheet c_winapi dart dcl dcpu16 dcs delphi diff div dos dot d ecmascript eiffel email epc e erlang euphoria ezt f1 falcon fo fortran freebasic freeswitch fsharp gambas gdb genero genie gettext glsl gml gnuplot go groovy gwbasic haskell haxe hicest hq9plus html html4strict html5 icon idl ini inno intercal io ispfpanel java5 java javascript jcl j jquery julia kixtart klonec klonecpp kotlin latex lb ldif lisp llvm locobasic logtalk lolcode lotusformulas lotusscript lscript lsl2 lua m68k magiksf make mapbasic mathematica matlab mercury metapost mirc mk-61 mmix modula2 modula3 mpasm mxml mysql nagios netrexx newlisp nginx nimrod nsis oberon2 objc objeck ocaml-brief ocaml octave oobas oorexx oracle11 oracle8 oxygene oz parasail parigp pascal pcre perl6 perl per pf phix php-brief php pic16 pike pixelbender pli plsql postgresql postscript povray powerbuilder powershell proftpd progress prolog properties providex purebasic pycon pys60 python qbasic qml q racket rails rbs rebol reg rexx robots roff rpmspec rsplus ruby rust sas sass scala scheme scilab scl sdlbasic smalltalk smarty spark sparql sql sshconfig standardml stonescript swift systemverilog tclegg tcl teraterm texgraph text thinbasic tsql twig typoscript unicon upc urbi uscript vala vbnet vb vbscript vedit verilog vhdl vim visualfoxpro visualprolog whitespace whois winbatch wolfram xbasic xml xojo xorg_conf xpp yaml z80 zxbasic

There are additional advanced options available for syntax highlighting, such as highlighting lines or adding line numbers.

Downloadable Code Blocks

When you use the <code> or <file> syntax as above, you might want to make the shown code available for download as well. You can do this by specifying a file name after language code like this: 

<file php myexample.php>
<?php echo "hello world!"; ?>
</file>
myexample.php
<?php echo "hello world!"; ?>

Jeśli nie chcesz żadnego podświetlania, ale chcesz pobrać plik, podaj myślnik (-) jako kod języka: <code - myfile.foo>.

Agregacja kanałów RSS/ATOM

dokuwiki może integrować dane z zewnętrznych kanałów XML. Do analizowania kanałów XML SimplePie wykorzystywany jest. Wszystkie formaty obsługiwane przez SimplePie mogą być również używane w DokuWiki. Na sposób renderowania można wpływać za pomocą wielu dodatkowych parametrów rozdzielonych spacjami:

Parametr Opis
dowolna liczba zostanie użyta jako maksymalna liczba elementów do wyświetlenia, domyślnie 8
odwróć wyświetlaj najpierw najnowsze pozycje w kanale
author wyświetl nazwy autorów wpisów
date pokaż daty wpisów
description pokaż opis wpisu. Wszystkie tagi HTML zostaną usunięte
nosort nie sortuj pozycji w kanale
n[dhm] okres odświeżania, gdzie d=dni, h=godziny, m=minuty. (np. 12h = 12 godzin).

Domyślny okres odświeżania wynosi 4 godziny. Każda wartość poniżej 10 minut będzie traktowana jako 10 minut. dokuwiki zazwyczaj próbuje dostarczyć wersję strony z pamięci podręcznej, co oczywiście jest nieodpowiednie, gdy strona zawiera dynamiczną treść zewnętrzną. Parametr ten nakazuje dokuwiki ponowne wyrenderowanie strony, jeśli upłynęło więcej niż okresu odświeżania od ostatniego wyświetlenia strony.

Domyślnie kanał będzie sortowany według daty, najnowsze pozycje na początku. Można go posortować tak, aby najstarsze pozycje znajdowały się na początku, używając parametru odwrotny lub wyświetlić kanał w obecnej postaci za pomocą opcji nosort.

Przykład: 

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

Makra kontrolne

Niektóre elementy składni wpływają na sposób renderowania strony przez DokuWiki, nie generując przy tym żadnych wyników. Dostępne są następujące makra kontrolne:

Makro „^ ” ^ Opis |

~~NOTOC~~ Jeśli to makro zostanie znalezione na stronie, spis treści nie zostanie utworzony
~~NOCACHE~~ DokuWiki domyślnie buforuje wszystkie wyniki. Czasami może to być niepożądane (np. gdy używana jest powyższa składnia <php>), dodanie tego makra wymusi na DokuWiki ponowne renderowanie strony przy każdym wywołaniu

Wtyczki składniowe

Składnię DokuWiki można rozszerzyć za pomocą wtyczki. Sposób korzystania z zainstalowanych wtyczek opisano na odpowiednich stronach opisowych. W tej konkretnej instalacji DokuWiki dostępne są następujące wtyczki składniowe:

1) To jest przypis