asciidoctor

How can I add a generic page header with site navigation to an asciidoc document?

由 为君一笑 提交于 2021-02-19 08:20:40
问题 I'm trying to build a basic documentation site using asciidoctor. One thing I am struggling with is how I can inject a standard site header (a banner with a logo and top-level navigation) into each documentation page. I render my asciidoc directly to html from the command line. I have tried to find a way to somehow inject an extra div element and position it fixed at the top, but I can't figure out what mechanism to use for this. My early attempts involved using docinfo.html but that gets

Is there any way to change the text size (font size) of specific blocks when you using asciidoc?

由 岁酱吖の 提交于 2021-02-18 22:33:09
问题 I need your help. Now I am using AsciiDoc and AsciiDoctor to create some manuals. I want texts smaller on some specific blocks, for example wide table, wide list, and so on, but not want main texts smaller. Especially I need to make texts of wide tables smaller as my customer requests so. Is there any way? 回答1: You mention lists and tables... About lists, it can't be done as stated in AsciiDoctor Documentation: Unsupported Complex AsciiDoc markup is not permitted in attribute values, such as:

Is there any way to change the text size (font size) of specific blocks when you using asciidoc?

由 混江龙づ霸主 提交于 2021-02-18 22:32:27
问题 I need your help. Now I am using AsciiDoc and AsciiDoctor to create some manuals. I want texts smaller on some specific blocks, for example wide table, wide list, and so on, but not want main texts smaller. Especially I need to make texts of wide tables smaller as my customer requests so. Is there any way? 回答1: You mention lists and tables... About lists, it can't be done as stated in AsciiDoctor Documentation: Unsupported Complex AsciiDoc markup is not permitted in attribute values, such as:

Antora top navigation bar customization

由 喜你入骨 提交于 2021-02-07 19:11:55
问题 My question is quite simple though I cannot find anything that points to it in the documentation. I am generating documentation for a project with the default generator in Antora but I cannot figure out how to customize the top navigation bar, items on the right side, which have some defaults. Since the site is generated, where should I change, or how, those items? I do not want to list such items there. 回答1: There is an additional approach that does not require you to create a standalone UI:

Gradle 比 Maven 好为什么用的人少

由 好久不见. 提交于 2021-02-04 01:40:53
都是编译工具，各有各的优势。 貌似常用的几个大项目都将构建移到了 Gradle，例如 Hibernate，Spring。 相对来说也会增加不少 Gradle 的人气吧。 因为不怎么调整编译，很多时候感觉都差不多，但是 Gradle 的学习曲线确实比 Maven 要陡峭一点点。可以说是成也萧何败也萧何，Gradle 就是因为灵活性比 Maven 要好，所以开发插件，提供新的功能就要比 Maven 要容易。 同时 Gradle 也使用 Maven 的中央仓库，很多时候可以说是站在巨人的肩膀上面，在 Gradle 的设计时候就已经考虑过了 Maven 已经存在的一些问题。 就是因为 Gradle 设计灵活性又导致了学习起来难学习。 不太喜欢的是 Gradle 的包结构，当包下载下来后会打上标签，有时候都不知道包下哪里去了，Maven 这里比较直观，就直接能找到。 尤其是在调试的时候，希望能够删掉一个包，使用一个已经编译好的包替代下，直接拷贝过去就好了，使用 Gradle 在这里有点惆怅。 喜欢 Gradle 是，Gradle 比较容易出文档，其实这个问题也不是大问题，Gradle 可以直接编译 Asciidoctor 的文档，然后输出各种格式。 下载速度来说，一般大公司可能都会有 Central Maven 的镜像，感觉上差别不是非常多。 https://www.ossez.com/t
订阅 asciidoctor