如何使用 imakeidx 和 splitindex 在 srcbook 中生成适当的索引？

Question

未制定指数的原因有两个。

具体来说，当 imakeidx 调用时带有 splitindex 选项，如中所示\usepackage[splitindex]{imakeidx}，latexmk 目前无法检测到运行 makeindex 的需要。这与省略 splitindex 选项或使用其他包创建索引的情况不同。
此外，使用 splitindex 选项时，需要运行 splitindex 程序来创建单独的索引。

第一个问题通过在文档顶部添加以下行来解决：

\typeout{Writing index file \jobname.idx}

这是 latexmk 用于检测索引是否存在的标准签名。（从 v. 4.84 开始，latexmk 将改进其对索引文件创建的检测，并且不再需要此技巧。）

第二个问题通过 latexmkrc 文件中的以下代码解决：

$makeindex = 'internal splitindex2 %S %D %R %B %O';
$clean_ext .= " %R-*.ind %R-*.idx %R-*.ilg %R-*.ind";

sub splitindex2 {
  # Use splitindex instead of makeindex.
  # The splitindex programe starts from an .idx file, makes a set of
  #   other .idx files for separate indexes, and then runs makeindex to
  #   make corresponding .ind files.
  # However, it is possible that the document uses the splitindex
  #   package, but in a way compatible with the standard methods
  #   compatible with makeindex, i.e., with a single index and with the
  #   use of the \printindex command.
  #   Then we need to invoke makeindex.
  # In addition, latexmk assumes that makeindex or its replacement makes
  #   an .ind file from an .idx file, and latexmk gives an error if it
  #   doesn't exist, so we need to make an .ind file.
  # Both problems are solved by running makeindex and then splitindex.
  # Note: errors are returned by makeindex and splitindex for things
  #   like a missing input file.  No error is returned for lines in an
  #   input file that are in an incorrect format; they are simply
  #   ignored.  So no problem is caused by lines in the .idx file
  #   that are generated by splitindex in a format incompatible with
  #   makeindex.
  my ($source, $dest, $root, $base, @opts) = @_;
  my $ret1 = system( "makeindex", $source );
  my $ret2 = system( "splitindex", $source );
  return $ret1 || $ret2;
}

Answer 1

未制定指数的原因有两个。

具体来说，当 imakeidx 调用时带有 splitindex 选项，如中所示\usepackage[splitindex]{imakeidx}，latexmk 目前无法检测到运行 makeindex 的需要。这与省略 splitindex 选项或使用其他包创建索引的情况不同。
此外，使用 splitindex 选项时，需要运行 splitindex 程序来创建单独的索引。

第一个问题通过在文档顶部添加以下行来解决：

\typeout{Writing index file \jobname.idx}

这是 latexmk 用于检测索引是否存在的标准签名。（从 v. 4.84 开始，latexmk 将改进其对索引文件创建的检测，并且不再需要此技巧。）

第二个问题通过 latexmkrc 文件中的以下代码解决：

$makeindex = 'internal splitindex2 %S %D %R %B %O';
$clean_ext .= " %R-*.ind %R-*.idx %R-*.ilg %R-*.ind";

sub splitindex2 {
  # Use splitindex instead of makeindex.
  # The splitindex programe starts from an .idx file, makes a set of
  #   other .idx files for separate indexes, and then runs makeindex to
  #   make corresponding .ind files.
  # However, it is possible that the document uses the splitindex
  #   package, but in a way compatible with the standard methods
  #   compatible with makeindex, i.e., with a single index and with the
  #   use of the \printindex command.
  #   Then we need to invoke makeindex.
  # In addition, latexmk assumes that makeindex or its replacement makes
  #   an .ind file from an .idx file, and latexmk gives an error if it
  #   doesn't exist, so we need to make an .ind file.
  # Both problems are solved by running makeindex and then splitindex.
  # Note: errors are returned by makeindex and splitindex for things
  #   like a missing input file.  No error is returned for lines in an
  #   input file that are in an incorrect format; they are simply
  #   ignored.  So no problem is caused by lines in the .idx file
  #   that are generated by splitindex in a format incompatible with
  #   makeindex.
  my ($source, $dest, $root, $base, @opts) = @_;
  my $ret1 = system( "makeindex", $source );
  my $ret2 = system( "splitindex", $source );
  return $ret1 || $ret2;
}

如何使用 imakeidx 和 splitindex 在 srcbook 中生成适当的索引？

答案1

相关内容