====== Składnia Formatowania ======

[[doku>DokuWiki]] obsługuje prosty język znaczników, który stara się uczynić pliki danych jak najbardziej czytelnymi. Ta strona zawiera całą możliwą składnię, którą możesz użyć podczas edycji stron. Po prostu spójrz na źródło tej strony, klikając "Edytuj tę stronę". Jeśli chcesz coś wypróbować, użyj strony [[playground:playground|plac zabaw]]. Prostsze znaczniki są łatwo dostępne przez [[doku>toolbar|szybkie przyciski]].

===== Podstawowe Formatowanie Tekstu =====

<code bash>DokuWiki obsługuje tekst **pogrubiony**, //pochylony//, __podkreślony__ i ''monospace''. Oczywiście możesz **__//''łączyć''//__** wszystkie te style.</code>

DokuWiki obsługuje tekst **pogrubiony**, //pochylony//, __podkreślony__ i ''monospace''.
Oczywiście możesz **__//''łączyć''//__** wszystkie te style.

<code bash>Możesz również użyć <sub>indeksu dolnego</sub> i <sup>indeksu górnego</sup>.</code>

Możesz również użyć <sub>indeksu dolnego</sub> i <sup>indeksu górnego</sup>.

<code bash>Możesz zaznaczyć coś jako <del>usunięte</del>.</code>

Możesz zaznaczyć coś jako <del>usunięte</del>.

**Akapity** są tworzone przez puste linie. Jeśli chcesz **wymusić nową linię** bez akapitu, możesz użyć dwóch ukośników końcowych lub końca linii.

To jest tekst z kilkoma łamanymi liniami\\ Zauważ, że dwa ukośniki końcowe są rozpoznawane tylko na końcu linii\\ lub po \\ spacji \\ to działa bez tego.

<code bash>
To jest tekst z kilkoma łamanymi liniami\\
Zauważ, że dwa ukośniki końcowe są rozpoznawane tylko na końcu linii\\
lub po \\
spacji \\
to działa bez tego.</code>

Powinieneś używać wymuszonych nowych linii tylko wtedy, gdy jest to naprawdę konieczne.

===== Linki =====

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

==== Zewnętrzne ====

Linki zewnętrzne są rozpoznawane automatycznie: http://www.google.com lub po prostu www.google.com - Możesz ustawić również tekst linku: [[http://www.google.com|Ten link prowadzi do Google]]. Adresy e-mail jak ten: <andi@splitbrain.org> również są rozpoznawane.

DokuWiki obsługuje kilka sposobów tworzenia linków. Linki zewnętrzne są rozpoznawane automatycznie: http://www.google.com lub po prostu www.google.com - Możesz ustawić tekst linku: [[http://www.google.com|Ten link prowadzi do Google]]. Adresy e-mail jak ten: <andi@splitbrain.org> również są rozpoznawane.

==== Wewnętrzne ====

Linki wewnętrzne są tworzone za pomocą kwadratowych nawiasów. Możesz po prostu podać [[pagename]] lub użyć dodatkowego [[pagename|tekst linku]].
<code bash>
Linki wewnętrzne są tworzone za pomocą kwadratowych nawiasów. Możesz po prostu podać [[pagename]] lub użyć dodatkowego [[pagename|tekst linku]].</code>

[[doku>pagename|Nazwy stron Wiki]] są automatycznie zamieniane na małe litery, znaki specjalne nie są dozwolone.

Możesz użyć [[some:namespaces]] za pomocą dwukropka w nazwie strony.

<code bash>''Możesz użyć [[some:namespaces]] za pomocą dwukropka w nazwie strony''</code>

Szczegóły na temat przestrzeni nazw znajdziesz w [[doku>namespaces]].

Możliwe jest również linkowanie do konkretnej sekcji. Po prostu dodaj nazwę sekcji po znaku hash, jak w HTML. Ten link prowadzi do [[skladnia#wewnetrzne|tej sekcji]].

Ten link prowadzi do [[syntax#internal|tej sekcji]].

<code bash>Ten link prowadzi do [[skladnia#wewnetrzne|tej sekcji]]</code>

Uwagi:

  * Linki do [[syntax|istniejących stron]] są wyświetlane w innym stylu niż [[nonexisting]].
  * DokuWiki nie używa domyślnie [[wp>CamelCase]] do automatycznego tworzenia linków, ale można to włączyć w pliku [[doku>config]]. Wskazówka: Jeśli DokuWiki jest linkiem, to jest to włączone.
  * Kiedy nagłówek sekcji jest zmieniany, zmienia się również jego zakładka. Dlatego nie polegaj zbytnio na linkowaniu do sekcji.

==== Interwiki ====

DokuWiki obsługuje linki [[doku>Interwiki]]. Są to szybkie linki do innych Wikis. Na przykład ten link prowadzi do strony Wikipedii na temat Wiki: [[wp>Wiki]].

<code bash>DokuWiki obsługuje linki [[doku>Interwiki]]. Są to szybkie linki do innych Wikis.
Na przykład ten link prowadzi do strony Wikipedii na temat Wiki: [[wp>Wiki]].</code>

==== Zasoby sieciowe Windows ====

Zasoby sieciowe Windows jak [[\\server\share|ten]] są również rozpoznawane. Należy jednak pamiętać, że mają one sens tylko w jednorodnej grupie użytkowników, jak np. korporacyjny [[wp>Intranet]].

Zasoby sieciowe Windows jak [[\\server\share|ten]] są również rozpoznawane.

Uwagi:

  * Ze względów bezpieczeństwa bezpośrednie przeglądanie zasobów sieciowych Windows działa tylko w przeglądarce Microsoft Internet Explorer (i tylko w "strefie lokalnej").
  * Dla przeglądarek Mozilla i Firefox można to włączyć za pomocą różnych obejść opisanych w [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|Mozilla Knowledge Base]]. Jednak nadal pojawi się ostrzeżenie JavaScript o próbie otwarcia zasobu sieciowego Windows. Aby usunąć to ostrzeżenie (dla wszystkich użytkowników), umieść następujący wiersz w ''conf/lang/en/lang.php'' (więcej szczegółów w [[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|lokalizacja]]): <code - conf/lang/en/lang.php>
<?php
/**
 * Dostosowanie pliku języka angielskiego
 * Skopiuj tylko ciągi, które należy zmodyfikować
 */
$lang['js']['nosmblinks'] = '';
</code>

==== Linki do obrazów ====

Możesz również użyć obrazu, aby linkować do innej wewnętrznej lub zewnętrznej strony, łącząc składnię linków i [[#images_and_other_files|obrazów]] (patrz poniżej) w ten sposób:

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

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

Należy pamiętać: Formatowanie obrazu jest jedynym formatowaniem akceptowanym w nazwach linków.

Cała składnia [[#images_and_other_files|obrazu]] i [[#links|linku]] jest obsługiwana (w tym zmiana rozmiaru obrazu, wewnętrzne i zewnętrzne obrazy oraz adresy URL oraz linki interwiki).

===== Przypisy =====

Możesz dodawać przypisy ((To jest przypis)) za pomocą podwójnych nawiasów okrągłych.

Możesz dodawać przypisy ((To jest przypis)) za pomocą podwójnych nawiasów okrągłych.

===== Sekcje =====

Możesz używać do pięciu różnych poziomów nagłówków, aby strukturyzować treść. Jeśli masz więcej niż trzy nagłówki, tabela treści jest generowana automatycznie -- można to wyłączyć, dodając ciąg ''<nowiki>~~NOTOC~~</nowiki>'' do dokumentu.

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

Kod:

<code bash>
==== Nagłówek poziomu 3 ====
=== Nagłówek poziomu 4 ===
== Nagłówek poziomu 5 ==
</code>

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

----

===== Pliki multimedialne =====

Możesz dołączyć zewnętrzne i wewnętrzne [[doku>images|obrazy, filmy i pliki audio]] za pomocą nawiasów klamrowych. Opcjonalnie możesz określić ich rozmiar.

Realny rozmiar:

  {{wiki:dokuwiki-128.png}}

Zmieniony rozmiar (200px szerokości):

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

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

Dodatkowe atrybuty mogą być używane w plikach multimedialnych:

  {{wiki:dokuwiki-128.png?200|Przykładowy podpis}}

{{wiki:dokuwiki-128.png?200|Przykładowy podpis}}

==== Galeria obrazów ====

Możesz również wyświetlić galerie obrazów na jednej stronie. Zobacz poniżej, aby uzyskać szczegóły:

  {{gallery>:katalog_ze_zdjeciami}}
  

Więcej szczegółów na temat wyświetlania obrazów znajdziesz w [[doku>images|przewodniku po obrazach]].

==== Wideo i audio ====

Wideo i audio z popularnych usług (np. YouTube) mogą być osadzone bezpośrednio:

  {{youtube>xxxxxx}}

  {{vimeo>xxxxxx}}

Więcej szczegółów znajdziesz w [[doku>audio_and_video|dokumencie audio i wideo]].

===== Listy =====

DokuWiki obsługuje wiele różnych typów list. Zwykłe listy są oznaczane gwiazdkami:

  * To jest punkt listy
  * Kolejny punkt

<code bash>  * To jest punkt listy
  * Kolejny punkt</code>

Listy uporządkowane są numerowane:

  - Punkt pierwszy
  - Punkt drugi

<code bash>
  - Punkt pierwszy
  - Punkt drugi</code>

Jest to [[doku>lists|podlista]]:

  - Punkt pierwszy
    - Punkt podrzędny A
    - Punkt podrzędny B
<code bash>
  - Punkt pierwszy
    - Punkt podrzędny A
    - Punkt podrzędny B</code>

Ponadto możliwe jest tworzenie listy definicji:

    : Opis
<code bash>
  Term
    : Opis</code>

Listy mogą być mieszane, ale nie jest to zalecane.

Listy mogą zawierać kilka różnych poziomów:

  - Punkt pierwszy
  - Punkt drugi
    * Punkt podrzędny A
    * Punkt podrzędny B
      - Punkt podrzędny a
      - Punkt podrzędny b
  - Punkt trzeci
<code bash>
  - Punkt pierwszy
  - Punkt drugi
    * Punkt podrzędny A
    * Punkt podrzędny B
      - Punkt podrzędny a
      - Punkt podrzędny b
  - Punkt trzeci</code>

Podgląd:

  * To jest punkt listy
  * Kolejny punkt

  - Punkt pierwszy
  - Punkt drugi

  - Punkt pierwszy
    - Punkt podrzędny A
    - Punkt podrzędny B


<code bash>    : Opis

  - Punkt pierwszy
  - Punkt drugi
    * Punkt podrzędny A
    * Punkt podrzędny B
      - Punkt podrzędny a
      - Punkt podrzędny b
  - Punkt trzeci</code>

===== Cytaty =====

Cytaty są wcięte z obu stron i mogą być zagnieżdżone:
<code bash>
  > To jest pierwszy poziom cytatu
  >> To jest drugi poziom cytatu</code>

Podgląd:


> To jest pierwszy poziom cytatu
>> To jest drugi poziom cytatu</code>

===== Tabele =====

Formatowanie tabel w DokuWiki jest dość proste.
<code bash>
  | To      | jest      | nagłówek |
  |---------|-----------|----------|
  | To      | jest      | wiersz   |
  | komórek | tabeli    |          |</code>

Poniżej wyświetla się tabela z przykładowymi danymi:

| To      | jest      | nagłówek |
|---------|-----------|----------|
| To      | jest      | wiersz   |
| komórek | tabeli    |          |


Przydatne jest również używanie ''htmlspecialchars'' w tagach. 

Aby uzyskać więcej informacji, zapoznaj się z [[doku>tables|dokumentacją dotyczącą tabel]].

===== Kod =====

Możesz wyświetlić kod w jednym wierszu za pomocą pary apostrofów. Przykład: ''Kod jednowierszowy''.

Kod wieloliniowy można wyświetlić tak::

<code bash>
To jest
  wieloliniowy kod
</code>
  
Przykład:
<code bash>
''
To jest
  wieloliniowy kod
''
</code>

Możesz podświetlić składnię określonych języków programowania. Aby to zrobić, użyj:

Przykład bash:
<code bash>
  echo "To jest kod bash";
</code>

Przykład php:
<code php>
  echo "To jest kod PHP";
</code>

Możliwe jest również używanie [[doku>plugin:geshi|GeSHi]] do podświetlania składni.

Lub innych możliwości np:

<file bash bash.sh>Bash</file>

<code bash><file bash bash.sh>Bash</file></code>
===== Notacje HTML =====

DokuWiki obsługuje standardowe tagi HTML. Możesz więc używać takich elementów jak <div> i <span> w swoich dokumentach.

===== Notacje XML =====

DokuWiki obsługuje podstawową składnię XML. Można na przykład włączyć proste tagi XML, takie jak:

<code bash>  <nowiki>[[wiki:dokuwiki]]</nowiki> albo [[doku>page]]</code>

Na przykład:

  <nowiki>[[wiki:dokuwiki]]</nowiki> albo [[doku>page]]

Domyślny okres odświeżania wynosi 4 godziny. Wartości poniżej 10 minut będą traktowane jako 10 minut. [[wiki:DokuWiki]] zazwyczaj próbuje dostarczyć zbuforowaną wersję strony, co jest oczywiście niewłaściwe, gdy strona zawiera dynamiczną treść zewnętrzną. Parametr określa, że [[wiki:DokuWiki]] ma ponownie wyrenderować stronę, jeśli minął czas dłuższy niż //okres odświeżania// od ostatniego renderowania strony.

Domyślnie kanał będzie sortowany według daty, od najnowszych do najstarszych elementów. Można go posortować od najstarszych do najnowszych, używając parametru ''reverse'' lub wyświetlić kanał bez zmian, używając ''nosort''.

**Przykład:**
<code bash>
  {{rss>http://slashdot.org/index.rss 5 author date 1h }}</code>

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


===== Makra sterujące =====

Niektóre składnie wpływają na sposób renderowania strony przez DokuWiki bez tworzenia jakiegokolwiek wyjścia. Dostępne są następujące makra sterujące:

^ Makro           ^ Opis |
| %%~~NOTOC~~%%   | Jeśli to makro znajduje się na stronie, nie zostanie utworzony spis treści |
| %%~~NOCACHE~~%% | DokuWiki domyślnie buforuje całe wyjście. Czasami może to być niepożądane (np. gdy używana jest składnia %%<php>%% powyżej), dodanie tego makra wymusi ponowne renderowanie strony przy każdym wywołaniu |

===== Wtyczki składniowe =====

Składnia DokuWiki może być rozszerzana za pomocą [[doku>plugins|wtyczek]]. Sposób użycia zainstalowanych wtyczek jest opisany na odpowiednich stronach z ich opisami. Dostępne są następujące wtyczki składniowe w tej konkretnej instalacji DokuWiki:

~~INFO:syntaxplugins~~