PL:Przewodnik po Psi Wiki
From PsiWiki
Ten dokument opisuje:
- Wymagania i ograniczenia dotyczące dodawania i edycji informacji w Psi Wiki.
- Możliwości Psi Wiki.
Contents |
Ogólne wymagania i ograniczenia
- Wszelkie edycje i komentarze mogą być dokonywane wyłącznie przez zarejestrowanych i zalogowanych użytkowników Wiki
- Korzystaj z linku Edytuj tę stronę wyłącznie do uaktualniania lub korekty zawartości artykułu.
- Korzystaj z linku Dyskusja jeśli chcesz porozmawiać lub skomentować zawartość artykułu.
Nie umieszczaj swoich komentarzy, pytań czy uwag w samej treści artykułu.
Struktura
Punkt #Tworzenie odnośników opisuje sposób tworzenia odnośników wewnątrz i pomiędzy dokumentami.
- Skategoryzowana instrukcja użytkownika - Zbiór kategorii zbierających różnorodne informacje na temat Psi:
- Terminologia związana z Jabberem, XMPP i oczywiście Psi
- Interfejs użytkownika
- Możliwości
- Instrukcja użytkownika - Dokument łączący różnorodne dokumenty ze Skategoryzowanej instrukcji użytkownika.
- Instrukcja instalacji - Zawiera informacje o instalacji Psi w różnych systemach operacyjnych.
Tworzenie odnośników
Pod żadnym pozorem nie dopuszcza się tworzenia odnośników do części przewodnika użytkownika.
Odnajdź artykuł ze skategoryzowanego przewodnika użytkownika, który zawiera treść, do której chcesz utworzyć odnośnik. Utwórz odnośnik do odnalezionego artykułu.
- Dzięki temu łatwiej jest zarządzać informacjami a nawet je przenosić.
- Dowolny wyspecjalizowany artykuł może zostać szybciej odnaleziony i wyświetlony niż gdyby się znajdował w scalonym przewodniku użytkownika.
Szablony/wzorce
Pokrótce: Szablony pozwalają wstawiać pewne formatowanie tekstu wewnątrz artykułów. Dłuższy opis można znaleźć tutaj (w języku angielskim).
Psi Wiki ma w chwili obecnej zdefiniowane następujące szablony:
- {{stub}} - Ten szablon dodaje informację, że dany artykuł jest nieukończony. (przykład)
- {{todo|Treść do zrobienia}} - Ten szablon dodaje informację, co należy jeszcze zrobić w danym artykule. Treść takiej informacji nie może zawierać odnośników. Przykład:
TODO: Dokończyć tłumaczenie Psi Wiki na język polski
Odnośniki InterWiki
Więcej informacji o odnośnikach InterWiki można znaleźć tutaj.
Psi Wiki wspiera następujące specjalne odnośniki InterWiki:
- [[FS:FlySprayNumber]] - Odnośnik do zgłoszenia błędu o numerze FlySprayNumber w FlySpray, naszym systemie zgłaszania błędów
- [[JEP:####]] - Odnośnik do JEP numer #### (należy uzupełnić numer JEPa wiodącymi zerami do 4 cyfr)
Kruczki i sztuczki (Tips & Tricks)
Artykuł Kruczki i sztuczki zawiera tłumaczenia wszystkich kruczków i sztuczek znajdujących się w Poradzie dnia w Psi. Ta strona ma służyć dodawaniu nowych sztuczek i ulepszaniu już istniejących.
Zawartość tego artykułu jest analizowana przy użyciu skryptu na kod C++, który następnie jest dołączany do źródeł Psi. Aby analiza się powiodła, zawartość artykułu musi spełniać ścisłe kryteria.
Kod Wiki, który musi być kopiowany dla każdego nowego kruczka i sztuczki jest następujący:
<div style="padding: .4em .9em .4em; border: 1px solid rgb(170, 170, 170); color: #000; background: rgb(249, 249, 249); margin-bottom: .9em ">
TREŚĆ KRUCZKA LUB SZTUCZKI
<br /><br /><em>Contributed by Dane osoby nadsyłającej</em>
</div>
Uwagi:
- Linia zawierająca dane osoby nadsyłającej może zostać pominięta (wraz z dwoma znacznikami <br />).
- Treść kruczka lub sztuczki 'nie może zawierać znaczników <div>.
Przykładowy fragment kodu Wiki jest umieszczony również na końcu źródła artykułu (w komentarzu). Można go skopiować i używać jako podstawy do dodania nowego kruczka lub sztuczki.
Inne Wiki
Oto kilka przykładów innych udanych i dobrze zorganizowanych Wiki opartych o silnik MediaWiki. Dobrze by było naśladować ich najlepsze strony:

