Współpraca przy Wiki
From Mandriva Poland
To wiki jest ciągle w trakcie budowy, więc każdy może pomóc je rozwijać. Twoja pomoc jest potrzebna. Możesz ułatwić życie wielu użytkownikom oraz zyskać satysfakcję i uznanie.
Jeśli chcesz pomóc:
- zobacz listę stron do opracowania,
- zobacz listę stron do korekty,
- zapoznaj się z poniższymi zasadami
- załóż konto na potrzeby Wiki
- aby się dołączyć skontaktuj z Tomkiem (tomasz.bednarski ( na ) mandriva.pl lub przez Jabber t.bednarski ( na ) jabber.mandriva.pl)
- zapisz się na listę dyskusyjną i napisz do nas ! :-)
Spis treści
|
[edytuj] Tworzenie i edytowanie stron
Wszystkie informacje na temat edytowania stron wiki są dostępne na stronach wikimedia w kilku różnych językach (niestety nie po polsku).
Oto kilka ogólnych zasad, według których tworzone są nasze strony wiki:
[edytuj] Tworzenie nowej strony
Kiedy chcemy utworzyć nową stronę, musimy pamiętać o następujacych zasadach:
- Strony mają mieć nazwy (adresy), które są krótkie i zwięzłe. Nie należy stosować nazw w stylu "Nagrywanie obrazów płyt z systemem Mandriva Linux za pomocą programu XXX", tylko po prostu "Nagrywanie obrazów płyt". Trzeba też wiedzieć, że odstępy (spacje) w adresie oznaczone przez podkreślenie ("_") będą w nazwie po prostu spacjami.
- Zanim stworzymy nową stronę, należy się upewnić czy nie istnieje już inna o podobnym temacie
- Podczas układania nazwy strony, należy sprawdzić jak nazywają się inne strony o podobnej tematyce. Na przykład: stronę na temat wydania 2008.0 systemu nazywamy "Mandriva 2008.0" a nie "2008.0". Tu polecam stronę Specjalna:Allpages.
- Przyjęliśmy, że na stronach wiki Mandrivy nie będą już stosowane "drzewa" w adresach, a zamiast tego strony będą grupowane po kategoriach. Oznacza to tyle, że strona nie będzie nazwana (czyli część jej adresu po "/pl/" nie będzie brzmiała) "/Dokumentacja/Poradniki/Obsługa programu XXX", tylko będzie to "Obsługa programu XXX", a do strony zostaną dodane odnośniki do kategorii Poradniki (która jest podkategorią kategorii Poradniki). Uwaga! To tylko przykład ;) Na naszym wiki nazwy kategorii mogą być inne.
Informacje na temat kategorii i ich stosowania są dostępne niżej na tej stronie, w dziale "Kategorie".
[edytuj] Tłumaczenia
Duża część tekstów na Wiki to tłumaczenia z wersji angielskiej. Przed tłumaczeniem zapoznaj się koniecznie z następującym poradnikiem:
Korzystaj także ze słowników:
Bardzo przydatne źródła. Postępuj zgodnie z zasadami w tych artykułach. W razie wątpliwości pisz na listę dyskusyjną.
Ważne
Jeżeli tłumaczysz tekst opisujący sposób używania oprogramowania to tłumacząc nazwy elementów interfejsu (np. Naciśnij przycisk "Aktualizuj") sprawdź koniecznie jak w rzeczywistości dana opcja się nazywa w programie. Unikniemy w ten sposób niezgodności między opisem a programem.
[edytuj] Tytuły stron
Każda strona zaczyna się od tytułu, który jest zaznaczony niebieską, powiększoną czcionką z żółtym podkreśleniem. Aby osiągnąć ten efekt, wystarczy skorzystać z szablonu tytuł. W praktyce, na górze strony wystarczy wpisać:
{{tytuł|Strona na temat czegośtam}}
aby uzyskać następujący efekt: [edytuj] Kategorie
Strony w wiki są podzielone na kategorie. Lista aktualnie utworzonych kategorii jest dostępna na stronie Specjalna:Categories. Każda strona utworzona w wiki musi być przypisana do jakiejś kategorii (wyjątkami są strony: Nowości, Wywiad z... i Strona główna). Jeżeli strona, którą tworzysz nie pasuje do żadnej istniejącej kategorii, utwórz nową. Chyba, że twoja strona dotyczy ogólnej tematyki związanej z systemem (tak, jak na przykład strona Wybierz_odpowiednią_wersję - wtedy przypisz ją po prostu do kategorii System.
Aby przypisać stronę do kategorii, wystarczy na górze strony (pod tytułem) albo na końcu (pod całym tekstem) wpisać:
[[Kategoria:jakaś kategoria]]
W ten sposób dana strona zostanie przypisana do kategorii jakaś kategoria, na dole pokaże się spis kategorii, do których przypisano stronę, a jej nazwa będzie wyświetlana w spisie stron z kategorii (czyli po otwarciu strony http://wiki.mandriva.com/pl/Kategoria:Jakaś_kategoria).
Ta strona (którą czytasz w tym momencie) jest przypisana do kategorii Pomoc.
Należy pamiętać, że niektóre kategorie są podkategoriami innych kategorii - na przykład kategorie Oprogramowanie i Wydania są podkategoriami kategorii System, w związku z tym kiedy dodajemy stronę do kategorii Wydania, nie musimy już dodawać jej do System.
[edytuj] Szablony
Szablony są to wcześniej ustalone sposoby w jaki mają wyglądać pewne elementy naszych stron. Są onə stosowane w omawianym już tytule strony.
Aby użyć szablonu do tekstu na stronie wystarczy wpisać:
{{nazwa_szablonu|Tekst w którym chcemy użyć szablonu}}
Lista wszystkie dostępnych szablonów wraz z opisami użycia jest dostępna poniżej:
[edytuj] Spis szablonów
- Szablon:Bug - stosowany do oznaczania numerów błędów (bugów) w systemie i aplikacjach. Szablon często stosowany na stronach errat do systemu.
- Szablon:File - używany do wyróżniania nazw plików,
- Szablon:Media - do oznaczania nazw repozytoriów, np. /main/release,
- Szablon:Pkg - oznacza nazwy pakietów systemu,
- Szablon:Prog - oznacza nazwy programów,
- Szablon:Tytuł - stosowany do tytułów stron. Każda strona powinna na samym początku zawierać tytuł!
- Szablon:Cmd - stosowany do oznaczania komend, np. cp plik1 plik2
- Szablon:Advisory - używany do oznaczania numeru Alertów bezpieczeństwa. Automatycznie tworzy odnośnik do alertu na stronie mandriva.com/security/advisories. Jako argument (po "advistory|") należy podać numer alertu!
- Szablon:Menu - stosowany do zaznaczania pozycji/kategorii menu systemowego.
- Szablony specjalne:
- Szablon:Nowości - szablon stosowany nie do wyświetlania zadanego tekstu, lecz jako integralna część strony głównej.
[edytuj] Inne wersje językowe
Kiedy tworzymy nową stronę, dobrym nawykiem jest sprawdzenie czy strona o podobnym temacie nie istnieje także już na stronach wiki w innych językach (na przykład angielskim czy francuskim). Jeśli tak - dobrze jest dodać taką stronę jako alternatywę dla naszej. To samo dotyczy stron tłumaczonych z wiki Mandrivy w innym języku - wtedy jednak trzeba dodać taką stronę, jako inną wersję językową tej, którą tworzymy.
Aby to zrobić, wystarczy skopiować adres takiej strony (np. 2008.1_Notes) i dodać (najlepiej przed lub po kategoriach, które stosujemy do naszej strony) w następujacy sposób:
[[en:2008.1_Notes]]
Ogólny "wzór" na dodawanie innych wersji językowych to: język:adres strony.
[edytuj] Rady przy przenoszeniu stron z wiki angielskiego/francuskiego/...
Kiedy kopiujemy stronę, z wiki Mandrivy w innym języku, należy pamiętać o:
[edytuj] Kategorie
Zmianie przypisania do danej kategorii - w wiki w innych językach słowo "Kategoria" brzmi inaczej niż po polsku ;) Dlatego np. w wiki angielskim strony są przypisane do kategorii poprzez[[Category:XXX]]W naszym wiki, stosujemy nazewnictwo polskie, toteż należy pamiętać aby słowo "Category" zmienić na "Kategoria":
[[Kategoria:XXX]]
[edytuj] Szablony
Większość szablonów stosowanych na wiki angielskim, jest dostępna także na naszym wiki. Trzeba jednak zwrócić uwagę, że niektóre z nich mają inne nazwy (angielski szablon "title" u nas nazywa się "tytuł", tak samo jako "version" i "wersja").
Podczas poglądu tworzonej strony na dole pod polem edycji pojawia się zawsze spis wszystkich szablonów wykorzystanych na stronie - należy sprawdzić czy wszystkie istnieją lub czy są dostępne ich polskie odpowiedniki. Polecam tutaj, dostępny wyżej na stronie, spis wszystkich naszych szablonów.
[edytuj] Inne języki
Podczas przenoszenia strony (przez proste kopiuj/wklej) przenosimy także jej odnośniki co innych wersji językowych (co jest bardzo pożądane), jednak zapominamy o dodaniu adresu do strony, którą kopiujemy! Trzeba pamiętać, aby po skopiowaniu strony, dodać do spisu jej odpowiedników w innych językach, także ten język, z którego kopiujemy!
[edytuj] Informacje, że strona jest niedokończona, nieprzetłumaczona...
Kiedy strona, nad którą pracujemy nie jest dokończona lub nie jest do końca przetłumaczona, polecamy stosowanie odpowiednich informacji, w postaci ramek na górze strony. Aktualnie stosowane przez nas to:
| Możesz zostać opiekunem tej strony! | |||
|---|---|---|---|
| Ta strona szuka swojego opiekuna. Jeżeli chcesz pomóc użytkownikom obejmij tę stronę opieką i dbaj o jej aktualizowanie! Skontakuj z Tomkiem (tomasz.bednarski ( na ) mandriva.pl) | |||
KOD:
{|style="-moz-border-radius:10px; padding:1em; width:100%; border:2px solid #30529f;"
!style="color: #30529f; font-size: 120%; text-align:left;" colspan="4"|Możesz zostać opiekunem tej strony!
|-
|Ta strona szuka swojego opiekuna. Jeżeli chcesz pomóc użytkownikom obejmij tę stronę opieką i dbaj o jej aktualizowanie! Skontakuj z Tomkiem (tomasz.bednarski ( na ) mandriva.pl)
|}
| Strona w trakcie budowy! | |||
|---|---|---|---|
| Ta strona jest ciągle niedokończona i zawiera niekompletne informacje. | |||
KOD:
{|style="-moz-border-radius:10px; padding:1em; width:100%; border:2px solid #30529f;"
!style="color: #30529f; font-size: 120%; text-align:left;" colspan="4"|Strona w trakcie budowy!
|-
|Ta strona jest ciągle niedokończona i zawiera niekompletne informacje.
|}
| Strona w trakcie tłumaczenia! | |||
|---|---|---|---|
| Ta strona jest ciągle tłumaczona i zawiera informacje w innym języku. | |||
KOD:
{|style="-moz-border-radius:10px; padding:1em; width:100%; border:2px solid #30529f;"
!style="color: #30529f; font-size: 120%; text-align:left;" colspan="4"|Strona w trakcie tłumaczenia!
|-
|Ta strona jest ciągle tłumaczona i zawiera informacje w innym języku.
|}
| Strona w korekty językowej! | |||
|---|---|---|---|
| Trwa korekta językowa tej strony. Strona może ona zawierać błędy. | |||
KOD:
{|style="-moz-border-radius:10px; padding:1em; width:100%; border:2px solid #30529f;"
!style="color: #30529f; font-size: 120%; text-align:left;" colspan="4"|Strona w trakcie korekty językowej!
|-
|Trwa korekta językowa tej strony. Strona może ona zawierać błędy.
|}
[edytuj] Kategorie robocze
Dla ułatwienia zarządzania pracą nad stronami wprowadziłem dodatkowe kategorie tzw. robocze:
- Strona do opracowania - służy do oznaczania stron, które są do opracowania, zaktualizowania lub przetłumaczenia.
- Strona do korekty - służy do oznaczania stron, które wymagają korekty językowej, merytorycznej lub sprawdzenia linków.
Jeżeli pracujesz nad stroną nie zapomnij dodać go do odpowiedniej kategorii. Będziemy wtedy wiedzieć czy jest zakończony czy trzeba jeszcze nad nic popracować.
[edytuj] Informacje na temat edytowania konkretnych stron
[edytuj] Strona główna
Strona główna korzysta ze styli CSS zdefiniowanych w http://wiki.mandriva.com/pl/MediaWiki:Common.css . Dodatkowo, panel z informacjami po prawej stronie (Nowości, Blogi, Ważnie informacje) jest dołączany z szablonu Szablon:Nowości
