| 1 2 3 4 5 6 7 8 9 10 11 12 | ||
|
Editor: geon
Time: 2011/10/10 21:19:40 GMT+2 |
||
| Note: pridavani znacek 2x-3x, zapracovani navrhu | ||
added: .. image:: py30.png :align: right .. image:: py25.png :align: right changed: - *Prostor jmen* *Jmenný prostor, Prostor jmen* changed: - *Skládání tuple* *Skládání n-tic, skládání tuple* changed: -Záložky -======== - -- http://wiki.l10n.cz/P%C5%99ekladatelsk%C3%A9_slovn%C3%ADky - slovníky jiných open source programů plus další základní doporučení a rady - -From mintaka Fri Mar 26 23:47:27 +0100 2010 -From: mintaka -Date: Fri, 26 Mar 2010 23:47:27 +0100 -Subject: Návrh k úpravě -Message-ID: <20100326234727+0100@www.py.cz> - - - -From mintaka Fri Mar 26 23:47:41 +0100 2010 -From: mintaka -Date: Fri, 26 Mar 2010 23:47:41 +0100 -Subject: Návrh k úpravě -Message-ID: <20100326234741+0100@www.py.cz> - -RE. Namespace, Prostor jmen: "jmenný prostor" mi přijde jako zažitější -RE. Tuple packing, Skládání tuple: proč ne "skládání n-tic" ? -
Tento text vznikl na základě potřeby vytvořit jednotné české názvosloví pro překlad dokumentace jazyka Python. Dokument rovněž uvádí některé doporučení pro překladatele. Nejnovější verzi dokumentu můžete najít na stránkách http://www.py.cz .
Původním autorem tohoto textu je Jan Švec, který dal dokument na wiki a umožnil tak jeho úpravy pythonýrskou komunitou.
V následujícím odstavci se pokusím v pár větách popsat jazyk Python. Tuto definici můžete použít kdekoli, kde chcete Python v krátkosti charakterizovat.
Python je objektový, vysoce výkonný interpretovaný programovací jazyk. Podporuje velké množství vysokoúrovňových datových typů (řetězce, seznamy, asociativní pole ...). Již základní distribuce disponuje mnoha moduly, pomocí nichž lze řešit širokou škálu problémů (práce se sokety, službami internetu, vlákny ...). Jeho interpretr běží na mnoha platformách (Linux, Java, Macintosh, Palm OS, DOS nebo Windows). Interpret lze velice snadno rozšířit pomocí modulů napsaných v jazyku C (příp. C++). Další informace hledejte na domovských stránkách jazyka http://www.python.org nebo na stránkách české komunity programátorů a uživatelů jazyka Python http://www.py.cz .
Tato doporučení se týkají všech dokumentů, které se zmiňují o jazyce Python. Jejich dodržování je doporučováno - přináší sjednocení dokumentace a ulehčuje čtenářům studium dokumentace. Taktéž je doporučováno veškerou existující dokumentaci upravit podle těchto pravidel.
Nedoporučuji psát, že Python je plně objektový jazyk. Jestliže se totiž v jakémkoli textu objevila tato věta, zvedla se vlna reakcí, říkající že Python má daleko do jazyků typu Smalltalk. Nicméně potřebujete-li v odborném textu vyzdvihnout možnost objektově orientovaného programování v jazyce Python, pište Python je objektový jazyk. Další přívlastky si prosím nechte pro sebe.
U programů a modulů, u nichž je třeba jen pouze teoretická šance, že je bude používat uživatel ze zahraničí doporučuji psát veškeré dokumentační řetězce v angličtině. Jestliže anglickým jazykem příliš nevládnete, je lepší najít někoho, kdo by byl ochoten těch pár kilobytů textu přeložit. Komentáře by bylo možné psát i česky (popř. slovensky) - o to důležitější je ovšem kvalita dokumentačních řetězců.
Ve všech textech, které uvádí příklady zdrojových kódů a následně vykládají jednotlivé funkce nebo metody doporučuji uvést znaky () za názvem funkce/metody. Čtenáři to umožňuje lepší orientaci mezi proměnnými. (Například: Funkce os.walk() projde celý adresářový strom ..., Metoda store() třídy MyClass uchová objekt ...)
Je možné používat oba výrazy, ovšem v rámci jednoho dokumentu, pokud je to vhodné, jednotně. Totéž platí i pro příkazy typu print (např. Příkaz print vytiskne argumenty jemu předané na standardní výstup.).
U slovních spojení, které obsahují slovo typ (ve významu datový typ), doporučuji explicitní uvedení slova datový (např. Sekvenční datové typy obsahují konečné množství prvků.).