Пакет: mlreportgen.dom
Суперклассы:
Тип пробела
Задает поведение для пробела и разрывов строки в тексте.
применяет заданную опцию пробела к пробелу в объекте ws
= WhiteSpace(option
)Text
или Paragraph
. Для PDF можно задать WhiteSpace
только для объекта Paragraph
.
option
— Поведение пробела'normal'
| 'nowrap'
| 'pre'
| 'pre-line'
| 'preserve'
| 'pre-wrap'
Поведение пробела, заданное как одно из этих значений.
Только 'preserve'
и 'normal'
влияют на Word вывод.
Значение | Описание |
---|---|
| Пробелы консервов и разрывы строки. |
| Для HTML и PDF, удаляет продвижение и конечные пробелы и сворачивает несколько пробелов в рамках текста к одиночному пробелу, игнорируя разрывы строки. Для Word, удаляет продвижение и конечные пробелы, игнорируя разрывы строки. |
| Последовательности пробелов выходят из строя в один пробел. Текст не переносится к следующей строке. Текст продвигается та же строка, пока с тегом |
| Пробел консервов. Текст переносится только на разрывах строки. Законы как |
| Последовательности пробелов выходят из строя в один пробел. Текст переносится когда необходимый и на разрывах строки. |
| Пробел консервов. Текст переносится когда необходимый и на разрывах строки. |
ws
— Тип пробелаmlreportgen.dom.WhiteSpace
Тип пробела, возвращенный как объект mlreportgen.dom.WhiteSpace
.
Id
— ID для элемента документаID для этого элемента документа, указанного как вектор символов. DOM генерирует уникальный идентификатор сеанса, когда он создает элемент документа. Можно задать собственный ID.
Тег
Пометьте для элемента документаПометьте для элемента документа, указанного как вектор символов.
Уникальный идентификатор сеанса сгенерирован как часть создания элемента документа. Сгенерированный тег имеет форму CLASS:ID
, где CLASS
является классом элемента, и ID
является значением свойства Id
объекта. Можно задать тег, чтобы заменить сгенерированный тег.
Например, чтобы облегчить идентифицировать, где проблема произошла во время генерации документов, можно задать собственное значение тега.
WhiteSpace
— Пробел и разрывы строки в тексте[]
(значение по умолчанию) | вектор символовЧтобы задать, как обработать пробел, используйте одно из этих значений.
Значение | Описание | Поддерживаемые Выходные типы |
---|---|---|
| Для HTML и PDF, удаляет пробелы вначале и конец текста. Несколько пробелов в рамках текста выходят из строя к одиночному пробелу. Для Word, удаляет пробелы вначале и конец текста. | Все выходные типы |
| Последовательности пробела выходят из строя в один пробел. Текст никогда не переносится к следующей строке. | HTML |
| Пробелы консервов и переводы строки. Законы как | Все выходные типы |
| Пробел консервов. Текст переносится только на разрывах строки. Законы как | HTML и PDF |
| Последовательности пробела выходят из строя в один пробел. Текст переносится. | HTML и PDF |
| Пробел консервов. Текст переносится когда необходимый и на разрывах строки | HTML и PDF |
Установка свойства WhiteSpace
добавляет соответствующий объект формата WhiteSpace
в свойство Style
. Удаление установки свойства WhiteSpace
удаляет объект WhiteSpace
.
Этот пример показывает эффект использования опции 'preserve'
для каждого из выходных форматов. В HTML, нескольких коллапсе пробелов, но конечном пробеле сохраняется. Сохранение конечного пробела полезно, например, когда вы создаете заголовок главы. Как правило, вы добавляете автоматический номер после текста 'Chapter: '
. Используя 'preserve'
сохраняет конечный пробел.
import mlreportgen.dom.*; doctype = 'html'; d = Document('test',doctype); open(d); p = Paragraph('This paragraph has extra spaces and one after the colon: '); p.Style = {WhiteSpace('preserve')}; append(p,'XX'); append(d,p); close(d); rptview(d.OutputPath);
Этот пример использует Word вывод. Несколько пробелов не выходят из строя, и конечный пробел сохраняется. Попытайтесь комментировать свойство WhiteSpace
. Несколько пробелов сохраняются, но конечный пробел удален.
import mlreportgen.dom.*; doctype = 'docx'; d = Document('test',doctype); open(d); p = Paragraph('This paragraph has extra spaces and one after the colon: '); p.Style = {WhiteSpace('preserve')}; append(p,'XX'); append(d,p); close(d); rptview(d.OutputPath);
Этот пример использует PDF вывод.
import mlreportgen.dom.*; doctype = 'pdf'; d = Document('test',doctype); open(d); p = Paragraph('This paragraph has extra spaces and one after the colon: '); % p.Style = {WhiteSpace('preserve')}; append(p,'XX'); append(d,p); close(d); rptview(d.OutputPath);
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.