Translation of a Python manual from English to Russian with formatting in Markdown

Перевод учебника с английского на русский

💵 Hello, future clients! I want to tell you about one of my biggest translations. I often translate various software documentation, but this order was unique because it's not just documentation; it's a whole textbook on the Python programming language!

It wasn't always straightforward; there were such terms for which the apparent translation did not work. An excellent example to show why machine translation will not replace humans.

Let's take, for example, Chapter 6 from the book. Its title is “Chapter 6 – Python Comprehensions,” and the first point is “List Comprehensions.” Online translators do not understand the translation context and translate as literally as possible "comprehension of Python" or "understanding of Python." I translated it as "генераторы списков" (list generators). This is the translation that fits most, but "абстракция списков" (list abstraction) or "включение списков" (list inclusion) would also work (depending on the context).

And there are many such terms throughout the text. Some are common for programming, and some are special only for Python. Somewhere I even had to consult with a programmer to ensure the correctness of the translation.

😰 Oh yes, I also needed to keep the style of the text. So that bold text remains bold, and code remains code. There are various tools for this. The customer chose Markdown, with each chapter in a separate file. I would also recommend the free program CherryTree for translating all sorts of documentation, especially for personal use, there you can also conveniently copy text styles and locally format the documentation.

Editing in Markdown

Translation sample

Source (English):

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

Target (Russian):

# Глава 15 - Логирование
Python предоставляет очень мощную библиотеку логирования в своей стандартной сборке. Многие программисты используют операторы печати для отладки (в том числе и я), но вы также можете использовать для этого логировнаие. Если вы не хотите, читая свой код, бесконечно удалять операторы print, использование логирования - более чистый метод. В данном разделе мы рассмотрим следующее:
- Создание простого логгера
- Как вести журнал из нескольких модулей
- Форматирование лога
- Конфигурация лога
К концу этой главы вы должны быть в состоянии уверенно создавать собственные логи для своих приложений. Давайте приступим!
## Создание простого логгера
Создать лог с помощью модуля logging легко и просто. Проще всего посмотреть на кусок кода, а затем объяснить его, так что вот вам код для чтения:

✏️ ➡️ To order a translation or if you have any questions: https://innalevi.com/kontakty/

🧮 ➡️ Calculate the cost of your order with my online calculator at this link: https://innalevi.com/kalkulyator

💵 ➡️ You can view all discounts and translation prices here: https://innalevi.com/oformit-zakaz/

🗣️ ➡️ You can read live reviews on this page: https://innalevi.com/otzyvy

en_USEnglish