DokuWiki

It's better when it's simple

Narzędzia użytkownika

Narzędzia witryny


pl:wiki:syntax

Różnice

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

Odnośnik do tego porównania

Poprzednia rewizja po obu stronachPoprzednia wersja
Nowa wersja
Poprzednia wersja
pl:wiki:syntax [2017-01-18 13:32] – [Fragmenty niesformatowane] 195.245.224.251pl:wiki:syntax [2017-01-18 14:42] (aktualna) – [Tłumaczenie strony] 195.245.224.251
Linia 402: Linia 402:
 ===== Podświetlanie składni ===== ===== 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> <code java>
-/** +/**
  * The HelloWorldApp class implements an application that  * The HelloWorldApp class implements an application that
  * simply displays "Hello World!" to the standard output.  * simply displays "Hello World!" to the standard output.
Linia 416: Linia 416:
 </code> </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_macc, 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, chaiscriptcil, 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> <code>
 <html> <html>
-To jest trochę kodu <font color="redsize="+1">HTML</font>+This is some <span style="color:red;font-size:150%;">inline HTML</span>
 </html> </html>
 +<HTML>
 +<p style="border:2px dashed red;">And this is some block HTML</p>
 +</HTML>
 </code> </code>
  
 <html> <html>
-To jest trochę kodu <font color="redsize="+1">HTML</font>+This is some <span style="color:red;font-size:150%;">inline HTML</span>
 </html> </html>
 +<HTML>
 +<p style="border:2px dashed red;">And this is some block HTML</p>
 +</HTML>
 +
 +Przykład PHP:
  
 <code> <code>
 <php> <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>
 +<PHP>
 +echo '<table class="inline"><tr><td>To samo, ale wewnątrz elementu bloku:</td>';
 +echo '<td>'.phpversion().'</td>';
 +echo '</tr></table>';
 +</PHP>
 </code> </code>
  
 <php> <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>
 +<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 konfiguracjiJeż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 ===== ===== Wtyczki składni =====
Linia 461: Linia 526:
   * //[[wkazimierczak@conforama.pl|Wojciech Kazimierczak]] 2007/07/15 21:32//   * //[[wkazimierczak@conforama.pl|Wojciech Kazimierczak]] 2007/07/15 21:32//
   * //[[easynet2@interia.pl|CreaThor]] 2008/06/05 12:15//   * //[[easynet2@interia.pl|CreaThor]] 2008/06/05 12:15//
 +  * //AndyGrond 2016/01/18//
pl/wiki/syntax.1484742726.txt.gz · ostatnio zmienione: 2017-01-18 13:32 przez 195.245.224.251

Wszystkie treści w tym wiki, którym nie przyporządkowano licencji, podlegają licencji: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki