Narzędzia użytkownika

Narzędzia witryny


wiki:skladnia

Składnia Formatowania

DokuWiki obsługuje prosty język znaczników, który stara się uczynić pliki danych jak najbardziej czytelnymi. Ta strona zawiera całą możliwą składnię, którą możesz użyć podczas edycji stron. Po prostu spójrz na źródło tej strony, klikając „Edytuj tę stronę”. Jeśli chcesz coś wypróbować, użyj strony plac zabaw. Prostsze znaczniki są łatwo dostępne przez szybkie przyciski.

Podstawowe Formatowanie Tekstu

DokuWiki obsługuje tekst **pogrubiony**, //pochylony//, __podkreślony__ i ''monospace''. Oczywiście możesz **__//''łączyć''//__** wszystkie te style.

DokuWiki obsługuje tekst pogrubiony, pochylony, podkreślony i monospace. Oczywiście możesz łączyć wszystkie te style.

Możesz również użyć <sub>indeksu dolnego</sub> i <sup>indeksu górnego</sup>.

Możesz również użyć indeksu dolnego i indeksu górnego.

Możesz zaznaczyć coś jako <del>usunięte</del>.

Możesz zaznaczyć coś jako usunięte.

Akapity są tworzone przez puste linie. Jeśli chcesz wymusić nową linię bez akapitu, możesz użyć dwóch ukośników końcowych lub końca linii.

To jest tekst z kilkoma łamanymi liniami
Zauważ, że dwa ukośniki końcowe są rozpoznawane tylko na końcu linii
lub po
spacji
to działa bez tego.

To jest tekst z kilkoma łamanymi liniami\\
Zauważ, że dwa ukośniki końcowe są rozpoznawane tylko na końcu linii\\
lub po \\
spacji \\
to działa bez tego.

Powinieneś używać wymuszonych nowych linii tylko wtedy, gdy jest to naprawdę konieczne.

Linki

DokuWiki obsługuje kilka sposobów tworzenia linków.

Zewnętrzne

Linki zewnętrzne są rozpoznawane automatycznie: http://www.google.com lub po prostu www.google.com - Możesz ustawić również tekst linku: Ten link prowadzi do Google. Adresy e-mail jak ten: andi@splitbrain.org również są rozpoznawane.

DokuWiki obsługuje kilka sposobów tworzenia linków. Linki zewnętrzne są rozpoznawane automatycznie: http://www.google.com lub po prostu www.google.com - Możesz ustawić tekst linku: Ten link prowadzi do Google. Adresy e-mail jak ten: andi@splitbrain.org również są rozpoznawane.

Wewnętrzne

Linki wewnętrzne są tworzone za pomocą kwadratowych nawiasów. Możesz po prostu podać pagename lub użyć dodatkowego tekst linku.

Linki wewnętrzne są tworzone za pomocą kwadratowych nawiasów. Możesz po prostu podać [[pagename]] lub użyć dodatkowego [[pagename|tekst linku]].

Nazwy stron Wiki są automatycznie zamieniane na małe litery, znaki specjalne nie są dozwolone.

Możesz użyć namespaces za pomocą dwukropka w nazwie strony.

''Możesz użyć [[some:namespaces]] za pomocą dwukropka w nazwie strony''

Szczegóły na temat przestrzeni nazw znajdziesz w namespaces.

Możliwe jest również linkowanie do konkretnej sekcji. Po prostu dodaj nazwę sekcji po znaku hash, jak w HTML. Ten link prowadzi do tej sekcji.

Ten link prowadzi do tej sekcji.

Ten link prowadzi do [[skladnia#wewnetrzne|tej sekcji]]

Uwagi:

  • Linki do istniejących stron są wyświetlane w innym stylu niż nonexisting.
  • DokuWiki nie używa domyślnie CamelCase do automatycznego tworzenia linków, ale można to włączyć w pliku config. Wskazówka: Jeśli DokuWiki jest linkiem, to jest to włączone.
  • Kiedy nagłówek sekcji jest zmieniany, zmienia się również jego zakładka. Dlatego nie polegaj zbytnio na linkowaniu do sekcji.

Interwiki

DokuWiki obsługuje linki Interwiki. Są to szybkie linki do innych Wikis. Na przykład ten link prowadzi do strony Wikipedii na temat Wiki: Wiki.

DokuWiki obsługuje linki [[doku>Interwiki]]. Są to szybkie linki do innych Wikis.
Na przykład ten link prowadzi do strony Wikipedii na temat Wiki: [[wp>Wiki]].

Zasoby sieciowe Windows

Zasoby sieciowe Windows jak ten są również rozpoznawane. Należy jednak pamiętać, że mają one sens tylko w jednorodnej grupie użytkowników, jak np. korporacyjny Intranet.

Zasoby sieciowe Windows jak ten są również rozpoznawane.

Uwagi:

  • Ze względów bezpieczeństwa bezpośrednie przeglądanie zasobów sieciowych Windows działa tylko w przeglądarce Microsoft Internet Explorer (i tylko w „strefie lokalnej”).
  • Dla przeglądarek Mozilla i Firefox można to włączyć za pomocą różnych obejść opisanych w Mozilla Knowledge Base. Jednak nadal pojawi się ostrzeżenie JavaScript o próbie otwarcia zasobu sieciowego Windows. Aby usunąć to ostrzeżenie (dla wszystkich użytkowników), umieść następujący wiersz w conf/lang/en/lang.php (więcej szczegółów w lokalizacja):
    conf/lang/en/lang.php
    <?php
    /**
     * Dostosowanie pliku języka angielskiego
     * Skopiuj tylko ciągi, które należy zmodyfikować
     */
    $lang['js']['nosmblinks'] = '';

Linki do obrazów

Możesz również użyć obrazu, aby linkować do innej wewnętrznej lub zewnętrznej strony, łącząc składnię linków i obrazów (patrz poniżej) w ten sposób:

[[http://php.net|{{wiki:dokuwiki-128.png}}]]

Należy pamiętać: Formatowanie obrazu jest jedynym formatowaniem akceptowanym w nazwach linków.

Cała składnia obrazu i linku jest obsługiwana (w tym zmiana rozmiaru obrazu, wewnętrzne i zewnętrzne obrazy oraz adresy URL oraz linki interwiki).

Przypisy

Możesz dodawać przypisy 1) za pomocą podwójnych nawiasów okrągłych.

Możesz dodawać przypisy 2) za pomocą podwójnych nawiasów okrągłych.

Sekcje

Możesz używać do pięciu różnych poziomów nagłówków, aby strukturyzować treść. Jeśli masz więcej niż trzy nagłówki, tabela treści jest generowana automatycznie – można to wyłączyć, dodając ciąg ~~NOTOC~~ do dokumentu.

Nagłówek poziomu 3

Nagłówek poziomu 4

Nagłówek poziomu 5

Kod:

==== Nagłówek poziomu 3 ====
=== Nagłówek poziomu 4 ===
== Nagłówek poziomu 5 ==

Używając czterech lub więcej myślników, możesz utworzyć linię poziomą:


Pliki multimedialne

Możesz dołączyć zewnętrzne i wewnętrzne obrazy, filmy i pliki audio za pomocą nawiasów klamrowych. Opcjonalnie możesz określić ich rozmiar.

Realny rozmiar:

{{wiki:dokuwiki-128.png}}

Zmieniony rozmiar (200px szerokości):

{{wiki:dokuwiki-128.png?200}}

Dodatkowe atrybuty mogą być używane w plikach multimedialnych:

{{wiki:dokuwiki-128.png?200|Przykładowy podpis}}

Przykładowy podpis

Galeria obrazów

Możesz również wyświetlić galerie obrazów na jednej stronie. Zobacz poniżej, aby uzyskać szczegóły:

{{gallery>:katalog_ze_zdjeciami}}

Więcej szczegółów na temat wyświetlania obrazów znajdziesz w przewodniku po obrazach.

Wideo i audio

Wideo i audio z popularnych usług (np. YouTube) mogą być osadzone bezpośrednio:

{{youtube>xxxxxx}}
{{vimeo>xxxxxx}}

Więcej szczegółów znajdziesz w dokumencie audio i wideo.

Listy

DokuWiki obsługuje wiele różnych typów list. Zwykłe listy są oznaczane gwiazdkami:

  • To jest punkt listy
  • Kolejny punkt
  * To jest punkt listy
  * Kolejny punkt

Listy uporządkowane są numerowane:

  1. Punkt pierwszy
  2. Punkt drugi
  - Punkt pierwszy
  - Punkt drugi

Jest to podlista:

  1. Punkt pierwszy
    1. Punkt podrzędny A
    2. Punkt podrzędny B
  - Punkt pierwszy
    - Punkt podrzędny A
    - Punkt podrzędny B

Ponadto możliwe jest tworzenie listy definicji:

  : Opis
  Term
    : Opis

Listy mogą być mieszane, ale nie jest to zalecane.

Listy mogą zawierać kilka różnych poziomów:

  1. Punkt pierwszy
  2. Punkt drugi
    • Punkt podrzędny A
    • Punkt podrzędny B
      1. Punkt podrzędny a
      2. Punkt podrzędny b
  3. Punkt trzeci
  - Punkt pierwszy
  - Punkt drugi
    * Punkt podrzędny A
    * Punkt podrzędny B
      - Punkt podrzędny a
      - Punkt podrzędny b
  - Punkt trzeci

Podgląd:

  • To jest punkt listy
  • Kolejny punkt
  1. Punkt pierwszy
  2. Punkt drugi
  1. Punkt pierwszy
    1. Punkt podrzędny A
    2. Punkt podrzędny B
    : Opis
 
  - Punkt pierwszy
  - Punkt drugi
    * Punkt podrzędny A
    * Punkt podrzędny B
      - Punkt podrzędny a
      - Punkt podrzędny b
  - Punkt trzeci

Cytaty

Cytaty są wcięte z obu stron i mogą być zagnieżdżone:

  > To jest pierwszy poziom cytatu
  >> To jest drugi poziom cytatu

Podgląd:

To jest pierwszy poziom cytatu
To jest drugi poziom cytatu</code>

Tabele

Formatowanie tabel w DokuWiki jest dość proste.

  | To      | jest      | nagłówek |
  |---------|-----------|----------|
  | To      | jest      | wiersz   |
  | komórek | tabeli    |          |

Poniżej wyświetla się tabela z przykładowymi danymi:

To jest nagłówek
——————–———-
To jest wiersz
komórek tabeli

Przydatne jest również używanie htmlspecialchars w tagach.

Aby uzyskać więcej informacji, zapoznaj się z dokumentacją dotyczącą tabel.

Kod

Możesz wyświetlić kod w jednym wierszu za pomocą pary apostrofów. Przykład: Kod jednowierszowy.

Kod wieloliniowy można wyświetlić tak::

To jest
  wieloliniowy kod

Przykład:

''
To jest
  wieloliniowy kod
''

Możesz podświetlić składnię określonych języków programowania. Aby to zrobić, użyj:

Przykład bash:

  echo "To jest kod bash";

Przykład php:

  echo "To jest kod PHP";

Możliwe jest również używanie GeSHi do podświetlania składni.

Lub innych możliwości np:

bash.sh
Bash
<file bash bash.sh>Bash</file>

Notacje HTML

DokuWiki obsługuje standardowe tagi HTML. Możesz więc używać takich elementów jak <div> i <span> w swoich dokumentach.

Notacje XML

DokuWiki obsługuje podstawową składnię XML. Można na przykład włączyć proste tagi XML, takie jak:

  <nowiki>[[wiki:dokuwiki]]</nowiki> albo [[doku>page]]

Na przykład:

<nowiki>[[wiki:dokuwiki]]</nowiki> albo [[doku>page]]

Domyślny okres odświeżania wynosi 4 godziny. Wartości poniżej 10 minut będą traktowane jako 10 minut. DokuWiki zazwyczaj próbuje dostarczyć zbuforowaną wersję strony, co jest oczywiście niewłaściwe, gdy strona zawiera dynamiczną treść zewnętrzną. Parametr określa, że DokuWiki ma ponownie wyrenderować stronę, jeśli minął czas dłuższy niż okres odświeżania od ostatniego renderowania strony.

Domyślnie kanał będzie sortowany według daty, od najnowszych do najstarszych elementów. Można go posortować od najstarszych do najnowszych, używając parametru reverse lub wyświetlić kanał bez zmian, używając nosort.

Przykład:

  {{rss>http://slashdot.org/index.rss 5 author date 1h }}

Makra sterujące

Niektóre składnie wpływają na sposób renderowania strony przez DokuWiki bez tworzenia jakiegokolwiek wyjścia. Dostępne są następujące makra sterujące:

Makro Opis
~~NOTOC~~ Jeśli to makro znajduje się na stronie, nie zostanie utworzony spis treści
~~NOCACHE~~ DokuWiki domyślnie buforuje całe wyjście. Czasami może to być niepożądane (np. gdy używana jest składnia <php> powyżej), dodanie tego makra wymusi ponowne renderowanie strony przy każdym wywołaniu

Wtyczki składniowe

Składnia DokuWiki może być rozszerzana za pomocą wtyczek. Sposób użycia zainstalowanych wtyczek jest opisany na odpowiednich stronach z ich opisami. Dostępne są następujące wtyczki składniowe w tej konkretnej instalacji DokuWiki:

1) , 2)
To jest przypis
wiki/skladnia.txt · ostatnio zmienione: przez tester