====== Składnia formatowania ======

[[doku>wiki:pl:dokuwiki|DokuWiki]] używa prostego języka znaczników, który umożliwia pozostawienie tekstu tak czytelnego, jak to możliwe. Poniższa strona zawiera całą dostępną składnię, którą można zastosować edytując treść. Zobacz po prostu na treść tej strony wciskając guzik //Edytuj stronę// na górze lub na dole strony. Jeżeli chcesz coś wypróbować, to zrób to na stronie [[playground:playground|"piaskownicy"]]. Szybkie formatowanie jest dostępne także za pomocą [[doku>wiki:quickbuttons|szybkich przycisków]].

[[wiki:wskazowki|Wskazówki na temat dobrego stylu]].

===== Proste formatowanie tekstu =====

DokuWiki umożliwia **pogrubienie**, //pochylenie//, __podkreślenie__ i ''stałą szerokość'' tekstu. Oczywiście można zastosować ich **__//''kombinację''//__**.

  DokuWiki umożliwia **pogrubienie**, //pochylenie//, __podkreślenie__ i ''stałą szerokość'' tekstu. 
  Oczywiście można zastosować ich **__//''kombinację''//__**.

Można też zastosować <sub>indeks górny</sub> lub <sup>indeks dolny</sup>.

  Można też zastosować <sub>indeks górny</sub> lub <sup>indeks dolny</sup>.

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

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

**Akapity** są tworzone przez puste linie. Jeżeli chcesz **wymusić nowy wiersz** bez akapitu, możesz wpisać dwukrotny znak odwrotnego ukośnika i spację w środku linii lub dwukrotny znak odwrotnego ukośnika na końcu linii.

To jest fragment tekstu z nowymi wierszami\\ Zwróć uwagę że
dwa odwrotne ukośniki są rozpoznawane jedynie na końcu linii\\
lub gdy jest za nimi\\ spacja \\a to dzieje się gdy jej nie ma.

  To jest fragment tekstu z nowymi wierszami\\ Zwróć uwagę że
  dwa odwrotne ukośniki są rozpoznawane jedynie na końcu linii\\
  lub gdy jest za nimi\\ spacja \\a to dzieje się gdy jej nie ma.

Nie powinno się wymuszać nowego wiersza jeżeli nie jest to naprawdę potrzebne.

===== Linki =====

DokuWiki udostępnia wiele sposobów tworzenia linków.

==== Zewnętrzne ====

Linki zewnętrzne są rozpoznawane automagicznie: http://www.google.com lub po prostu www.google.com. Można też zmienić nazwę linka: [[http://www.google.com|To link który prowadzi do Google]]. Adresy e-mail są wyświetlane tak: <andi@splitbrain.org>.

  Linki zewnętrzne są rozpoznawane automagicznie: http://www.google.com lub po prostu www.google.com.
  Można też zmienić nazwę linka: [[http://www.google.com|To link który prowadzi do Google]]. 
  Adresy e-mail są wyświetlane tak: <andi@splitbrain.org>.



==== Wewnętrzne ====

Linki wewnętrzne są tworzone przez kwadratowe nawiasy. Można wpisać po prostu [[nazwa strony]] lub nadać jej dodatkowy [[nazwa strony|Tytuł]]. Nazwy stron są automatycznie zamieniane na małe litery, znaki specjalne nie są dozwolone.

  Linki wewnętrzne są tworzone przez kwadratowe nawiasy. Można wpisać po prostu 
  [[nazwa strony]] lub nadać jej dodatkowy [[nazwa strony|Tytuł]]. Nazwy stron 
  są automatycznie zamieniane na małe litery, znaki specjalne nie są dozwolone.

Można użyć [[wiki:katalogów]] wpisując dwukropek przed nazwą strony.

  Można użyć [[wiki:katalogów]] wpisując dwukropek przed nazwą strony.

Szczegóły są opisane na stronie projektu: [[wiki:namespaces]].

Można także utworzyć link do rozdziału tekstu - dopisz nazwę tytułu za nazwą strony tak, jak robi się to w HTML. Ten link prowadzi do [[syntax#wewnetrzne|tego rozdziału]].

  Ten link prowadzi do [[syntax#wewnetrzne|tego rozdziału]].

Uwagi:

  * Linki do [[wiki:syntax|istniejących stron]] są pokazane w inny sposób niż do stron [[wiki:nieistniejących]].
  * DokuWiki domyślnie nie używa [[wp>CamelCase]] by automatycznie utworzyć linki, ale to zachowanie można włączyć w [[doku>wiki:config|pliku konfiguracyjnym]]. Podpowiedź: jeżeli ToJest link, to znaczy że opcja jest włączona.
  * Gdy tytuł rozdziału jest zmieniony, to trzeba zmienić link do niego, więc nie polegaj zbytnio na takich linkach.


==== Interwiki ====

DokuWiki umożliwia tworzenie linków [[doku>wiki:interwiki|Interwiki]]. Są to szybkie linki do innych systemów Wiki. Na przykład to jest link do strony w Wikipedii na temat [[wp>Wiki]].

  DokuWiki umożliwia tworzenie linków [[doku>wiki:interwiki|Interwiki]]. Są to szybkie linki 
  do innych systemów Wiki. Na przykład to jest link do strony w Wikipedii na temat [[wp>Wiki]].


==== Udziały sieciowe Windows ====

Udziały sieciowe Windows, takie jak [[\\server\share|ten]], są także rozpoznawane. Proszę zauważyć że takie linki mają sens tylko w homogenicznych grupach użytkowników jak w korporacyjnym [[wp>Intranet|intranecie]].

  Udziały sieciowe Windows takie jak [[\\server\share|ten]] są także rozpoznawane.

Uwagi:

  * Ze względów bezpieczeństwa bezpośrednie przeglądanie udziałów sieciowych działa domyślnie tylko w Microsoft Internet Explorer (i tylko w "strefie lokalnej").
  * W Mozilli i Firefox można tę funkcję uaktywnić za pomocą opcji [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]], lecz nie jest to zalecane.
  * Zobacz więcej szczegółów w [[bug>151]].


==== Linki w grafice ====

Możesz utworzyć link wewnętrzny lub zewnętrzny w grafice wklejonej na stronie poprzez złączenie składni linku i [[#zdjęcia i inne pliki|grafiki]] (zobacz poniżej) w ten sposób:

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

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

Uwaga: Formatowanie grafiki jest jedynym elementem składni, który można użyć w linkach.

Jest tu dozwolona całość składni [[#zdjęcia i inne pliki|grafiki]] i [[#linki|linków]] (w tym skalowanie grafiki, grafika wewnętrzna i zewnętrzna oraz łącza URL i interwiki.


===== Przypisy =====

Można dodawać przypisy ((To jest przypis)) używając podwójnych nawiasów.

  Można dodawać przypisy ((To jest przypis)) używając podwójnych nawiasów.

===== Podział na sekcje (tytuły) =====

Można używać do pięciu poziomów tytułów by nadać treści strony strukturę hierarchiczną. Jeżeli w dokumencie będzie więcej niż trzy tytuły, spis treści zostanie wygenerowany automatycznie -- można to zablokować poprzez dodanie napisu ''<nowiki>~~NOTOC~~</nowiki>'' w treści dokumentu.

==== Tytuł poziomu 3 ====
=== Tytuł poziomu 4 ===
== Tytuł poziomu 5 ==

  ==== Tytuł poziomu 3 ====
  === Tytuł poziomu 4 ===
  == Tytuł poziomu 5 ==

Używając czterech lub więcej kresek (znak minus), można uzyskać poziomą linię:

----



===== Zdjęcia i inne pliki =====

Możesz wstawić wewnętrzne lub zewnętrzne [[doku>wiki:images|zdjęcie]] za pomocą nawiasów klamrowych. Opcjonalnie można ustalić jego wielkość.

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

Skalowane do podanej szerokości:  {{wiki:dokuwiki-128.png?50}}

Podana szerokość i wysokość:      {{wiki:dokuwiki-128.png?200x50}}

Przeskalowana grafika zewnętrzna: {{http://de3.php.net/images/php.gif?200x50}}

  Normalny rozmiar:                 {{wiki:dokuwiki-128.png}}
  Skalowane do podanej szerokości:  {{wiki:dokuwiki-128.png?50}}
  Podana szerokość i wysokość:      {{wiki:dokuwiki-128.png?200x50}}
  Przeskalowana grafika zewnętrzna: {{http://de3.php.net/images/php.gif?200x50}}

Dodając spacji z lewej lub prawej możesz odpowiednio wyrównać grafikę.

{{ wiki:dokuwiki-128.png}}

{{wiki:dokuwiki-128.png }}

{{ wiki:dokuwiki-128.png }}

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

Oczywiście można też dodać podpis (wyświetlany jako podpowiedź przez większość przeglądarek).

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

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

Jeżeli podasz nazwę pliku (wewnętrznego lub zewnętrznego) który nie jest zdjęciem (''gif, jpeg, png''), to w zamian pojawi się link do niego.

Składnia dla linków do [[#Linki w grafice|grafiki z innych stron]] opisana powyżej.

===== Listy =====

Dokuwiki wspiera tworzenie numerowanych i nienumerowanych list. By utworzyć punkt listy, zrób wcięcie tekstu wstawiając na początku wiersza dwie spacje i wpisz ''*'' dla podpunktu nienumerowanego lub ''-'' dla numerowanego.


  * To jest lista
  * To druga pozycja
    * Może być wiele poziomów wypunktowań
  * Jeszcze jeden podpunkt

  - Ta sama lista, lecz numerowana
  - Kolejny podpunkt
    - Po prostu użyj wcięcia tekstu, by zaznaczyć poziom
  - To jest to

<code>
  * To jest lista
  * To druga pozycja
    * Może być wiele poziomów wypunktowań
  * Jeszcze jeden podpunkt

  - Ta sama lista, lecz numerowana
  - Kolejny podpunkt
    - Po prostu użyj wcięcia tekstu, by zaznaczyć poziom
  - To jest to
</code>


===== Emotikony =====

Dokuwiki przekształca często używane [[http://pl.wikipedia.org/wiki/emotikony|emotikony]] do ich graficznego odpowiednika. Dodatkowe znaki można umieścić w katalogu ''smiley'' i skonfigurować w pliku ''conf/smileys.conf''. Poniżej przegląd emotikon zawartych w DokuWiki.

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

===== Typografia =====

[[DokuWiki]] może konwertować proste oznaczenia tekstowe na poprawne typograficznie znaki. Oto przykłady rozpoznawanych kombinacji znaków:

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

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

Uwaga: Ta konwersja może być wyłączona przez [[doku>wiki:config#typography|opcję konfiguracyjną]] lub [[doku>wiki:entities|plik wzorcowy?]].


===== Cytowanie =====

Czasami chcesz zaznaczyć część tekstu by pokazać iż jest odpowiedzią lub komentarzem. Zastosuj wtedy następującą składnię:

  Myślę, że powinniśmy tak zrobić.
  
  > Nie, nie powinniśmy  
  >> A moim zdaniem powinniśmy.
  > Naprawdę?
  >> Tak!
  >>> Więc zróbmy tak!

Myślę, że powinniśmy tak zrobić.
> Nie, nie powinniśmy
>> A moim zdaniem powinniśmy.
> Naprawdę?
>> Tak!
>>> Więc zróbmy tak!


===== Tabele =====

DokuWiki posiada 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    | złączona kolumna (zwróć uwagę na podwójną kreskę) ||
| Wiersz 3 Kolumna 1    | Wiersz 2 Kolumna 2     | Wiersz 2 Kolumna 3        |

Kolumny tabeli powinny zaczynać się od ''|'' dla normalnych komórek i od ''^'' dla 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    | złączona kolumna (zwróć uwagę na podwójną kreskę) ||
  | Wiersz 3 Kolumna 1    | Wiersz 2 Kolumna 2     | Wiersz 2 Kolumna 3        |

By połączyć komórki poziomo, pozostaw następną komórkę całkowicie pustą, jak w przykładzie powyżej. Upewnij się że zawsze masz tę samą ilość separatorów komórek w wierszu!

Można też utworzyć nagłówki wierszy w pionie.

|               ^ Nagłówek 1                  ^ Nagłówek 2                ^
^ Nagłówek 3    | Wiersz 1 Kolumna 2          | Wiersz 1 Kolumna 3        |
^ Nagłówek 4    | tym razem bez łączenia      |                           |
^ Nagłówek 5    | Wiersz 2 Kolumna 2          | Wiersz 2 Kolumna 3        |

Jak zauważyłeś, to separator komórki decyduje o formatowaniu:

  |               ^ Nagłówek 1                  ^ Nagłówek 2                ^
  ^ Nagłówek 3    | Wiersz 1 Kolumna 2          | Wiersz 1 Kolumna 3        |
  ^ Nagłówek 4    | tym razem bez łączenia      |                           |
  ^ Nagłówek 5    | Wiersz 2 Kolumna 2          | Wiersz 2 Kolumna 3        |


Uwaga: nie jest możliwe pionowe łączenie komórek.


You can align the table contents, too. Just add at least two whitespaces at the opposite end of your text: Add two spaces on the left to align right, two spaces on the right to align left and two spaces at least at both ends for centered text.

^           Tabela z wyrównaniem           ^^^
|         prawo|    środek    |lewo          |
|lewo          |         prawo|    środek    |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

Tak to wygląda w tekście źródłowym:

  ^           Tabela z wyrównaniem           ^^^
  |         prawo|    środek    |lewo          |
  |lewo          |         prawo|    środek    |
  | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |




===== Fragmenty niesformatowane =====

Możesz włączyć do tekstu fragmenty, które nie będą formatowane poprzez poprzedzenie wiersza dwiema spacjami (jak we wszystkich powyższych przykładach) lub używając znaczników ''code'' lub ''file''.

<code>
To fragment wcześniej sformatowanego kodu zawierającego spacje, które są zachowane               <-w ten sposób.
</code>

<file>
Mniej więcej to samo; można używać do cytowania fragmentów pliku.
</file>

By parser całkowicie zignorował pewien fragment (tzn. nie formatował go), ujmij ten fragment w znaczniki ''nowiki'' lub - jeszcze prościej - w podwójny znak procenta ''<nowiki>%%</nowiki>''.

<nowiki>
To jest fragment tekstu, który zawiera adres: http://www.splitbrain.org ale **formatowanie** tu nie występuje.
</nowiki>

Zobacz źródło tej strony żeby zobaczyć jak używać bloków.


===== Podświetlanie składni =====

[[DokuWiki]] może podświetlać składnię kodu źródłowego, co ułatwia jego czytanie. W tym celu używa [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- więc każdy język wspierany przez GeSHi jest rozpoznawany. Składnia jest taka sama jak w blokach kodu w poprzednim akapicie, ale tym razem w znaczniku jest wstawiona dodatkowo nazwa zastosowanego języka, np. ''<nowiki><code java></nowiki>''.

<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.
    }
}
</code>

Obecnie są rozpoznawane następujące języki: //actionscript-french, actionscript, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, caddcl, cadlisp, cfdg, cfm, c_mac, c, cpp, csharp, css, delphi, diff, div, dos, d, eiffel, fortran, freebasic, gml, groovy, html4strict, idl, ini, inno, java5, java, javascript, latex, lisp, lua, matlab, mpasm, mysql, nsis, objc, ocaml-brief, ocaml, oobas, oracle8, pascal, perl, php-brief, php, python, qbasic, reg, robots, ruby, sas, scheme, sdlbasic, smalltalk, smarty, sql, tcl, text, thinbasic, tsql, vbnet, vb, vhdl, visualfoxpro, winbatch, xml//



===== Wstawianie HTML i PHP =====

Możesz wbudować w swój dokument czysty kod HTML i PHP używając znaczników ''html'' lub ''php'' w ten sposób:

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

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

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

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

**Uwaga**: wstawianie HTML i PHP jest domyślnie wyłączone w konfiguracji. Jeżeli tak jest, kod jest wyświetlany bez interpretacji.




===== Wtyczki składni =====

Składnia DokuWiki może być rozszerzona przez [[doku>wiki:plugins|wtyczki]]. Instalacja i zasady używania poszczególnych wtyczek są opisane na ich własnych stronach. W tej instalacji DokuWiki są dostępne następujące wtyczki:

~~INFO:syntaxplugins~~

===== Tłumaczenie strony =====
Dodaj swój e-mail jeżeli utworzyłeś, przetłumaczyłeś lub zmodyfikowałeś fragment tej strony:
  * //[[wkazimierczak@conforama.pl|Wojciech Kazimierczak]] 2007/07/15 21:32//