Pomoc przy rozwoju MDC jest tak prosta, jak używanie przeglądarki internetowej. Jeśli kiedykolwiek używałeś formularzy na stronach WWW lub wypełniałeś pola tekstowe pisząc na swoim blogu, posiadasz wszystkie umiejętności konieczne, aby zacząć.

Wprowadzenie

Zachęcamy Cię do pisania, edytowania, sprawdzania i tłumaczenia dowolnych dokumentów na tym Wiki. Prosimy, pomagaj nam, i nie martw się, jeśli nie jesteś pewien(a) czy masz rację. Każda zmiana osoby początkującej jest sprawdzana i w razie potrzeby zostanie ona poprawiona. Naszym wspólnym celem jest stworzenie potężnego źródła wiedzy o technologiach internetowych, opartych na standardach WWW. Nie możemy tego zrobić bez Waszej pomocy. Nie mamy ogromnych pieniędzy, ani armii profesjonalnych redaktorów, jedyne co mamy to grupa wolontariuszy z projektu MozillaPL, starających się zapewnić jak najlepszą jakość polskiemu MDC. Zdecydowaliśmy się użyć Wiki właśnie po to, aby każdy mógł się przyłączyć. Nawet jeśli nie masz dużo czasu, wystarczy, że w wolnej chwili przetłumaczysz choć kawałek jakiegoś artykułu, poprawisz błędy podczas czytania innego, albo dodasz nowy odnośnik do dobrej strony o danej tematyce — i już pomogłeś! To naprawdę niewiele pracy, a dla nas to ogromne wsparcie. Mamy szansę sprawić, by następne pokolenie autorów stron WWW uczyło się na najlepszych możliwych materiałach, tworząc źródło wiedzy, z którego sami będziemy mogli korzystać na co dzień. Wykorzystajmy to!

Podstawy

Poniżej znajduje się krótki przewodnik nt. jak edytować i tworzyć strony na wiki MDC. Pisanie i składnię wiki zawsze możesz poćwiczyć w Piaskownicy.

Edycja stron

Aby edytować strony wiki, utwórz własne konto, które jest darmowe i jego założenie zajmuje jedynie kilka sekund. Przejdź do strony logowania i wypełnij formularz. Raz utworzone konto pozwala na edycję stron zawsze, gdy zalogujemy się do MDC.

Z prawej strony na każdej stronie znajduje się kolumna zawierająca odnośnik „Edytuj”. Po jego kliknięciu zostaniesz przeniesiony do formularza z zawartością strony, w którym możesz robić zmiany, jakie tylko chcesz, potem przejrzeć je i zapisać. Zapisane zmiany będą od razu widoczne na stronie.

Tworzenie nowej strony

Najprostszą drogą rozpoczęcia tworzenia strony na MDC będzie stworzenie odnośnika do niej na swojej stronie użytkownika, następnie kliknięcie go i wybranie trybu edycji.

Aby przejść do swojej strony, kliknij nazwę swojego profilu znajdującą się w niebieskim pasku na górze tego wiki. Jeśli nie miałeś żadnej zawartości na stronie swojego profilu, zostaniesz automatycznie przeniesiony do formularza edycji, w którym będziesz mógł dodać dowolną zawartość.

Tworzenie odnośnika do strony, którą chcesz dodać, polega na napisaniu tytułu, jaki chcesz nadać nowej stronie i objęciu go kwadratowymi nawiasami, tak jak tutaj: [[To jest przykład]]. Kiedy zapiszesz stronę, ten kod zmieni się w odnośnik, taki jak ten: Tutaj jest przykład odnośnika.

Jeśli strona jeszcze nie istnieje, odnośnik będzie koloru czerwonego. Gdy strona już istnieje, odnośnik będzie koloru niebieskiego. Jeśli chcesz utworzyć nową stronę, ale tytuł tej strony jest już zajęty, sprawdź najpierw czy pomógłbyś bardziej edytując i poprawiając istniejącą stronę. Jeśli nie, spróbuj wymyślić inny tytuł strony i stwórz dla niej odnośnik.

Kiedy chcesz dodać zawartość do nowo utworzonej strony, kliknij na czerwony odnośnik i rozpocznij pisanie. Pamiętaj, aby używać przycisku Zapisz, znajdującego się u dołu formularza edycji do zapisywania swojej pracy (używaj go częściej, gdy tworzysz długi wpis).

Jak nazywać nowe strony?

Więcej informacji o tworzeniu nazw nowych stron znajdziesz w poradniku nazywania stron.

Znaczniki wiki

Jeśli naciśniesz odnośnik „Edytuj” w kolumnie z prawej strony, zobaczysz, że tekst strony stanowią specjalne znaki na przykład: znaki "==" wokół nagłówka i nawiasy "[[ ]]" wokoło odnośników. Jest to bardzo prosta forma znaczników tekstowych, które są unikalne w systemie wiki. System znaczników wiki jest bardzo prosty do nauki, i toleruje, jeśli popełnimy błąd.

Dokumentacja znaczników Wiki

Pełna dokumentacja znaczników wiki, które możesz użyć do nauczenia się języka edycji w wiki.

Pisanie, edycja i przeglądanie

Trochę dokładniejszy opis ról w polskim MDC.

Tłumacze

Polskie MDC chce przede wszystkim oferować wysokiej jakości tłumaczenie oryginalnego MDC. Oznacza to, że zawsze chętnie przyjmiemy każde tłumaczenie dowolnego tekstu znajdującego się na angielskim MDC. Szczególnie interesuje nas tematyka standardów WWW, jako że zagadnienia specyficzne dla języków Mozilli nie są tak krytyczne dla poprawiania jakości sieci, jak nauka standardów. Tłumaczenia nie muszą być od razu doskonałe, na MDC trwa nieustanny proces poprawy jakości tekstów i nawet jeśli przetłumaczysz na początku dość topornie, to powoli i spokojnie wyszlifujemy ten dokument później. Ważne jest, żeby zacząć.

Pisarze

Jeśli chcesz napisać coś od zera, swojego, najlepiej byłoby, gdyby tekst powstał w języku angielskim, gdyż dzięki temu skorzysta cały świat, a nie tylko polscy użytkownicy. Jednak nawet jeśli nie masz ochoty pisać po angielsku, zachęcamy Cię do napisania nowego artykułu na jakikolwiek interesujące tematy, jakie są zawarte w wiki. Nowa zawartość może być artykułem o wielkości jednej strony lub pełnym spisem przewodnim dokumentacji. Ilość wprowadzonej zawartości do projektu jest tylko i wyłącznie zależna od Ciebie i Twoich możliwości.

Jeśli chcesz wziąć udział w jakimś dużym projekcie, przyłącz się do społeczności MDC i porozmawiaj z nami o tym w pierwszej kolejności, na wypadek, gdyby ktoś inny planował (lub nawet już zaczął) podobny projekt.

Jeśli masz pytania odnośnie stylu lub używania reguł wewnątrz tego wiki, zajrzyj do przewodnika dla edytorów.

Edytorzy

Edytorzy są zawsze mile widziani, szczególnie do poprawy błędnie napisanych artykułów, gramatyki lub wymowy. Zobacz przewodnik dla edytorów, aby dowiedzieć się więcej.

Pamiętaj, że nie musisz brać na siebie odpowiedzialności i przyjmować jakiejś roli, aby edytować i poprawiać dowolny dokument, jaki znajdziesz. Nawet najmniejsze poprawki są bardzo cenne i poprawiają jakość tej bazy wiedzy.

Recenzenci

Poprawy techniczne lub sugestie są na MDC zawsze bardzo mile widziane, więc jeśli napotkałeś błąd techniczny w którymś z tłumaczeń (w kodzie strony lub w tekście), możesz natychmiast go poprawić. Jeśli natomiast coś wzbudza jakieś pytania lub kontrowersje, opisz to w stronie „Dyskusji”, która jest dostępna dla każdego artykułu.

Przewodnik

Przewodnik dla edytorów pokazujący styl, w jakim jest tworzone jest wiki MDC. Przewodnik ten będziemy rozszerzać w przyszłości, więc jeśli masz określone pytania, na które nie znalazłeś odpowiedzi w przewodniku dla edytorów lub innych stronach pomocy MDC, prześlij je na listę mailingową MDC lub do lidera projektu, abyśmy wiedzieli, co należy dodać.

Przenoszenie starych dokumentacji

Migracją zajmuje się angielska wersja MDC, my natomiast wprowadzamy zmiany już po przeniesieniu dokumentacji ze strony mozilla.org do angielskiego wiki. Jeśli chcesz się zająć przenosinami dokumentacji to odwiedź angielską wersję tej strony.

Lokalizacja MDC

Jeśli jesteś zainteresowany pomocą w tłumaczeniu dokumentacji na wiki MDC na jakikolwiek inny język, to możesz śmiało rozpocząć poprzez odwiedzenie odpowiedniej wersji językowej wiki i rozpocząć edycję/tworzenie nowych stron.

Istniejące projekty lokalizacyjne

Aktualnie MDC jest tłumaczone na następujące języki: kataloński, chiński (Chiny), niemiecki, angielski, francuski, włoski, japoński, holenderski, polski, portugalski, hiszpański, koreański, chiński (Tajwan), rosyjski.

Jak zacząć nowy projekt lokalizacji?

Jeśli chcesz się dowiedzieć jak rozpocząć nową lokalizację, przejdź na angielską wersję strony projektów lokalizacji i postępuj wg poleceń tam zawartych.

„Wojny edycyjne” lub innego rodzaju konflikty

Jeżeli kiedykolwiek napotkasz „wojnę edycyjną”, w której dwie lub więcej osób naprzemiennie edytują tę samą treść, spróbuj najpierw wyjaśnić zajście z uczestnikami.

Jeśli nie przynosi skutku Twoja mediacja między skłóconymi osobami, powiadom wszystkich będących w społeczności MDC poprzez listę mailingową MDC lub (w ostateczności) poinformuj lidera projektu MDC. Inni doświadczeni członkowie społeczności prawdopodobnie zdołają rozwiązać problem.

  • Wojny edycyjne — odnośnik do dokładniejszego wyjaśnienia tego terminu na Wikipedii.

Poproś o usunięcie strony

Jeżeli utworzyłeś stronę przez przypadek lub uważasz, że jakaś strona powinna zostać usunięta, to musisz dodać ją do kategorii „Strony do usunięcia” poprzez dodanie na dole strony wpisu: [[Kategoria:Strony do usunięcia]].

Kategoria stron do usunięcia jest przeglądana okresowo przez administratorów MDC i strony zgłoszone do usunięcia są sprawdzane, a następnie usuwane.

UWAGA: Proszę nie usuwać stron lub kategorii innych niż te, które są oznaczone flagą „Strona do usunięcia”.

Dołącz do społeczności MDC

Mozilla Developer Center jest w większości pracą własną grupy wolontariuszy i zawsze jesteśmy zadowoleni, gdy pomoc rozpoczyna nowy pisarz lub edytor.

Listy mailingowe / grupy dyskusyjne

  • Przeglądaj fora MDC ...

Kanał IRC

Znaleźć nas także można na serwerze irc.mozilla.org na kanale #devmo: #devmo na irc.mozilla.org.

Lider projektu MDC

Autorzy i etykiety dokumentu

 Ostatnia aktualizacja: lukasz.jezierski,