文档在哪里?(或者:我们可能需要一个在线文档门户)

文档在哪里?(或者:我们可能需要一个在线文档门户)

这基本上文档在哪里?,但让我重复一下,然后提出一个想法......跳过这条线立即到达那里

经过一段时间的思考,我得出的结论是:对我来说,使 (La)TeX 变得复杂的一个重要原因是文档(或者说我如何找到它的方法)。

是的,TeX 非常古老,有许多扩展和风格以及相互竞争的不良做法,但我认为,如果能够直观地查阅文档,那么情况就不会那么糟糕了。所以让我们看看我如何处理这个问题,以及我们可以从中学到什么:

  • 我意识到我需要一些我不知道如何实现的东西,或者宏不能按照我的理解工作
  • 我谷歌我想要的内容或命令
  • 我希望一些文档站点会出现在结果的第一页,但最多只有 StackExchange 或类似的 QA 页面,没有列出所有选项等的正式文档。

对最初提到的帖子的回答ftp://ftp.dante.de/tex-archive/help/Catalogue/alpha.html (这对我来说似乎不起作用,Chromium 尝试打开 Firefox,但它也不知道该如何处理它)https://www.ctan.org/tex-archive/info/LatexHelpBook或旧的texdoc <package name> (这告诉我texdoc error: No texlive.tlpdb nor shipped tlpdb data found.,也许我必须单独安装文档?)— 无论如何,我认为,按照今天的惯例,它不够用户友好。


那么,反对以“阅读文档”或其他任何获得同意的方式创建一个文档中心的理由是什么呢?在这个文档中心里,核心和所有已知的(或最常用)可以阅读哪些软件包,包括它们引入的所有宏以及它们的选项和含义?理想情况下,还可以添加交叉引用。我想https://www.latex-project.org/或直接从那里链接和推广。

我只能想到关于未来版本的策略问题。如果软件包在作者没有确认和认可的情况下被添加,他们就不会提交更新的文档。让团队手动追踪这些肯定不是一个面向未来的策略,但我认为一开始只添加最受欢迎的软件包,并依靠(希望)从那时起,文档的日益普及可以推动作者提交他们的文档,从而产生良好的效果。

那么,您对此有何看法?这完全没有必要吗?这样的项目已经在进行中了吗?如果是的话,它还没有进入我的搜索结果。


编辑:引起我注意的该方向的现有项目:https://texdoc.net– 查找包名称的文档资源,不允许搜索宏名称。我建议将此作为一个问题

相关内容