☰

使用 TeXLive 分发的中央文档系统 (texdoc)

tag-icon • tag-icon installing texlive texdoc
使用 TeXLive 分发的中央文档系统 (texdoc)

最近，当我偷偷看一个有多年 TeX 使用经验的人时，我看到他在终端中输入了一些内容，导致一个包含我们正在使用的 LaTeX 包文档的 pdf 文件打开。我问他是否有一个用于查找包文档的中央实用程序，他的回答是：“是的，它叫做texdoc，看看它。”然后我们继续做我们的事情，因为他给我的时间有限，所以我没有进一步询问，我想我会自己找出答案。

于是我尝试了一下，但似乎无法掌握窍门。我已安装好 TeX Live 2012，并得到以下输出：

$ texdoc
/usr/local/texlive/2012/bin/i386-linux/texdoc:7: module 'texdoc.main' not found:
no field package.preload['texdoc.main']
[kpse lua searcher] file not found: 'texdoc.main'
[kpse C searcher] file not found: 'texdoc.main'
[kpse All-in-one searcher] file not found: 'texdoc'

因此，据我所知，显然缺少或未配置某些内容。我确保我也安装了文档，并tlmgr确认了这一点。考虑到我的这位导师已经是一位老先生，这个软件可能过时了吗？或者（似乎更合理）我只是做错了？

后续问题1[已解决]

感谢 David Carlisle 的回答，我似乎已经解决了texdoc无法正常工作的问题。但是，现在我得到的只是以下内容：

~$ texdoc geometry
Sorry, no documentation found for geometry.
If you are unsure about the name, try searching CTAN's TeX catalogue at
http://ctan.org/search.html#byDescription.

编辑/解决：由于我最初安装了该medium方案，因此当时下载的所有软件包都没有文档。重新安装 TeXLive 解决了该问题。

答案1

你的安装有问题：

texdoc longtable

应该打开longtable包裹

texdoc

它本身应该会回应一些使用帮助，开头是这样的

$ texdoc
Usage: texdoc [OPTION]... NAME...
  or:  texdoc ACTION

Try to find appropriate TeX documentation for the specified NAME(s).
Alternatively, perform the given ACTION and exit.

Current settings: --view, --interact (default).

Options:
  -w, --view            Use view mode: start a viewer. (default)
  -m, --mixed           Use mixed mode (view or list).

然而谷歌表明这个错误之前已经出现过。

本帖最后由 yumian 于 2017-02-27 17:47 编辑 ...

http://tug.org/pipermail/texdoc/2011q3/000281.html

答案2

我听从了 David Carlisle 的建议，并导航到他提供的链接。我将我的解决方案作为单独的答案发布，以便将其“放在现场”，而不仅仅是作为链接。

事实证明，我在安装 TeX Live 时发现了几个问题：

  • 我没有perl-tk在基于 Unix 的系统上安装该软件包，这显然是手动安装 TeX Live 时的一个优点；最重要的是，它启用了tlmgr或“TeX Live Manager”的 GUI。在 Debian 衍生系统（所有 *buntus）上，可以通过运行快速修复此问题

    sudo apt-get install perl-tk

    在终端中。

  • 我的系统中仍然预装了旧的漫游版本luatex。这很重要，因为texdoc它是一个 Lua 脚本或以某种方式使用 Lua 脚本（Lua 是一种编程语言，请参阅 David Carlisle 的回答中的链接并阅读完整的电子邮件交流以了解更多信息）。由于我的 PATH 变量设置为

    PATH="...:/usr/bin/:....:/usr/local/texlive/2012/bin/i386-linux"

    当我首次执行texdoc系统时，发现旧版本luatex找不到必要的文件，因为它位于与实际 TeX Live 安装不同的目录中。通过两个简单的步骤解决了这个问题：

    1. 删除系统上预装的旧 TeX Live 发行版的所有痕迹（通过sudo apt-get remove texlive-*在基于 Debian 的系统上运行）
    2. 更正 PATH 环境变量，以便我的 TeX Live 安装目录位于可能有 TeX 相关二进制文件的任何其他目录之前。这可以通过更改文件.pam_environment（针对当前用户会话）或使用 sudo 权限编辑“/etc/environment”（针对所有用户）来完成。

完成这些步骤后，一切都按预期进行：texdoc尝试查找您指定包的文档...它什么也找不到。这是因为我最初安装了该medium方案，但其中没有文档。使用方案重新安装 TexLivecomplete解决了这个问题。

答案3

对于没有安装 TeX Live 的人来说，还有一个在线版本由本网站的经常撰稿人开发和维护。就像texdoc它本身一样，这是一个不容忽视的非常有用的资源。

界面非常简单，无需解释，但基本原则是 URLhttp://texdoc.net/pkg/<packagename>应该将您链接到包的（主）文档。因此，

http://texdoc.net/pkg/geometry

让我有机会下载geometry文档。（我假设如果你的浏览器安装了 pdf 插件，它只会显示 PDF。）

相关内容