我正在尝试使用asciidoctor构建一个基本的文档站点 . 我正在努力的一件事是如何将标准网站 Headers （带有徽标和顶级导航的 Banner ）注入每个文档页面 .
我从命令行直接将我的asciidoc渲染为html . 我试图找到一种方法以某种方式注入一个额外的 div 元素并将其固定在顶部，但我无法弄清楚使用什么机制 . 我早期的尝试涉及使用 docinfo.html ，但是它会被注入 <head> 元素中的html，而不是 <body> .
我知道像Jekyll这样的全面发布系统允许我配置可以解决这个问题的“前端问题”，但我希望有一个机制或技巧可以使用vanilla asciidoctor来实现这一目标 .
1 回答
Ted Bergeron在邮件列表mentioned一个简单的项目：
Demo website刚刚使用Asciidoctor创建 .
检查corresponding repo以查看文件以及如何创建站点（仅使用一个命令） .
总结：只需创建一个包含您的站点导航的头文件asciidoc文件（在演示站点中使用表标记完成），不包括0级（文档） Headers . 将此 Headers 文件放在网站每个页面的顶部 . 然后通过在项目上运行
asciidoctor *.txt来渲染 .