☰

Latex“命令示例”查找/参考 - 从命令行？

tag-icon • tag-icon tools
Latex“命令示例”查找/参考 - 从命令行？

我已经很喜欢这个texdef工具了，它在命令行上使用，如下所示：

$ texdef -t latex \newcounter

\newcounter:
macro:#1->\expandafter \@ifdefinable \csname c@#1\endcsname {\@definecounter {#1}}\@ifnextchar [{\@newctr {#1}}{}

也就是说，我们可以\newcounter从命令行查找：搜索并找到的定义——我认为这很棒。

但是，我经常需要其他东西。比如现在，我需要使用\newcounter，而且由于我很少使用计数器，我已经完全忘记了正确的使用语法（即我在哪里使用\the等等）。然后我总是必须在线查找:)，也就是搜索引擎，然后点击结果，然后它并不总是我希望的信息，然后返回浏览器，等等。而且，在此过程中我不能离线。

因此，基本上，我需要的是一个命令行工具，我可以用它来查找有关命令的一些简短信息，并且希望得到一个示例；例如，这是一个伪：

$ texexampleref  \newcounter

% \newcounter: creates a new counter (dimen?)

% example usage:

% create a new counter that is automatically set to zero
\newcounter{NameOfTheNewCounter}
% To increase the counter, use:
\stepcounter{NameOfTheNewCounter}
% ... or (add number 1):
\addtocounter{NameOfTheNewCounter}{1}
% To set the counter value explicitly, use:
\setcounter{NameOfTheNewCounter}{12}
% To show the counter value (typeout)
\typeout{ Counter value is: \theNameOfTheNewCounter }
% ...

这里我借用了LaTeX/计数器 - 维基教科书作为内容。基本上，我希望信息行以百分号为前缀% - 这样整个示例片段就可以粘贴在pdflatex终端 shell 中；并且它将是“可编译的”，因为它会在终端中产生一些输出（至少是标准输出）。当然 - 至少在这种情况下 - 相同的示例也可以用于查询\stepcounter和\addtocounter和\setcounter。

我有点怀疑它的存在——虽然它并不复杂，但我可以想象这个工具的维护会是一场噩梦:)（尽管我也可以想象这里有一个超长的社区 Wiki，里面有用户可编辑的示例，可以作为该工具的一个可下载数据库源……或者，如果有一个用于在.dtx文件中标记示例的命令，也许可以自动收集示例）。但我仍然想确定——所以我的问题是：有这样的工具吗？

答案1

NASA LaTeX 网站提供了您需要的适量信息：http://www.giss.nasa.gov/tools/latex/index.html

你可以使用文本浏览器从命令行访问它，例如elinks。例如，在 Unixy 系统上，你可以将其放入你的.bash_aliases或其他适当的点文件中：

function texhelp {
  elinks http://www.google.com/search?q="$1"+site:http://giss.nasa.gov/tools/latex
}

用法：在终端中，输入texhelp newcounter。

NASA 提供了其整个文档网站供下载，因此您可以下载离线版本，仍然使用文本浏览器；或者您可以剥离 HTML 文件然后使用grep，等等。

相关内容