我最近创建了一个文档类,不久前才将其打包成 DTX 文件。我有一个如下所示的安装文件:
%%
%% Licence info
%%
\input docstrip.tex
\keepsilent
\usedir{tex/latex/bil-CV}
\preamble
This is a generated file licenced under the MIT License:
The MIT License (MIT)…blah blah blah...
\endpreamble
\generate{\file{bil-CV.cls}{\from{bil-CV.dtx}{class}}}
\obeyspaces
\Msg{*********************************************************}
\Msg{*}
\Msg{* To finish the installation you have to move the}
\Msg{* following file into a directory searched by TeX:}
\Msg{*}
\Msg{* \space\space bil-CV.cls}
\Msg{*}
\Msg{* To produce the documentation run the file bil-CV.dtx}
\Msg{* through LaTeX.}
\Msg{*}
\Msg{* Happy TeXing!}
\Msg{*********************************************************}
\endbatchfile
我通过执行来运行它latex bil-CV.ins
,并得到以下输出:
This is pdfTeX, Version 3.14159265-2.6-1.40.15 (TeX Live 2014) (preloaded format=latex)
restricted \write18 enabled.
entering extended mode
(./bil-CV.ins
LaTeX2e <2014/05/01>
Babel <3.9k> and hyphenation patterns for 78 languages loaded.
(/usr/local/texlive/2014/texmf-dist/tex/latex/base/docstrip.tex
Utility: `docstrip' 2.5d <2005/07/29>
English documentation <2014/04/19>
**********************************************************
* This program converts documented macro-files into fast *
* loadable files by stripping off (nearly) all comments! *
**********************************************************
********************************************************
* No Configuration file found, using default settings. *
********************************************************
)
Generating file(s) ./bil-CV.cls
Processing file bil-CV.dtx (class) -> bil-CV.cls
Lines processed: 407
Comments removed: 262
Comments passed: 9
Codelines passed: 130
*********************************************************
*
* To finish the installation you have to move the
* following file into a directory searched by TeX:
*
* bil-CV.cls
*
* To produce the documentation run the file bil-CV.dtx
* through LaTeX.
*
* Happy TeXing!
*********************************************************
)
No pages of output.
Transcript written on bil-CV.log.
既然指定了\usedir{tex/latex/bil-CV}
,为什么在CWD中生成了类文件,而不是像和ins文件~/Library/texmf/tex/latex/bil-CV
中所指定的那样?/usr/local/texlive/2014/texmf.cnf
答案1
详情如下DocStrip 手册,DocStrip 的设计要求您设置\BaseDirectory
(因为 TeX 无法知道您要安装到哪里)和\UseTDS
(激活您的\usedir
行到方法 TDS 结构的映射)。这些行最有可能进入文件docstrip.cfg
而不是.ins
文件本身。
正如评论中所述,出于安全原因,现代 TeX 系统不允许写入当前目录之上的目录。(这可以更改,但不建议这样做。)TeX 和 DocStrip 无法创建目录,因此结构也需要预先存在。因此,DocStrip 的“提取到 TDS”功能最好被视为历史概念,而不是今天使用的。与其使用 DocStrip 来填充本地树,更有用的方法是创建 TDS 样式的 zip 并使用它。有各种脚本可用于帮助完成此过程。