Pomoc:Tworzenie podręczników: Różnice pomiędzy wersjami

Z Wikibooks, biblioteki wolnych podręczników.
Usunięta treść Dodana treść
m robot poprawia: es:Wikilibros:Manual
Linia 153: Linia 153:


===Zareklamowanie podręcznika===
===Zareklamowanie podręcznika===
Dobrze jest dodać link na Wikipedii używając szablonu <tt><nowiki>{{wikibooks|Nazwa podręcznika|Nazwa podręcznika}}</nowiki></tt>. Nic nie szkodzi na przeszkodzie, by zgłosić podręcznik (o ile jest dobry) do internetowych katalogów.
Dobrze jest dodać link na Wikipedii używając szablonu <tt><nowiki>{{wikibooks|Nazwa podręcznika|Nazwa podręcznika}}</nowiki></tt>. Nic nie stoi na przeszkodzie, by zgłosić podręcznik (o ile jest dobry) do internetowych katalogów.


==Zobacz też==
==Zobacz też==

Wersja z 10:17, 28 mar 2010

Szablon:Zalecenia i wytyczne

Jeśli masz zamiar stworzyć na Wikibooks nową książkę, trafiłeś w odpowiednie miejsce! Ten poradnik podpowie ci, jak skonstruować łatwy w utrzymaniu i poszerzaniu podręcznik, bezboleśnie zaznajomi cię też z paroma zasadami, którymi kierujemy się na Wikibooks, aby utrzymać księgozbiór w porządku i móc go łatwo przeglądać i edytować.

Przed rozpoczęciem pracy

  1. przeszukaj Wikibooks - być może jest tu już podręcznik, który chciałbyś napisać, lub wystarczy poszerzyć istniejący
  2. zastanów się, co i jak chcesz napisać. Jeśli nie jesteś pewien kształtu tekstu, który chcesz stworzyć na Wikibooks, użyj strony Wikibooks:Brudnopis zamiast eksperymentować na nowym haśle
  3. jeśli tego jeszcze nie zrobiłeś, zajrzyj na stronę Wikibooks:Czym Wikibooks nie jest i Wikibooks:Dlaczego nie pisać na Wikibooks, aby upewnić się, że dobrze rozumiesz ideę Wikibooks. Dodatkowo przygotowaliśmy dla Ciebie strony pomocy: Wikibooks:FAQ, Wikibooks:Szybka pomoc, Wikibooks:Witamy nowicjuszy. Zawsze możesz poprosić o pomoc
  4. zobacz, jak zostały zrobione podręczniki na Wikibooks o podobnej tematyce. Jeśli podpatrzysz w nich dobre rozwiązania, oszczędzi ci to pracy.

Nazewnictwo

Pierwsza rzecz, nad jaką należy się zastanowić, to wybranie nazwy podręcznika. Sprawa jest niebanalna, bo zaważy również na wszystkie podrozdziały książki.

Generalnie, preferujemy nazwy, które jak najprościej i najpełniej wyrażają istotę rzeczy: Mikrobiologia, Historia Polski, Książka kucharska, Mechanika kwantowa. Tytuł książki nie powinien być przesadnie długi, nie powinien też zawierać niestandardowych znaków (mechanizm MediaWiki ostrzeże, jeśli dany znak nie może znaleźć się w tytule).

Jeśli tworzymy podrozdziały podręcznika, ich tytuły dopisujemy do tytułu głównej książki. Przykładowo, mamy podręcznik Filozofia i planujemy dodać rozdział Filozofia grecka. Nowy artykuł powinien nosić nazwę Filozofia/Filozofia grecka - tytuł książki i rozdziału są oddzielone slashem (bez spacji).

Przeczytaj także Wikibooks:Nazewnictwo artykułów aby poznać szczegóły.

Główna strona podręcznika

Na stronie głównej podręcznika możesz w zależności od upodobań umieścić zawartość podręcznika lub też okładka. Przykład obu możliwości: C i IRC/Okładka.

Konstrukcja

Dobrze jest, jeśli przystępując do pracy masz obmyśloną z grubsza wizję podręcznika. Nie chodzi o szczegóły - raczej o to, jak będzie postępował jego rozwój i jaki zakres ma obejmować. Najlepiej rzecz jasna byłoby, gdybyś miał / miała już gotowy podręcznik napisany przez siebie, np. pod "Wordem". Dzięki temu byłyby mniejsze szanse, że porzucisz pisanie podręcznika w połowie pracy. Nie marnowałbyś / marnowałabyś swojego wysiłku i czasu, a czytelnicy nie zawiedliby się na Tobie.

Jednym z pierwszych kroków twórcy nowego podręcznika powinno być umieszczenie w głównym haśle (w naszym przypadku będzie to Filozofia) spisu treści. W ten sposób porządkujemy nasze pomysły i stawiamy ważny krok - następni edytorzy zastaną już gotowy plan i to ty w dużym stopniu wskażesz im, co powinni zrobić.

Oczywiście spis treści można w każdej chwili zmienić, ale gdy prace są zaawansowane, nie jest już to takie łatwe. Trzeba wówczas tworzyć nowy moduł o pożądanym tytule, przenieść tam zawartość poprzedniego modułu, a w starym (już bezużytecznym) module wstawić szablon "ek", żeby administrator wiedział, że może go usunąć.

Treść

Pora wpisać do podręcznika treść. Nie musisz od razu rzucać się na głęboką wodę - dobrym pomysłem jest napisanie spisu treści, dobrego i kompletnego wstępu lub pierwszego rozdziału. Kolejni czytelnicy lub edytorzy będą widzieli, że podchodzisz poważnie do tematu i większe jest prawdopodobieństwo, że wrócą do twojej książki. Spis treści pokaże innym chętnym, co mają robić, gdyby chcieli pomóc w rozwoju podręcznika.

Na początku można wstawić kilka linków do naszego siostrzanego projektu, Wikipedii - szczególnie, jeśli ma hasło poświęcone tematowi. Jednak dopisz coś od siebie i nie przepisuj treści z Wikipedii - to niepotrzebne, bo czytelnik może odwiedzić link by przeczytać to samo, a z drugiej strony książka, która składa się z dwóch zdań i kilku linków do Wikipedii sprawia fatalne wrażenie. Nie idź więc na łatwiznę i jeśli zdecydowałeś się stworzyć nową książkę, daj próbkę swoich możliwości. Pamiętaj, że na Wikibooks nie wolno wklejać tekstów objętych prawem autorskim. Jeśli znajdziesz tekst, który chcesz skopiować lub przetłumaczyć, ale nie ma wyraźnej informacji o licencji pozwalającej na skorzystanie z niego na Wikibooks - wstrzymaj się.

Jeśli znalazłeś ciekawy i rozbudowany artykuł na Wikipedii, który chciałbyś przerobić we własnej książce nie przepisuj treści Wikipedii - poproś administratora o import strony na Wikibooks - pamiętaj, że używając treści GNU FDL zobowiązany jesteś podać źródło i jego autorów.

Możesz przeszukać zasoby anglojęzycznych Wikibooks oraz pozostałe. Jeśli znajdziesz taką samą książkę w języku obcym, wstaw link do niego (tzw. interwiki) - robi się to umieszczając zwyczajowo na końcu strony kod [[en:Philosophy]] - jeśli przykładowo znaleźliśmy podręcznik do filozofii. Linki interwiki wstawiamy tylko na stronie głównej książki.

Pamiętaj o zachowaniu neutralnego punktu widzenia i opieraniu się na wiarygodnych źródłach.

Nagłówki

Aby podzielić tekst na części użyj nagłówków:

==Nagłówek 2==

===Nagłówek 3===

====Nagłówek 4====

Nie rób zbyt dużo nagłówków, gdyż artykuł może się stać mało przejrzysty

Uwaga: Nagłówek pierwszego poziomu (= Nagłówek 1 =) nie powinien być stosowany. Funkcje nagłówka 1. poziomu spełnia tytuł modułu (widoczny na górze strony).

Ozdobniki i komunikaty

Może okazać się, że będziesz potrzebował zostawić jakieś komunikaty - na przykład, że w danym miejscu powinien znajdować się obrazek - lub po prostu zechcesz umieścić w tekście jakiś ozdobnik. Zajrzyj na Wikibooks:Szablony, gdzie znajdziesz listę gotowych do wstawienia elementów. Pamiętaj jednocześnie, że do umieszczania uwag o tekście służy strona dyskusji.

Nawigacja

Aby ułatwić poruszanie się do przodu i wstecz między rozdziałami, można wstawić na strony jeden z szablonów nawigacyjnych.

Grafika

Na Wikibooks można umieszczać grafikę. Jeśli chcesz dowiedzieć się więcej, przeczytaj Wikibooks:Ilustracja Wikibooks.

Materiały z Wikipedii

Na Wikibooks można dowolnie używać materiałów z Wikipedii, ale należy w opisie zmian (krótkim polu pod polem edycji) podać źródło (z jakiego hasła wzięliśmy tekst). Podobnie można używać materiałów ze stron i publikacji na licencji GFDL, ale zawsze konieczne jest podanie źródła.

Od 2007 roku istnieje również możliwość importu stron z innych serwisów Wiki. Więcej znajdziesz na stronie: Wikibooks:Import.

Korzystaj ze strony dyskusji

Na temat każdej strony można rozpocząć dyskusję, klikając na zakładkę powyżej jej tytułu i zaczynając ją jak każdy artykuł. Dyskusja może ci się przydać do wstawienia notatek i uwag odnośnie tekstu a także wytycznych dla przyszłych edytorów. Sam tekst artykułu nie powinien służyć do wstawiania swoich uwag, ewentualnie można w treści artykułu zaznaczyć rzeczy do zrobienia (szablon {{TODO}}).

Dobrze jest utworzyć dla podręcznika jedną, centralną stronę dyskusji, gdzie będą dyskutowane kwestie istotne dla całego podręcznika.

Kategoria

Kategorie na Wikibooks mają nieco inne użycie niż na Wikipedii. Na Wikipedii każda strona znajduje się w jakiejś kategorii; na Wikibooks to podręczniki są podstawowymi jednostkami i tylko stronę główną podręcznika (okładkę a wobec jej braku spis treści) umieszcza się w określonej kategorii.

Wykaz ważnych stron "technicznych", "administracyjnych" i ogólnej natury znajdziesz w kategorii: meta-strony Wikibooks. Porządkujący wykaz stron Wikibooks znajduje się w spisie treści przestrzeni nazw.

Skróty

Przeglądając Wikibooks często napotkasz na skróty, które pojawiają się w ramce, w prawym, górnym rogu strony. Są to po prostu oznaczenia często używanych i odwiedzanych stron, ważnych dla społeczności autorów podręczników. Ich wykaz znajdziesz na stronie Wikibooks:Skróty.

Zwyczajowo tworzone strony

Okładka i spis treści

Podręcznik wielomodułowy na swej głównej stronie (np. "Angielski, Mikrobiologia) powinien mieć umieszczony spis treści (np. Mikrobiologia). Ozdobną stronę tytułową (nazywaną na Wikibooks "okładką") możemy wykonać na osobnej stronie.

Okładka

  1. tworzymy stronę Podręcznik/Okładka i linkujemy do Podręcznik
  2. tworzymy spis treści w Podręcznik
  3. linki w księgozbiorze itp. prowadzą do strony Podręcznik/Okładka


Strona tytułowa (okładka) podręcznika powinna zawierać:

  • odnośnik do spisu treści
  • linki interwiki i kategorię (nie powinny być na stronie ze spisem treści)
  • opcjonalnie grafikę lub zdjęcie związane tematycznie z książką
  • opcjonalnie link do głównej strony dyskusji podręcznika
  • link do wersji do druku (o ile istnieje)
  • ewentualne odnośniki do spisu treści kolejnych poziomów, zagadnień
  • ewentualne krótkie wprowadzenie do podręcznika, informacje o postępie prac

Przykłady stron tytułowych:

Jeśli podręcznik ma osobno spis treści i okładkę, strona dyskusji okładki powinna przekierowywać do strony dyskusji spisu treści.

Spis treści

Na stronie ze spisem treści oprócz listy rozdziałów możemy umieścić linki do pokrewnych podręczników oraz stron organizacyjnych danego podręcznika. Jeśli książka ma okładkę, powinien być dostępny link do niej.

Przykłady spisów treści:

Informacje o podręczniku i autorach

Jeśli przy podręczniku pracuje kilka osób, lub wykorzystywane są w nim źródła zewnętrzne, dobrze jest stworzyć stronę informacyjną podręcznika. Nazywamy ją Nazwa podręcznika/O podręczniku. Na stronie takiej wydzielamy zazwyczaj dwie sekcje.

Pierwsza z nich wymienia osoby, które wniosły znaczny wkład w rozwój podręcznika. Wystarczy, że będą to linki do stron Wikipedystów, nie przedstawiamy się w wykazie autorów, takie informacje należy umieścić na swojej stronie użytkownika.

Druga sekcja, zatytułowana "Źródła" lub "Bibliografia", powinna zawierać listę książek, z których korzystaliśmy przy pisaniu podręcznika i odnośniki do stron internetowych, których treść wykorzystaliśmy. Jest to odpowiednie miejsce na napisanie o licencjach tekstów źródłowych - jeśli korzystamy np. z tekstu na licencji GNU FDL, to licencja nakłada na nas obowiązek poinformowania o oryginale i o tym, że jest na licencji GFDL.

Przykłady:

Indeks

Jeśli w podręczniku pojawia się wiele definicji różnych terminów, warto dla ułatwienia życia czytelnikom stworzyć indeks, zbierający najważniejsze z pojęć i linkujący do rozdziałów, które je objaśniają. Dodatkową zaletą tworzenia indeksu jest potencjalne zwiększenie rankingu w wyszukiwarkach. Przykład indeksu (nie będący jednak wzorem) można znaleźć w C/Indeks. W podręczniku z dziedziny nauk humanistycznych warto ułożyć indeks osób, taki jak np. w Historia administracji/Indeks nazwisk.

Wytyczne dla innych autorów

Wikibooks to miejsce, gdzie wspólnie tworzy się podręczniki. Aby inne osoby były w stanie rozwijać podręcznik, warto opracować plan prac. W takim celu dobrze jest stworzyć rozdział Dla autorów lub założyć sekcję w głównej stronie dyskusji podręcznika. Rozdział taki powinien zawierać najważniejsze wytyczne dotyczące stylu, na przykład dla książki o matematyce będzie to ustalenie notacji wzorów. Oprócz tego przydatne jest określenie, co powinien zawierać każdy rozdział podręcznika (gdy gotowy jest szkielet spisu treści).

Przykłady:

Po zakończeniu pracy

Koniec pracy nad stroną nie jest finałem procedury dodawania nowej książki. Czeka cię jeszcze kilka prostych czynności.

Dopisanie do księgozbioru

Aby książka była widoczna dla innych użytkowników, należy ją dodać w odpowiednie miejsce na stronie Wikibooks:Księgozbiór.

Ikony kompletności

W Księgozbiorze zaznaczamy, jaki jest etap prac nad daną książką. Zobacz szczegóły w Wikibooks:Etapy rozwoju książek.

Jeśli chcesz, możesz umieszczać ikonki kompletności przy poszczególnych działach swojego Wikibooks (tak jak tutaj: Skialpinizm) - rozważ tylko, czy nie zmniejszy to przejrzystości.

Umieszczenie na liście nowych podręczników

Jeśli tworzysz zupełnie nową książkę, możesz ją umieścić w widocznym na stronie głównej szablonie Nowe podręczniki.

Wersja dla druku

Możesz też pomyśleć na samym początku o wersji przeznaczonej dla druku, jeśli uważasz, że czytelnicy będą chcieli drukować twój podręcznik. Zobacz na Wikibooks:Podręczniki do druku aby przeczytać, jak to zrobić.

Obserwowanie

Ciężko jest dodać cały podręcznik do swojej listy obserwowanych. Na Wikibooks bardziej od tej listy przydaje się funkcja Zmiany w dolinkowanych (w ramce poniżej pola z wyszukiwaniem). Używając jej na stronie ze spisem treści podręcznika można zobaczyć listę wszystkich zmian w stronach dolinkowanych ze spisu treści.

Zareklamowanie podręcznika

Dobrze jest dodać link na Wikipedii używając szablonu {{wikibooks|Nazwa podręcznika|Nazwa podręcznika}}. Nic nie stoi na przeszkodzie, by zgłosić podręcznik (o ile jest dobry) do internetowych katalogów.

Zobacz też