Codex

dla autorów

<< | Indeks dukumentacji (en) | >>

Tutejsze strony są stronami WikiWikiWeb, co oznacza, że mogą być tworzone i edytowane przez wielu autorów. Aby edytować stronę, kliknij link Edytuj, który jest gdzieś na stronie, zwykle w nagłówku, lub stopce. Pewne strony mogą być zabezpieczone hasłem, zależnie od zasad bezpieczeństwa przyjętych w danym systemie, ale wiele systemów zezwala na otwartą edycję stron.

Kiedy edytujesz stronę, widzisz znaczniki, które opisują jej zawartość. Podstawowe zasady znakowania są dość proste:

  1. Umieszczaj pustą linię pomiędzy akapitami.
  2. Lista: zacznij każdą linię od #, jeśli lista ma być numerowana, albo *, jeśli punktowana.
  3. Nagłówek: zacznij linię od dwóch, albo więcej znaków !; im więcej tym mniejszy nagłówek.
  4. Wyróżnienie: na końcach wpisz 2, albo 3 apostrofy - tak będzie ''kursywa'', a tak '''wytłuszczenie'''.
  5. Link do innej strony: umieść jej nazwę w podwójnych nawiasach kwadratowych, np. [[inna strona]]. Linki do nieistniejących stron? są pokazywane w specjalny sposób, by zaprosić do ich edycji.
  6. Link do strony WWW: wystarczy wpisać jej adres, np. http://www.example.com/ .

Jeśli chcesz eksperymentować z edycją, rób to w Piaskownicy. Możesz edytować Piaskownicę bez wpływania na cokolwiek ważnego tutaj. Jeśli edytujesz inne strony, wskazane jest podpisanie swojego wkładu do nich - użycie ~~~ umieszcza nazwę, którą wpiszesz w polu Autor poniżej okienka do edycji.

Przykłady

Tabela poniżej pokazuje wiele powszechnie stosowanych znaczników używanych do formatowania stron. Lewa kolumna pokazuje wynik działania znacznika, prawa - co napisać, aby taki wynik uzyskać. Więcej szczegółów jest opisanych w text formatting rules Zasadach Formatowania Tekstu i innych stronach z dokumentacją. Wyczerpująca lista znakowań jest podana w głównym skorowidzu znakowań.

Wygląd ogólny

Jak to wygląda

Jak to napisać

Pusta linia

zaczyna nowy akapit.

Pojedyncze przejście do nowej linii zwykle nie zmienia rozmieszczenia. Użyj dwóch lewych ukośników
aby podzielić linię.

Pojedynczy lewy ukośnik dołącza następną linię do poprzedniej.

Użyj trzech lewych ukośników

aby podzielić z podwójnym odstępem.

  • Listy tworzy się używając gwiazdek
    • Więcej gwiazdek daje głębsze listy
      • Lista jest kończona

przez pierwszą linię, która nie ma znaku listy.

  1. Numerowane listy
  2. też są możliwe
    • i listy można zagnieżdżać.
Strzałka (->) daje wcięcie zawartości.
Linia napisana z równa z tą z wcięciem kontynuuje je.
Dłuższa strzałka (-->) wcina głębiej.
Odwrócona strzałka (-<) robi wcięcie, które nie działa na pierwszą linię ale na dalsze.
Dłuższa odwrócona strzałka wcina głębiej. Oczywiście te dalsze linie.
Lista definicji
lista: element / definicja
element
definicja elementu
inny element
definicja tegoż

Linie zaczynające się od spacji są formatowane dokładnie tak, jak napisane, fontem o stałej szerokości.

Zauważ, że bardzo długie linie takiego preformatowanego tekstu mogą spowodować, że cała strona będzie szeroka.

Ten tekst jest wycentrowany.

Ten tekst jest dosunięty w prawo.

Cztery minusy lub więcej na początku linii


robią linię poziomą.

Linki

Jak to wygląda

Jak to napisać

Ćwicz edytowanie w wiki sandbox.

  • Tekst w podwójnym nawiasie kwadratowym staje się linkiem do innej strony.
  • Słowa są automatycznie zaczynane z dużej litery w tytułach stron.

Ćwicz edytowanie w wiki sandbox.

A w którym? W Main.WikiSandbox.

  • Gdy linkujesz to strony w innej wikigrupie, podaje nazwę grupy, po niej separator, i nazwę strony.
  • Jeśli tym separatorem jest ukośnik, pokaże się tylko nazwa strony.
  • Jeśli tym separatorem jest kropka, pokaże się pełna nazwa.

Ćwicz edytowanie w miejscu do ćwiczeń.

Ćwicz edytowanie w miejscu do ćwiczeń.

Ćwicz edytowanie w miejscu do ćwiczeń.

  • Tekst po kresce pionowej (|) jest pokazywany zamiast linku; alternatywnie (i może bardziej zrozumiale) można pisać: tekst -> link).

Ćwicz edytowanie w piaskownicach.

Po angielsku: sandbox.

  • Przyrostki stają się częścią tekstu linku.
  • Nawiasy ukrywają część nazwy linku.

Swoją drogą, co to jest aardvark?

  • Pmwiki może używać przedrostków InterMap mających specyficzne znaczenie.
  • Nawiasy mogą ukrywać również te przedrostki.

Linki do zewnętrznych stron mogą być wpisywane jako:

  1. sam URL: http://google.com
  2. link z tekstem: Google
  3. jako odsyłacz: [1]

Link może się otwierać w nowym oknie, jak w http://www.pmwiki.org.

Formatowanie znaków

Kursywa, wytłuszczenie, kursywa wytłuszczona.

  • Tu wszędzie są apostrofy (pojedyńcze), nie cudzysłowy (podwójne).

Tekst o stałej szerokości czcionki

[@To jest preformatowany blok tekstu@]

  • Tekst przesunięty w górę
  • Tekst przesunięty w dół
  • Tekst skasowany przekreślony
  • Tekst wstawiony podkreślony
  • Tekst duży i większy
  • Tekst mały i mniejszy

WikiStyles pozwalają, aby tekst był w różnych kolorach.

  • Używaj małych liter w kolorach RGB (#ff7f00, nie #FF7F00).

Nagłówki i bloki

Główny pod-nagłówek

Główny pod-nagłówek mniejszą czcionką

Pod-pod-nagłówek

I dalsze

Pod-...-nagłówki
  • Nagłówki są użyteczne do określenia hierarchicznej struktury strony. To nie jest tylko napisanie większą czcionką.
Tytuły stron

Nie są pokazywane w miejscu zdefiniowania

  • (:title:) może ustawić tytuł strony inny, niż jej nazwa.
Style bloków

Cały tekst w tym bloku jest pomarańczowy.

  • Pomarańczowe niebo
  • Pomarańczowe morze
  • Pomarańczowa zieleń
  • A teraz lista jest purpurowa,
  • a teraz niebieska i wycentrowana,
  • teraz dosunięta w prawo,
  • i wreszcie normalna.
  • Uwaga: to zostało zrobione inaczej - pokazany sposób może nie działać w tabeli.

<< | Indeks dokumentacji (en) | >>

Jestem nowicjuszem w PmWiki, gdzie znajdę podstawowe rady jak zacząć?

Ta strona (albo po angielsku: Basic Editing) jest dobra na początek. Dalszych informacji możesz szukać na stronach Indeksu dokumentacji (w języku angielskim), które zawierają listę istotnych stron dokumentacji, zorganizowany od podstawowych do zaawansowanych, lub w Głównym indeksie znaczników (także j.ang.).

Jak wstawić znaki specjalne na stronie wiki?

Użyj ich kodów - special characters zawiera ich listę - jak Copyright (© = &#169;) i Trademark (® albo ™ = &#174; &#8482;) (znaki, których nie ma na klawiaturze).

Jak utworzyć nową stronę?

Najpierw na istniejącej stronie - można w nawet Piaskownicy, ale raczej warto mieć tę nową stronę dolinkowaną - utwórz link; zostanie on pokazany ze znakiem zapytania po zapisaniu tej strony - kliknięcie na link pozwoli na edycję nowej strony. Inny sposób, to podmienić nazwę strony w URL pokazywanym przez przeglądarkę i wcisnąć Enter, po czym będzie można kliknąć Edit i napisać tę nową stronę.