Współpraca przy Wiki

From Mandriva Poland

Rozwijanie Wiki


To wiki jest ciągle w trakcie budowy, więc każdy może pomóc je rozwijać. Jeśli chcesz pomóc, zapoznaj się z poniższą stroną i skontakuj z Pauliną (paulina.budzon @ mandriva.pl).

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:

  1. 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.
  2. Zanim stworzymy nową stronę, należy się upewnić czy nie istnieje już inna o podobnym temacie
  3. 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.
  4. 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] 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:
Strona na temat czegośtam

[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

  1. Szablon:Bug - stosowany do oznaczania numerów błedów (bugów) w systemie i aplikacjach. Szablon często stosowany na stronach errat do systemu.
  2. Szablon:File - używany do wyróżniania nazw plików,
  3. Szablon:Media - do oznaczania nazw repozytoriów, np. /main/release,
  4. Szablon:Pkg - oznacza nazwy pakietów systemu,
  5. Szablon:Prog - oznacza nazwy programów,
  6. Szablon:Tytuł - stosowany do tytułów stron. Każda strona powinna na samym początku zawierać tytuł!
  7. Szablon:Cmd - stosowany do oznaczania komend, np. cp plik1 plik2
  8. 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!
  9. Szablon:Menu - stosowany do zaznaczania pozycji/kategorii menu systemowego.
  10. 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 wszystkuch 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:

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 budowy!
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 budowy!
|-
|Ta strona jest ciągle tłumaczona i zawiera informacje w innym języku.
|}


[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

Źródło: "http://wiki.mandriva.com/pl/Wsp%C3%B3%C5%82praca_przy_Wiki"