wuffur: переводы
Style Guide for Python Code
→- Code should be written in a way that does not disadvantage other implementations of Python (PyPy, Jython, IronPython, Pyrex, Psyco, and such).
0 - Код следует писать так, чтобы не было неудобно его использовать на других реализация языка Python (PyPy, Jython, IronPython, Pyrex, Psyco, и других)
→These lines should be included after the module's docstring, before any other code, separated by a blank line above and below.
0 Данные строки должны быть включены после docstring в модуле, до любого другого кода, и отделены сверху и снизу пустой строкой.
→If you have to have Subversion, CVS, or RCS crud in your source file, do it as follows.
__version__ = "$Revision: 68852 $"
# $Source$
__version__ = "$Revision: 68852 $"
# $Source$
0 Если в файле с вашими исходниками вам приходится иметь грязь от систем управления версиями, таких как Subversion, CVS, или RCS, делайте следующее.
__version__ = "$Revision: 68852 $"
# $Source$
__version__ = "$Revision: 68852 $"
# $Source$
→For one liner docstrings, it's okay to keep the closing """ on the same line.
0 Для однострочных docstrings, ничего что закрывающие """ находятся на одной линии.
→Note that most importantly, the """ that ends a multiline docstring should be on a line by itself, and preferably preceded by a blank line, e.g.:
"""Return a foobang
Optional plotz says to frobnicate the bizbaz first.
"""
"""Return a foobang
Optional plotz says to frobnicate the bizbaz first.
"""
0 Имейте в виду, что наиболее важно, чтобы """, которая закрывает многострочные docstrings, должны быть на отдельной строке, и желательно после них была пустая линия, как здесь:
"""Возвращаем foobang
Необязательный plotz говорит, что он бесцельно манипулирует bizbaz первым.
"""
"""Возвращаем foobang
Необязательный plotz говорит, что он бесцельно манипулирует bizbaz первым.
"""
→PEP 257 describes good docstring conventions.
0 PEP 257 описывает хорошие соглашения по docstrings.
→This comment should appear after the "def" line.
0 Комментарий должен появиться после строки c определенем "def".
→Docstrings are not necessary for non-public methods, but you should have a comment that describes what the method does.
0 Docstrings не обязательны для не public методов, но вам следует ставить комменатрии, которые описывают, что метод выполняет.
→Write docstrings for all public modules, functions, classes, and methods.
0 Пишете docstrings для public модулей, функций, классов и методов.
→Conventions for writing good documentation strings (a.k.a. "docstrings") are immortalized in PEP 257.
0 Соглашение о написании хороших строк документации (docstrings) увековечены в PEP 257
→Don't do this:
x = x + 1 # Increment x
But sometimes, this is useful:
x = x + 1 # Compensate for border
x = x + 1 # Increment x
But sometimes, this is useful:
x = x + 1 # Compensate for border
0 Не пишите так:
x = x + 1 # Инкремент x
Но иногда, бывает полезно написать:
x = x + 1 # компенсатор для границы
x = x + 1 # Инкремент x
Но иногда, бывает полезно написать:
x = x + 1 # компенсатор для границы
→Inline comments are unnecessary and in fact distracting if they state the obvious.
0 Внутристрочные комментарии необязательны и фактически отталкивают, если они обьясняют очевидное.
→Inline comments should be separated by at least two spaces from the statement.
They should start with a # and a single space.
They should start with a # and a single space.
0 Внутристрочные комментарии следует отделять как минимум двумя пробелами от выражения.
Им следует начинаться с одного символа # и одного пробела.
Им следует начинаться с одного символа # и одного пробела.
→Use inline comments sparingly.
0 Поменьше используйте внутристрочные комментарии.
→Inline Comments
0 Внутристрочные комментарии
→Paragraphs inside a block comment are separated by a line containing a single #.
0 Параграфы внутри блокового комментария разделены строкой содержащей один символ #.
→Each line of a block comment starts with a # and a single space (unless it is indented text inside the comment).
0 Каждая стока блоковых комментариев начинается с # и заканчивается одним пробелом (до тех пор пока нет текста с отступами внутри комментария).
→Block comments generally apply to some (or all) code that follows them, and are indented to the same level as that code.
0 Блоковые комментарии обычно добавляются к некоторой части(или всему) коду, который их сопровождает и выравнены на тот же уровень, что и код программы.
→Block Comments
0 Блоки комментариев.
→Python coders from non-English speaking countries: please write your comments in English, unless you are 120% sure that the code will never be read by people who don't speak your language.
0 Программисты на питоне из не англоговорящих стран: пожалуйста пишите свои комментарии на английском, до тех пор пока вы на 120% будете уверены, что ваш код никогда не будут читать люди, которые не знают ваш язык.
Резюме
- Пол:
- мужчина
- Родной язык:
- русский
- С нами:
- с 17 марта 2009 г. (6422 дня)
- Деятельность:
-
3282 версии перевода
с общим рейтингом 172
325 комментариев
Карма: 13 (оценок: 13)