:imagesdir: images

== docToolchain

:url-ci-travis: https://app.travis-ci.com/github/docToolchain/docToolchain

image:https://api.travis-ci.com/doctoolchain/doctoolchain.svg?branch=ng[link={url-ci-travis}]

[NOTE]

新冠肺炎疫情正在造成影响。 这段时间里大家时间紧张,一些问题无法及时处理。 因此我(rdmueller)刚刚引入了优先级更高的"赞助"问题。 这个标签应该有助于解释为什么某些问题会优先于其他问题得到处理。 如果你想赞助某个问题,只需使用本页面顶部的赞助链接即可。

[IMPORTANT]

如果你以前使用过docToolchain,请注意主分支正在进行一些更改。

如果你想要一个全新的版本,并且愿意接受配置上的变化,那么这个"ng"分支就是你需要的。

如果你想要你熟悉的版本,那么请下载https://github.com/docToolchain/docToolchain/releases[V1.0.0发布版]

image:https://travis-ci.org/docToolchain/docToolchain.svg?branch=master["构建状态", link="https://travis-ci.org/docToolchain/docToolchain"] image:https://opencollective.com/doctoolchain/backers/badge.svg["Open Collective上的支持者"] image:https://opencollective.com/doctoolchain/sponsors/badge.svg["Open Collective上的赞助商"]

=== 创建精彩文档!

docToolchain 是软件架构http://www.writethedocs.org/guide/docs-as-code/[_文档即代码_]方法的一种实现。 docToolchain的基础是将软件文档与代码同等对待的理念,以及http://arc42.org[_arc42_]软件架构模板。

https://docToolchain.github.io/docToolchain[阅读更多...]

image::https://doctoolchain.github.io/docToolchain/v2.0.x/images/ea/Manual/Overview2.png[]

https://doctoolchain.github.io/docToolchain/v1.3.x/htmlchecks/[HTML完整性检查测试结果]

=== 贡献者

本项目的存在要感谢所有做出贡献的人!

image::https://opencollective.com/doctoolchain/contributors.svg?width=600&button=false[]

另请参阅文档中的https://doctoolchain.github.io/docToolchain/v2.0.x/010_manual/040_contributors.html[贡献者列表]。

每一份贡献都非常宝贵且受到赞赏,无论大小。 即使只是修复一个拼写错误或为项目加星标也有助于推广它。

我决定给予个人和公司支持这个项目的机会。 这是通过https://opencollective.com实现的 - 与https://asciidoctor.org/[Asciidoctor]使用的服务相同。

=== 使用docToolchain的公司

docToolchain仍然是较小的开源项目之一, 但一些公司已经通过docToolchain全面采用文档即代码的方法。 如果你的公司使用docToolchain,欢迎通过拉取请求添加公司标志。 请在PR中声明我们可以在所有项目网站和文档中显示该标志。

[cols="1,2"] |=== a| [link=https://www.tomtom.com] image::TomTomLogo.png[TomTom, width=50%]

a| [link=https://www.dbsystel.de] image::db-logo.svg[DB Systel, width=50%]

a| [link=https://www.codecentric.de] image::cclogo.png[codecentric, width=50%]

a| [link=https://www.innoq.com] image::innoq-logo.svg[INNOQ, width=50%] |===

=== 支持者

感谢所有支持者!

image::https://opencollective.com/doctoolchain/backers.svg?width=890["成为支持者", link="https://opencollective.com/doctoolchain#backers"]

=== 赞助商

通过成为赞助商来支持我们。你的标志将出现在这里并链接到你的网站。

https://opencollective.com/doctoolchain#sponsors[成为赞助商]

image::https://opencollective.com/doctoolchain/sponsor/0/avatar.svg["赞助商", link="https://opencollective.com/doctoolchain/sponsor/0/website"]

=== 本项目的历史

我刚刚发现了一条较早的https://twitter.com/RalfDMueller/status/668540860649349120[推文],它让我想起了这个项目的根源和开端。 一切都始于两个重要部分。 一个名为asciidoc2confluence的脚本和一些从企业架构中导出图表的脚本。

第一个在上面的推文中有链接,第一次提交可以追溯到2015年年中。 从那时起,许多贡献者加入了进来! 感谢你们所有的贡献!