Składnia

DokuWiki udostępnia prosty język znaczników (ang. markup language), którego celem jest maksymalne ułatwienie pisania tekstów z użyciem bogatego formatowania, ale bez niepotrzebnej komplikacji składni, żeby nie zniechęcać niewtajemniczonych. Ta strona zawiera wszystkie możliwe elementy składni języka, które możesz używać w DokuWiki. Wystarczy popatrzeć na kod źródłowy tej strony poprzez użycie przycisku Edytuj stronę na górze lub dole ekranu. Jeśli chcesz popróbować swoich sił bez ryzyka zepsucia strony, użyj piaskownicy. Podstawowe znaczniki są także łatwo dostępne poprzez szybkie przyciski (quickbuttons).

Pogrubienie: **tekst**

Pochylenie: //tekst//

Podkreślenie: __tekst__

Monospace: ''tekst''

_{Indeks dolny}: _tekst

^{Indeks górny}: ^tekst

Przekreślenie: <del>tekst</del>

Do wymuszania nowych linii służą dwa ukośniki poprzedzone spacją ()

DokuWiki obsługuje kilka możliwości tworzenia linków.

Linki zewnętrzne są tworzone automatycznie, trzeba jednak pamiętać o “http://” (np. http://google.pl).

Linki wewnętrzne tworzone są za pomocą podwójnych nawiasów kwadratowych ([[wiki:syntax]] lub z nazwą: [[wiki:syntax|Składnia]]).

You can use namespaces by using a colon in the pagename.

You can use [[wiki:namespaces]] by using a colon in the pagename.

For details about namespaces see wiki:namespaces.

Linking to a specific section is possible, too. Just add the sectionname behind a hash character as known from HTML. This links to this Section.

This links to [[syntax#internal|this Section]].

Uwagi:

• Links to existing pages are shown in a different style from nonexisting ones.
• DokuWiki does not use CamelCase to automatically create links by default, but this behaviour can be enabled in the config file. Hint: If DokuWiki is a link, then it’s enabled.
• When a section’s heading is changed, it’s bookmark changes, too. So don’t rely on section linking too much.

DokuWiki obsługuje linki Interwiki. Są to szybkie linki do innych Wiki. Na przykład to jest link do artykułu o Wiki zamieszczonego na Wikipedii: Wiki.

DokuWiki obsługuje linki [[doku>wiki:interwiki|Interwiki]]. Są to szybkie linki do innych Wiki.
Na przykład to jest link do artykułu o Wiki zamieszczonego na Wikipedii: [[wp>Wiki]].

Windows shares like this are recognized, too. Please note that these only make sense in a homogenous user group like a corporate Intranet.

Windows Shares like [[servershare|this]] are recognized, too.

Notes:

• For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the “local zone”).
• For Mozilla and Firefox it can be enabled through the config option security.checkloaduri but this is not recommended
• See 151 for more info

Możesz też użyć obrazka jako link zewnętrzny lub wewnętrzny poprzez łączenie składni linków i obrazków (zobacz poniżej) w taki sposób:

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

Uwaga: Formatowanie obrazków jest jedyną składnią akceptowaną w nazwach linków.

Cała składnia obrazków i linków jest wspierana (włączając zmianę wielkości obrazków, wewnętrzne i zewnętrzne obrazki i adresy URL oraz linki interwiki (interwiki links).)

Możesz dodać przypisy, używając podwójnych nawiasów 1) - ((Przypis!)).

Możesz użyć do pięciu poziomów nagłówków, by nadać strukturę dokumentowi. Gdy użyjesz więcej niż trzech nagłówków, zostanie automatycznie wygenerowany spis treści. Można to wyłączyć poprzez wstawianie do dokumentu ciągu znaków: ~~NOTOC~~.

==== Nagłówek Poziom 3 ====
=== Nagłówek Poziom 4 ===
== Nagłówek Poziom 5 ==

Używając czterech lub więcej myślników, uzyskuje się poziomą linię:

Możesz wstawiać zewnętrzne i wewnętrzne obrazki używając klamerek. Dodatkowo możesz ustalać ich rozmiary.

Rozmiar oryginalny:

Zmiana rozmiarów do zadanej szerokości:

Zmiana szerokości i wysokości:

Zmiana rozmiarów obrazka zewnętrznego:

Rozmiar oryginalny:                     {{wiki:dokuwiki-128.png}}
Zmiana rozmiarów do zadanej szerokości: {{wiki:dokuwiki-128.png?50}}
Zmiana szerokości i wysokości:          {{wiki:dokuwiki-128.png?200x50}}
Zmiana rozmiarów obrazka zewnętrznego:  {{http://de3.php.net/images/php.gif?200x50}}

Używając białych spacji z lewej bądź prawej strony możesz wybrać pozycję obrazka:

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

oczywiście, możesz też dodać tytuł (wyświetlany przez większość przeglądarek jako podpowiedź (tooltip)).

{{ wiki:dokuwiki-128.png |To jest podpis}}

Gdy podanasz nazwę pliku (zewnętrznego bądź wewnętrznego) nie będącego obrazkiem (gif,jpeg,png), wtedy będzie ona wyświetlona jako odnośnik.

Zobacz też, jak tworzyć linki obrazkowe.

Dokuwiki obsługuje uporządkowane (numerowane) i nieuporządkowane (wypunktowane) listy. Pojedynczy element listy uzyskasz poprzez stworzenie wcięcia w postaci dwóch spacji oraz użycia * dla listy wypunktowanej albo - dla numerowanej.

• Oto lista
• Drugi element
  • Dostępne są różne poziomy
• Inny element

1. Taka sama lista, tylko numerowana
2. Inny element
   1. Użyj głębszych wcięć dla innych poziomów
3. To jest to (That’s it)

  * Oto lista
  * Drugi element
    * Dostępne są różne poziomy
  * Inny element

  - Taka sama lista, tylko numerowana
  - Inny element
    - Użyj głębszych wcięć dla innych poziomów
  - To jest to (That's it)

DokuWiki konwertuje powszechnie używane emotikony do ich graficznych odpowiedników. Więcej emotikonów można dodać do katalogu smiley o konfigurować w pliku conf/smileys.conf. Poniżej przegląd emotikonów dołączonych do DokuWiki.

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

DokuWiki potrafi zamieniać znaki tekstowe na odpowiadające im encje (?). Przykład:

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

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

Uwaga: ta funkcja może zostać wyłączona poprzez plik konfiguracyjny.

Czasem możesz chcieć zaznaczyć w jakimś tekście, że jest on odpowiedzią bądź komentarzem. Możesz użyć do tego następującej składni:

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

> Nie, nie powinniśmy

>> Moim zdaniem powinniśmy

> Naprawdę?

>> Tak!

>>> W takim razie zróbmy to!

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

Nie, nie powinniśmy

Moim zdaniem powinniśmy

Naprawdę?

Tak!

W takim razie zróbmy to!

DokuWiki obsługuje prostą składnię tworzenia tabeli.

Normalne wiersze tabeli muszą zaczynać i kończyć się znakiem |, zaś nagłówki znakiem ^.

^ Rubryka 1             ^ Rubryka 2              ^ Rubryka 3                 ^
| Wiersz 1 Kolumna 1    | Wiersz 1 Kolumna 2     | Wiersz 1 Kolumna 3        |
| Wiersz 2 Kolumna 1    | łączenie kolumn (zauważ podwójny znak separacji)   ||
| Wiersz 3 Kolumna 1    | Wiersz 2 Kolumna 2     | Wiersz 2 Kolumna 3        |

By połączyć komórki poziomo, po prostu pozostaw kolejną komórkę pustą (jak wyżej). Upewnij się, że każdy wiersz ma tyle samo separatorów komórek!

Rubryki w pionie są również możliwe.

Jak widać, to separator komórek stojący przed komórką decyduje o jej formatowaniu:

|              ^ Rubryka 1                   ^ Rubryka 2                 ^
^ Rubryka 3    | Wiersz 1 Kolumna 2          | Wiersz 1 Kolumna 3        |
^ Rubryka 4    | bez łączenia tym razem      |                           |
^ Rubryka 5    | Wiersz 2 Kolumna 2          | Wiersz 2 Kolumna 3        |

Uwaga: Łączeznie pionowe (wierszy) nie jest możliwe.

Możesz również zmieniać położenie (align) zawartości tabeli. Po prostu dodaj conajmniej dwie białe spacje na przeciwnym końcu tekstu: Dodaj dwie spacje po lewej, by umieścić tekst z prawej, daj dwie spacje z prawej prawej, by przesunąć tekst w lewo oraz dwie spacje po obu stronach, by wypośrodkować tekst.

Oto źródło powyższej tabelki:

^        Tabela z ustawieniem tekstu        ^^^
|         prawo|    środek    |lewo          |
|lewo          |         prawo|    środek    |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

You can include non parsed blocks into your documents by either indenting them by at least two spaces (like used for the previous examples) or by using the tags code or file.

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.  

To let the parser ignore an area completely (ie. do no formatting on it), enclose the area either with nowiki tags or even simpler, with double percent signs %%.

This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it.

See the source of this page to see how to use these blocks.

DokuWiki może podświetlać kod źródłowy, przez co staje się on łatwiejszy w czytaniu. Używany jest tu GeSHi Generic Syntax Highlighter – więc każdy język obsługiwany przez GeSHi jest podświetlany. Składnia jest taka sama, jak w bloku kodu poprzedniej sekcji, jednak tym razem nazwa użytego języka umieszczona jest w znaczniku. Na przykład <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.
    }
}

Obecnie rozpoznawane następujące języki: actionscript, actionscript-french, ada, apache, applescript, asm, asp, bash, caddcl, cadlisp, c, c_mac, cpp, csharp, css, delphi, diff, d, div, dos, eiffel, freebasic, gml, html4strict, ini, inno, java, javascript, lisp, lua, matlab, mpasm, nsis, objc, ocaml, ocaml-brief, oobas, oracle8, pascal, perl, php-brief, php, python, qbasic, scheme, sdlbasic, smarty, sql, ruby, vb, vbnet, vhdl, visualfoxpro, xml

You can embed raw HTML or PHP code into your documents by using the html or php tags like this:

<html>
This is some <font color="red" size="+1">HTML</font>
</html>

This is some <font color="red" size="+1">HTML</font>

<php>
echo 'A logo generated by PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
</php>

echo 'A logo generated by PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';

Please Note: HTML and PHP embedding is disabled by default in the configuration. If disabled, the code is displayed instead of executed.

Składnia DokuWiki może być poszerzona przez wtyczki. Używanie zainstalowanych wtyczki opisane jest na odpowiednich stronach instruktażowych. Następujące wtyczki składni są dostępne w tej wersji instalacyjnej DokuWiki:

• Info Plugin 2005-08-03 przez Andreas Gohr
  Displays information about various DokuWiki internals
• Variable Plugin 2006-01-12 przez Esther Brunner
  insert dynamic variables