asciidoc

我每天与内容管理工具和支持文档编写者合作，他们首选的标记语言是 。 它具有简单的语法，但具有足够的功能，甚至可以使精通文档的书呆子开心。 AsciiDoc允许您以更自然的方式编写文档，并对其进行清晰的标记，以便在Web上呈现或作为PDF呈现。 这让我想到：“仅使用AsciiDoc维护网站是否方便？”

经过与同事的搜索和聊天之后，我找到了 ，这是一个发布平台，可以将用Markdown或AsciiDoc编写的文章转换成可用于网络的内容。 这是一个非常 ，具有用于处理模板和主题的丰富语言，并且使用起来非常有趣。

对我来说，一大优势是Hugo不需要数据库即可支持具有很多功能的博客网站。 页面以HTML呈现，因此网站非常快速且易于维护。 它甚至带有自己的服务器，因此我可以在工作时测试自己的网站。 只要您的服务器可以提供HTML，就可以了。

缺少数据库或对诸如PHP之类的语言的需求降低了SQL注入的风险，这使其特别易于创建安全站点。 它也使网站的速度比传统平台上的网站快，并且将其与内容交付网络（CDN）组合在一起可以创建一个非常快速的网站。

它支持通常由博客平台驱动的任务； 例如，当添加新文章时，它可以自动填充RSS feed。 团队中的每个人都可以在本地运行该站点的副本，因此他们可以在草稿状态下处理其文章，并避免在准备好文章之前将其发布。 如果将其与Git分支策略结合使用，则多个作者可以处理博客和文章，然后在准备发布时将其预订回您的主分支。 其他互动元素，例如评论，可以与Disqus添加在一起。

另一种开发平台

当我开发博客时，我从“内容优先”的想法开始，并尝试不与平台捆绑在一起。 这是个好主意，但实际上，我一直在对该网站进行调整。 然后我稍微调整一下，然后一个周末消失了，而且我还没有写任何内容。 我花了所有时间玩这个主题或从事后端服务。

使用带有AsciiDoc标记语言的Hugo平台和的数字瑞士军刀AsciiDoctor，可以帮助我专注于内容和结构，而不是呈现方式。 Hugo有一个不错的模板系统，因此我可以用更少的代码做更多的事情。 AsciiDoc帮助我编写了结构良好的文档，而Hugo在编写文档时使用AsciiDoctor将文档转换为其他格式，例如PDF或Linux手册页。 因为我可以将它们本地预览为HTML，所以可以确定内容需要工作的地方。 通过在控制台中运行Hugo，无论何时保存文档，我都能看到文档问题，因此我可以对其进行修复并继续。 这与我通常的例行程序不同：

``我的博客文章完成了！现在将我的杰作传播给全世界！...等等，为什么我的所有文字都为H1？我讨厌自己。''

-我，凌晨3点，很少睡觉，喝咖啡太多

文档工作流程

我通常用简明的英文写我的初稿。 在每篇文章中，我都在Git中使用了一个新的分支，这样在我准备发表之前，一切都会变得轻松而简单。 一旦对文章进行了几处编辑以确保一切正常，就添加了AsciiDoc标记，以便Hugo可以将文章格式化为纯HTML。 当文章准备发布时，我将其合并回我的主分支。

我经常处理包含标准化文本或内容（例如，有关许可，支持或公司描述的信息）的文档。 我针对该样板内容使用include语句，并在我的模板中进行设置，或者定义要添加的内容类型，具体取决于我正在处理的内容。 这种方法使标准的重复内容更加模块化，并且更易于维护。

您还可以定义您的主题可用于组织内容的元数据，例如，标记文章，对内容进行分组，将页面定义为“解决方案”或“ FAQ”等。这对于AsciiDoc尤其方便，因为文档的标题会有一个标准的元数据部分，文章和博客文章之间可能会有所不同。 我可以在Hugo中定义元数据，当我创建新内容时，它会为我完成工作。

我首选的编辑器Vim具有可用于AsciiDoc的语法文件。 如果您正在寻找一种更直观的内容处理方法，建议您使用带有的编辑器。 它提供页面的实时预览，使您轻松检查文档。 Atom由GitHub创建，并具有与Git一起使用的内置支持，因此可以轻松处理跨不同分支的文档。

^{原子编辑器}

总体而言，我对Hugo和AsciiDoc感到非常满意。 我的过程更加注重内容。 我的Git工作流程非常好，与传统PHP / MySQL内容管理系统相比，站点性能明显更好。

入门

如果您对Hugo和AsciiDoc入门感兴趣，那么我提供内容，主题和有关如何启动和运行的说明。 自述文件还包含有关下载和配置Hugo以及使用AsciiDoc进行编写的分步说明，以及指向资源的链接以帮助您入门。

您使用过AsciiDoc和Hugo吗？ 请在评论中发布指向您的项目的链接。

翻译自:

asciidoc