Создать индексную страницу для ASCII документа
У меня есть много документов ASCII в разных местах, и я хочу создать индексную страницу, которая должна отображать эти документы. Но условие здесь в том, что я хочу перечислить все ссылки на документы на странице индекса, и если пользователь нажимает на любую ссылку, то должен отображаться только документ. Я не хочу отображать документы под оглавлением. Я просто хочу отобразить оглавление на странице индекса.
Есть какой-либо способ сделать это?
1 ответ
Если я вас правильно понимаю, вы хотите создать многодокументный веб-сайт, но вам нужна индексная страница, на которой отображается только оглавление, а другие документы размещаются в другом месте. Я полагаю, что лучший способ получить этот эффект - генерировать фрагментарные выходные данные XHTML с помощью цепочки инструментов DocBook. Я считаю, что это должно быть возможно с инструментами Asciidoctor, но я реализовал этот конкретный набор инструментов для пост-рендеринга только с оригинальным (основанным на Python) инструментом рендеринга AsciiDoc, как описано здесь. Эта настройка настраивается для создания страницы индекса TOC, которая ссылается на чанкированный выход (вы можете настроить уровень чанкирования).
Как вы уже поняли, автоматическая генерация TOC AsciiDoc работает только с настоящим документом, который требует включения подчиненного документа для получения заголовков для TOC. Я могу придумать способы сортировки игры, например, включить только заголовок включенного документа (include::path/to/document.adoc[lines=1]) и затем скрывать даже эти заголовки с помощью CSS или чего-то еще. Проблема в том, что ссылки в оглавлении будут указывать внутри, поэтому вам нужно как-то с этим справиться.
Другой способ - использовать любой из генераторов статических сайтов, которые поддерживают или могут быть легко расширены для поддержки AsciiDoc. То, о чем вы говорите, не является готовой функцией, о которой я знаю, но все они, по крайней мере, позволяют генерировать организованную навигацию типа TOC.