Różnice

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

--- pl:syntax [2013/04/01 11:51]
legatum utworzono
+++ pl:syntax [2013/04/01 11:52] (aktualna)
legatum
@@ Linia 1: / Linia 1: @@
 ====== 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 [[playground:playground|"piaskownicy"]]. Szybkie formatowanie jest dostępne także za pomocą [[doku>pl:toolbar|szybkich przycisków]].
+In order to allow content editing by ordinary users (meaning **you** :-)), Legatum Homeopathicum runs on [[doku>DokuWiki]] engine. DokuWiki supports some simple markup language, which tries to make the datafiles as readable as possible. This page contains all possible syntax you may use when editing the pages. Simply have a look at the source of this page by clicking "Edit" button in the right upper part of the browser window. If you want to try something, just use the [[playground:playground|playground]] page.
-===== Proste formatowanie tekstu =====
+The simpler markup is easily accessible via toolbar buttons too, so you are encouraged to use these as much as you can. Just select the text using your mouse or keyboard and click the toolbar button or hit the corresponding access key (hotkey) combination on the keyboard to achieve the same (Alt + Key).
-DokuWiki umożliwia **pogrubienie**, //pochylenie//, __podkreślenie__ i ''stałą szerokość'' tekstu. Oczywiście można zastosować ich **__//''kombinację''//__**.
+===== Toolbar Buttons =====
-  DokuWiki umożliwia **pogrubienie**, //pochylenie//, __podkreślenie__ i ''stałą szerokość'' tekstu.
+Most buttons have access keys assigned to them -- just press Alt button and a corresponding access key (see the table below).
-  Oczywiście można zastosować ich **__//''kombinację''//__**.
-Można też zastosować <sub>indeks dolny</sub> lub <sup>indeks górny</sup>.
+:!: If these do not work with ALT, please refer to the [[doku>accesskeys|access keys page]] or to your browser manual to see how to use access keys.
-  Można też zastosować <sub>indeks dolny</sub> lub <sup>indeks górny</sup>.
+^ Button  ^ Key  ^ Function  ^
+|  {{http://www.dokuwiki.org/lib/images/toolbar/bold.png?nolink}}        |  ''**b**''  | Bold formatting |
+|  {{http://www.dokuwiki.org/lib/images/toolbar/italic.png?nolink}}      |  ''**i**''  | Italic formatting |
+|  {{http://www.dokuwiki.org/lib/images/toolbar/underline.png?nolink}}   |  ''**u**''  | Underlined formatting |
+|  {{http://www.dokuwiki.org/lib/images/toolbar/mono.png?nolink}}        |  ''**c**''  | Code formatting |
+|  {{http://www.dokuwiki.org/lib/images/toolbar/strike.png?nolink}}      |  ''**d**''  | Strike-through formatting |
+|  {{http://www.dokuwiki.org/lib/images/toolbar/hequal.png?nolink}}      |  ''**8**''  | Same level headline |
+|  {{http://www.dokuwiki.org/lib/images/toolbar/hminus.png?nolink}}      |  ''**9**''  | Lower headline |
+|  {{http://www.dokuwiki.org/lib/images/toolbar/hplus.png?nolink}}       |  ''**0**''  | Higher headline |
+|  {{http://www.dokuwiki.org/lib/images/toolbar/h.png?nolink}}           |             | Select headline |
+|  {{http://www.dokuwiki.org/lib/images/toolbar/h1.png?nolink}}          |  ''**1**''  | Level 1 headline (via 'Select headline' button) |
+|  {{http://www.dokuwiki.org/lib/images/toolbar/h2.png?nolink}}          |  ''**2**''  | Level 2 headline (via 'Select headline' button) |
+|  {{http://www.dokuwiki.org/lib/images/toolbar/h3.png?nolink}}          |  ''**3**''  | Level 3 headline (via 'Select headline' button) |
+|  {{http://www.dokuwiki.org/lib/images/toolbar/h4.png?nolink}}          |  ''**4**''  | Level 4 headline (via 'Select headline' button) |
+|  {{http://www.dokuwiki.org/lib/images/toolbar/h5.png?nolink}}          |  ''**5**''  | Level 5 headline (via 'Select headline' button) |
+|  {{http://www.dokuwiki.org/lib/images/toolbar/link.png?nolink}}        |  ''**l**''  | Internal link formatting (launches the Link Wizard) |
+|  {{http://www.dokuwiki.org/lib/images/toolbar/linkextern.png?nolink}}  |             | External link formatting |
+|  {{http://www.dokuwiki.org/lib/images/toolbar/ol.png?nolink}}          |  ''**-**''  | Ordered list item |
+|  {{http://www.dokuwiki.org/lib/images/toolbar/ul.png?nolink}}          |  ''**.**''  | Unordered list item |
+|  {{http://www.dokuwiki.org/lib/images/toolbar/hr.png?nolink}}          |             | Horizontal rule |
+|  {{http://www.dokuwiki.org/lib/images/toolbar/image.png?nolink}}       |             | Media Selection, includes file/attachment uploader |
+|  {{http://www.dokuwiki.org/lib/images/toolbar/smiley.png?nolink}}      |             | Smiley picker |
+|  {{http://www.dokuwiki.org/lib/images/toolbar/chars.png?nolink}}       |             | Character picker |
+|  {{http://www.dokuwiki.org/lib/images/toolbar/sig.png?nolink}}         |  ''**y**''  | Signature (only when logged in)|
-Można oznaczyć coś jako <del>usunięte</del>.
+===== Basic Text Formatting =====
-  Można oznaczyć coś jako <del>usunięte</del>.
+DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts. Of course you can **__//''combine''//__** all these.
-**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.
+  DokuWiki supports **bold**, //italic//, __underlined__ and ''monospaced'' texts.
+  Of course you can **__//''combine''//__** all these.
-To jest fragment tekstu z nowymi wierszami\\ Zwróć uwagę że
+You can use <sub>subscript</sub> and <sup>superscript</sup>, too. For example, Lyc.<sup>30</sup> would be a good use.
-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
+  You can use <sub>subscript</sub> and <sup>superscript</sup>, too. For example, Lyc.<sup>30</sup> would be a good use.
-  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.
+You can mark something as <del>deleted</del> as well.
-===== Linki =====
+  You can mark something as <del>deleted</del> as well.
-DokuWiki udostępnia wiele sposobów tworzenia linków.
+**Paragraphs** are created from blank lines. If you want to **force a newline** without a paragraph, you can use two backslashes followed by a whitespace or the end of line.
-==== Wewnętrzne ====
+This is some text with some linebreaks\\ Note that the
+two backslashes are only recognized at the end of a line\\
+or followed by\\ a whitespace \\this happens without it.
-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]].
+  This is some text with some linebreaks\\ Note that the
+  two backslashes are only recognized at the end of a line\\
+  or followed by\\ a whitespace \\this happens without it.
-  Wewnętrzne linki są tworzone przy użyciu nawiasów prostokątnych.
+You should use forced newlines only if really needed.
-  Można podać tylko [[nazwę strony]] lub dodatkowo użyć [[nazwę strony|opisu]].
-[[doku>pagename|Wiki pagenames]] are converted to lowercase automatically, special characters are not allowed.
+Instead of a **hyphen** (-), please use a **dash** -- either [[wp>Dash#En_dash_versus_em_dash|en dash]] (--) or em dash (---) -- where appropriate (spaced or unspaced).
-You can use [[some:namespaces]] by using a colon in the pagename.
+  Instead of a **hyphen** (-), please use a **dash** -- either [[wp>Dash#En_dash_versus_em_dash|en dash]] (--) or em dash (---) -- where appropriate (spaced or unspaced).
+===== Links =====
-  You can use [[some:namespaces]] by using a colon in the pagename.
+DokuWiki supports multiple ways of creating links.
-For details about namespaces see [[doku>pl:namespaces]].
+==== Internal ====
-Linking to a specific section is possible, too. Just add the section name behind a hash character as known from HTML. This links to [[syntax#internal|this Section]].
+Internal links are created by using square brackets. You can either just give a page name -- such as [[en:ahr:lippe-ad-importance-of-a-single-symptom-158-10559]] -- or use an additional link text -- such as [[en:ahr:lippe-ad-importance-of-a-single-symptom-158-10559|Lippe: Importance of a Single Symptom]].
-  This links to [[syntax#internal|this Section]].
+  You can either just give a page name -- such as [[en:ahr:lippe-ad-importance-of-a-single-symptom-158-10559]] --
+  or use an additional link text -- such as [[en:ahr:lippe-ad-importance-of-a-single-symptom-158-10559|Lippe: Importance of a Single Symptom]].
-Notes:
+[[doku>pagename|Wiki pagenames]] are converted to lowercase automatically, special characters are not allowed.
-  * Links to [[syntax|existing pages]] are shown in a different style from [[nonexisting]] ones.
+You can use [[some:namespaces]] by using a colon in the pagename.
-  * DokuWiki does not use [[wppl>CamelCase]] to automatically create links by default, but this behavior can be enabled in the [[doku>pl:config]] file. Hint: If DokuWiki is a link, then it's enabled.
-  * When a section's heading is changed, its bookmark changes, too. So don't rely on section linking too much.
-==== Zewnętrzne ====
+  You can use [[some:namespaces]] by using a colon in the pagename.
-Linki zewnętrzne są rozpoznawane automatycznie: http://www.google.com lub po prostu www.google.com. Można też zmienić nazwę linka: [[http://www.google.com|To link który prowadzi do Google]]. Adresy e-mail są wyświetlane tak: <andi@splitbrain.org>.
+In order to faciliate translations, the first namespace part is reserved for language variation (**en** for English, **de** for German, **sk** for Slovak)\\
+For example http://www.legatum.sk/en:ahr:lippe-ad-clinical-observations-08-158-10555 and http://www.legatum.sk/sk:ahr:lippe-ad-clinical-observations-08-158-10555 are English and Slovak versions of the same article.
-  Linki zewnętrzne są rozpoznawane automatycznie: http://www.google.com lub po prostu www.google.com.
+For details about namespaces see [[doku>namespaces]].
-  Można też zmienić nazwę linka: [[http://www.google.com|To link który prowadzi do Google]].
-  Adresy e-mail są wyświetlane tak: <andi@splitbrain.org>.
+Linking to a specific section is possible, too. Just add the section name behind a hash character as known from HTML. This links to [[syntax#internal|this Section]].
+  This links to [[syntax#internal|this Section]].
+=== Linking to a specific sentence ===
-==== Interwiki ====
+Most articles in [[en:resources|resources]] are sentence disambiguated (by an algorithm). In practice, this means each sentence has a unique anchor you can directly link to. This is a useful feature for linking directly to specific proving symptoms or any sentence or part of an article you would like to direct our attention to.
-DokuWiki umożliwia tworzenie linków [[doku>pl: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]].
+The syntax is the same as in section linking, you just need to find the anchor number in the source of the article (click the Edit button) -- in order to know where to link to.
-  DokuWiki umożliwia tworzenie linków [[doku>interwiki|Interwiki]]. Są to szybkie linki
+For example, if you wish to link to a sentence where [[en:ahr:lippe-ad-the-homoeopathician-158-10568#s24|Dr. Lippe explains to us how to properly relate a successful cure]], you will do this as follows
-  do innych systemów Wiki. Na przykład to jest link do strony w Wikipedii na temat [[wp>Wiki]].
+  [[en:ahr:lippe-ad-the-homoeopathician-158-10568#s24|Dr. Lippe explains to us how to properly relate a successful cure]]
+Notes:
-==== Udziały sieciowe Windows ====
+  * Links to [[syntax|existing pages]] are shown in a different style from [[nonexisting]] ones.
+  * When a section's heading is changed, its bookmark changes, too. So don't rely on section linking too much -- use anchor linking, if possible.
+==== External ====
-Udziały sieciowe Windows, takie jak [[\\server\share|ten]], są także rozpoznawane. Proszę zauważyć że takie linki mają sens tylko w homogenicznych grupach użytkowników jak w korporacyjnym [[wppl>Intranet|intranecie]].
+External links are recognized automagically: http://www.google.com or simply www.google.com - You can set the link text as well: [[http://www.google.com|This Link points to google]]. Email addresses like this one: <contact@email.com> are recognized, too.
-  Udziały sieciowe Windows takie jak [[\\server\share|ten]] są także rozpoznawane.
+  DokuWiki supports multiple ways of creating links. External links are recognized
+  automagically: http://www.google.com or simply www.google.com - You can set
+  link text as well: [[http://www.google.com|This Link points to google]]. Email
+  addresses like this one: <contact@email.com> are recognized, too.
-Uwagi:
+DokuWiki supports [[doku>Interwiki]] links. These are quick links to other Wikis. For example this is a link to Wikipedia's page about Wikis: [[wp>Wiki]].
-  * 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").
+  DokuWiki supports [[doku>Interwiki]] links. These are quick links to other Wikis.
-  * W Mozilli i Firefox można tę funkcję uaktywnić za pomocą opcji [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]], lecz nie jest to zalecane.
+  For example this is a link to Wikipedia's page about Wikis: [[wp>Wiki]].
-  * Zobacz więcej szczegółów w [[bug>151]].
+==== Image Links ====
+You can also use an image to link to another internal or external page by combining the syntax for links and [[#images_and_other_files|images]] (see below) like this:
-==== Linki w grafice ====
+  [[http://www.homeopathy.net|{{wiki:dokuwiki-128.png}}]]
-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.homeopathy.net|{{wiki:dokuwiki-128.png}}]]
-  [[http://www.php.net|{{wiki:dokuwiki-128.png}}]]
+Please note: The image formatting is the only formatting syntax accepted in link names.
-[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]
+The whole [[#images_and_other_files|image]] and [[#links|link]] syntax is supported (including image resizing, internal and external images and URLs and interwiki links).
+===== Footnotes =====
-Uwaga: Formatowanie grafiki jest jedynym elementem składni, który można użyć w linkach.
+You can add footnotes ((This is a footnote)) by using double parentheses.
-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.
+  You can add footnotes ((This is a footnote)) by using double parentheses.
+===== Sectioning =====
-===== Przypisy =====
+You can use up to five different levels of headlines to structure your content. If you have more than three headlines, a table of contents is generated automatically -- this can be disabled by including the string ''<nowiki>~~NOTOC~~</nowiki>'' in the document.
-Można dodawać przypisy ((To jest przypis)) używając podwójnych nawiasów.
+==== Headline Level 3 ====
+=== Headline Level 4 ===
+== Headline Level 5 ==
-  Można dodawać przypisy ((To jest przypis)) używając podwójnych nawiasów.
+  ==== Headline Level 3 ====
+  === Headline Level 4 ===
+  == Headline Level 5 ==
-===== Podział na sekcje (tytuły) =====
+By using four or more dashes, you can make a horizontal line:
-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 ''<nowiki>~~NOTOC~~</nowiki>'' 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ę:
 ----
+===== Images and Other Files =====
+You can include external and internal [[doku>images]] with curly brackets. Optionally you can specify the size of them.
-===== Zdjęcia i inne pliki =====
+Real size:                        {{wiki:dokuwiki-128.png}}
-Możesz wstawić wewnętrzne lub zewnętrzne [[doku>images|zdjęcie]] za pomocą nawiasów klamrowych. Opcjonalnie można ustalić jego wielkość.
-Normalny rozmiar:                 {{wiki:dokuwiki-128.png}}
+Resize to given width:            {{wiki:dokuwiki-128.png?50}}
-Skalowane do podanej szerokości:  {{wiki:dokuwiki-128.png?50}}
+Resize to given width and height((when the aspect ratio of the given width and height doesn't match that of the image, it will be cropped to the new ratio before resizing)): {{wiki:dokuwiki-128.png?200x50}}
-Podana szerokość i wysokość:      {{wiki:dokuwiki-128.png?200x50}}
+Resized external image:           {{http://de3.php.net/images/php.gif?200x50}}
-Przeskalowana grafika zewnętrzna: {{http://de3.php.net/images/php.gif?200x50}}
+  Real size:                        {{wiki:dokuwiki-128.png}}
+  Resize to given width:            {{wiki:dokuwiki-128.png?50}}
+  Resize to given width and height: {{wiki:dokuwiki-128.png?200x50}}
+  Resized external image:           {{http://de3.php.net/images/php.gif?200x50}}
-  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 spacji z lewej lub prawej możesz odpowiednio wyrównać grafikę.
+By using left or right whitespaces you can choose the alignment.
 {{ wiki:dokuwiki-128.png}}
@@ Linia 156: / Linia 182: @@
   {{ wiki:dokuwiki-128.png }}
-Oczywiście można też dodać podpis (wyświetlany jako podpowiedź przez większość przeglądarek).
+Of course, you can add a title (displayed as a tooltip by most browsers), too.
-{{ wiki:dokuwiki-128.png |To jest podpis}}
+{{ wiki:dokuwiki-128.png |This is the caption}}
-  {{ wiki:dokuwiki-128.png |To jest podpis}}
+  {{ wiki:dokuwiki-128.png |This is the caption}}
-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.
+If you specify a filename (external or internal) that is not an image (''gif, jpeg, png''), then it will be displayed as a link instead.
-Składnia dla linków do [[#Linki w grafice|grafiki z innych stron]] opisana powyżej.
+For linking an image to another page see [[#Image Links]] above.
-===== Listy =====
+===== Lists =====
-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.
+Dokuwiki supports ordered and unordered lists. To create a list item, indent your text by two spaces and use a ''*'' for unordered lists or a ''-'' for ordered ones.
+  * This is a list
+  * The second item
+    * You may have different levels
+  * Another item
-  * To jest lista
+  - The same list but ordered
-  * To druga pozycja
+  - Another item
-    * Może być wiele poziomów wypunktowań
+    - Just use indentation for deeper levels
-  * Jeszcze jeden podpunkt
+  - That's it
-  - Ta sama lista, lecz numerowana
-  - Kolejny podpunkt
-    - Po prostu użyj wcięcia tekstu, by zaznaczyć poziom
-  - To jest to
 <code>
-  * To jest lista
+  * This is a list
-  * To druga pozycja
+  * The second item
-    * Może być wiele poziomów wypunktowań
+    * You may have different levels
-  * Jeszcze jeden podpunkt
+  * Another item
-  - Ta sama lista, lecz numerowana
+  - The same list but ordered
-  - Kolejny podpunkt
+  - Another item
-    - Po prostu użyj wcięcia tekstu, by zaznaczyć poziom
+    - Just use indentation for deeper levels
-  - To jest to
+  - That's it
 </code>
+Also take a look at the [[doku>faq:lists|FAQ on list items]].
-===== Konwersja tekstu =====
+===== Text Conversions =====
-DokuWiki może zamieniać określone, predefiniowane znaki lub ciągi znaków na grafikę lub inny tekst lub HTML.
+DokuWiki can convert certain pre-defined characters or strings into images or other text or 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.
+The text to image conversion is mainly done for smileys. And the text to HTML conversion is used for typography replacements, but can be configured to use other HTML as well.
-==== Emotikony ====
+==== Text to Image Conversions ====
-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 converts commonly used [[wp>emoticon]]s to their graphical equivalents. Those [[doku>Smileys]] and other images can be configured and extended. Here is an overview of Smileys included in DokuWiki:
   * 8-) %%  8-)  %%
@@ Linia 225: / Linia 251: @@
   * DELETEME %% DELETEME %%
+==== Text to HTML Conversions ====
+Typography: [[DokuWiki]] can convert simple text characters to their typographically correct entities. Here is an example of recognized characters.
-==== Typografia ====
-[[DokuWiki]] może konwertować proste oznaczenia tekstowe na poprawne typograficznie znaki. Oto przykłady rozpoznawanych kombinacji znaków:
 -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
@@ Linia 239: / Linia 263: @@
 </code>
-Uwaga: Ta konwersja może być wyłączona przez [[doku>config#typography|opcję konfiguracyjną]] lub [[doku>entities|plik wzorcowy?]].
+The same can be done to produce any kind of HTML, it just needs to be added to the [[doku>entities|pattern file]].
+There are three exceptions which do not come from that pattern file: multiplication entity (640x480), 'single' and "double quotes". They can be turned off through a [[doku>config:typography|config option]].
-===== Cytowanie =====
+===== Quoting =====
-Czasami chcesz zaznaczyć część tekstu by pokazać iż jest odpowiedzią lub komentarzem. Zastosuj wtedy następującą składnię:
+Some times you want to mark some text to show it's a reply or comment. You can use the following syntax:
-  Myślę, że powinniśmy tak zrobić.
+  I think we should do it.
+  > No, we shouldn't.
+  >> Well, I say we should.
+  > Really?
+  >> Yes!
-  > Nie, nie powinniśmy
+  >>> Then let's do it!
-  >> A moim zdaniem powinniśmy.
-  > Naprawdę?
-  >> Tak!
-  >>> Więc zróbmy tak!
-Myślę, że powinniśmy tak zrobić.
+I think we should do it.
-> Nie, nie powinniśmy
->> A moim zdaniem powinniśmy.
-> Naprawdę?
->> Tak!
->>> Więc zróbmy tak!
+> No, we shouldn't.
-===== Tabele =====
+>> Well, I say we should.
-DokuWiki posiada prostą składnię do tworzenia tabel.
+> Really?
-^ Nagłówek 1            ^ Nagłówek 2             ^ Nagłówek 3                ^
+>> Yes!
-| 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        |
-Kolumny tabeli powinny zaczynać się od ''|'' dla normalnych komórek i od ''^'' dla nagłówków.
+>>> Then let's do it!
-  ^ Nagłówek 1            ^ Nagłówek 2             ^ Nagłówek 3                ^
+===== Tables =====
-  | 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 zawsze masz tę samą ilość separatorów komórek w wierszu!
+DokuWiki supports a simple syntax to create tables.
-Można też utworzyć nagłówki wierszy w pionie.
+^ Heading 1      ^ Heading 2       ^ Heading 3          ^
+| Row 1 Col 1    | Row 1 Col 2     | Row 1 Col 3        |
+| Row 2 Col 1    | some colspan (note the double pipe) ||
+| Row 3 Col 1    | Row 3 Col 2     | Row 3 Col 3        |
-|               ^ Nagłówek 1                  ^ Nagłówek 2                ^
+Table rows have to start and end with a ''|'' for normal rows or a ''^'' for headers.
-^ 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 komórki decyduje o formatowaniu:
+  ^ Heading 1      ^ Heading 2       ^ Heading 3          ^
+  | Row 1 Col 1    | Row 1 Col 2     | Row 1 Col 3        |
+  | Row 2 Col 1    | some colspan (note the double pipe) ||
+  | Row 3 Col 1    | Row 3 Col 2     | Row 3 Col 3        |
-  |               ^ Nagłówek 1                  ^ Nagłówek 2                ^
+To connect cells horizontally, just make the next cell completely empty as shown above. Be sure to have always the same amount of cell separators!
-  ^ 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, poprzez umieszczenie '':::'' w komórkach znajdujących się poniżej tej, z którą chcemy je połączyć.
+Vertical tableheaders are possible, too.
-^ Nagłówek 1            ^ Nagłówek 2                    ^ Nagłówek 3                ^
+|              ^ Heading 1            ^ Heading 2          ^
-| Wiersz 1 Kolumna 1    | ta kolumna łączy się w pionie | Wiersz 1 Kolumna 3        |
+^ Heading 3    | Row 1 Col 2          | Row 1 Col 3        |
-| Wiersz 2 Kolumna 1    | :::                           | Wiersz 2 Kolumna 3        |
+^ Heading 4    | no colspan this time |                    |
-| Wiersz 3 Kolumna 1    | :::                           | Wiersz 2 Kolumna 3        |
+^ Heading 5    | Row 2 Col 2          | Row 2 Col 3        |
-Poza ww. składnią, komórki te nie mogą posiadać żadnej innej treści.
+As you can see, it's the cell separator before a cell which decides about the formatting:
-  ^ Nagłówek 1            ^ Nagłówek 2                    ^ Nagłówek 3                ^
+  |              ^ Heading 1            ^ Heading 2          ^
-  | Wiersz 1 Kolumna 1    | ta kolumna łączy się w pionie | Wiersz 1 Kolumna 3        |
+  ^ Heading 3    | Row 1 Col 2          | Row 1 Col 3        |
-  | Wiersz 2 Kolumna 1    | :::                           | Wiersz 2 Kolumna 3        |
+  ^ Heading 4    | no colspan this time |                    |
-  | Wiersz 3 Kolumna 1    | :::                           | Wiersz 2 Kolumna 3        |
+  ^ Heading 5    | Row 2 Col 2          | Row 2 Col 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ć.
+You can have rowspans (vertically connected cells) by adding '':::'' into the cells below the one to which they should connect.
+^ Heading 1      ^ Heading 2                  ^ Heading 3          ^
+| Row 1 Col 1    | this cell spans vertically | Row 1 Col 3        |
+| Row 2 Col 1    | :::                        | Row 2 Col 3        |
+| Row 3 Col 1    | :::                        | Row 2 Col 3        |
-^           Tabela z wyrównaniem           ^^^
+Apart from the rowspan syntax those cells should not contain anything else.
-|         prawo|    środek    |lewo          |
-|lewo          |         prawo|    środek    |
-| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
-Tak to wygląda w tekście źródłowym:
+  ^ Heading 1      ^ Heading 2                  ^ Heading 3          ^
+  | Row 1 Col 1    | this cell spans vertically | Row 1 Col 3        |
+  | Row 2 Col 1    | :::                        | Row 2 Col 3        |
+  | Row 3 Col 1    | :::                        | Row 2 Col 3        |
-  ^           Tabela z wyrównaniem           ^^^
+You can align the table contents, too. Just add at least two whitespaces at the opposite end of your text: Add two spaces on the left to align right, two spaces on the right to align left and two spaces at least at both ends for centered text.
-  |         prawo|    środek    |lewo          |
-  |lewo          |         prawo|    środek    |
-  | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
+^           Table with alignment           ^^^
+|         right|    center    |left          |
+|left          |         right|    center    |
+| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
+This is how it looks in the source:
+  ^           Table with alignment           ^^^
+  |         right|    center    |left          |
+  |left          |         right|    center    |
+  | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
-===== Fragmenty niesformatowane =====
+Note: Vertical alignment is not supported.
-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''.
+===== No Formatting =====
-<code>
+If you need to display text exactly like it is typed (without any formatting), enclose the area either with ''%%<nowiki>%%'' tags or even simpler, with double percent signs ''<nowiki>%%</nowiki>''.
-To fragment wcześniej sformatowanego kodu zawierającego spacje, które są zachowane               <-w ten sposób.
-</code>
-<file>
-Mniej więcej to samo; można używać do cytowania fragmentów pliku.
-</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>''.
 <nowiki>
-To jest fragment tekstu, który zawiera adres: http://www.splitbrain.org ale **formatowanie** tu nie występuje.
+This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it.
 </nowiki>
+The same is true for %%//__this__ text// with a smiley ;-)%%.
-Zobacz źródło tej strony żeby zobaczyć jak używać bloków.
+  <nowiki>
+  This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it.
+  </nowiki>
+  The same is true for %%//__this__ text// with a smiley ;-)%%.
+===== Code Blocks =====
-===== Podświetlanie składni =====
+You can include code blocks into your documents by either indenting them by at least two spaces (like used for the previous examples) or by using the tags ''%%<code>%%'' or ''%%<file>%%''.
-[[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>''.
+  This is text is indented by two spaces.
-<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.
-    }
-}
-</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//
-===== 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:
 <code>
-<html>
+This is preformatted code all spaces are preserved: like              <-this
-To jest trochę kodu <font color="red" size="+1">HTML</font>
-</html>
 </code>
-<html>
+<file>
-To jest trochę kodu <font color="red" size="+1">HTML</font>
+This is pretty much the same, but you could use it to show that you quoted a file.
-</html>
+</file>
-<code>
+Those blocks were created by this source:
-<php>
-echo 'A logo generated by PHP:';
-echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
-</php>
-</code>
-<php>
+    This is text is indented by two spaces.
-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.
+  <code>
+  This is preformatted code all spaces are preserved: like              <-this
+  </code>
+  <file>
+  This is pretty much the same, but you could use it to show that you quoted a file.
+  </file>
-===== Wtyczki składni =====
+===== Control Macros =====
-Składnia DokuWiki może być rozszerzona przez [[doku>plugins|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:
+Some syntax influences how DokuWiki renders a page without creating any output it self. The following control macros are availble:
-~~INFO:syntaxplugins~~
+^ Macro           ^ Description |
+| %%~~NOTOC~~%%   | If this macro is found on the page, no table of contents will be created |
+| %%~~DISCUSSION:off~~%%   | If this macro is found on the page, no discussion at the end of the page will be created |
+| %%~~NOCACHE~~%% | DokuWiki caches all output by default. Sometimes this might not be wanted (eg. when the %%<php>%% syntax above is used), adding this macro will force DokuWiki to rerender a page on every call |
-===== Tłumaczenie strony =====
-Dodaj swój e-mail jeżeli utworzyłeś, przetłumaczyłeś lub zmodyfikowałeś fragment tej strony:
-  * //[[wkazimierczak@conforama.pl|Wojciech Kazimierczak]] 2007/07/15 21:32//
-  * //[[easynet2@interia.pl|CreaThor]] 2008/06/05 12:15//

Legatum Homeopathicum

Narzędzia użytkownika

Narzędzia witryny

Różnice

Narzędzia strony