Создать индексную страницу для документа ASCII - PullRequest
0 голосов
/ 07 июня 2018

У меня много документов ASCII в разных местах, и я хочу создать индексную страницу, которая должна отображать эти документы.Но условие здесь в том, что я хочу перечислить все ссылки на документы на странице индекса, и если пользователь нажимает на любую ссылку, то должен отображаться только документ.Я не хочу отображать документы под оглавлением.Я просто хочу отобразить оглавление на странице индекса.

Есть ли способ сделать это?

1 Ответ

0 голосов
/ 12 июня 2018

Если я вас правильно понимаю, вы хотите создать многодокументный веб-сайт, но вам нужна индексная страница, на которой отображается только оглавление, а остальные документы размещаются в другом месте.Я полагаю, что лучший способ получить этот эффект - генерировать фрагментарные выходные данные XHTML с помощью цепочки инструментов DocBook.Я считаю, что это должно быть возможно с инструментами Asciidoctor , но я реализовал этот конкретный набор инструментов для пост-рендеринга только с оригинальным (основанным на Python) инструментом рендеринга AsciiDoc, как задокументировано здесь .Эта настройка настраивается для генерации страницы индекса TOC, которая ссылается на чанкованный вывод (вы можете настроить уровень чанкирования).

Как вы уже выяснили, автоматическая генерация TOC AsciiDoc работает только с настоящим документом, которыйтребует включения подчиненного документа, чтобы получить их заголовки для оглавления.Я могу придумать способы игры, например, включить только заголовок включенного документа (include::path/to/document.adoc[lines=1]) и затем скрыть даже эти заголовки с помощью CSS или чего-то еще.Проблема в том, что ссылки в оглавлении будут указывать внутренне, поэтому вам нужно как-то с этим справиться.

Другой способ - использовать любой из генераторов статического сайта , которые поддерживаютили может быть легко расширен для поддержки AsciiDoc.То, о чем вы говорите, не является готовой функцией, о которой я знаю, но все они по крайней мере позволяют генерировать организованную навигацию типа TOC.

...