Pl:Wskazówki dotyczące Wiki
Wstęp | Wskazówki | Struktura | Tłumaczenie | Porządkowanie | Pomoc | ||||||||||||||||
Podczas pisania stron Wiki należy przestrzegać poniższych wskazówek. Pomoże to stworzyć użyteczną i łatwą w użyciu dokumentację, która będzie dostępna dla wszystkich. WikiProject Cleanup to strona koordynująca prace nad Wiki w celu zwiększenia zgodności z tymi wytycznymi. ZrozumiałośćTwórz krótkie strony, używaj prostego języka i unikaj żargonu. OpenStreetMap ma być dostępny dla wszystkich, a nasza dokumentacja powinna to odzwierciedlać. Dostosuj tekst do ludzi w różnym wieku! Niektóre strony Wiki mają formę dokumentacji technicznej. Nawet w nich powinniśmy dążyć do tego, aby były zrozumiałe dla użytkowników posiadających szereg technicznych umiejętności. Pisz proste wprowadzenia do tematu i rozważ wydzielenie bardzo skomplikowanych szczegółów do osobnych artykułów. StrukturaWiki powinno być tak skonstruowane, aby umożliwić ludziom łatwe znajdowanie treści, których szukają, począwszy od strony głównej. Niektóre kluczowe treści są bezpośrednio powiązane ze stroną główną, ale inne linki na stronie głównej prowadzą do ogólnych artykułów na konkretny temat. Sprzeczne informacjeSprzeczne informacje są bardzo złe. Informacje na temat bieżących zaleceń dotyczących tagowania powinny być spójne. Jeśli tak nie jest, prosimy skontaktować się z innymi użytkownikami w celu osiągnięcia konsensusu. Zalecenia dotyczące tagowania powinny idealnie pasować do rzeczywistego tagowania, chyba że istnieje uzasadniony powód, aby tego nie robić. Propozycje i proponowane zmiany w tagowaniu są wyjątkiem od tej reguły. Należy je jednak wyraźnie zidentyfikować jako propozycje. PowielaniePowielanie jest często złe, ponieważ grozi dostarczeniem sprzecznych informacji i zwiększa ilość pracy. W przypadku niepotrzebnego powielania, należy zracjonalizować je, aby zapewnić jedno jasne źródło informacji. Na przykład treść z Wikipedii, można zastąpić linkiem do niej (weryfikowalność treści). Template:merge służy do oznaczania stron wymagających reorganizacji w celu usunięcia duplikatów, z podobną zawartością, stron. W przypadku, gdy powielanie jest przydatne (na przykład jest prezentowane w innym stylu, strukturze strony lub dla różnych odbiorców), ważne jest, aby wyjaśnić powody takiego stanu rzeczy i połączyć je, aby uniknąć nieporozumień. Jeśli nie ma powodu do powielania, strony powinny zostać scalone. Pamiętaj, że scalenie niekoniecznie oznacza, że pozostaje nam jedna strona, na której były dwa wcześniej. Istnieją inne wyniki, na przykład nietechniczna strona z podsumowaniem strony może zawierać link do bardziej szczegółowej strony technicznej. Tytuły – Konwencja nazewnictwa stronW przypadku tytułów stron wielowryazowych należy napisać drugie i kolejne słowa małymi literami, chyba że tytuł jest nazwą własną, którą zawsze pisze się wielkimi literami, nawet w środku zdania. Nie używaj CamelCasePageTitles, w których słowa są połączone bez spacji – MediaWiki pozwala nam używać spacji jak w naturalnym języku. Wyjątkiem byłaby sytuacja, w której tytuł strony jest nazwą czegoś, co ma połączone słowa, np. "OpenLayers" Prefiksy w tytułach stron były używane w przeszłości (np. prefiks WikiProject). Jest to w większości uciążliwa spuścizna, ale nie można tego łatwo naprawić na tym etapie. Przeniesienie wszystkich takich stron byłoby bardzo dużym zadaniem. Jednak odradza się tworzenie schematów prefiksów tytułów stron. Użyj tytułów stron w języku naturalnym i połącz zestaw stron, aby utworzyć struktury linków w treści samych stron. Aktualną dyskusję na ten temat można znaleźć w struktury Wiki. WprowadzenieStrony powinny zaczynać się od krótkiego akapitu wprowadzającego zawierającego kilka zdań w kontekście OSM. Powinno to zawierać nazwę znacznika lub tytuł i wyjaśnić, o czym jest dana strona/znacznik. Często przydatne jest dołączenie linku do bardziej ogólnej strony i do bardziej szczegółowych stron, ponieważ pomaga to w nawigacji. Ta wstępna sekcja powinna pojawić się przed jakimkolwiek nagłówkiem (i przed Spisem treści na długiej stronie). Przynajmniej część wprowadzenia powinna znajdować się u góry strony nad jakimkolwiek nagłówkiem. Zapewni to spójny układ na Wiki. LinkiStrony powinny być dobrze połączone, aby pomóc użytkownikom znaleźć informacje, których szukają. Ważne powiązane pojęcia są zazwyczaj związane z wprowadzeniem. Jeśli nie możesz wymyślić powiązanej strony wiki, z którą można się połączyć, prawdopodobnie nie tworzysz strony w wystarczająco szerokich kategoriach. Zachęcamy również do łączenia z pokrewnymi pojęciami w dalszej części strony. Łączenie sekcji z główną stronąMożna użyć kodu {{Main|nazwa strony}} pod nagłówkiem sekcji, aby podać link do głównego artykułu odnoszącego się do tematu sekcji. Sekcja powinna wtedy jedynie podsumować linkowaną stronę główną (i z pewnością nie powinna, w żaden sposób, być z nią sprzeczna). Tytuł sekcji powinien zwykle być taki sam jak strona, z którą jest połączony. Linkowanie do WikipediiLinki do Wikipedii mogą być mylące. Linkuj do Wikipedii, tylko wtedy, kiedy pojęcie nie jest lepiej wyjaśnione w kontekście OSM na tej wiki. Jeśli używasz składni Nie twórz linków do stron Wikipedii, na których istnieje ten sam lub podobny tytuł na tej wiki (z wyjątkiem artykułu na tej wiki, gdzie można go użyć jako dodatkowego odnośnika zewnętrznego, aby uzyskać więcej informacji na ten temat). Artykuł o stronie internetowejMamy wiele stron na Wiki poświęconych opisowi zewnętrznej strony internetowej (usługi map, oprogramowanie itp.). Oczywiście zewnętrzny link do tej strony jest niezwykle ważny. Główny odnośnik powinien być umieszczony w nawiasach po tytule (który jest pogrubiony) w pierwszym zdaniu lub połączony większym tekstem w osobnej linii po początkowych zdaniach. Na tych stronach nie ma sensu powielanie za dużo informacji znalezionych na stronie zewnętrznej. Strona powinna opisywać witrynę w kontekście OSM. Bądź bardziej neutralny i mniej promocyjny z twoim opisem, chociaż staraj się używać języka, który promuje OSM i używa OSM. Lista oprogramowania/usługMamy wiele stron zawierających listy punktowane lub tablice Wiki (•) zawierające wykaz oprogramowania/usług. Jeśli mamy strony wiki o oprogramowaniu, a nawet jeśli nie mamy (czerwone linki), preferowanym formatem jest wewnętrzny link do strony wiki OSM, a następnie zewnętrzny link do strony w nawiasach. Następnie może pojawić się krótki opis lub inne kolumny tabeli. Powinniśmy dążyć do zapewnienia linków zarówno do strony Wiki, jak i do linku zewnętrznego, nawet jeśli strona Wiki jeszcze nie istnieje, aby zachęcić do zdrowego poziomu powiązań Wiki. Czerwone linki można wypełniać informacją pośrednią zgodnie z powyższymi wskazówkami. Pełne linki zewnętrzne URL mogą być dobre, jeśli są krótkie, ponieważ użytkownik wie, czego się spodziewać po kliknięciu. Należy użyć alternatywnego tekstu linku, aby to skrócić, najlepiej do nazwy domeny, aby było jasne, że jest to link zewnętrzny. Przykład:
W bardzo ograniczonych przestrzeniach (często w przypadku tabel Wiki) możemy użyć składni z numerowanymi linkami (np. [1]), aby zmniejszyć jego długość. Możemy zrezygnować z linku zewnętrznego i połączyć tylko do strony Wiki, ponieważ będzie ona miała link zewnętrzny. Jeśli strona Wiki nie istnieje, możemy wybrać tylko zewnętrzny link, ale lepiej byłoby utworzyć stronę Wiki z krótkim opisem. KategorieDo grupowania stron według rodzaju należy używać kategorii, które powinny być zgodne z tymi samymi konwencjami nazewnictwa, co w przypadku stron wiki. Kategorie mogą być kategoryzowane w celu utworzenia hierarchii, która pomoże przenieść nas do interesującego nas tematu. Na przykład Category:Pl:Budynki znajduje się w kategorii Category:Pl:Infrastruktura. Strony mogą należeć do wielu kategorii, ale nie powinny ich zaśmiecać. Strona odnosząca się do autobusów (na przykład strona o przystankach autobusowych) powinna być zakwalifikowana jako 'Buses', ale nie jako 'Public transport'. Jednak główna strona Buses powinna być oznaczona w granicach kategorii Category:Public transport, a także bardziej specyficznie. Strona każdej kategorii powinna zawierać jedną linijkę wprowadzenia, która powinna zawierać link do odpowiedniej głównej strony obiektu, najlepiej o tej samej nazwie. Na przykład Podczas kategoryzacji, strony powinny w razie potrzeby korzystać z opcji sortowania, aby upewnić się, że są odpowiednio wyświetlane na liście stron. Dla przykładu spójrz na strony wymienione w Category:Users in London. Będą one wszystkie wymienione pod 'U' z powodu prefiksu 'User:', ale może to być zmienione. Na przykład User:Harry Wood ma w kodzieWiki: JęzykOpenStreetMap Wiki korzysta z brytyjskiego angielskiego na stronach po angielsku i odpowiedniego lokalnego języka angielskiego na zlokalizowanych stronach tematycznych. Tak więc każda strona, która w większości dotyczy Stanów Zjednoczonych, będzie raczej używać amerykańskiego angielskiego. Dotyczy to szczególnie stron miejsc w Mapping projects. TłumaczenieZobacz Tłumaczenie Wiki. Obejmuje ona wstępne filozoficzne przemyślenia na temat tego, co chcemy osiągnąć dzięki tłumaczeniom na Wiki, podczas gdy nie jest jasne, czy Wiki będzie migrować do rozszerzenia tłumaczeń. Edycja opisówPamiętaj o użyciu pola Opis zmian podczas edycji, aby wskazać, co zostało zmienione. Pomaga to innym redaktorom. |