Как улучшить поведение разрыва строки в asciidoctor-pdf? - PullRequest
Новая
       53

Как улучшить поведение разрыва строки в asciidoctor-pdf?

0 голосов
/ 05 февраля 2019

Я пишу документацию в asciidoctor, которая также должна включать примеры для определения bean-компонента Spring, написанного на XML.Этот пример взят непосредственно из кода, который находится в том же хранилище Mercurial.Так что в моей настоящей документации я хочу использовать макрос Asciidoctors include (однако в приведенном здесь примере не используется include, потому что в этом нет необходимости демонстрировать проблему).

Теперь в строке есть довольно длинные строкиXML, который оказался проблемой, особенно в asciidoctor-pdf.Например, когда я конвертирую этот фрагмент asciidoc в PDF: 

== Example

[source%nowrap,xml]
----
  <bean class="com.mycompany.stuff.FooBarFactory"
     name="customExtension.myFooBarFactory"
     depends-on="base.oneBaseBean,base.anotherBaseBean,customExtension.someOtherBean"
     p:customFooBar="com.mycompany.stuff.modules.customExtension.foobars.FooBarWithAVeryLongName"
/>
----

Это будет ужасно смотреться в PDF, с или без Nowrap.Когда я копирую код из PDF, концы длинных строк находятся за пределами страницы.Существует также разрыв строки в зависимости от, но при копировании фрагмента из PDF «зависит от» стало «зависит от».

Конечно, я мог бы скопировать содержимое XML непосредственно в мой файл asciidoc иадаптируйте форматирование, но это не то решение, которое я бы предпочел, потому что тогда кто-то изменит XML-файл и забудет также обновить документацию.

Можно ли изменить способ, которым asciidoctor-pdf разбивает словаНапример, что-то эквивалентное свойству CSS word-wrap: break-word (это, вероятно, уже поможет)?

...