ArchWiki Tutorial (Polski)
From ArchWiki
- Przedstawiony poniżej tekst jest krótkim wprowadzeniem do tłumaczenia i tworzenia swoich artykułów. Jeśli te wiadomości są dla ciebie nie wystarczające zapraszam pod link:Help:Editing
i18n |
---|
Niemiecki |
Angielski |
Czeski |
Francuzki |
Portugalski(Brazylia) |
Hiszpański |
Chiński |
Rosyjski |
Contents |
Rejestracja i logowanie
Przygodę z Archwiki zaczynamy od założenia swojego prywatnego konta. Aby to uczynić wystarczy, że klikniesz na "create an account or log in" w menu po prawej stronie. Pamiętaj, że wystarczy ci jedno konto by móc pracować z wiki.
Dodawanie nowych artykułów
Aby dodać nowy artykuł wystarczy, że:
- Kliknij na przycisk Edit na dole twojej nowej strony "http://wiki.archlinux.org/index.php/My_New_Page"
- Na samym początku polecam dodać nazwę kategorii, w której ma się znaleźć artykuł. Sprawę tą rozwiązuje wstawienie tagu: [[Category:Some Category]] na samym początku strony.
Jeśli nie możesz zdecydować się na odpowiednią kategorię, to zachęcam do odwiedzenia ArchWiki_Category_Tree.
Edycja
Edycja jest jedną z najczęściej wykorzystywanych funkcji. Dzięki niej możesz poprawić błędy na stronie lub zaktualizować wybrany artykuł. Brak przycisku edycji na stronie oznacza, że autor nie życzy sobie modyfikacji i zablokował stronę. Wtedy jedynym rozwiązaniem jest pisanie do autora lub tworzenie nowego artykułu.
Pamiętaj by wyjaśnić dlaczego modyfikowałeś daną stronę za pomocą "Summary"
Zawsze pamiętaj o show preview wykonaniu podglądu strony, która edytowałeś. Wykorzystanie tej funkcji pozwala uniknąć wstawienia błędnego kodu do systemu wiki.
By poćwiczyć lub wykonać edycję otwórz nowe okno sandbox i następnie kliknij na "edit". Teraz dopisz to co chciałeś i naciśnij przycisk zapisz(save).
Formatowanie tekstu.
Większość tekstu można formatować za pomocą górnego menu. Nie musisz uczyć się HTML by sprawnie tworzyć swoje prace.
Pogrubienie i Kursywa
Pogrubienie i kursywa powstają gdy dane słowo otoczymy podwójnymi lub potrójnymi apostrofami('). Przykład:
- ''kursywa'' jest rozpoznawane jako tekst: kursywa. (2 apostrofy(') po obu stronach tekstu.)
- '''Pogrubienie''' jest rozpoznawane jako tekst:Pogrubiony. (3 apostrofy(') z obu stron tekstu)
- '''''tekst pogrubiony i przekrzywiony''''' jest rozpoznawany jako tekst: Pogrubiony i przekrzywiony. (2 + 3 = 5 apostrofów z obu stron)
Nagłówki
Nagłówki są jednymi z ważniejszych elementów organizacji tekstu. Dzięki nim mamy możliwość uczynienia naszego artykułu jeszcze bardziej czytelnym. Jak je tworzymy?? Przykład:
- =Nagłówek glówny= (1 znak równości z obu stron tekstu)
- ==Nagłówek niższego rzędu== (2 znaki równości z obu stron tekstu)
- ===Jeszcze niższy === (3 znaki równości z obu stron tekstu)
- ====I kolejny:)==== (4 znaki równości z obu stron tekstu)
- =====Następny ===== (5 znaków równości z obu stron tekstu)
Uwaga: Jeśli artykuł ma co najmniej trzy nagłówki to skrypt wygeneruje dla niego specjalną tabelę z spisem treści:) Gdyby ktoś nie chciał generować tej tabeli wystarczy umieścić w kodzie __NOTOC__
Tabulacja
Tabulacja jest kolejnym bardzo pożytecznym tagiem w kodzie wiki :) Dzięki niej możemy dowolnie formatować tekst na stronie. Powstaje ona za pomocą dwukropka (:<tt>) na początku linii. Analogicznie użycie podwójnego lub potrójnego dwukropka zwiększa wcięcie tekstu. Aby zakończyć tabulacje tekstu wystarczy nacisnąć ( Enter lub Return).
Przykład:
Linia bez tabulacji. :Linia z pojedynczą tabulacją. ::Linia z podwójną tabulacją.
Efektem tego kodu jest: Linia bez tabulacji.
- Linia z pojedynczą tabulacją.
- Linia z podwójną tabulacją.
Wypunktowanie
Podczas pisania lub tłumaczenia jakiegoś artu bardzo często stosujemy wypunktowania. dzięki nim możemy podkreślić jakieś wymieniane cechy. Aby uzyskać efekt wypunktowania wystarczy wstawić znak gwiazdki do tekstu(<tt>*<tt>). Tak jak w przypadku tabulacji zwiększenie ilości gwiazdek powoduje utworzenie podpunktów.
A o to kolejny przykład
*Punkt *Drugi punkt **Podpunkt drugiego punktu *Trzeci punkt
Wygląda to tak:
- Punkt
- Drugi punkt
- Podpunkt drugiego punktu
- Trzeci punkt
Numerowanie punktów
Zamiana gwiazdy z poprzedniego paragrafu (<tt>*<tt>) na znak hash (<tt>#<tt>) powoduje utworzenie numeracji punktów i podpunktów.
Przykład:
#Numer jeden #Numer dwa ##Podpunkt 1 punktu 2 #Numer trzy
Podgląd:
- Numer jeden
- Numer dwa
- Podpunkt 1 punktu 2
- Numer trzy
Znacznik Code
Aby cała linia była ujęta na szarym tle(słynny znacznik [code][/code] z for internetowych :)wystarczy pisany tekst poprzedzić spacją Przykład:
To jest tekst code:)
Hiperłącza
Pisząc nasze wypociny często odwołujemy się do jakichś kodów lub stron www. Aby w naszych artykułach nie występowały brzydkie i długie linki, możemy skorzystać gotowych formuł.
Linki wewnętrzne
Jeśli chciałbyś się odwołać do jakiegoś artykułu z naszej wiki, wystarczy w podwójnych klamrach umieścić nazwę pracy. Równie dobrze jeśli artykułu nie ma w naszej bazie, jednak w niedalekiej przyszłości będziesz go pisał możesz już wcześniej zastosować formule hiperłącza.
Przykład: Stworzymy teraz link do Wikia:
- <tt>[[Wikia]]
W/w link czasem może być bardzo długi i brzydko wyglądający. Jeśli nie odpowiada ci nazwa danego linku, możesz ją zmienić poprzez dodanie po odnośniku "|" kreski i odpowiedniej nazwy.
Np:
- Polecamy wejść na [[Arch Linux|home page]]...
Oto co wypluje powyższy kod:):
- Polecamy wejść na home page...
Można również stworzyć kombinację:
- Dodaj pytanie do strony: [[quiz]]zes.
Wynikiem tego będzie tekst:
- Dodaj pytanie do strony: quizzes.
Hiperłącza do innych wersji językowych
Jak możecie zobaczyć u samej góry tego tekstu istnieją odnośniki do innych wersji językowych. Takie linki tworzymy za pomocą i18n-box:
{{i18n_links_start}} {{i18n_entry|Deutsch|niemiecki}} {{i18n_entry|Français|francuski}} {{i18n_links_end}}
Title (Language)
Na przykład:
Gnome Gnome (Deutsch) Gnome (Français)
Zewnętrzne linki
Czasami zdarza się, że chcemy dorzucić linki do zewnętrznych stron. Jak się pewno domyślacie utworzenie tych linków nie jest takie trudne:): Jeśli na przykład chcecie umieścić link do :
wystarczy użyć kodu :
- [http://www.google.com/ Google]
Co w rezultacie daje:Google
Zmienne i szablony
Używaj tagu {{SITENAME}} by zobaczyć aktualny dokument.
Jeśli masz taką potrzebę to możesz samodzielnie tworzyć swoje szablony. Po tym jak utworzysz swój własny szablon strony:XXX. Wystarczy używać komendy:{{XXX}} . Jest to dość przydatna funkcja gdy dana rzecz ma być umieszczona, czy załączona na kilkunastu stronach.
Kategoria specjalna
Twórcy Archwiki dla dobra ogółu utworzyli kilka kategorii specjalnych :
Artykuły nie dokończone
Na stronie Category Stub można ujrzeć wszystkie artykuły, które są oflagowane tagiem{{stub}}. Kiedy dana strona jest tak oflagowana:
- zbyt krótki artykuł
- zbyt zagmatwany
- nie dokończony
Arty nie przetłumaczone
Strona Category "Translation Requested" zawiera wszystkie prośby o przetłumaczenie danego artykułu.
Praca musi posiadać flagę{{translateme}}.
Błędne prace
Można znaleźć na Category "Accuracy Disputes"
Aby jakieś wypociny znalazły się na w/w stronie wystarczy umieścić tag:{{accuracy}}.
Prośby i Problemy
jeśli czegoś ci brakuje lub czegoś nie zrozumiałeś to zapraszam do wykorzystania :Requests