====== Składnia formatowania ====== [[doku>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 [[playground:playground|strony testowej]]. Do prostszych elementów znaczników można łatwo uzyskać dostęp za pomocą [[doku>toolbar|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ć indeks dolny i indeks górny. Można również oznaczyć coś jako usunięte . Można również oznaczyć coś jako usunięte . **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: [[http://www.google.com|This Link prowadzi do strony google]]. Adresy e-mail, takie jak ten: 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: są również rozpoznawane. ==== Linki wewnętrzne ==== Linki wewnętrzne tworzy się za pomocą nawiasów kwadratowych. Można po prostu podać [[de:wiki:pagename]] lub użyć dodatkowego [[de:wiki:pagename|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]]. [[doku>pagename|Nazwy stron wiki]] są automatycznie zamieniane na małe litery; znaki specjalne są niedozwolone. Można używać [[some: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 [[doku>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 [[de:wiki:syntax#internal|tę sekcję]]. To prowadzi do [[de:wiki:syntax#internal|tę sekcję]]. Uwagi: * Linki do [[de:wiki:syntax|istniejących stron]] są wyświetlane w innym stylu niż te z [[de:wiki:nonexisting]] . * DokuWiki domyślnie nie wykorzystuje [[wp>CamelCase]] do automatycznego tworzenia linków, ale tę funkcję można włączyć w pliku [[doku>config]] . Wskazówka: Jeśli „DokuWiki” jest linkiem, oznacza to, że funkcja jest włączona. * Gdy zmienia się nagłówek sekcji, zmienia się również jej zakładka. Nie należy więc zbytnio polegać na linkach do sekcji. ==== Interwiki ==== 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]] . 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 [[\\server\share|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 [[wp>Intranet]] . Udostępnione zasoby systemu Windows, takie jak [[\\server\share|ten]] są również rozpoznawane. Uwagi: * Ze względów bezpieczeństwa bezpośrednie przeglądanie udziałów systemu Windows domyślnie działa tylko w przeglądarce Microsoft Internet Explorer (i tylko w „strefie lokalnej”). * W przeglądarkach Mozilla i Firefox można to włączyć za pomocą różnych rozwiązań opisanych w [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|Mozilla bazie wiedzy]]. Nadal jednak będzie wyświetlać się ostrzeżenie JavaScript dotyczące próby otwarcia udziału w systemie Windows. Aby usunąć to ostrzeżenie (dla wszystkich użytkowników), należy umieścić następujący wiersz w pliku ''conf/lang/en/lang.php'' (więcej szczegółów na stronie [[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|lokalizacji]]): ==== 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 [[de:wiki:syntax#images_and_other_files|obrazów]] (patrz poniżej) w następujący sposób: [[http://php.net|{{wiki:dokuwiki-128.png}}]] [[http://php.net|{{wiki:dokuwiki-128.png}}]] Uwaga: W nazwach linków akceptowana jest wyłącznie składnia formatowania obrazów. Cały [[de:wiki:syntax#images_and_other_files|]] obrazu oraz [[de:wiki:syntax#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 ((To jest przypis)) 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 [[doku>images|obrazów, filmów i plików audio]] za pomocą nawiasów klamrowych. Opcjonalnie można określić ich rozmiar. Rozmiar rzeczywisty: {{wiki:dokuwiki-128.png }} Zmiana rozmiaru do podanej szerokości: {{wiki:dokuwiki-128.png?50 }} 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): {{wiki:dokuwiki-128.png?200x50}} Obraz zewnętrzny po zmianie rozmiaru:           {{https://www.php.net/images/php.gif?200x50}} 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. {{ wiki:dokuwiki-128.png}} {{wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }} {{wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }} 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. {{wiki:dokuwiki-128.png?100&right}} {{wiki:dokuwiki-128.png?100&right }} Oczywiście można również dodać tytuł (wyświetlany jako podpowiedź przez większość przeglądarek). {{ wiki:dokuwiki-128.png |Oto podpis}} {{ wiki:dokuwiki-128.png |Oto podpis}} Aby umieścić link do obrazu prowadzący na inną stronę, zobacz [[de:wiki:syntax#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 {{wiki:dokuwiki-128.png?linkonly }} {{wiki:dokuwiki-128.png?linkonly}} 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. * To jest lista * Druga pozycja * Można stosować różne poziomy * Kolejna pozycja - Ta sama lista, ale uporządkowana - Kolejna pozycja - Aby uzyskać głębsze poziomy, wystarczy użyć wcięcia - 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 [[doku>faq:lists|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 [[wp>emoticon]] na ich graficzne odpowiedniki. Te [[doku>Smileys]] i inne obrazy można konfigurować i rozszerzać. Oto przegląd emotikonów zawartych w DokuWiki: * 8-) %% 8-) %% * 8-O %% 8-O %% * :-( %% :-( %% * :-) %% :-) %% * =) %% = ) %% * :-/ %% :-/ %% * :-\ %% :-\ %% * :-? %% :-? %% * :-D %% :-D %% * :-P %% :-P %% * :-O %% :-O %% * :-X %% :-X %% * :-| %% :-| %% * ;-) %% ;-) %% * ^_^ %% ^_^ %% * m( %% m( %% * :?: %% :?: %% * :!: %% :!: %% * LOL %% LOL %% * FIXME %% FIXME %% * DELETEME %% DELETEME %% ==== Konwersja tekstu na HTML ==== Typografia: [[de:wiki:dokuwiki]] umożliwia konwersję prostych znaków tekstowych na ich typograficznie poprawne odpowiedniki. Oto przykład rozpoznanych 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'..." To samo można zrobić, aby wygenerować dowolny kod HTML – wystarczy dodać go do [[doku>entities|plik wzorca]]. Istnieją trzy wyjątki, które nie pochodzą z tego pliku wzorca: znak mnożenia (640x480), „pojedyncze” i „podwójne cudzysłowy”. Można je wyłączyć za pomocą opcji [[doku>config:typography|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 ''%%%%'' 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 ;-)%%. 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 ;-)%%. ===== 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 ''%%%%'' or ''%%%%''. 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. 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. ==== Podświetlanie składni ==== [[wiki:dokuwiki]] może podświetlać kod źródłowy, co ułatwia jego czytanie. Wykorzystuje on [[http://qbnz.com/highlighter/|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. '''' or ''''. /** * 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 [[doku>syntax_highlighting|advanced options]] available for syntax highlighting, such as highlighting lines or adding line numbers. ==== Downloadable Code Blocks ==== When you use the ''%%%%'' or ''%%%%'' 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: Jeśli nie chcesz żadnego podświetlania, ale chcesz pobrać plik, podaj myślnik (''-'') jako kod języka: ''%%%%''. ===== Agregacja kanałów RSS/ATOM ===== [[de:wiki:dokuwiki]] może integrować dane z zewnętrznych kanałów XML. Do analizowania kanałów XML [[http://simplepie.org/|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. [[wiki: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 [[wiki: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 }} {{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 %%%%), 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ą [[doku>plugins|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: ~~INFO:syntaxplugins~~