==== Linki graficzne ====
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 pełna składnia [[#pliki mediów|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 ''~~NOTOC~~ '' 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ę:
----
===== Pliki mediów =====
Możesz wstawić wewnętrzne lub zewnętrzne [[doku>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 spacje 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 dymek 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 [[#Linki graficzne|linków graficznych]] do innych stron jest opisana powyżej.
==== Wspierane formaty mediów ====
DokuWiki pozwala na bezpośrednie osadzenie (embed) następujących formatów mediów.
| Grafika | ''gif'', ''jpg'', ''png'' |
| Wideo | ''webm'', ''ogv'', ''mp4'' |
| Audio | ''ogg'', ''mp3'', ''wav'' |
| Flash | ''swf'' |
Jeśli podasz nazwę pliku w niewspieranym formacie, to będzie on prezentowany jako link.
Gdy dodasz ''?linkonly'' będzie to zwykły link do mediów, bez wyświetlenia ich w tekście.
{{wiki:dokuwiki-128.png?linkonly}}
{{wiki:dokuwiki-128.png?linkonly}} To jest zwykły link do grafiki.
==== Formaty rezerwowe (fallback) ====
Niestety niektóre przeglądarki nie rozumieją wszystkich formatów video i audio. Aby złagodzić ten problem, możesz dostarczyć twój plik w kilku różnych formatach.
Rozważmy na przykład to osadzone wideo mp4:
{{video.mp4|Zabawne wideo}}
Gdy wgrasz ''video.webm'' i ''video.ogv'' obok podanego w tekście ''video.mp4'', DokuWiki automatycznie doda je jako alternatywne formaty, a przeglądarka zrozumie jeden z tych trzech plików.
Dodatkowo DokuWiki wspiera grafikę "plakat", która będzie pokazywana przed startem wideo. Plik graficzny musi mieć tą samą nazwę jak wideo i musi być w formacie jpg lub png. W powyższym przykładzie plik ''video.jpg'' zadziała.
===== 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
* 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
===== Konwersja tekstu =====
DokuWiki może zamieniać określone, predefiniowane znaki lub ciągi znaków na grafikę lub inny tekst lub HTML.
Zamiana na grafikę dotyczy przede wszystkim emotikonów. Zamianę na tekst lub HTML stosuje się zaś głównie do poprawek typograficznych, może być jednak równie dobrze skonfigurowana do innych efektów HTML.
==== Konwersja tekstu na grafikę ====
DokuWiki przekształca często używane [[http://pl.wikipedia.org/wiki/emotikony|emotikony]] do ich graficznego odpowiednika. Znaki [[doku>Smileys]] i inne grafiki można konfigurować i rozszerzać ich listę. Poniżej przegląd emotikonów zawartych w DokuWiki.
* 8-) %% 8-) %%
* 8-O %% 8-O %%
* :-( %% :-( %%
* :-) %% :-) %%
* =) %% =) %%
* :-/ %% :-/ %%
* :-\ %% :-\ %%
* :-? %% :-? %%
* :-D %% :-D %%
* :-P %% :-P %%
* :-O %% :-O %%
* :-X %% :-X %%
* :-| %% :-| %%
* ;-) %% ;-) %%
* ^_^ %% ^_^ %%
* :?: %% :?: %%
* :!: %% :!: %%
* LOL %% LOL %%
* FIXME %% FIXME %%
* DELETEME %% DELETEME %%
==== Konwersja tekstu na HTML ====
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'..."
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."
W taki sam sposób możemy utworzyć dowolny HTML, jeśli zostanie to zaznaczone w [[doku>entities|pliku wzorców]].
Są trzy wyjątki, które nie pochodzą z tego pliku wzorców: znak mnożenia (640x480), 'pojedyncze' i "podwójne cudzysłowy". Te wyjątki mogą być wyłączone w [[doku>config:typography|konfiguracji]].
===== 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 |
Wiersze tabeli powinny zaczynać się i kończyć znakiem ''|'' dla normalnych komórek a ''^'' 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 w każdym wierszu masz tą samą ilość separatorów komórek!
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 stojący przed komórką 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 |
Można również łączyć komórki w pionie (rowspan), poprzez umieszczenie ''%%:::%%'' w komórkach znajdujących się poniżej tej, z którą chcemy je połączyć.
^ Nagłówek 1 ^ Nagłówek 2 ^ Nagłówek 3 ^
| Wiersz 1 Kolumna 1 | ta kolumna łączy 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 mogą posiadać żadnej innej treści.
^ Nagłówek 1 ^ Nagłówek 2 ^ Nagłówek 3 ^
| Wiersz 1 Kolumna 1 | ta kolumna łączy 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 też wyrównywać zawartość tabeli. Po prostu dodaj dwie spacje po przeciwnej stronie tekstu: Dodaj dwie spacje po lewej stronie aby wyrównać do prawej, dwie spacje po prawej stronie aby wyrównać do lewej lub po dwie spacje po obu stronach aby tekst wyśrodkować.
^ 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 |
Uwaga: Wyrównanie w pionie nie jest wspierane.
===== Fragmenty niesformatowane =====
Jeśli chcesz pokazać tekst dokładnie tak, jak został napisany (niesformatowany), otocz ten obszar tagami ''%%%%'' albo nawet prościej, podwójnym znakiem procenta ''%% ''.
Ten tekst zawiera adres: http://www.splitbrain.org i **formatowanie**, lecz nic się z tym nie dzieje.
Poprawne jest również to: %%//__ten__ tekst// ma emotikon ;-)%%.
Ten tekst zawiera adres: http://www.splitbrain.org i **formatowanie**, lecz nic się z tym nie dzieje.
Poprawne jest również to: %%//__ten__ tekst// ma emotikon ;-)%%.
===== Bloki kodu =====
Bloki z kodem programu możesz załączać zaczynając każdy wiersz co najmniej dwoma spacjami (jak w poprzednich przykładach), możesz też użyc tagów ''%%%%'' albo ''%%%%''.
To jest tekst z wcięciem na 2 spacje.
To jest preformatowany kod wszystkie spacje są zachowane: jak <-te
Teraz jest całkiem tak samo, użyj tego sposobu aby pokazać, że cytujesz plik.
Powyższe bloki zostały stworzone przez takie źródło:
To jest tekst z wcięciem na 2 spacje.
To jest preformatowany kod wszystkie spacje są zachowane: jak <-te
Teraz jest całkiem tak samo, użyj tego sposobu aby pokazać, że cytujesz plik.
===== 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 poprzedniej sekcji, ale tym razem w znaczniku jest wstawiona dodatkowo nazwa zastosowanego języka, np. ''
'' lub '' ''.
/**
* 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 są rozpoznawane następujące języki: //4cs, 6502acme, 6502kickass, 6502tasm, 68000devpac, abap, actionscript-french, actionscript, actionscript3, ada, algol68, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, bascomavr, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_loadrunner, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, coffeescript, cpp, cpp-qt, csharp, css, cuesheet, d, dcs, delphi, diff, div, dos, dot, e, epc, ecmascript, eiffel, email, erlang, euphoria, f1, falcon, fo, fortran, freebasic, fsharp, gambas, genero, genie, gdb, glsl, gml, gnuplot, go, groovy, gettext, gwbasic, haskell, hicest, hq9plus, html, html5, icon, idl, ini, inno, intercal, io, j, java5, java, javascript, jquery, kixtart, klonec, klonecpp, latex, lb, lisp, llvm, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, newlisp, nsis, oberon2, objc, objeck, ocaml-brief, ocaml, oobas, oracle8, oracle11, oxygene, oz, pascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender, pli, plsql, postgresql, povray, powerbuilder, powershell, proftpd, progress, prolog, properties, providex, purebasic, pycon, python, q, qbasic, rails, rebol, reg, robots, rpmspec, rsplus, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, systemverilog, tcl, teraterm, text, thinbasic, tsql, typoscript, unicon, uscript, vala, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, winbatch, whois, xbasic, xml, xorg_conf, xpp, yaml, z80, zxbasic//
==== Bloki kodu możliwe do pobrania ====
Gdy używasz składni ''%%%%'' lub ''%%%%'' jak powyżej, możesz także udostępnić ten kod do ściągnięcia. By to się stało, podaj nazwę pliku za kodem języka, jak tu:
Jeśli nie chcesz podświetlania kodu, ale chcesz udostępnić plik do pobrania, podaj myślnik (''-'') jako kod języka: ''%%%%''.
===== Osadzanie kodu HTML i PHP =====
Możesz osadzić w swoim dokumencie surowy kod HTML i PHP używając tagów ''%%%%'' lub ''%%%%''. (Gdy użyjesz w tagu wielkich liter, kod pojawi sie na poziomie bloku.)
Przykład HTML:
This is some inline HTML
And this is some block HTML
This is some inline HTML
And this is some block HTML
Przykład PHP:
echo 'Wersja PHP: ';
echo phpversion();
echo ' (generated inline HTML)';
echo 'To samo, ale wewnątrz elementu bloku: ';
echo ''.phpversion().' ';
echo '
';
echo 'Wersja PHP: ';
echo phpversion();
echo ' (inline HTML)';
echo 'To samo, ale wewnątrz elementu bloku: ';
echo ''.phpversion().' ';
echo '
';
**Zwróć uwagę**: osadzanie HTML i PHP jest domyślnie zablokowane. Przy zablokowaniu kod jest wyświetlany, a nie wykonywany.
===== Agregacja kanałów RSS/Atom =====
[[DokuWiki]] może integrować dane z zewnętrznych kanałów XML. Do parsowania XML użyty został moduł [[http://simplepie.org/|SimplePie]]. Wszystkie formaty zrozumiałe dla SimplePie mogą być używane także w DokuWiki. Możesz wpłynąć na renderowanie przez wiele dodatkowych parametrów oddzielonych spacjami:
^ Parametr ^ Opis ^
| dowolna liczba | będzie użyta jako maksymalna liczba wyświetlanych elementów, domyślnie 8 |
| reverse | wyświetla ostatnie elementy jako pierwsze w kanale |
| author | pokazuje nazwy autorów elementów |
| date | pokazuje daty elementów |
| description| pokazuje opis elementu. Jeśli [[doku>config:htmlok|HTML]] jest wyłączony, wszystkie znaczniki zostaną usunięte |
| nosort | nie sortuj elementów w kanale |
| //n//[dhm] | okres odświeżania, gdzie d=dni, h=godziny, m=minuty. (np. 12h = 12 godzin). |
Okres odświeżania to domyślnie 4 godziny. Każda wartość poniżej 10 minut będzie traktowana jako 10 minut. [[wiki:DokuWiki]] na ogół stara się dostarczyć buforowane wersje strony, oczywiście jest to niewłaściwe, gdy strona zawiera dynamiczne treści zewnętrzne. Parametr ten nakazuje [[wiki:DokuWiki]] powtórne renderowanie strony jeśli minęło więcej czasu niż //okres odświeżania// od ostatniego renderowania strony.
Domyślnie kanał będzie sortowany po dacie, nowsze elementy jako pierwsze. Można je posortować od ostatnich używając parametru ''reverse'', lub wyświetlić kanał jak jest przez ''nosort''.
**Przykład:**
{{rss>http://slashdot.org/index.rss 5 author date 1h }}
{{rss>http://slashdot.org/index.rss 5 author date 1h }}
===== Makra sterujące =====
Są to elementy składni, które wpływają na to jak DokuWiki renderuje stronę, lecz same nie tworzą żadnej treści. Dostępne są następujące makra:
^ Makro ^ Opis |
| %%~~NOTOC~~%% | Gdy to makro zostanie znalezione na stronie, nie będzie tworzony spis treści |
| %%~~NOCACHE~~%% | DokuWiki domyślnie buforuje swoje wyjście. Gdy to nie jest pożądane (np. gdy jest używana składnia %%%% jak wyżej), dodanie tego makra zmusi DokuWiki do renderowania strony przy każdym wywołaniu |
===== Wtyczki składni =====
Składnia DokuWiki może być rozszerzona przez [[doku>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//
* //[[easynet2@interia.pl|CreaThor]] 2008/06/05 12:15//
* //AndyGrond 2016/01/18//