zoukankan      html  css  js  c++  java
  • DITA 已死

    最近在整理历史的研究文档的时候发现了还保有了一些有关 DITA 的文档。

    随着技术的发展,DITA 显得非常臃肿了,并且编译处理并不是非常友好。

    查询了下官方的版本历史:

    已经有差不多 2 年没有更新了,由此看来 DITA 作为文档交付应该已经是日薄西山了。应该没有什么人通过写 XML 的方式来写文档了。

    相反,MD 和 AsciiDoc 格式的文档却大行其道。

    其主要原因是能够随意部署,并且文档结构少,约束少,更加容易写作和阅读。

    作为文档来说,内容是最主要的,格式相对来说没有那么重要,如果有漂亮的格式,但是内容一团糟,又怎么会有人去看和使用呢。

    回想一下曾经用过的 DITA,编译太复杂,PDF 生成问题太多,CHM 格式的文档很多时候大家都不愿意用,更多的都在使用 Github 上来写 MD 格式。

    DITA 已死,就此留念。

    超级复杂的文档格式。

    因为是基于 XML 的,每一个段落的创作都非常复杂,你还需要考虑复杂的 XML 标签。让写作不是一种享受,简直是一种折磨。

    相对 MD 格式就让人舒服多了,你只需要关注一些常用的标记,其他的都是以内容为主。

    比如说 Discourse 这个社区使用的 MD 格式就非常简单,能够让所有人更多的关注内容而不是标记。

    不管怎么样, DITA 也代表了人类文明出版中的小缩影。

    https://www.ossez.com/t/dita-docbook/10050/2

  • 相关阅读:
    微信Web开发者工具 移动调试 手机连接不上
    js 生成guid 自定义函数
    json
    c# 返回时间差
    Quartz.Net和队列应用demo
    数据库字段数字表示含义的枚举维护
    API文档自动生成,Swagger的配置
    请求资源文件报500错误
    文件上传三:base64文件上传
    文件上传二:FormData上传
  • 原文地址:https://www.cnblogs.com/huyuchengus/p/14295303.html
Copyright © 2011-2022 走看看