<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
<html>
<head>
<meta HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-2">
<title>Doporučení pro překlad odborných textů jazyka Python - verze 1.1</title>
</head>
<body>
<div align="center">
<h2>Doporučení pro překlad odborných textů jazyka Python</h2>
<b>
Jan Švec
<a href="mailto:honza@py.cz"><honza@py.cz></a>
</b><br>
<b>verze 1.1 (2. října 2002)</b><br>
<font size="-1">Copyright © 2002 Jan Švec</font>
</div>
<hr>
<ul>
<li>
<h3>Úvod</h3>
<p>
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 Českého sdružení programátorů a uživatelů jazyka Python (PyCZ,
<a href="http://py.cz">http://py.cz</a>).
</p>
<p>
Autorem tohoto textu je Jan Švec
<a href="mailto:honza@py.cz"><honza@py.cz></a>.
Připomínky týkající se pravopisu a překlepů zasílejte prosím na jeho
e-mailovou adresu.
</p>
<p>
Verze tohoto dokumentu je 1.1 (2. říjen 2002). Jde o druhou verzi, do
které byly doplněny (příp. poupraveny) především překlady termínů
<i>list comprehension</i>, <i>slice</i> <i>statement</i>.
</p>
<p>
Věcné připomínky k překladům termínů a jednotlivým doporučením můžete
zasílat do e-mailové diskusní skupiny
<a href="mailto:python@py.cz"><python@py.cz></a>.
</p>
</li>
<li>
<h3>Definice jazyka Python</h3>
<p>
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.
</p>
<p><i>
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).
Interpretr 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
<a href="http://www.python.org">http://www.python.org</a> nebo na
stránkách Českého sdružení programátorů a uživatelů jazyka Python (PyCZ,
<a href="http://py.cz">http://py.cz</a>).
</i><p>
<p>
<font size="-1">
Toto je pouze nástin možného "oficiálního" českého popisu jazyka
Python. Otevírám prostor pro další diskusi. Příspěvky zasílejte
do mailing-listu python@py.cz.
</font>
</p>
</li>
<li>
<h3>Doporučení pro překlad dokumentace</h3>
<p>
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.
</p>
<ul>
<li>
<h4>Objektové programování v Pythonu</h4>
<p>
Nedoporučuji psát, že Python je
<i>plně objektový jazyk</i>. 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. Diskusi na toto téma
přenechám jiným (prosím, nezasílejte příspěvky ohledně tohoto
tématu do diskuse python@py.cz), nicméně potřebujete-li
v odborném textu vyzdvihnout možnost objektově orientovaného
programování v jazyce Python, pište
<i>Python je objektový jazyk</i>. Další přívlastky si prosím
nechte pro sebe.
</p>
</li>
<li>
<h4>Jazyk dokumentačních řetězců</h4>
<p>
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ů.
</p>
</li>
<li>
<h4>Psaní funkcí a metod</h4>
<p>
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: <i>Funkce os.walk()
projde celý adresářový strom ...</i>, <i>Metoda store() třídy
MyClass uchová objekt ...</i>)
</p>
</li>
<li>
<h4>Argumenty vs. parametry</h4>
<p>
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
<i>print</i> (např. <i>Příkaz print vytiskne argumenty jemu
předané na standardní výstup.</i>).
</p>
</li>
<li>
<h4>Datové typy</h4>
<p>
U slovních spojení, které obsahují slovo typ (ve významu datový
typ), doporučuji explicitní uvedení slova datový (např.
<i>Sekvenční <u>datové</u> typy obsahují konečné množství
prvků.</i>).
</p>
</li>
<li>
<h4>Slovník termínů pro překlad</h4>
<p>
Následující výčet termínů lze použít pro překlad dokumentace
z anglického jazyka do jazyka českého (popř. slovenského).
</p>
<ul>
<li>
<b>Builtin <i>(function, module, namespace)</i></b> -
<i>Interní</i>, pouze výjimečně je možné použít <i>Vestavěný</i>
nebo <i>Vnitřní</i>.
</li>
<li>
<b>Dictionary</b> - v dokumentaci pro začátečníky je lepší
psát <i>Slovník</i>, zároveň je třeba uvést další možný překlad
<i>Asociativní pole</i>. V textech pro pokročilejší bych se
spíše přikláněl k druhému výrazu.
</li>
<li>
<b>Catching an exception</b> - <i>Odchycení výjimky</i>
</li>
<li>
<b>Default argument values</b> -
<i>Implicitní hodnota argumentu</i>, nebo opisem za použití
sousloví <i>Nepovinný argument</i>
</li>
<li>
<b>Exceptions</b> - <i>Výjimky</i>
</li>
<li>
<b>Exception throws</b> - <i>Výjimka se šíří</i>
</li>
<li>
<b>High level data types</b> - <i>Vysokoúrovňové datové typy</i>
</li>
<li>
<b>Immutable types</b> - <i>Neměnné typy</i>
</li>
<li>
<b>Indentation</b> - při prvním výskytu v textu doporučuji
použít <i>Odsazení od kraje</i>, později lze zkrátit na
<i>Odsazení</i>
</li>
<li>
<b>Keyword arguments</b> - <i>Keyword argumenty</i>
</li>
<li>
<b>Lambda functions</b> - <i>Anonymní lambda funkce</i>,
případně <i>Lambda funkce</i>
</li>
<li>
<b>List</b> - <i>Seznam</i>
</li>
<li>
<b>List comprehension</b> - Po delším čase se konečně našel
vystihující a jednoduchý překlad - <i>Stručný seznam</i>
</li>
<li>
<b>Mapping types</b> - <i>Mapované typy</i>
</li>
<li>
<b>Mutable types</b> - <i>Proměnné typy</i>
</li>
<li>
<b>Namespace</b> - <i>Prostor jmen</i>
</li>
<li>
<b>Positional arguments</b> - <i>Poziční argumenty</i>
</li>
<li>
<b>Raising exception</b> - <i>Vyvolání výjimky</i>
</li>
<li>
<b>Raw string</b> - <i>Raw řetězec</i>
</li>
<li>
<b>Sequence types</b> - <i>Sekvenční typy</i>, podle doporučení
výše psát raději <i>Sekvenční datové typy</i>, zkráceně
<i>Sekvence</i>.
</li>
<li>
<b>Sequence unpacking</b> - <i>Rozklad sekvencí</i>
</li>
<li>
<b>Slice (1)</b> (jako způsob, kterým je možné indexovat více
prvků najednou) - předně lze použít doporučovaný překlad
<i>Indexování podsekvencí</i> případně
<i>Indexování subsekvencí</i>, až pokud by opakované použití
výše uvedených termínů nebylo vhodné, lze použít i překlad
<i>Slice konstrukce</i>, případně <i>Slice</i>.
</li>
<li>
<b>Slice (2)</b> (jako výsledek slice konstrukce) - překládat
jako <i>Podsekvence</i>, <i>Subsekvence</i>. Výjimečně také
jako <i>Slice</i>, případně použít výrazu <i>Řez</i>. Je-li to
nutné, použijte opisný tvar <i>Výsledek slice konstrukce</i>,
případně <i>Podmnožina prvků seznamu (tuple)</i>.
</li>
<li>
<b>Statement</b> - vždy překládat jako <i>Příkaz</i>.
</li>
<li>
<b>Tuple</b> - <i>Tuple</i>, tento výraz nepřekládat,
v některých případech je rovněž ovšem možný překlad <i>n-tice</i>.
(Například: <i>Dvojice souřadnic (x, y)</i> je lepší než
<i>Tuple souřadnic (x, y)</i>).
</li>
<li>
<b>Tuple packing</b> - <i>Skládání tuple</i>
</li>
<li>
<b>Unhandled exception</b> - <i>Neobsloužená výjimka</i>
</li>
</ul>
</li>
</ul>
</li>
<li>
<h3>Licence</h3>
<p>
Tento dokument byl vytvořen pro České sdružení programátorů a uživatelů
jazyka Python (PyCZ, <a href="http://py.cz">http://py.cz</a>). Dokument je
možné šířit a/nebo modifikovat pod licencí GPL verze 2 (nebo, podle vaší
volby, libovolnou novější verzí).
</p>
<p>
Copyright © 2002 Jan Švec
<a href="mailto:honza@py.cz"><honza@py.cz></a>
</p>
</ul>
</body>
</html>