Różnice między wybraną wersją a wersją aktualną.
— |
wiki:syntax [2010/05/09 12:02] (aktualna) |
||
---|---|---|---|
Linia 1: | Linia 1: | ||
+ | ====== Składnia formatowania ====== | ||
+ | [[wiki:DokuWiki]] obsługuje prosty język znaczników, dzięki któremu pliki z danymi są najprostsze, jak to tylko możliwe. Na tej stronie znajdziesz informacje o znacznikach, których możesz używać podczas edytowania tekstu. Możesz także podejrzeć źródło tej strony, klikając przycisk //Edit this page// na dole strony. Jeśli chcesz potestować znaczniki, użyj strony [[playground]]. Niektóre znaczniki są także dostępne poprzez [[wiki:quickbuttons|quickbuttons]], czyli guziki w polu edycji. | ||
+ | |||
+ | |||
+ | |||
+ | ===== Podstawowe formatowanie tekstu ===== | ||
+ | |||
+ | DokuWiki obsługuje **pogrubienie**, //pochylenie//, __podkreślenie__ oraz tekst ''maszynowy'' . Oczywiście możesz **__//''połączyć''//__** wszystkie znaczniki. | ||
+ | |||
+ | DokuWiki obsługuje **pogrubienie**, //pochylenie//, __podkreślenie__ oraz tekst ''maszynowy'' . | ||
+ | Oczywiście możesz **__//''połączyć''//__** wszystkie znaczniki. | ||
+ | |||
+ | Możesz używać także indeksów <sub>dolnych</sub> oraz <sup>górnych</sup>. | ||
+ | |||
+ | Możesz używać także indeksów <sub>dolnych</sub> oraz <sup>górnych</sup>. | ||
+ | |||
+ | Możesz oznaczyć coś jako <del>usunięte</del>. | ||
+ | |||
+ | Możesz oznaczyć coś jako <del>usunięte</del>. | ||
+ | |||
+ | **Akapity** są tworzone z pustych linii. Jeśli chcesz **złamać linię** bez akapitu, użyj podwójnego backslasha oraz spacji. | ||
+ | |||
+ | To jest łamany tekst\\ Zauważ, że backslashe | ||
+ | są rozpoznawane tylko na końcu linii\\ | ||
+ | lub gdy za nimi znajduje się\\ spacja. \\bez niej otrzymujemy takie coś. | ||
+ | |||
+ | To jest łamany tekst\\ Zauważ, że backslashe | ||
+ | są rozpoznawane tylko na końcu linii\\ | ||
+ | lub gdy za nimi znajduje się\\ spacja. \\bez niej otrzymujemy takie coś. | ||
+ | |||
+ | |||
+ | Łamania tekstu powinno się używać tylko w razie konieczności. | ||
+ | |||
+ | |||
+ | ===== Linki ===== | ||
+ | |||
+ | DokuWiki obsługuje kilka możliwości tworzenia linków. | ||
+ | |||
+ | |||
+ | |||
+ | ==== Linki zewnętrzne ==== | ||
+ | |||
+ | Zewnętrzne linki są rozpoznawane automatycznie (np. www.google.com), można też ustawić nazwę linku [[http://www.google.com|Link do google]]. Adresy e-mail również są rozpoznawalne (np. <lol@lol.org>) | ||
+ | |||
+ | Zewnętrzne linki są rozpoznawane automatycznie (np. www.google.com), | ||
+ | można też ustawić nazwę linku [[http://www.google.com|Link do google]]. | ||
+ | Adresy e-mail również są rozpoznawalne (np. <lol@lol.org> | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ==== Linki wewnętrzne ==== | ||
+ | |||
+ | Linki wewnętrzne tworzy się używając nawiasów kwadratowych np. [[doku>wiki:link]] lub z dodatkowym tytułem [[doku>wiki:link|Link]] . Nazwy stron wiki są automatycznie konwertowane na tak aby zawierały tylko małe litery, znaki specjalne są zabronione. | ||
+ | |||
+ | Linki wewnętrzne tworzy się używając nawiasów kwadratowych np. [[doku>wiki:link]] lub z dodatkowym | ||
+ | tytuem[[doku>wiki:link|Link]] . Nazwy stron wiki są automatycznie konwertowane na tak aby zawierały tylko małe | ||
+ | litery, znaki specjalne są zabronione. | ||
+ | |||
+ | Można używać [[wiki:namespaces]] używając dwukropka w nazwie strony. | ||
+ | |||
+ | Można używać [[wiki:namespaces]] używając dwukropka w nazwie strony. | ||
+ | |||
+ | Po więcej informacji o namespace'ach zapraszam tu : [[doku>wiki:namespaces]] | ||
+ | |||
+ | Możliwe jest również linkowanie do konkretnych sekcji. Wystarczy dodać nazwę przed znakiem "#". | ||
+ | Link do [[syntax#internal|this Section]] | ||
+ | |||
+ | Link do [[syntax#internal|this Section]] | ||
+ | |||
+ | Uwagi: | ||
+ | * Linki do [[wiki:syntax|istniejących stron]] są wyświetlane inaczej niż linki do stron [[wiki:nieistanieje|nie istniejących]]. | ||
+ | * DokuWiki nie używa domyślnie [[wp>CamelCase]] do automatycznego tworzenia linków, ale to zachowanie może być wymuszone w pliku konfiguracyjnym. Wskazówka: Jeśli DokuWiki jest linkiem, oznacza że jest to włączone. | ||
+ | * Kiedy zmienia sie nagłówek sekcji, zmienia sie też jego adres, więc nie polegaj zbytnio na takich odnosnikach. | ||
+ | |||
+ | |||
+ | |||
+ | ==== Interwiki ==== | ||
+ | DokuWiki wspiera odnosniki [[doku>wiki:interwiki]]. To szybkie linki do innych Wiki. Np. to jest link do wikipedycznej strony o wikipediach(poprawcie to :p) [[wp>Wiki]] | ||
+ | |||
+ | DokuWiki wspiera odnosniki [[doku>wiki:interwiki]]. To szybkie linki do innych Wiki. | ||
+ | Np. to jest link do wikipedycznej strony o wikipediach(poprawcie to :p) [[wp>Wiki]] | ||
+ | |||
+ | |||
+ | ==== Windows Shares ==== | ||
+ | |||
+ | Windows shares like [[\\server\share|this]] are recognized, too. Please note that these only make sense in a homogenous user group like a corporate [[wp>Intranet]]. | ||
+ | |||
+ | Windows Shares like [[\\server\share|this]] are recognized, too. | ||
+ | |||
+ | Notes: | ||
+ | |||
+ | * For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the "local zone"). | ||
+ | * For Mozilla and Firefox it can be enabled through the config option [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]] but this is not recommended | ||
+ | * See [[bug>151]] for more info | ||
+ | |||
+ | ==== Linki do obrazków ==== | ||
+ | |||
+ | Możesz także użyć obrazka jako linku do innej (wewnętrznej lub zewnętrznej) strony, łącząc składnie dla odsyłaczy i obrazków - zobacz na ponizszym przykładzie: | ||
+ | |||
+ | [[http://www.php.net|{{wiki:dokuwiki-128.png}}]] | ||
+ | |||
+ | [[http://www.php.net|{{wiki:dokuwiki-128.png}}]] | ||
+ | |||
+ | **Zauważ**:Formatowanie obrazków to jedyne dopuszczalne formatowanie w nazwach linków. | ||
+ | |||
+ | |||
+ | |||
+ | ===== Przypisy ===== | ||
+ | |||
+ | Możesz dodać przypis ((To jest przypis)) obejmując go podwójnym nawiasem okrągłym. | ||
+ | |||
+ | Możesz dodać przypis ((To jest przypis)) obejmując go podwójnym nawiasem okrągłym. | ||
+ | |||
+ | |||
+ | ===== Podział na działy ===== | ||
+ | Możesz użyć do pieciu róznych poziomów nagłówków by zorganizować treść. Jeśli wstawisz więcej niż trzy nagłówki zostanie wygenerowany automatycznie spis treści. Można go wyłaczć przez wpisanie w tresci ciągu ''<nowiki>~~NOTOC~~</nowiki>'' | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ==== Nagłówek rzędu 3 ==== | ||
+ | === Nagłówek rzędu 4 === | ||
+ | == Nagłówek rzędu 5 == | ||
+ | |||
+ | ==== Nagłówek rzędu 3 ==== | ||
+ | === Nagłówek rzędu 4 === | ||
+ | == Nagłówek rzędu 5 == | ||
+ | |||
+ | Używając czterech lub więcej myślników utworzysz poziomą linię. | ||
+ | |||
+ | ---- | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===== Obrazki i inne pliki ===== | ||
+ | |||
+ | Możesz osadzać zewnątrzne i wewnętrzne [[doku>images]] za pomocą nawiasów klamrowych. Opcjonalnoe możesz nadać im rozmairy. | ||
+ | |||
+ | Rzeczywisty rozmiar: {{wiki:dokuwiki-128.png}} | ||
+ | |||
+ | Rozmiar zmieniony wzgledem szerokości: {{wiki:dokuwiki-128.png?50}} | ||
+ | |||
+ | Rozmiar zmieniony wzglądem szerokości i wysokości: {{wiki:dokuwiki-128.png?200x50}} | ||
+ | |||
+ | Przeskalowany obrazek z zewnątrz: {{http://www.agh.edu.pl/images/a0.jpg?200x100}} | ||
+ | |||
+ | Rzeczywisty rozmiar: {{wiki:dokuwiki-128.png}} | ||
+ | Rozmiar zmieniony wzgledem szerokości: {{wiki:dokuwiki-128.png?50}} | ||
+ | Rozmiar zmieniony wzglądem szerokości i wysokości: {{wiki:dokuwiki-128.png?200x50}} | ||
+ | Przeskalowany obrazek z zewnątrz: {{http://www.agh.edu.pl/images/a0.jpg?200x100}} | ||
+ | |||
+ | |||
+ | Używając prawo lub lewostronnie spacji możesz ustalić 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 także dodać tytuł (wyświetlany przez większość przeglądarek jako tooltip). | ||
+ | |||
+ | {{ wiki:dokuwiki-128.png |To jest podpis podpis}} | ||
+ | |||
+ | {{ wiki:dokuwiki-128.png |To jest podpis podpis}} | ||
+ | |||
+ | Jeśli wpiszesz adres który nie wskazuje na plik graficzny (''gif,jpeg,png''), zostanie on wyświetlony jako link tekstowy. | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===== Listy ===== | ||
+ | |||
+ | [[Dokuwiki]] wspiera uporządkowane i nieuporządkowane listy. By utworzyć element listy, rozpocznij linie dwoma spacjami a nastepnie uzyj ''*'' dla listy nieuporządkowanej lub ''-'' dla listy uporządkowanej. | ||
+ | |||
+ | * To jest lista | ||
+ | * To jest jej drugi element | ||
+ | * Możesz stworzyć kilka poziomów | ||
+ | * Kolejny element | ||
+ | |||
+ | - A to lista uporządkowana | ||
+ | - Kolejny Element | ||
+ | - Użyj wcięć by stworzyć poziomy | ||
+ | - To wszystko | ||
+ | |||
+ | <code> | ||
+ | * To jest lista | ||
+ | * To jest jej drugi element | ||
+ | * Możesz stworzyć kilka poziomów | ||
+ | * Kolejny element | ||
+ | |||
+ | - A to lista uporządkowana | ||
+ | - Kolejny Element | ||
+ | - Użyj wcięc by stworzyć poziomy | ||
+ | - To wszystko | ||
+ | </code> | ||
+ | |||
+ | |||
+ | ===== Emotikony ===== | ||
+ | |||
+ | [[DokuWiki]] zamienia powszechnie używane [[http://pl.wikipedia.org/wiki/Emotikon|emotikon]]y na ich graficzne odpowiedniki. Więcej emotek moze być umieszczonych w katalogu ''smiley'' i skonfigurowanych w pliku ''conf/smileys.conf''. Oto przegląd emotek dostępnych w DokuWiki. | ||
+ | |||
+ | * 8-) %% 8-) %% | ||
+ | * 8-O %% 8-O %% | ||
+ | * :-( %% :-( %% | ||
+ | * :-) %% :-) %% | ||
+ | * =) %% =) %% | ||
+ | * :-/ %% :-/ %% | ||
+ | * :-\ %% :-\ %% | ||
+ | * :-? %% :-? %% | ||
+ | * :-D %% :-D %% | ||
+ | * :-P %% :-P %% | ||
+ | * :-O %% :-O %% | ||
+ | * :-X %% :-X %% | ||
+ | * :-| %% :-| %% | ||
+ | * ;-) %% ;-) %% | ||
+ | * ^_^ %% ^_^ %% | ||
+ | * :?: %% :?: %% | ||
+ | * :!: %% :!: %% | ||
+ | * LOL %% LOL %% | ||
+ | * FIXME %% FIXME %% | ||
+ | * DELETEME %% DELETEME %% | ||
+ | |||
+ | |||
+ | |||
+ | ===== Typografia ===== | ||
+ | |||
+ | [[DokuWiki]] potrafi zamieniać proste znaki na ich typograficzne odpowiedniki. Oto przykłady rozpoznawanych znaków. | ||
+ | |||
+ | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | ||
+ | "Pomyślał 'It's a man's world'..." | ||
+ | |||
+ | <code> | ||
+ | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | ||
+ | "Pomyślał 'It's a man's world'..." | ||
+ | </code> | ||
+ | |||
+ | Prosze zauważyć że ta konwersja może być wyłączona w pliku konfiguracyjny. | ||
+ | |||
+ | |||
+ | ===== Cytowanie ===== | ||
+ | Czasami chcesz oznaczyć tekst jako odpowiedź lub komentarz. Możesz do tego celu uzyć 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! | ||
+ | |||
+ | I think we should do it | ||
+ | |||
+ | > No we shouldn't | ||
+ | |||
+ | >> Well, I say we should | ||
+ | |||
+ | > Really? | ||
+ | |||
+ | >> Yes! | ||
+ | |||
+ | >>> Then lets do it! | ||
+ | |||
+ | |||
+ | ===== Tabele ===== | ||
+ | |||
+ | DokuWiki posiada prostą składnie do wstawiana tabel. | ||
+ | |||
+ | ^ Nagłówek 1 ^ Nagłówek 2 ^ Nagłówek 3 ^ | ||
+ | | Rząd 1 Kol 1 | Rząd 1 Kol 2 | Rząd 1 Kol 3 | | ||
+ | | Rząd 2 Kol 1 | połączone kolumny (zauważ podwójny pipe) || | ||
+ | | Rząd 3 Kol 1 | Rząd 2 Kol 2 | Rząd 2 Kol 3 | | ||
+ | |||
+ | Rzędy tabeli muszą czczynać się od ''|'' dla normalnych rzędów lub ''^'' dla rzędów nagłówkowych. | ||
+ | |||
+ | ^ Nagłówek 1 ^ Nagłówek 2 ^ Nagłówek 3 ^ | ||
+ | | Rząd 1 Kol 1 | Rząd 1 Kol 2 | Rząd 1 Kol 3 | | ||
+ | | Rząd 2 Kol 1 | połączone kolumny (zauważ podwójny pipe) || | ||
+ | | Rząd 3 Kol 1 | Rząd 2 Kol 2 | Rząd 2 Kol 3 | | ||
+ | |||
+ | Aby połaczyć komórki w poziomie, zrób następną komórke zupełnie pustą jak na powyższym przykładzie. Upewnij się, że wstawiłeś taką samą ilość separatorów komórek. | ||
+ | |||
+ | Również pionowe nagłówki w tabeli są dopuszczalne: | ||
+ | |||
+ | | ^ Nagłówek 1 ^ Nagłówek 2 ^ | ||
+ | ^ Nagłówek 3 | Rząd 1 Kol 2 | Rząd 1 Kol 3 | | ||
+ | ^ Nagłówek 4 | tym razem komórki nie są złączone | | | ||
+ | ^ Nagłówek 5 | Rząd 2 Kol 2 | Rząd 2 Kol 3 | | ||
+ | |||
+ | Jak widać o formatowaniu decyduje separator komórki wstawiony **przed** nią. | ||
+ | |||
+ | | ^ Nagłówek 1 ^ Nagłówek 2 ^ | ||
+ | ^ Nagłówek 3 | Rząd 1 Kol 2 | Rząd 1 Kol 3 | | ||
+ | ^ Nagłówek 4 | tym razem komórki nie są złączone | | | ||
+ | ^ Nagłówek 5 | Rząd 2 Kol 2 | Rząd 2 Kol 3 | | ||
+ | |||
+ | **Zauważ:** Pionowe połaczenie komórek (rowspan) nie jest mozliwe. | ||
+ | |||
+ | Możesz wyrównać zawartość komórek tabeli. Dodaj poprostu przynajmnej dwie spacje na przeciwnym końcu tekstu: Dodaj dwie spacje po lewej by wyrównać do prawej, dwie spacje po prawej by wyrównać do lewej i przynajmniej po dwie spacje po obu stronach tekstu aby go wyśrodkować. | ||
+ | |||
+ | |||
+ | ^ Tabela z wyrównaniem ^^^ | ||
+ | | prawostronnym| środkowym |lewostronnym | | ||
+ | |lewostronnym | prawostronnym| środkowym | | ||
+ | | xxxxxxxxxxxxxxxxxxxxxx | xxxxxxxxxxxxxxxxxxxxxx | xxxxxxxxxxxxxxxxxxxxxx | | ||
+ | |||
+ | A tak wygląda kod tego przykładu: | ||
+ | |||
+ | ^ Tabela z wyrównaniem ^^^ | ||
+ | | prawostronnym| środkowym |lewostronnym | | ||
+ | |lewostronnym | prawostronnym| środkowym | | ||
+ | | xxxxxxxxxxxxxxxxxxxxxx | xxxxxxxxxxxxxxxxxxxxxx | xxxxxxxxxxxxxxxxxxxxxx | | ||
+ | |||
+ | |||
+ | ===== Nieprzetworzone bloki ===== | ||
+ | Mozesz wstawić nieprzetworzone bloki tekstu wcinając je przynajmniej 2 spacjami (jak w poprzednim przykładzie) lub używając tagów ''code'' lub ''file''. | ||
+ | |||
+ | <code> | ||
+ | To jest preformatowany kod, spacje są zachowane w ten <-sposób | ||
+ | </code> | ||
+ | |||
+ | <file> | ||
+ | To jest własciwie takie samo, ale możesz użyć tego by pokazać że cytujesz plik | ||
+ | </file> | ||
+ | |||
+ | Aby parser zupełnie zignorował obszar (np. nie dokonywał na nim formatowania), umieść go w tagach ''nowiki'' lub nawet prościej, za pomocą podwójnego znaku procentu ''<nowiki>%%</nowiki>''. | ||
+ | |||
+ | <nowiki> | ||
+ | To jest tekst który zawiera adres http://is.fizyk.org i **formatowanie**, ale nie jest on przetworzony | ||
+ | </nowiki> | ||
+ | |||
+ | Zobacz źródło tej strony, aby zobaczyć jak używac tych bloków. |