====== 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:

<code>
  * Punkt pierwszy
  * Punkt drugi
    * Podpunkt
</code>

Efekt:

  * Punkt pierwszy
  * Punkt drugi
    * Podpunkt

Lista numerowana (numery pojawią się automatycznie):

<code>
  - Punkt pierwszy
  - Punkt drugi
    - Podpunkt
  - Punkt trzeci
</code>

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:
  * ''gry'' to katalog główny (np. wszystkie gry),
  * ''shadow-empire'' to podkatalog (czyli konkretna gra),
  * ''poradnik'' to 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'', nie ''Panzer_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:

[[/Gry/Shadow Empire/Poradnik]]

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:

[[/Gry/Shadow Empire/Poradnik]]

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):

[[Midgård]]

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):

[[/Gry/Shadow Empire/]]

==== Zewnętrzne ====

Linki do zewnętrznych stron są przekształcane automatycznie:

''%%https://www.google.com/%%''

Efekt:

https://www.google.com/

Z dowolnym tekstem:

''%%[[https://www.google.com/|Jakaś wyszukiwarka]]%%''

Efekt:

[[https://www.google.com/|Jakaś wyszukiwarka]]

===== 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!