历史

我们今天所知的 AsciiDoc 已经历了二十年的发展。

概述

创建用于 DocBook 的简写格式 AsciiDoc 的想法最初是由 Stuart Rackham 在 2002 年构思的(甚至早于 Markdown)。Stuart 以 AsciiDoc.py 项目启动了这种新的简写语言和处理器。该项目发展了十年,然后 Asciidoctor 登场,成为其继任者。

开发 Asciidoctor 的动力是为了在 Ruby 中处理 AsciiDoc,以便 GitHub 应用程序使用并在线发布 git 文档。据故事所述,GitHub 正在逐步淘汰对 AsciiDoc 的支持,因为 AsciiDoc.py 已知存在攻击向量,通过子进程调用被认为不是最优且不安全。与此同时,GitHub 开始为 git 网站开发 AsciiDoc 的 Ruby 实现(后来成为 Asciidoctor)。得益于 GitHub(特别是 Ryan Waldron)和 Red Hat(Dan Allen)的开发人员之间的合作,他们使 Asciidoctor 成熟到足以替代 AsciiDoc.py。GitHub 上对 AsciiDoc 的支持得以保留!

Asciidoctor 是第一个用另一种语言(在此情况下为 Ruby)实现 AsciiDoc 语法的项目。用 Ruby 编写代码的决定也使同一代码库能够跨 Ruby、JVM 平台和 JavaScript 运行时共享,这得益于 Ruby 本身的便携性。

时间线

您可以在下方找到 AsciiDoc 历史上的主要事件时间线,直到 Asciidoctor 2.0.0 版本发布和 AsciiDoc 工作组的成立。

2002年11月25日

Stuart Rackham 发布 AsciiDoc.py (1.0) 的首次公开发布

2002年11月25日

AsciiDoc.py 项目在 SourceForge.net 下以 asciidoc 的名称注册

2002年11月25日

AsciiDoc.py 网站的首次发布,网址为 www.methods.co.nz/asciidoc(使用 AsciiDoc 编写并由 AsciiDoc.py 驱动)

2007年10月23日

AsciiDoc.py 源存储库转换为 Mercurial 并迁移到 Google Code
参见 code.google.com/archive/p/asciidoc/

2012年3月1日

Dan 发现 AsciiDoc 并发布到 Google+
存档于 asciidoctor.org/news/2012/03/01/wow-asciidoc-is-incredible/

2012年4月3日

Nick Hengeveld 向 github.com/git/git-scm.com 提交了 asciidoc.rb(Asciidoctor 原型)的第一个提交
参见 github.com/git/git-scm.com/commit/5a5edecfc2c4a1bcff86af432e062d2c6f860bed

2012年6月1日

Ryan Waldron 基于 Nick Hengeveld 和其他人为 Git 网站 (git-scm.com) 编写的原型,向 Asciidoctor 提交了第一个提交,参见 github.com/asciidoctor/asciidoctor/commit/67833eed5cb7a22499662f2d98734ef08ae61eca

2012年6月14日

Ryan Waldron 向 rubygems.org/gems/asciidoctor 发布了 Asciidoctor 的首次发布
参见 rubygems.org/gems/asciidoctor/versions/0.0.1

2012年8月3日

Asciidoctor 取代了 git-scm.com 存储库中的 asciidoc.rb(Asciidoctor 原型)
参见 github.com/git/git-scm.com/blob/ab9efdc8d95c65b9e74954a4847de8b8f98486fb/lib/asciidoc.rb(原型的最后一个版本)和 github.com/git/git-scm.com/pull/582/commits/90d47b8a1f54e73431e5a2db088bb2b5d32545d4(切换到 Asciidoctor)

2012年12月3日

Dan Allen 注册了 asciidoc.org 域名

2012年12月10日

Stuart Rackham 表示支持 Asciidoctor
“向任何能够相当准确地移植 AsciiDoc 的人致敬。”

2012年12月27日

asciidoctor.org 域名已注册

2013年1月8日

由于 AsciiDoc.py 的安全顾虑,GitHub 禁用了 GitHub 存储库中的 AsciiDoc 渲染

2013年1月17日

GitHub 使用 Asciidoctor 而非 AsciiDoc.py 重新启用了 GitHub 存储库中的 AsciiDoc 渲染
公告: asciidoctor.org/news/2013/01/30/asciidoc-returns-to-github/

2013年1月30日

Asciidoctor 项目转移到 GitHub 上的 asciidoctor 组织
参见 github.com/asciidoctor/asciidoctor

2013年1月30日

Asciidoctor 初始网站发布(使用 AsciiDoc 编写并由 Asciidoctor 驱动)
公告: asciidoctor.org/news/2013/04/08/a-new-resource-for-asciidoc/

2013年2月4日

Andres Almiray 和 Basel Hackergarten 团队发布了首个 Asciidoctor Gradle 插件

2013年2月18日

Jason Porter 发布了首个 Asciidoctor Maven 插件
公告: asciidoctor.org/news/2013/04/16/introducing-the-asciidoctor-maven-plugin/

2013年3月18日

Alex Soto 向 AsciidoctorJ 提交了第一个提交

2013年4月11日

Alex Soto 发布了 AsciidoctorJ(当时的 Asciidoctor Java 集成)的首次发布
公告: asciidoctor.org/news/2013/04/18/enjoy-the-magic-of-asciidoctor-in-java/

2013年4月16日

Asciidoctor 项目的领导权从 Ryan Waldron 转移到 Dan Allen

2013年4月28日

Jason Porter 将 Asciidoctor Maven 插件切换为使用 AsciidoctorJ(当时的 Asciidoctor Java 集成)
公告: asciidoctor.org/news/2013/04/28/asciidoctor-maven-plugin-0-1-2-released/

2013年4月25日

Dan Allen 发布了 Asciidoctor 的首次发布到 rubygems.org/gems/asciidoctor
参见 rubygems.org/gems/asciidoctor/versions/0.1.2
公告: asciidoctor.org/news/2013/04/25/asciidoctor-0-1-2-released/

2013年5月18日

Dan 成功让 Asciidoctor 在 JavaScript 中运行(转换了整个 AsciiDoc Python 用户指南)

2013年5月19日

Dan Allen 提交了 Asciidoctor.js 的第一个提交

2013年5月21日

Dan Allen 制作了 Asciidoctor.js 的第一个工作原型
公告: asciidoctor.org/news/2013/05/21/asciidoctor-js-render-asciidoc-in-the-browser/

2013年5月31日

Asciidoctor 0.1.3 发布,标志着从实现 AsciiDoc 到开始对其进行改进的转变
公告: asciidoctor.org/news/2013/05/31/asciidoctor-0-1-3-released/

2013年6月1日

John Ericksen 发布了首个 Asciidoclet
公告: asciidoctor.org/news/2013/06/03/asciidoclet-announcement/

2013年9月5日

Asciidoctor 0.1.4 发布,增加了扩展功能和多项语言增强
公告: asciidoctor.org/news/2013/09/05/asciidoctor-0-1-4-released/

2013年9月18日

Guillaume Grossetie 发布了首个 Asciidoctor.js 浏览器扩展(当时称为 Live Preview)
公告: asciidoctor.org/news/2013/09/18/introducing-asciidoctor-js-live-preview/

2013年11月27日

Stuart Rackham 同意将 AsciiDoc.py 的源代码移动到 GitHub 上的 asciidoc 组织

2013年12月21日

AsciiDoc.py 源存储库转换为 git 并迁移到 GitHub 上的 asciidoc 组织
参见 github.com/asciidoc/asciidoc

2014年2月13日

Pepijn Van Eeckhoudt 发布了首个 Asciidoctor Diagram
公告: asciidoctor.org/news/2014/02/18/plain-text-diagrams-in-asciidoctor/

2014年7月29日

Dan Allen 发布了首个 Asciidoctor EPUB3

2014年7月31日

Guillaume Grossettie 发布了首个 Asciidoctor.js

2014年8月12日

Asciidoctor 1.5.0 发布,引入了 AsciiDoc 的现代化语法
公告: asciidoctor.org/news/2014/08/12/asciidoctor-1-5-0-released/

2014年8月21日

Alex Soto 发布了首个 AsciidoctorJ(新名称)版本
公告: asciidoctor.org/news/2014/08/21/asciidoctorj-1-5-0-released/

2014年8月23日

Guillaume Grossetie 和 Anthonny Quérouil 发布了 Asciidoctor.js 1.5.0,实现了与 Asciidoctor Ruby 的功能对等
公告: asciidoctor.org/news/2014/08/23/asciidoctor-js-1-5-0-released/

2014年9月4日

Dan Allen 发布了首个 Asciidoctor PDF

2015年3月31日

asciidoc.org 解析到主要的 AsciiDoc.py 网站

2016年11月26日

Asciidoctor gem 下载次数超过 100 万次

2017年11月6日

Asciidoctor 拥有了品牌标识和官方 logo,由 mmajko 贡献
参见 github.com/asciidoctor/brand

2018年12月31日

Asciidoctor 项目采用语义化版本控制
公告: asciidoctor.org/news/2018/12/31/making-the-switch-to-semver/

2019年1月7日

宣布有意启动 AsciiDoc 规范
公告: asciidoctor.org/news/2019/01/07/asciidoc-spec-proposal/

2019年3月22日

Dan Allen 发布了 Asciidoctor 2 的首个版本
公告: github.com/asciidoctor/asciidoctor/releases/tag/v2.0.0

2019年4月24日

Robert Panzer 发布了 AsciidoctorJ 2 的首个版本

2020年1月20日

在 Marat Radchenko 的领导下发布了首个 Asciidoctor EPUB3

2020年7月21日

AsciiDoc 工作组正式成立
参见 www.eclipse.org/lists/asciidoc-wg/msg00113.html

2020年12月13日

Asciidoctor gem 下载次数超过 1000 万次

2021年1月5日

docs.asciidoctor.org 启动了 Asciidoctor 的新文档网站

2021年3月3日

chat.asciidoctor.org(托管在 zulipchat.com 上)启动了 Asciidoctor 的新项目聊天

2022年4月20日

重新发布 asciidoc.org 网站,以反映 AsciiDoc 在 AsciiDoc WG 管理下的当前状态和方向