更简便的文档编写、更简洁的网站以及在OSCON 2013上更快速的协作 collaboration

…​以你写电子邮件时使用的相同格式。

确实，轻量级标记语言的焦点就在于 AsciiDoc。AsciiDoc 的语法感觉很自然，这让你专注于内容。用 AsciiDoc 写的内容在原始形式下易于阅读和编辑，这促进了协作。它也可以被转换成 HTML 以用于展示，欢迎来到网络发布！

在用AsciiDoc编写了一些文档后，我们将使用静态网站生成器Awestruct和[Jekyll](Bootstrap(Zurb Foundation(http://foundation.zurb.com)来装扮内容，使之具有优雅的外观和感觉。

我们将使用一条命令`git push`来将我们的网站发布到GitHub Pages。

真正的乐趣从这时候开始。通过GitHub，我们可以使用git和GitHub界面中的基于网页的协作工具[在内容上进行协作]。

有数十亿的设备连接到了网络。而且还会有更多的设备加入。无论设备市场如何随时间变化，对我们来说挑战始终如一。我们需要让我们的内容出现在所有这些设备上。

AsciiDoc 不仅仅是一种轻量级标记语言。它使我们能够编写可重用的、结构化的内容，而且还鼓励我们这样做。

'' 可重用的内容可以与其他内容混合搭配，创建适应设备、环境或情景的组合。这也是保持我们的内容DRY（不要重复自己）的一种方式，这样我们就不必在十几个地方，甚至两个地方更新相同的内容。''

结构化内容是有意义的、有语义的内容，通过元数据进行标记。如果我们知道文档中包含什么内容的话，我们可以做很多事情。我们可以提取摘要或摘录。我们可以在内容不需要时将其隐藏。我们可以呈现一个结构，并允许用户深入查看他们想要看的内容。

内容不再存在于“页面”上。未来出版的单位是[“块”](http://asciidoctor.org/news/2013/07/16/oscon-2013-docs-workshop-preview)。这些较小、离散的资源可以针对特定平台进行调整，或者使用自动化进行聚合。

网络正在变化。它已经超越了桌面。它现在是一个行路勇士。我们对内容发布的思考方式必须适应。比以往任何时候都更多，我们*必须*将内容与呈现分离。

撰写文档是项艰苦的工作。因此，我们并不经常去做。然而，我们却错过了接触和影响我们目标受众的最佳机会。让我们采取行动改变这一现状吧。

出席http://www.oscon.com/oscon2013/public/schedule/detail/29335[Easier Documentation, Simpler Websites And Faster Collaboration]以了解如何操作：

…所有这些都由开源软件驱动：

,=== Ruby,Git,AsciiDoc / Asciidoctor Awestruct,Jekyll,Haml / Slim SASS / Compass,Zurb Foundation,Travis CI ,===

让我们一起烘焙出更好的文档。文档要“可复用”和“有结构”。

开源社区的成员，像你一样对文档编写和网络出版充满热情。

不确定那是不是你？你是否对以下任何内容做出了贡献、进行维护或组织？

如果你点了头，那么你就是我们中的一员 :)