Różnice

Różnice między wybraną wersją a wersją aktualną.

--- pl:wiki:syntax [2017-01-18 11:00] – [Udziały sieciowe Windows] 195.245.224.251
+++ pl:wiki:syntax [2017-01-18 14:42] (aktualna) – [Tłumaczenie strony] 195.245.224.251
@@ Linia 95: / Linia 95: @@
 </code>
-==== Linki w grafice ====
+==== 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:
+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}}]]
@@ Linia 105: / Linia 105: @@
 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.
+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).
@@ Linia 132: / Linia 132: @@
-===== Zdjęcia i inne pliki =====
+===== 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ść.
@@ Linia 149: / Linia 149: @@
   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ę.
+Dodając spacje z lewej lub prawej możesz odpowiednio wyrównać grafikę.
 {{ wiki:dokuwiki-128.png}}
@@ Linia 161: / Linia 161: @@
   {{ wiki:dokuwiki-128.png }}
-Oczywiście można też dodać podpis (wyświetlany jako podpowiedź przez większość przeglądarek).
+Oczywiście można też dodać podpis (wyświetlany jako dymek przez większość przeglądarek).
 {{ wiki:dokuwiki-128.png |To jest podpis}}
@@ Linia 169: / Linia 169: @@
 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.
+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 =====
@@ Linia 203: / Linia 231: @@
 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. Zamianę na tekst lub HTML stosuje się zaś głównie do poprawek typograficznych, może być jednak równie dobrze skonfigurowana do innych czynności.
+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.
-==== Emotikony ====
+==== Konwersja tekstu na grafikę ====
-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.
+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-)  %%
@@ Linia 232: / Linia 260: @@
-==== Typografia ====
+==== Konwersja tekstu na HTML ====
-[[DokuWiki]] może konwertować proste oznaczenia tekstowe na poprawne typograficznie znaki. Oto przykłady rozpoznawanych kombinacji znaków:
+Typografia: [[DokuWiki]] może konwertować proste oznaczenia tekstowe na poprawne typograficznie znaki. Oto przykłady rozpoznawanych kombinacji znaków:
 -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
@@ Linia 244: / Linia 272: @@
 </code>
-Uwaga: Ta konwersja może być wyłączona przez [[doku>config#typography|opcję konfiguracyjną]] lub [[doku>entities|plik wzorcowy?]].
+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 =====
@@ Linia 276: / Linia 305: @@
 | 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.
+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                ^
@@ Linia 283: / Linia 312: @@
   | 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!
+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.
@@ Linia 292: / Linia 321: @@
 ^ Nagłówek 5    | Wiersz 2 Kolumna 2          | Wiersz 2 Kolumna 3        |
-Jak zauważyłeś, to separator komórki decyduje o formatowaniu:
+Jak zauważyłeś, to separator stojący przed komórką decyduje o formatowaniu:
   |               ^ Nagłówek 1                  ^ Nagłówek 2                ^
@@ Linia 299: / Linia 328: @@
   ^ Nagłówek 5    | Wiersz 2 Kolumna 2          | Wiersz 2 Kolumna 3        |
-Można również łączyć komórki w pionie, poprzez umieszczenie '':::'' w komórkach znajdujących się poniżej tej, z którą chcemy je połączyć.
+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                ^
@@ Linia 306: / Linia 335: @@
 | Wiersz 3 Kolumna 1    | :::                           | Wiersz 2 Kolumna 3        |
-Poza ww. składnią, komórki te nie mogą posiadać żadnej innej treści.
+Poza składnią rowspan, komórki te nie mogą posiadać żadnej innej treści.
   ^ Nagłówek 1            ^ Nagłówek 2                    ^ Nagłówek 3                ^
@@ Linia 328: / Linia 357: @@
   | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
+Uwaga: Wyrównanie w pionie nie jest wspierane.
 ===== 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''.
+Jeśli chcesz pokazać tekst dokładnie tak, jak został napisany (niesformatowany), otocz ten obszar tagami ''%%<nowiki>%%'' albo nawet prościej, podwójnym znakiem procenta ''<nowiki>%%</nowiki>''.
+<nowiki>
+Ten tekst zawiera adres: http://www.splitbrain.org i **formatowanie**, lecz nic się z tym nie dzieje.
+</nowiki>
+Poprawne jest również to: %%//__ten__ tekst// ma emotikon ;-)%%.
+  <nowiki>
+  Ten tekst zawiera adres: http://www.splitbrain.org i **formatowanie**, lecz nic się z tym nie dzieje.
+  </nowiki>
+  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 ''%%<code>%%'' albo ''%%<file>%%''.
+  To jest tekst z wcięciem na 2 spacje.
 <code>
-To fragment wcześniej sformatowanego kodu zawierającego spacje, które są zachowane               <-w ten sposób.
+To jest preformatowany kod wszystkie spacje są zachowane: jak              <-te
 </code>
 <file>
-Mniej więcej to samo; można używać do cytowania fragmentów pliku.
+Teraz jest całkiem tak samo, użyj tego sposobu aby pokazać, że cytujesz plik.
 </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>''.
+Powyższe bloki zostały stworzone przez takie źródło:
-<nowiki>
+    To jest tekst z wcięciem na 2 spacje.
-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.
+  <code>
+  To jest preformatowany kod wszystkie spacje są zachowane: jak              <-te
+  </code>
+  <file>
+  Teraz jest całkiem tak samo, użyj tego sposobu aby pokazać, że cytujesz plik.
+  </file>
 ===== 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>''.
+[[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. ''<nowiki><code java></nowiki>'' lub ''<nowiki><file java></nowiki>''.
 <code java>
 /**
  * The HelloWorldApp class implements an application that
  * simply displays "Hello World!" to the standard output.
@@ Linia 368: / Linia 416: @@
 </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//
+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 ''%%<code>%%'' lub ''%%<file>%%'' 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:
-===== Wstawianie HTML i PHP =====
+<code>
+<file php myexample.php>
+<?php echo "hello world!"; ?>
+</file>
+</code>
+<file php myexample.php>
+<?php echo "hello world!"; ?>
+</file>
+Jeśli nie chcesz podświetlania kodu, ale chcesz udostępnić plik do pobrania, podaj myślnik (''-'') jako kod języka: ''%%<code - myfile.foo>%%''.
+===== Osadzanie kodu HTML i PHP =====
+Możesz osadzić w swoim dokumencie surowy kod HTML i PHP używając tagów ''%%<html>%%'' lub ''%%<php>%%''. (Gdy użyjesz w tagu wielkich liter, kod pojawi sie na poziomie bloku.)
-Możesz wbudować w swój dokument czysty kod HTML i PHP używając znaczników ''html'' lub ''php'' w ten sposób:
+Przykład HTML:
 <code>
 <html>
-To jest trochę kodu <font color="red" size="+1">HTML</font>
+This is some <span style="color:red;font-size:150%;">inline HTML</span>
 </html>
+<HTML>
+<p style="border:2px dashed red;">And this is some block HTML</p>
+</HTML>
 </code>
 <html>
-To jest trochę kodu <font color="red" size="+1">HTML</font>
+This is some <span style="color:red;font-size:150%;">inline HTML</span>
 </html>
+<HTML>
+<p style="border:2px dashed red;">And this is some block HTML</p>
+</HTML>
+Przykład PHP:
 <code>
 <php>
-echo 'A logo generated by PHP:';
+echo 'Wersja PHP: ';
-echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
+echo phpversion();
+echo ' (generated inline HTML)';
 </php>
+<PHP>
+echo '<table class="inline"><tr><td>To samo, ale wewnątrz elementu bloku:</td>';
+echo '<td>'.phpversion().'</td>';
+echo '</tr></table>';
+</PHP>
 </code>
 <php>
-echo 'A logo generated by PHP:';
+echo 'Wersja PHP: ';
-echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
+echo phpversion();
+echo ' (inline HTML)';
 </php>
+<PHP>
+echo '<table class="inline"><tr><td>To samo, ale wewnątrz elementu bloku:</td>';
+echo '<td>'.phpversion().'</td>';
+echo '</tr></table>';
+</PHP>
+**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 }}
-**Uwaga**: wstawianie HTML i PHP jest domyślnie wyłączone w konfiguracji. Jeżeli tak jest, kod jest wyświetlany bez interpretacji.
+{{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 %%<php>%% jak wyżej), dodanie tego makra zmusi DokuWiki do renderowania strony przy każdym wywołaniu |
 ===== Wtyczki składni =====
@@ Linia 413: / Linia 526: @@
   * //[[wkazimierczak@conforama.pl|Wojciech Kazimierczak]] 2007/07/15 21:32//
   * //[[easynet2@interia.pl|CreaThor]] 2008/06/05 12:15//
+  * //AndyGrond 2016/01/18//