asciidoctor 安装试用_weixin_33766168的博客-程序员信息网

技术标签: git  运维  操作系统  

备注:

   asciidoctor 是asciidoc 的增强,使用简单,模板比较丰富,对于持续集成方面的开发也是一个不错的工具
 
1. 安装
a. 环境准备
  MRI   Ruby 1.8.7, 1.9.3, 2.0, 2.1, 2.2 & 2.3
  JRuby 1.7 in Ruby 1.8 and 1.9 modes, 9000
  Rubinius 2.2.x
  实际上 需要的是ruby  jruby ,其他的不是必须的

b. 安装
   yum insatll -y ruby 
   jruby 安装包下载安装
   wget https://repo1.maven.org/maven2/org/jruby/jruby-dist/9.1.15.0/jruby-dist-9.1.15.0-bin.tar.gz
   后面配置环境变量即可
   gem install asciidoctor 如果慢,可以替换 gem 源  gem sources --add https://gems.ruby-china.org/ --remove https://rubygems.org/
2. 使用
参考源码 https://github.com/mraible/infoq-mini-book.git
实际上只需要src/docs 文件
asciidoctor index.adoc
 生成的效果
 
 
3. pdf 格式生成
a. 安装插件
gem install asciidoctor-pdf
b. 使用方式
asciidoctor-pdf index.adoc
生成效果
 
 
4. docker 使用
a. 镜像拉取
docker pull asciidoctor/docker-asciidoctor
b. 启动
docker run -it -v  your directory:/documents/ asciidoctor/docker-asciidoctor
c. 运行生成对应类似文档
 已经包含的工具集 
 asciidoctor             asciidoctor-epub3   asciidoctor-revealjs
 asciidoctor-confluence  asciidoctor-pdf     asciidoctor-safe
 比如:
 pdf: asciidoctor-pdf   index.adoc
5. 总结
实际上spring 项目使用asciidoctor 构建的还是比较多的,对于大家在进行微服务以及持续集成中结合
swagger,或者类似的api 文档生活工具,可以方便高效的进行系统的开发设计,提高生产力
6. 参考资料
https://github.com/mraible/infoq-mini-book.git
http://asciidoctor.org/
 
 
 
 
版权声明:本文为博主原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://blog.csdn.net/weixin_33766168/article/details/86406417

智能推荐

JS和Jquery知识点_Noneyes的博客-程序员信息网

js数据类型    undefined  boolean  string    number  object  functionJS中的调试方式    1.alert()弹窗        会中断代码执行    2.document.write()        相当于PHP中的echo        当代码执行完毕再执行,会覆盖原来的内容(最好不要出现在事件中)

基于数组的循环队列和基于链表的队列_认真很简单的博客-程序员信息网_java一个循环队列链表

数据的插入和取出涉及对当前数据量nItems属性的修改,大量的插入、移除操作时,对nItems属性的操作可能影响性能,可参考不包含数据项个数属性的队列实现。包含数据项个数属性的队列package datastructure.c4.queue.queuedef;public class Queue { private int maxSize; private long[] queAr

更换根目录linux命令,linux中怎么切换到根目录_瞎了了的博客-程序员信息网

linux中怎么切换到根目录以下文字资料是由(历史新知网www.lishixinzhi.com)小编为大家搜集整理后发布的内容,让我们赶快一起来看一下吧!具体的操作步骤 :1,切换到家目录:此时可以直接用不带参数的cd命令,也可以用cd ~命令,还可以使用cd $HOME。本质上,这三个命令都是一样的。2,切换到根目录,并查到符号链接文件夹3,上图中,列出了/目录下所有的文件夹,当然,我们还可以过...

vue-cil3 运行报错 --- warnings potentially fixable with the `--fix` option_羽Orz的博客-程序员信息网

原因:vscode、vetur、slint规范化冲突,并且不符合ESlint规范functineName() 左括号前没有空格报错'space-before-function-paren':0分号; 报错引号需要是单引号以上两个问题,需要自己创建一个.prettierrc的JSON文件"semi":false, // 在格式化的时候不加分号"s...

Linux+Docker+Jenkins+Git自动化部署SpringBoot项目_小亮彡的博客-程序员信息网

一、下载启动Jenkins1、docker下载jenkinsdocker pull jenkins2、创建本地数据卷我这里映射本地数据卷的路径为/data/jenkins_home/,你想放别的地方可以自行修改mkdir -p /data/jenkins_home/需要修改下目录权限,因为当映射本地数据卷时,/data/jenkins_home/目录的拥有者为root用户,而容器中jenkins用户的 uid 为 1000。chown -R 1000:1000 /data/jenkins_

git 回退到上一版本_呦呦切克闹_666的博客-程序员信息网

1.回退到上一版本git reset --hard FETCH_HEAD(目前我自己所遇到的问题,此方法可以解决百分之五十以上的问题)一般用于解决 git pull 从服务器拉取内容的时候经遇到的问题...

随便推点

python 快速入门函数_ljwy1234的博客-程序员信息网

def func(): print("hello world") return "hello world"a = func()print(a)# hello world# hello worlddef func_args(a, b, c): print(a, b, c)func_args(10, 20, "helloworld")#10 20 hell

嵌入式系统是不是计算机系统,开发必知:嵌入式系统对比计算机系统_蔡道济的博客-程序员信息网

【IT168技术】对目前国内流行的嵌入式系统定义提出质疑,认为嵌入式系统不是“专用计算机系统”,嵌入式系统不只“以计算机技术为基础”。从嵌入式系统的发展起源、体系结构、功能特点、知识技术体系等方面进行了分析论证,从而进一步完善了嵌入式系统的定义。随着现代化技术的飞速发展,嵌入式系统已深入到社会的各个领域,嵌入式系统的产品已应用到人们的日常生活的各个角落,嵌入式系统技术已成为目前人们研究的热门之一。...

Highcharts图表 - 项目总结_daxia_85的博客-程序员信息网

近期用图表做了些关于统计的图表, 因为与其把一些冷冰冰的数据给老板看, 都不如我们把数据做成图的形式,让老板看的更加直观,方便,下面就是我这次项目做的图表,用的就是Highcharts图表, 里面用到的一些参数, 我做了注释,至于Highcharts图表功能很强大, 参数也很多, 要是你想让图表功能更加丰富, 你可以去官网看看http://www.hcharts.cn/

s3c2440对nandflash的操作_zhaocj的博客-程序员信息网

本文以K9F2G08U0A为例,详细讲解了s3c2440对nandflash的基本操作,包括读ID,页读,页写,擦除,随意读,随意写等内容。

MySQL是怎么保证redo log和binlog是完整的?_华为云开发者联盟的博客-程序员信息网_binlog为什么不能保证完整性

摘要:WAL机制保证只要redo log和binlog保证持久化到磁盘,就能确保MySQL异常重启后,数据可以恢复。

消息 544,级别 16,状态 1,第 3 行 当 IDENTITY_INSERT 设置为 OFF 时,不能为表 ‘Table ‘ 中的标识列插入显式值。_Neter_yx的博客-程序员信息网

将一个表的信息插入到另外一个表的时候,因为目标表中存在自增主键,此时需要打开一下允许执行的自增插入的语句。--打开允许执行自增列插入数据的开关SET IDENTITY_INSERT Table ON执行完插入之后 还需要关闭一下这个开关。--关闭允许执行自增列插入数据的开关SET IDENTITY_INSERT Table OFF...

推荐文章

热门文章

相关标签