Zanurkuj w Pythonie/Zalecenia dla autorów

O podręczniku

Książka ta jest tłumaczeniem „Dive into Python” (czyli „Zanurkuj w Pythonie”), udostępnionej na licencji zgodnej z licencją Wikibooks (GNU Free Documentation License). Możesz zajrzeć do sekcji O podręczniku. Pomysł przetłumaczenia tego podręcznika został dany przez Warszka. Praca nad powstawaniem tego podręcznika była koordynowana przez Piotra.

Tłumaczenie

Proces tłumaczenia został już zakończony. Teraz trzeba zrobić poprawki.

Poprawki

Podręcznik wymaga:

zmiany kodu,
ujednolicenia sposobu zwracania się do Czytelnika,
ujednolicenia pojęć technicznych (w tym "section" to nie "sekcja", tylko podrozdział),
poprawy błędów ortograficznych, stylistycznych, składniowych itp.
wytłumaczenia niektórych pojęć dla osób, które nigdy wcześniej nie programowały,
zmniejszenia ilości zbędnych porównań do innych języków programowania,

Zmiany w kodzie

W plikach źródłowych należy zmienić klasy na klasy w nowym stylu. Ponadto należy przetłumaczyć notki dokumentacyjne i komentarze na język polski. Wszelkie łańcuchy znaków z polskimi znakami tworzymy w unikodzie. Poniżej przedstawione są pliki źródłowe, a po poprawie przekopiujemy je do odpowiednich podrozdziałów.

Poniżej znajdują się pliki do poprawy (być może niektóre trzeba będzie przekopiować z http://diveintopython.org):

Sposób zwracania się do czytelnika

Ujednolicenie terminologii

Wszelkie tłumaczenia technicznych pojęć muszą się pokrywać z przedstawionymi w słowniku. Jeśli jakiegoś pojęcia nie ma, to powinno się je dodać. W podręczniku podczas pierwszego wystąpienia jakiegoś technicznego zwrotu, należy w nawiasie umieścić jego angielski odpowiednik.

Słownik

dictionary: słownik
delimiter: separator (coś co oddziela), ogranicznik (coś co ogranicza)
dispatcher: funkcja pośrednicząca
doc string: notka dokumentacyjna
file-like object: obiekt plikopodobny
multi-variable assignment: wielozmienne przypisanie
nested scope: zagnieżdżona przestrzeń nazw
overload: nadpisywać
tuple: krotka
unit testing: testowanie jednostkowe
slice: wycinek
slicing: wycinanie
string: napis (tłumaczenie bardziej intuicyjne dla początkującego) albo łańcuch znaków. Z reguły krótkie łańcuchy znaków będziemy tłumaczyć jako napis, dłuższe jako łańcuch znaków.
list comprehension: wyrażenie listowe, jeśli chodzi o konstrukcję [x for x in y]. W odniesieniu do czynności — odwzorowywanie listy.

Poprawa różnych błędów

Kolorowanie kodu

Nie kolorujemy ręcznie kodu. Jest to zbyt pracochłonne i niszczy czytelność źródła strony. Do tego celu został stworzony skrypt, który to robi za nas, automatycznie podczas wgrywania strony (wymaga JavaScriptu). Aby włączyć podświetlanie składni do każdej strony wstawiamy kod {{Podświetl|py}}, a następnie każdy kod Pythona pod znaczniki <code>...</code> np. <code>def</code> lub pod blok pre.

Szablony

W podręczniku wykorzystujemy poniższe szablony:

Nawigacja

 {{Nawigacja|Zanurkuj w Pythonie|
  [[../Instalacja|Instalacja]]|
  [[../Wbudowane typy danych|Wbudowane typy danych]]|
 }}

Porada, informacja

{{Infobox|Tekst}}

Otrzymamy:

Uwaga

{{Uwaga|Tekst uwagi}}

Otrzymamy: