Попытка получить включает в себя работу с AsciiDoc Java интерфейс

Question

Я должен признать, что я новичок в AsciiDoc и ASciiDoctor ...

То, что я пытаюсь сделать это, чтобы сделать данный шаблон AsciiDoc (https://github.com/masch70/arc42-template-asciidoc) с заводной. Моим решением является использование интерфейса Java AsciiDoctor, который, как представляется, переписывает AsciiDoc, работающий с jRuby. код прекрасно работает до сих пор:

@Grab('org.asciidoctor:asciidoctor-java-integration:0.1.4') 
import org.asciidoctor.* 
def asciidoctor = Asciidoctor.Factory.create() 
def output = asciidoctor.renderFile(new File('index.ad'),[ 
'in_place':true, 
'section-numbers':true, 
'header_footer':true, 
]) 

но мне кажется, что он игнорирует включать разделы, которые выглядят довольно хорошо для меня:

include::sections/02_architecture_constraints.ad[] 

Вместо того, в том числе файл, ссылка на файл будет оказаны.

Руководство AsciiDoctor говорит, что включено: http://asciidoctor.org/docs/user-manual/#include-directive, так что вопрос в том, что я делаю неправильно?

Answer 1

Добавить safe вариант. По умолчанию параметр safe для API равен SECURE или 20 (целочисленное значение), которое отключает директивы include. Вы можете использовать любую из нижеприведенных пар ключ-значение:

'safe':'SAFE' 
'safe': 1 

'safe':'SERVER' 
'safe': 10 

'safe':'UNSAFE' //If you want 
'safe': 0 

Ниже следует работать.

def output = asciidoctor.renderFile(new File('index.ad'),[ 
'in_place':true, 
'header_footer':true, 
'safe':'SAFE' 
]) 

См. Running AsciiDoctor Securely для получения более подробной информации.

UPDATE
toc и section numbers атрибуты в CLI, так что мы просто нужно добавить необходимые атрибуты опций.

Простейший способ:

def output = asciidoctor.renderFile(new File('index.ad'),[ 
'in_place':true, 
'header_footer':true, 
'safe':'SAFE', 
'attributes': [toc: true, numbered: true] //I suppose 
]) 

Но выше плотно пары с основными реализациями ASCII DOC, который мы хотели абстрагироваться в первую очередь. Asciidoctor предоставляет полезные шаблоны Builder для преодоления этого беспорядка.

import static org.asciidoctor.AttributesBuilder.attributes 
import static org.asciidoctor.OptionsBuilder.options 
import org.asciidoctor.Placement 

Attributes attributes = attributes().tableOfContents(true) 
            .tableOfContents2(Placement.LEFT) 
            .sectionNumbers(true) 
            .get() 

Options options = options().inPlace(true) 
          .headerFooter(true) 
          .attributes(attributes) 
          .get() 

def output = asciidoctor.renderFile(new File('index.ad'), options) 

Посетите этот package from asciidoctor java integration, и это будет в значительной степени ясно, как вещи могут быть легко адаптированы.

Answer 2

Предлагаю вам попробовать asciidoctor gradle plugin.