Пакет: 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
- идентификатор для этого элемента документаИдентификатор для этого элемента документа, заданный как вектор символов или строковый скаляр. DOM генерирует уникальный идентификатор сеанса при создании элемента документа. Вы можете задать свой собственный идентификатор.
Tag
- тег для этого элемента документаТег для этого элемента документа, заданный как вектор символов или строковый скаляр.
DOM генерирует тег с уникальным сеансом как часть создания этого объекта. Сгенерированный тег имеет форму CLASS: ID, где CLASS является классом объекта, а ID является значением Id
свойство объекта. Определение собственного значения тега может помочь вам определить, где произошла проблема во время генерации документа.
WhiteSpace
- Как относиться к пустому пространству в тексте[]
(по умолчанию) | 'normal'
| 'nowrap'
| ...Как обработать пустое пространство в тексте, заданное как одно из значений в этой таблице.
Значение | Описание | Поддерживаемые выходные типы |
---|---|---|
| Для HTML и PDF это значение удаляет пространства в начале и конце текста. Несколько пространства в тексте свернуты в одно пространство. Для Word это значение удаляет пространства в начале и конце текста. | Все |
| Последовательности белого пространства коллапсируют в единое пустое пространство. Текст никогда не переносится в следующую линию. | HTML |
| Сохраняет пустое пространство. Текст переносится только на пропуски линий. Действует как | HTML и PDF |
| Последовательности белого пространства коллапсируют в единое пустое пространство. Текст переносится при необходимости и на пропусках линий. | HTML и PDF |
| Сохраняет пустое пространство. Текст переносится при необходимости и на пропусках линий. | HTML и PDF |
| То же, что и 'pre'. | Все |
Установка WhiteSpace
свойство добавляет соответствующее mlreportgen.dom.WhiteSpace
форматировать объект в Style
свойство. Установка 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. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.