Asciidoc
文章平均质量分 86
介绍 Asciidoc 的使用
RockTec
这个作者很懒,什么都没留下…
展开
-
第十篇 Asciidoc 给文章编号 解决标题编号的问题
嗯,你的理解没错,区段就是HTML里面的标题一到标题六的等价物,区段规定了文档的结构,因此它决定了文档的目录(Toc:Table of Content)。Article是adoc文档的默认类型,就是说,当你不设置你的文档类型时,默认情况下,你的adoc文件的文档类型就是Article。从文档头开始的位置,在上例中是第一行开始,往下遇到的第一个空行,是文档头的结束位置,之后就是文档的主体,也就是Body部分了。在上述四种类型中,Aritcle类型,指的是短文类型,也是我们最常用的类型,我们先重点看一看。原创 2024-05-17 18:44:07 · 961 阅读 · 0 评论 -
第九篇 Asciidoc 用属性控制文档的呈现 图表标题中文显示
如果您使用 Asciidoc 进行严肃写作,比如,写一本书,那么您不可避免需要对图表编号,因为 Asciidoc 的默认呈现是 英文,所以它图表标题是英文,如下图所示:图 1. 范畴论函子Figure 1.,用的英文,您想把它改为中文,怎么办呢?原创 2024-05-16 17:10:50 · 729 阅读 · 0 评论 -
第八篇 Asciidoc 输出 All In One HTML 解决图片无法显示问题
小明使用 Asciidoc 来记笔记,他将笔记输出为 HTML 文件。小丽向小明借笔记。小明将 Asciidoc 笔记输出为 HTML文件,并拷贝给了小丽。但是,小丽发现,图片都显示不出来了。小丽:小明,你给我的笔记,图片都显示不出来啊。小明:是我给你的那个 HTML 文件吗?小丽:是的。小明:哦,我忘记拷贝 HTML 文件依赖的图片了。等我重新整理一下,再发给你。说完,小明犯了难,因为这些 HTML 文件涉及多个本地的图片,要把它们都挑选出来,还真是麻烦。原创 2024-05-15 09:43:15 · 337 阅读 · 0 评论 -
第七篇 Asciidoc中使用PlantUML 绘制各种示意图
示意图表示的是大体上描述或表示物体的形状、相对大小、物体与物体之间的联系(关系),描述某器材或某机械的大体结构和工作的基本原理,描述某个工艺过程简单图示都叫做示意图。示意图的特点就是简单明了,它突出了重点,忽略很多次要的细节。老师上课时在黑板上经常画的某物体或某结构的简图都属于示意图。— 百度知道这个定义并不精确,严格说,示意图是将作者的抽象思维映射成的图示。相对于画作,示意图重在达意,而非摹形。在现代工程领域,示意图是最主要的交流手段之一。原创 2024-05-14 16:03:57 · 784 阅读 · 0 评论 -
第六篇 Asciidoc 图片按行排
如果把要显示的内容看成一个集合,那么每一个内容都可以看成一个盒子,盒子与盒子的关系只可能有三种:上下关系(按列排),也就是一个内容在上,一个内容在下左右关系(按行排),也就是一个在左,一个在右,如果排满了一行,就接着排下一行包含关系(一个是容器,另一个是容器里面的一个元素):例如,相框套照片上述逻辑,对于熟悉 HTML 的小伙伴,并不是什么新概念,就是 Block元素 和 inline元素,即块元素和行内元素。原创 2024-05-13 14:49:35 · 272 阅读 · 1 评论 -
第五篇 Asciidoc 插入图片文件夹太乱?指定图片文件夹,一篇解决
假设您的图片在剪贴板,这里有个窍门,按 Ctrl + Alt + V,直接插入图片到adoc文档。此时,vscode的asciidoc插件会将剪贴板图片,自动保存到您指定的目录下,比如 images。,点表示文档所在的目录,斜杠表示之下,images表示一个目录的名字。嗯,的确有点乱,主要是目录下的图片太多了,找adoc文档要拖动列表,如何指定插入列表所用的目录呢?上面的代码,属性是 imagesdir,写的时候要用冒号围起来,然后空格,之后是你指定的目录路径。图片由示意图生成:参见本系列文章。原创 2024-05-10 13:53:35 · 605 阅读 · 0 评论 -
番外篇 CSDN编辑器的使用 - 解决本地编辑帖子再上传CSDN问题
CSDN编辑器是CSDN网站提供的在线编辑器,用于编写和发布文章、代码等。它有两种编辑模式:富文本编辑器:即所见即所得编辑器,用户可以直接编辑文本内容,并实时预览效果。用户需要输入内容并设置内容的呈现样式。MD编辑器:即MarkDown编辑器,用户使用MarkDown标记语言,输入内容并标记内容的语义,编辑器负责排版。这样就省去了在界面里设置格式的麻烦。一份MarkDown文本粘贴进去,格式就排好了。如上图所示,在左边用户可以输入 MD 内容,右边就是预览。原创 2024-05-03 15:53:52 · 545 阅读 · 1 评论 -
第四篇 Asciidoc - MindMap 思维导图 不是事
因此,笔者的做法是,维护一个文档,里面有各种图表的代码,需要画新图的时候,复制粘贴一个已有的,然后修改。我们的目录结构、模块结构、分类结构等等,都是树型结构,它非常普遍,因此 MindMap 是笔记软件中,获得最多支持的一种图。中间的代码,你可以写你的 MindMap层级,*号的多少表示层级,一个星号表示一级,两个星号表示二级,等等,依次类推。便于修改:因为示意图是一段代码,所以,您可以随时修改,立即得到新版本,无须去修图。精确地说,这类图,是对思维结构的一种映射,因此叫做 Diagram,即示意图。原创 2024-05-09 08:01:49 · 364 阅读 · 1 评论 -
第三篇 Asciidoc的正确打开方式 Vscode中使用Asciidoc
在浏览器中 Asciidoc 文件,仅仅是编辑 Asciidoc 文件的若干方法之一。它的缺点是插入图片需要到别的地方找图床,这就很不方便。我们都有自己熟悉的文本编辑器,或者集成开发环境(IDE)。在自己喜欢的 IDE 中,编辑 Asciidoc 文件,然后实时预览,岂不美哉?原创 2024-05-06 22:16:33 · 1242 阅读 · 0 评论 -
第二篇 5分钟上手Asciidoc - 使用初体验,编辑文档常用姿势
这篇是 Asciidoc 的快速入门文章。让我们将注意力集中到 Asciidoc 的核心语法。忽略一些操作上的次要细节。您可能想在本篇看到,如何安装和配置编译器,如何安装插件,如何插入图片、表格等等,总之你可能会想很多东西,于是得出结论,这个东西不能在5分钟内学会。但是安装和配置 Asciidoc 都有文档可查,插件的安装和配置也有文档可查,我们何不单刀直入,直指核心呢?所以本篇要讲的两个问题是:文档写作的最小功能子集最小功能子集的 Asciidoc 语法。原创 2024-05-05 07:44:43 · 862 阅读 · 3 评论 -
第一篇 Asciidoc - 程序员如何写作?专注内容,格式让系统去完成
自从人类有了文字,知识的传播主要靠两种方式:直接经验:就是从实际动手获得知识间接经验:通过间接信息,例如经过整理的 文字、图片、声音获得知识对于程序员,乃至于需要大量文字工作的工作者,写作工具,无疑是重要的。古语有云:工欲望善其事,必先利其器。到目前为止,可以说,文字仍然是知识传播的最主要手段,因为它是符号化的,类似代数,在代数中,我们用一个符号代替数字;在文字中,我们用符号代替对世界的描述。文字的这种抽象性,使得它可以高度抽象,概括信息到一个很小的空间,相对于其他媒体,具有不可比拟的优势。原创 2024-05-04 22:40:11 · 1038 阅读 · 1 评论