Spis treści
Instrukcja edytowania
Ta strona zawiera najważniejsze zasady i składnię, które pomogą Ci edytować artykuły w Strategopedii.
Nie musisz znać wszystkiego — wystarczy kilka podstaw, by tworzyć czytelne i wartościowe treści.
Akapity
Akapity rozdzielone są pustą linią:
To jest pierwszy akapit. To już drugi.
Efekt:
To jest pierwszy akapit.
To już drugi.
Nowa linia zrobiona pojedynczym "enterem" nie zadziała.
Efekt:
Nowa linia zrobiona pojedynczym „enterem” nie zadziała.
W wyjątkowych sytuacjach można wymusić nową linię\\ bez nowego akapitu przez użycie ''\\'' na końcu linii.
Efekt:
W wyjątkowych sytuacjach można wymusić nową linię
bez nowego akapitu przez użycie \\ na końcu linii.
Ale należy raczej używać akapitów lub list.
Nagłówki (tytuły sekcji)
Można używać do pięciu poziomów tytułów by nadać treści strony strukturę hierarchiczną.
====== Nagłówek najwyższego poziomu ======
Po sześć znaków = po obu stronach to nagłówek najwyższego poziomu, taki jak tworzący tytuł tego artykułu.
===== Nagłówek niższego poziomu =====
Pięć znaków = to nagłówek drugiego poziomu, taki jak tworzący tytuł tej sekcji „Nagłówki (tytuły sekcji)”.
Nagłówek najniższego (piątego) poziomu tworzą po dwa znaki = po obu stronach tytułu.
Spis treści
Jeśli strona zawiera co najmniej cztery nagłówki, DokuWiki automatycznie doda spis treści na jej początku.
Aby temu zapobiec, wystarczy umieścić w dowolnym miejscu strony specjalny znacznik: ~~NOTOC~~.
Listy
Każdy element listy musi być poprzedzony co najmniej dwoma spacjami przed znakiem * (lista punktowana) lub - (lista numerowana).
Podpunkty to kolejne dwie spacje.
Lista punktowana:
* Punkt pierwszy
* Punkt drugi
* Podpunkt
Efekt:
- Punkt pierwszy
- Punkt drugi
- Podpunkt
Lista numerowana (numery pojawią się automatycznie):
- Punkt pierwszy
- Punkt drugi
- Podpunkt
- Punkt trzeci
Efekt:
- Punkt pierwszy
- Punkt drugi
- Podpunkt
- Punkt trzeci
Formatowanie
**pogrubiony tekst** pogrubiony tekst
//kursywa// kursywa
''monospace'' monospace
Można stosować ''**//kombinacje//**'' kombinacje
Katalogi (przestrzenie nazw)
Struktura DokuWiki
W DokuWiki każda strona, poza stroną główną /start, znajduje się w tzw. katalogu (czyli przestrzeni nazw) — działa to podobnie jak foldery i pliki na komputerze. Pomaga to porządkować treści, np. wszystkie strony dotyczące jednej gry mogą znajdować się w osobnym katalogu.
Przykład:
http://pl.strategopedia.testingmagic.ovh/gry/shadow-empire/poradnik
Tutaj:
gryto katalog główny (np. wszystkie gry),shadow-empireto podkatalog (czyli konkretna gra),poradnikto strona w katalogu tej gry.
Konwencja używana w adresach na Strategopedii
Na Strategopedii przyjęliśmy następującą konwencję tworzenia adresów stron w przeglądarce (czyli tego, co widzisz w pasku adresu):
- Slash (
/) jako separator katalogów, zamiast domyślnego dwukropka (:), - Małe litery w nazwach katalogów i stron,
- Łącznik (
-) zamiast spacji i podkreślników (_) — np.panzer-general-2, niePanzer_General_2.
Strony startowe katalogów
Teoretycznie możliwe jest, by jednocześnie istniały katalog i strona o tych samych nazwach. Jednak na Strategopedii nie chcemy takich sytuacji, ponieważ utrudnia to nawigację.
Zamiast tego każdy katalog powinien mieć swoją stronę startową. Adres takiej strony to zawsze start, poprzedzony oczywiście ewentualnymi katalogami oddzielonymi znakami /.
Na Strategopedii strony startowe katalogów pełnią funkcję stron głównych dla działów lub danej gry, i powinny zawierać np. opis gry, spis treści i odnośniki do podstron.
Tworzenie stron i katalogów
Strony możesz tworzyć na dwa sposoby:
- przez kliknięcie w link do nieistniejącej strony – zalecana metoda,
- przez wpisanie adresu nieistniejącej strony bezpośrednio w pasku przeglądarki.
Jeśli katalogi i podkatalogi w adresie strony jeszcze nie istnieją, zostaną utworzone automatycznie.
Usuwanie stron i katalogów
Aby usunąć stronę, po prostu ją wyczyść i zapisz pustą – system potraktuje to jako usunięcie.
Katalogi nie są „usuwalne” bezpośrednio – po prostu znikają automatycznie, jeśli nie zawierają żadnych stron.
Linki
Wewnętrzne
Aby utworzyć odnośnik do innej, nawet nie istniejącej, strony wewnątrz wiki, użyj składni:
[[/Gry/Shadow Empire/Poradnik]]
Efekt:
Pamiętaj, że nie da się stworzyć pustego katalogu. Ostatni człon linku po ostatnim znaku / zawsze zostanie potraktowany jako nazwa strony.
Znak / na samym końcu linku zostaje automatycznie zamieniony na /start w adresie.
Przykład:
[[/Gry/Shadow Empire/]] jest równoznaczne z [[/Gry/Shadow Empire/Start]].
Konwencja zapisu linków na Strategopedii
Dla lepszego wyglądu stosuj spacje do oddzielania wyrazów oraz wielkie litery tak, jakby każdy katalog i strona były tytułami (odpowiednio polskim lub angielskim). Rzeczywisty adres będzie miał same małe litery i znak łącznika (-) zamiast spacji.
[[/Gry/Shadow Empire/Poradnik]]
Efekt:
Można też stosować niestandardowe litery spoza angielskiego alfabetu. W adresie zostaną one zamienione na litery bez znaków diakrytycznych.
[[Midgård]]
Efekt (najedź kursorem, by zobaczyć adres):
Nie pisz jawnie Start jako nazwa strony. Stosuj znak / na końcu.
[[/Gry/Shadow Empire/]]
Efekt (sprawdź adres, najeżdżając kursorem na link):
Zewnętrzne
Linki do zewnętrznych stron są przekształcane automatycznie:
https://www.google.com/
Efekt:
Z dowolnym tekstem:
[[https://www.google.com/|Jakaś wyszukiwarka]]
Efekt:
Grafiki
Najpierw wgraj plik graficzny na serwer, używając przycisku Dodaj obrazek lub inny plik (zalecany sposób). Możesz też użyć Menadżera multimediów, jednak pamiętaj, żeby ustawić wtedy właściwy katalog.
Najlepiej korzystać z własnoręcznie przygotowanych grafik, np. schematów, diagramów lub ilustracji stworzonych na potrzeby artykułu.
Zalecamy ograniczenie użycia zrzutów ekranu z gier. Jeśli naprawdę są konieczne, przestrzegaj poniższych zasad:
- Używaj tylko fragmentów (np. wycinków z kadrowaniem),
- Stosuj niską rozdzielczość (wystarczającą do przekazu),
- Użyj formatu jpeg,
- W opisie (pod obrazkiem) podaj:
- tytuł gry,
- wydawcę,
- informację w jakim celu grafika została użyta.
Przykładowy opis: „Zedytowany zrzut ekranu z gry *Shadow Empire*, wyd. Slitherine, użyty w celach edukacyjnych.”,
W ten sposób Strategopedia może zachować swój legalny charakter.
Więcej informacji
Szczegółowa składnia: https://www.dokuwiki.org/pl:wiki:syntax
Miłego edytowania!