Включить текст из одной квартиры в другую

Question

Представьте, что у меня есть три подходящих файла:

main.apt

Info, details, etc..

    some text

Configuration

    some text

child1.apt

Info, details, etc..

    some text

Configuration

    [Same text as MAIN.APT configuration]

child2.apt

Info, details, etc..

    some text

Configuration

    [Same text as MAIN.APT configuration]

Я хочу следовать принципу СУХОЙ (не повторяться) и повторно использовать текст из main.apt и добавлять его в child1.apt и child2.apt. Это действительно поможет в написании документации.

Я попытался использовать фрагменты (сначала сгенерированная документация сайта с идентификаторами, а затем добавлены ссылки на эти идентификаторы):

~~START SNIPPET: id
~~END SNIPPET: id
%{snippet|id=id|url=http://svn.example.com/path/to/main.html}

И сгенерированный сайт, используя

     mvn site:stage

, но это не работает, потому что он вставляет блок текста HTML, который не форматируется как HTML. Я также попробовал дословно параметр в отрывках, это не помогает.

Может быть, у кого-то есть решение этой проблемы и / или возникла такая же проблема? Пожалуйста, расскажите мне свою историю, предложения. Решение спасло бы мой день:)

Answer 1

Используйте скорость. Переименуйте child1.apt и child2.apt в child1.apt.vm и child2.apt.vm соответственно. Затем заменить

[Same text as MAIN.APT configuration]

с

#parse("main.apt")

В site.xml включите дочерние страницы, как и любые другие:

<item name="child 1" href="child1.html"/>