ASCIIDOC: "Неразрешенная директива в ...": "<stdin>" "или" index.adoc "

Question

Я новичок в ASCIIDOC и просто хотел знать ГДЕ возникает следующая проблема.

Настройка:

• Intellij с новым набором ASCIIDOC-Plugin
• neweset asciidoctor-maven-plugin с preserveDirectories = true

Я организовал свои asciidocs так:

• footer.adoc
• header.adoc
• index.adoc
• подпапка
  • index.adoc

Генерируемая документация выглядит следующим образом:

• footer.html
• header.html
• index.html
• вложенная папка
  • index.html

Теперь, если я хочу, чтобы subfolder / index.html также включал заголовок и нижний колонтитул, я подумал, что мне нужно записать include::../header.adoc[] в файл adoc, что не является проблемой для Intellij-Plugin.Но в сгенерированном html вы найдете следующую ошибку:

<p>Unresolved directive in index.adoc - include::../header.adoc[]</p>

Поэтому, когда я пишу следующее в adoc-файл: include::header.adoc[] сгенерированный html счастлив, но плагин Intellij ASCIIDOC показывает ошибку:

Unresolved directive in <stdin> - include::header.adoc[]

Мне просто интересно, является ли это ошибкой для команды плагинов Intellij или для команды плагинов Maven.Или, может быть, у кого-то есть решение этой проблемы?

И небольшой бонусный вопрос: можно ли настроить плагин maven так, чтобы он не генерировал header- / footer.htmls, поскольку они уже включены в фактические htmls?

Answer 1

У меня нет опыта работы с плагином maven, но у меня есть большой опыт работы с AsciiDoc, плагином IntelliJ и плагином Gradle.

Поведение плагина IntelliJ правильное.Когда вы конвертируете /subfolder/index.adoc, включаемые разрешения разрешаются относительно этого файла, поэтому правильное включение include::../header.adoc.

Вы описываете, что не указываете, какой файл отображать для подключаемого модуля maven (header.adoc конвертируется).Это может быть проблемой с плагином maven:

Вы просто указываете исходный путь, и все документы отображаются относительно этого исходного пути, и, следовательно, /subfolder/index.adoc имеет неправильный исходный путь.

С плагином Gradle, вы не можете указать все документы для конвертации.Это также позволит избежать конвертации header.adoc.Из документации по плагину maven я вижу, что вы можете указать только один файл.

Имея это в виду, я бы предложил изменить вашу файловую структуру таким образом, чтобы у вас были все файлы для преобразования в одномпапка.Затем вы можете указать эту папку, и другие файлы не должны быть преобразованы.Это также должно решить вашу проблему с относительным именем пути:

/src/docs/
      |
      +-common/
      |    |
      |    +-header.adoc
      |    +-footer.adoc
      +-chapters/
      +-main/
         |
         +-index1.adoc
         +-index2.adoc