The translation is temporarily closed for contributions due to maintenance, please come back later.
The translation was automatically locked due to following alerts: Could not merge the repository.
Zen

Translation

English
-- Good
if (a == true and b == false) or (a == false and b == true) then
<...>
end

-- Bad
if a == true and b == false or a == false and b == true then
<...>
end

-- Good but not explicit
if a ^ b == true then
end
222/2210 · 221
English Russian Actions
There should be one -- and preferably only one -- obvious way to do it.
Должен существовать один -- и, желательно, только один -- очевидный способ сделать это.
Although that way may not be obvious at first unless you're Dutch.
Хотя он поначалу может быть и не очевиден.
Now is better than never.
Сейчас лучше, чем никогда.
Although never is often better than *right* now.
Хотя никогда зачастую лучше, чем прямо сейчас.
If the implementation is hard to explain, it's a bad idea.
Если реализацию сложно объяснить -- идея плоха.
If the implementation is easy to explain, it may be a good idea.
Если реализацию легко объяснить -- идея, возможно, хороша.
Namespaces are one honking great idea -- let's do more of those!
Пространства имен -- отличная штука! Сделаем побольше!
https://www.python.org/dev/peps/pep-0020/
https://www.python.org/dev/peps/pep-0020/
Indentation and formatting
Отступы и форматирование
4 spaces instead of tabs. PIL suggests using two spaces, but a programmer looks at code from 4 to 8 hours a day, so it's simpler to distinguish indentation with 4 spaces. Why spaces? Similar representation everywhere.
4 пробела, а не табуляция. Библиотека PIL предлагает использовать два пробела, но разработчик читает код от 4 до 8 часов в день, а различать отступы с 4 пробелами легче. Почему именно пробелы? Соблюдение однородности.
You can use vim modelines:
Можно использовать строки режима (modelines) vim:
-- vim:ts=4 ss=4 sw=4 expandtab
-- vim:ts=4 ss=4 sw=4 expandtab
A file should ends w/ one newline symbol, but shouldn't ends w/ blank line (two newline symbols).
Файл должен заканчиваться на один символ переноса строки, но не должен заканчиваться на пустой строке (два символа переноса строки).
Every do/while/for/if/function should indent 4 spaces.
Отступы всех do/while/for/if/function должны составлять 4 пробела.
Related ``or``/``and`` in ``if`` must be enclosed in the round brackets (). Example:
``or``/``and`` в ``if`` должны быть обрамлены круглыми скобками (). Пример:
-- Good
if (a == true and b == false) or (a == false and b == true) then
<...>
end

-- Bad
if a == true and b == false or a == false and b == true then
<...>
end

-- Good but not explicit
if a ^ b == true then
end
if (a == true and b == false) or (a == false and b == true) then
<...>
end -- хорошо

if a == true and b == false or a == false and b == true then
<...>
end -- плохо

if a ^ b == true then
end -- хорошо, но не явно
Type conversion
Преобразование типов
Do not use concatenation to convert to string or addition to convert to number (use ``tostring``/``tonumber`` instead):
Не используйте конкатенацию для конвертации в строку или в число (вместо этого воспользуйтесь ``tostring``/``tonumber``):
-- Bad
local a = 123
a = a .. ''

-- Good
local a = 123
a = tostring(a)

-- Bad
local a = '123'
a = a + 5 -- 128

-- Good
local a = '123'
a = tonumber(a) + 5 -- 128
local a = 123
a = a .. ''
-- плохо

local a = 123
a = tostring(a)
-- хорошо

local a = '123'
a = a + 5 -- 128
-- плохо

local a = '123'
a = tonumber(a) + 5 -- 128
-- хорошо
Try to avoid multiple nested ``if``'s with common body:
Постарайтесь избегать несколько вложенных ``if`` с общим телом оператора:
-- Good
if (a == true and b == false) or (a == false and b == true) then
do_something()
end

-- Bad
if a == true then
if b == false then
do_something()
end
if b == true then
if a == false then
do_something()
end
end
if (a == true and b == false) or (a == false and b == true) then
do_something()
end
-- хорошо

if a == true then
if b == false then
do_something()
end
if b == true then
if a == false then
do_something()
end
end
-- плохо
Avoid multiple concatenations in one statement, use ``string.format`` instead:
Избегайте множества конкатенаций в одном операторе, лучше использовать ``string.format``:
-- Bad
function say_greeting(period, name)
local a = "good " .. period .. ", " .. name
end

-- Good
function say_greeting(period, name)
local a = string.format("good %s, %s", period, name)
end

-- Best
local say_greeting_fmt = "good %s, %s"
function say_greeting(period, name)
local a = say_greeting_fmt:format(period, name)
end
function say_greeting(period, name)
local a = "good " .. period .. ", " .. name
end
-- плохо

function say_greeting(period, name)
local a = string.format("good %s, %s", period, name)
end
-- хорошо

local say_greeting_fmt = "good %s, %s"
function say_greeting(period, name)
local a = say_greeting_fmt:format(period, name)
end
-- лучше всего
Use ``and``/``or`` for default variable values
Используйте ``and``/``or`` для указания значений переменных, используемых по умолчанию,
-- Good
function(input)
input = input or 'default_value'
end

-- Ok but excessive
function(input)
if input == nil then
input = 'default_value'
end
end
function(input)
input = input or 'default_value'
end -- хорошо

function(input)
if input == nil then
input = 'default_value'
end
end -- нормально, но избыточно
``if``'s and return statements:
операторов ``if`` и возврата:
-- Good
if a == true then
return do_something()
end
do_other_thing()

-- Bad
if a == true then
return do_something()
else
do_other_thing()
end
if a == true then
return do_something()
end
do_other_thing() -- хорошо

if a == true then
return do_something()
else
do_other_thing()
end -- плохо
Using spaces:
Использование пробелов:
Don't use spaces between function name and opening round bracket. Split arguments with one whitespace character:
не следует вставлять пробелы между именем функции и открывающей круглой скобкой, но аргумент необходимо разделять одним символом пробела
-- Bad
function name (arg1,arg2,...)
end

-- Good
function name(arg1, arg2, ...)
end
function name (arg1,arg2,...)
end -- плохо

function name(arg1, arg2, ...)
end -- хорошо
Add a space after comment markers:
добавляйте пробел после маркера комментария

Loading…

User avatar None

String updated in the repository

testing_project / Documentation: dev_guide/lua_style_guide — Russian

-- Good
if (a == true and b == false) or (a == false and b == true) then
<...>
end

-- Bad
if a == true and b == false or a == false and b == true then
<...>
end

-- Good but not explicit
if a ^ b == true then
end
if (a == true and b == false) or (a == false and b == true) then
<...>
end -- хорошо

if a == true and b == false or a == false and b == true then
<...>
end -- плохо

if a ^ b == true then
end -- хорошо, но не явно
2 years ago
Browse all string changes

Things to check

Mismatching line breaks

Number of new lines in translation does not match source

Reset

Glossary

English Russian
No related strings found in the glossary.

String information

String age
2 years ago
Last updated
2 years ago
Source string age
2 years ago
Translation file
locale/ru/LC_MESSAGES/dev_guide/lua_style_guide.po, string 38