💵 Привет, будущие заказчики! Хочу рассказать об одном из самых больших своих переводов. Я часто перевожу разную документацию к программному обеспечению, но этот заказ был особенным, потому что это не просто документация, это целый учебник по языку программирования Python!
Не везде было просто, бывали такие термины, для которых не работает очевидный перевод. Хороший пример, чтобы показать, почему машинный перевод не заменит человеческого.
Возьмём, например, 6 главу из книги. Её заголовок “Chapter 6 – Python Comprehensions” и первый пункт “List Comprehensions”. Онлайн переводчики не понимают контекста перевода и переводят максимально дословно “постижение Python” или “понимание Python”. Я перевела как “генераторы списков”, это перевод, который подходит больше всего, но “абстракция списков” или “включение списков” тоже бы подошло (в зависимости от контекста).
И таких терминов по тексту множество. Какие-то общие для программирования, какие-то особенные только для Python. Где-то даже понадобилось проконсультироваться с программистом, чтобы убедиться в корректности перевода.
😰 Ах да, нужно же было ещё и сохранить стиль текста. Чтобы жирный текст оставался жирным, а код оставался кодом. Для этого есть разные инструменты. Заказчик выбрал Markdown, с каждой главой в отдельном файле. Я бы для перевода всяких документаций, особенно для личного пользования, так же рекомендовала бы бесплатную программу CherryTree, там тоже можно удобно скопировать стили текста и локально оформить документацию.
Пример перевода
Исходный текст (английский язык):
Chapter 15 - Logging
Python provides a very powerful logging library in its standard library. A lot of programmers use print statements for debugging (myself included), but you can also use logging to do this. It’s actually cleaner to use logging as you won’t have to go through all your code to remove the print statements. In this chapter we’ll cover the following topics:
- Creating a simple logger
- How to log from multiple modules
- Log formatting
- Log configuration
By the end of this chapter, you should be able to confidently create your own logs for your applications. Let’s get started!
Creating a Simple Logger
Creating a log with the logging module is easy and straight-forward. It’s easiest to just look at a piece of code and then explain it, so here’s some code for you to readПеревод на русский язык:
# Глава 15 - Логирование
Python предоставляет очень мощную библиотеку логирования в своей стандартной сборке. Многие программисты используют операторы печати для отладки (в том числе и я), но вы также можете использовать для этого логировнаие. Если вы не хотите, читая свой код, бесконечно удалять операторы print, использование логирования - более чистый метод. В данном разделе мы рассмотрим следующее:
- Создание простого логгера
- Как вести журнал из нескольких модулей
- Форматирование лога
- Конфигурация лога
К концу этой главы вы должны быть в состоянии уверенно создавать собственные логи для своих приложений. Давайте приступим!
## Создание простого логгера
Создать лог с помощью модуля logging легко и просто. Проще всего посмотреть на кусок кода, а затем объяснить его, так что вот вам код для чтения:✏️ ➡️ Для заказа перевода или если у вас возникли вопросы: https://innalevi.com/kontakty/
🧮 ➡️ Посчитаете стоимость своего заказа в моем онлайн-калькуляторе по ссылке: https://innalevi.com/kalkulyator
💵 ➡️ Посмотреть все скидки и цены на перевод можно тут: https://innalevi.com/oformit-zakaz/
🗣️ ➡️ Почитать живые отзывы можно вот на этой странице: https://innalevi.com/otzyvy
Русский 
English 
Deutsch