asciidoc

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:

Centos 安装git

由 前提是你 提交于 2021-01-19 22:09:54
1. 需要给 CentOS 下载安装编译工具。 $ sudo yum groupinstall “Development Tools” 2. 安装一些 git 构建或执行时需要的其他依赖。 $ sudo yum install zlib-devel perl-ExtUtils-MakeMaker asciidoc xmlto openssl-devel 3. 下载 git 最新版本的源代码 $ cd ~ $ wget -O git.zip https://github.com/git/git/archive/master.zip 4. 解压源文件 $ unzip git.zip $ cd git-master $ autoconf $ ./configure $ make && make install $ ln -s /usr/local/bin/git /usr/bin/ 如果系统中已经安装过旧的版本，步骤6可能会报文件已存在的错误，这个时候需要把旧的 link 删掉再重新 link。 7. 检查 git 版本 $ git --version 来源： oschina 链接： https://my.oschina.net/u/2624116/blog/3008930

DITA 已死

由 末鹿安然 提交于 2021-01-18 22:53:01
最近在整理历史的研究文档的时候发现了还保有了一些有关 DITA 的文档。 随着技术的发展，DITA 显得非常臃肿了，并且编译处理并不是非常友好。 查询了下官方的版本历史： 已经有差不多 2 年没有更新了，由此看来 DITA 作为文档交付应该已经是日薄西山了。应该没有什么人通过写 XML 的方式来写文档了。 相反，MD 和 AsciiDoc 格式的文档却大行其道。 其主要原因是能够随意部署，并且文档结构少，约束少，更加容易写作和阅读。 作为文档来说，内容是最主要的，格式相对来说没有那么重要，如果有漂亮的格式，但是内容一团糟，又怎么会有人去看和使用呢。 回想一下曾经用过的 DITA，编译太复杂，PDF 生成问题太多，CHM 格式的文档很多时候大家都不愿意用，更多的都在使用 Github 上来写 MD 格式。 DITA 已死，就此留念。 超级复杂的文档格式。 因为是基于 XML 的，每一个段落的创作都非常复杂，你还需要考虑复杂的 XML 标签。让写作不是一种享受，简直是一种折磨。 相对 MD 格式就让人舒服多了，你只需要关注一些常用的标记，其他的都是以内容为主。 比如说 Discourse 这个社区使用的 MD 格式就非常简单，能够让所有人更多的关注内容而不是标记。 不管怎么样， DITA 也代表了人类文明出版中的小缩影。 https://www.ossez.com/t/dita
订阅 asciidoc