☰

升级texdoc

tag-icon • tag-icon texdoc
升级texdoc

我想确保texdoc cool打开texmf-dist/doc/latex/cool/Content_LaTeX_Package_Demo.pdf而不是texmf-dist/doc/latex/cool/cool.pdf：我的默认配置是这样的：

$ texdoc -l cool
 1 /usr/local/texlive/2010/texmf-dist/doc/latex/cool/cool.pdf
   = Package documentation
 2 /usr/local/texlive/2010/texmf-dist/doc/latex/cool/Content_LaTeX_Package_Demo.pdf
   = EXamples of use
Please enter the number of the file to view, anything else to skip:

根据texdoc手动的这可以通过本地texdoc/texdoc.cnf文件完成。我明白了。但是当我检查texdoc的搜索路径时，我发现了一些有趣的东西：

$ texdoc -f
texdoc 0.72
Configuration files are:
    absent  /Users/matthew/Dropbox/Library/texmf:~/Library/texmf/texdoc/texdoc-x86_64-darwin.cnf
(*) absent  /Users/matthew/Dropbox/Library/texmf:~/Library/texmf/texdoc/texdoc.cnf
    absent  /Users/matthew/Dropbox/Library/texmf:~/Library/texmf/texdoc/texdoc-dist.cnf
    absent  /usr/local/texlive/2010/../texmf-local/texdoc/texdoc-x86_64-darwin.cnf
    absent  /usr/local/texlive/2010/../texmf-local/texdoc/texdoc.cnf
    active  /usr/local/texlive/2010/texmf/texdoc/texdoc.cnf
(*) This is the recommended configuration file for your personal preferences.

前三个目录看起来好像包含文字:~。如果我在或中创建配置文件~/Dropbox/Library/texmf/texdoc/，则~/Library/texmf/texdoc找不到它们。

我认为我按照以下解决方案创建了这个问题如何向 TeXLive 添加包含个人风格文件的额外可搜索目录，而不是在 ~/Library/texmf 下？：

$ kpsewhich --var-value=TEXMFHOME
/Users/matthew/Dropbox/Library/texmf:~/Library/texmf

它似乎texdoc假设这$TEXMFHOME是一个单一的目录，而不是一个冒号分隔的目录列表。有解决方法吗？

答案1

我有三个答案。

升级texdoc

曼努埃尔·佩古里埃-戈纳尔 (英里/加仑)，的维护者texdoc表示这个问题自 TeX Live 2011 发布的 v0.81 版本以来已经得到修复。我将在升级我的 TL 时验证这一点。

设置 KPSE 变量

请参阅下面 MPG 的评论。KPSE 变量仅$TEXMFHOME.texdoc可用于覆盖$TEXMFHOME目的texdoc。我运行了

$ sudo tlmgr conf texmf TEXMFHOME.texdoc "~/Library/texmf"

现在我明白了：

$ texdoc -f
texdoc 0.72
Configuration files are:
    absent  /Users/matthew/Library/texmf/texdoc/texdoc-x86_64-darwin.cnf
(*) active  /Users/matthew/Library/texmf/texdoc/texdoc.cnf
    absent  /Users/matthew/Library/texmf/texdoc/texdoc-dist.cnf
    absent  /usr/local/texlive/2010/../texmf-local/texdoc/texdoc-x86_64-darwin.cnf
    absent  /usr/local/texlive/2010/../texmf-local/texdoc/texdoc.cnf
    active  /usr/local/texlive/2010/texmf/texdoc/texdoc.cnf
(*) This is the recommended configuration file for your personal preferences.

如果我加上~/Library/texmf/texdoc/texdoc.cnf一行

adjscore(cool) Content_LaTeX_Package_Demo = 10

我得到：

$ texdoc -l cool
 1 /usr/local/texlive/2010/texmf-dist/doc/latex/cool/Content_LaTeX_Package_Demo.pdf
   = EXamples of use
 2 /usr/local/texlive/2010/texmf-dist/doc/latex/cool/cool.pdf
   = Package documentation

这正是我想要的。不仅如此，当我在 TeXShop 中选择“帮助”>“显示包帮助...”时，它会反映此更新。

设置环境变量

这是我的第一个答案。手册指出，可以通过在环境变量后添加后缀texdoc来覆盖环境变量。因此，解决方法是设置：texdoc_texdoc

$ export TEXMFHOME_texdoc=~/Library/texmf

（我在 Mac OSX 上使用bashshell。）这必须放在我的~/.profile文件中，以便它在每个 shell 中执行。

但是由于我有 TeX Live 并已对其进行了自定义，因此采用 TL 路线而不是环境变量更有意义。

相关内容