To jest stara wersja strony!
Spis treści
Składnia formatowania
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 "piaskownicy". Szybkie formatowanie jest dostępne także za pomocą szybkich przycisków.
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ć indeks dolny lub indeks górny.
Można też zastosować <sub>indeks dolny</sub> lub <sup>indeks górny</sup>.
Można oznaczyć coś jako usunięte.
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.
Wewnętrzne
Wewnętrzne linki są tworzone przy użyciu nawiasów prostokątnych. Można podać tylko nazwę strony lub dodatkowo użyć opisu.
Wewnętrzne linki są tworzone przy użyciu nawiasów prostokątnych. Można podać tylko [[nazwę strony]] lub dodatkowo użyć [[nazwę strony|opisu]].
Nazwy stron wiki są automatycznie przekształcane do małych liter, znaki specjalne są niedozwolone.
Możesz użyć nazw podając dwukropek w nazwie strony.
Możesz użyć [[przestrzeni:nazw]] podając dwukropek w nazwie strony.
Szczegóły dotyczące przestrzeni nazw znajdują się w pl:namespaces.
Możliwe jest linkowanie do sekcji. Dadaj nazwę sekcji poprzedzoną znakiem płotka, podobnie jak robi się to w HTML. Ten wpis linkuje do tej Sekcji.
Ten wpis linkuje do [[syntax#internal|tej Sekcji]].
Uwagi:
- Linki do istniejących stron prezentują sie w innym stylu niż te nieistniejące.
- Gdy zmienia się nagłówek sekcji, zmienia sie także jej zakładka (bookmark). Więc nie polegaj zbyt mocno na linkowaniu sekcji.
Zewnętrzne
Linki zewnętrzne są rozpoznawane automagicznie: http://www.google.com lub po prostu www.google.com. Można też zmienić nazwę linka: Ten link prowadzi do Google. Adresy e-mail takie jak ten: andi [at] splitbrain [dot] org są także rozpoznawane.
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|Ten link prowadzi do Google]]. Adresy e-mail takie jak ten: <andi@splitbrain.org> są także rozpoznawane.
Interwiki
DokuWiki umożliwia tworzenie linków Interwiki. Są to szybkie linki do innych systemów Wiki. Na przykład to jest link do strony w Wikipedii na temat Wiki.
DokuWiki umożliwia tworzenie linków [[doku>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 ten, są także rozpoznawane. Proszę zauważyć że takie linki mają sens tylko w homogenicznych grupach użytkowników jak w korporacyjnym 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ą różnych obejść, wspomnianych w Mozilla Knowledge Base, lecz ciągle będą się pojawiać ostrzeżenia JavaScript. Aby usunąć te ostrzeżenia (dla wszystkich użytkowników), umieść następującą linię w
conf/lang/en/lang.php
(more details at localization):- conf/lang/en/lang.php
<?php /** * Customization of the english language file * Copy only the strings that needs to be modified */ $lang['js']['nosmblinks'] = '';
Linki graficzne
Możesz utworzyć link wewnętrzny lub zewnętrzny w grafice wklejonej na stronie poprzez złączenie składni linku i grafiki (zobacz poniżej) w ten sposób:
[[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 grafiki i linków (w tym skalowanie grafiki, grafika wewnętrzna i zewnętrzna oraz łącza URL i interwiki).
Przypisy
Można dodawać przypisy 1) 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 zdjęcie za pomocą nawiasów klamrowych. Opcjonalnie można ustalić jego wielkość.
Skalowane do podanej szerokości:
Przeskalowana grafika zewnętrzna:
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 }}
Oczywiście można też dodać podpis (wyświetlany jako dymek przez większość przeglądarek).
{{ 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 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}}
dokuwiki-128.png 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 emotikony do ich graficznego odpowiednika. Znaki Smileys i inne grafiki można konfigurować i rozszerzać ich listę. Poniżej przegląd emotikonów zawartych w DokuWiki.
- 8-)
- 8-O
- :-(
- :-)
- =)
- :-/
- :-\
- :-?
- :-D
- :-P
- :-O
- :-X
- :-|
- ;-)
- ^_^
- :?:
- :!:
- LOL
- FIXME
- DELETEME
Konwersja tekstu na HTML
Typografia: DokuWiki może konwertować proste oznaczenia tekstowe na poprawne typograficznie znaki. Oto przykłady rozpoznawanych kombinacji znaków:
→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® „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 pliku wzorców.
Są trzy wyjątki, które nie pochodzą z tego pliku wzorców: znak mnożenia (640×480), 'pojedyncze' i „podwójne cudzysłowy”. Te wyjątki mogą być wyłączone w 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śmyA 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
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
.
To fragment wcześniej sformatowanego kodu zawierającego spacje, które są zachowane <-w ten sposób.
Mniej więcej to samo; można używać do cytowania fragmentów pliku.
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 %%
.
To jest fragment tekstu, który zawiera adres: http://www.splitbrain.org ale **formatowanie** tu nie występuje.
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 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. <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. } }
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:
<html> To jest trochę kodu <font color="red" size="+1">HTML</font> </html>
<html> To jest trochę kodu <font color=„red” size=„+1”>HTML</font> </html>
<php> echo 'A logo generated by PHP:'; echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />'; </php>
<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 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:
- Gallery Plugin 2023-12-08 przez Andreas Gohr
Creates a gallery of images from a namespace or RSS/ATOM feed - Repository plugin 2024-02-09 przez Andreas Gohr/Håkan Sandell
Helps organizing the plugin and template repository
Tłumaczenie strony
Dodaj swój e-mail jeżeli utworzyłeś, przetłumaczyłeś lub zmodyfikowałeś fragment tej strony:
- Wojciech Kazimierczak 2007/07/15 21:32
- CreaThor 2008/06/05 12:15