修复 JAIR 样式

Question 1

您可以通过插入包来获得一些您想要的功能，hyperref如下面的最小图所示（这些设置与 JAIR 文件夹中的 sample2e.tex 示例文件一起使用）。

\documentclass[jair,twoside,11pt,theapa]{article}
\usepackage[bookmarks=true]{hyperref}
\hypersetup{%
    bookmarks=false,    % show bookmarks bar?
    pdftitle={TeX and friends hackers manual},    % title
    pdfauthor={Yiannis Lazarides},                     % author
    pdfsubject={TeX and LaTeX},                        % subject of the document
    pdfkeywords={TeX, LaTeX, graphics, images}, % list of keywords
    colorlinks=true,       % false: boxed links; true: colored links
    linkcolor=blue,       % color of internal links
    citecolor=black,       % color of links to bibliography
    filecolor=black,        % color of file links
    urlcolor=purple,        % color of external links
    linktoc=page            % only page is linked
}
\usepackage{jair, theapa, rawfonts}

\jairheading{1}{1993}{1-15}{6/91}{9/91}
\ShortHeadings{Minimizing Conflicts: A Heuristic Repair Method}
{Minton, Philips, Johnston, \& Laird}
\firstpageno{25}

\begin{document}
\section{One}\label{sec:one}
\section{Three}
  In Section \ref{sec:one}, we referenced \ldots
\section{Four}
  Some more text.
\end{document}

但是，正如您正确指出的那样，类文件需要彻底修改才能在屏幕上查看。在印刷版中，该样式为期刊文章提供了出色的样式。我建议采用以下方法。

将基本内容复制.cls到文件中.dtx，以便您可以记录更改。
首先追求立即实现功能，无需任何参考书目和引用。
声明一个选项“oldclass”或类似选项来打开旧式文件以实现向后兼容。
确保到目前为止一切正常，没有任何错误。
将课程升级到 BiblateX，这样该课程可能还能再存活 20 年，到那时 AI 就已经足够先进，可以从此接管课程！

这种方法的优点是，您可以确保向后兼容性，并且可以以更好的方式进行渐进式改进。如果您对 LaTeX 相当熟悉，则需要 1-2 周的全职工作。

Answer

您可以通过插入包来获得一些您想要的功能，hyperref如下面的最小图所示（这些设置与 JAIR 文件夹中的 sample2e.tex 示例文件一起使用）。

\documentclass[jair,twoside,11pt,theapa]{article}
\usepackage[bookmarks=true]{hyperref}
\hypersetup{%
    bookmarks=false,    % show bookmarks bar?
    pdftitle={TeX and friends hackers manual},    % title
    pdfauthor={Yiannis Lazarides},                     % author
    pdfsubject={TeX and LaTeX},                        % subject of the document
    pdfkeywords={TeX, LaTeX, graphics, images}, % list of keywords
    colorlinks=true,       % false: boxed links; true: colored links
    linkcolor=blue,       % color of internal links
    citecolor=black,       % color of links to bibliography
    filecolor=black,        % color of file links
    urlcolor=purple,        % color of external links
    linktoc=page            % only page is linked
}
\usepackage{jair, theapa, rawfonts}

\jairheading{1}{1993}{1-15}{6/91}{9/91}
\ShortHeadings{Minimizing Conflicts: A Heuristic Repair Method}
{Minton, Philips, Johnston, \& Laird}
\firstpageno{25}

\begin{document}
\section{One}\label{sec:one}
\section{Three}
  In Section \ref{sec:one}, we referenced \ldots
\section{Four}
  Some more text.
\end{document}

但是，正如您正确指出的那样，类文件需要彻底修改才能在屏幕上查看。在印刷版中，该样式为期刊文章提供了出色的样式。我建议采用以下方法。

将基本内容复制.cls到文件中.dtx，以便您可以记录更改。
首先追求立即实现功能，无需任何参考书目和引用。
声明一个选项“oldclass”或类似选项来打开旧式文件以实现向后兼容。
确保到目前为止一切正常，没有任何错误。
将课程升级到 BiblateX，这样该课程可能还能再存活 20 年，到那时 AI 就已经足够先进，可以从此接管课程！

这种方法的优点是，您可以确保向后兼容性，并且可以以更好的方式进行渐进式改进。如果您对 LaTeX 相当熟悉，则需要 1-2 周的全职工作。

Question 2

事实证明

\usepackage[implicit=false]{hyperref}

足以阻止hyperrefJAIR 样式相互干扰。即使 JAIR 的 BibTeX 样式文件被修改，urlbst支持 DOI 字段和内联超链接 URL。

根据文档，选项implicit=false可防止包重新定义某些 LaTeX 内部结构。文档中的超链接似乎也被省略了，但这对我来说并不那么重要。hyperrefimplicit=false

Answer

事实证明

\usepackage[implicit=false]{hyperref}

足以阻止hyperrefJAIR 样式相互干扰。即使 JAIR 的 BibTeX 样式文件被修改，urlbst支持 DOI 字段和内联超链接 URL。

根据文档，选项implicit=false可防止包重新定义某些 LaTeX 内部结构。文档中的超链接似乎也被省略了，但这对我来说并不那么重要。hyperrefimplicit=false

Question 3

我在撰写 JAIR 文章时也遇到了同样的兼容性问题。事实证明，只需在序言中稍加努力，theapa就可以使其与以下代码基本兼容：hyperref

加载顺序很重要：首先hyperref，然后refstyle（或者你选择的交叉引用包，可能需要加载前 hyperref)，最后jair和theapa。这样，我们可以启用hyperref对超链接、超链接交叉引用、书签、PDF 属性和 PDF 布局的支持：

%use this command unless it is already invoked earlier in the preamble
\makeatletter

\usepackage[implicit=true,unicode=true,
 bookmarks=true,bookmarksnumbered=true,bookmarksopen=true]
 {hyperref}
\hypersetup{
  pdftitle={my title},
  pdfauthor={my name},
  pdfsubject={my subject},
  pdfkeywords={my keywords},
  %all links are black to preserve the appearance of a printed paper
  colorlinks=true,
  allcolors=black,
  pdfpagelayout=OneColumn,
  pdfnewwindow=true,
}

\usepackage{refstyle}

%we also use the package rawfonts because this this is copied verbatim
%from the JAIR author kit (http://www.jair.org)
\usepackage{jair, theapa, rawfonts}

加载这些包后，我们仍然没有对引用的超链接支持。我们必须从重新定义一个内部命令theapa，并定义与的引用命令等效的新命令theapa：

%load this package unless you have loaded it earlier
\usepackage{ifpdf}

%only the pdflatex driver can handle hyperlinks that break across lines
%(as citations often do) so we define them only when using pdflatex
\ifpdf

  %we add hyperref support with the commands \hyper@natanchorstart and \hyper@natanchorend
  \def\@lbibitem[#1]#2{\def\BBA{\BBAA}\item[\hyper@natanchorstart{#2}\@biblabel{#1}\hyper@natanchorend]\if@filesw
        { \def\BBA{\string\BBA}%
          \def\protect##1{\string ##1\space}\immediate
          \write\@auxout{\string\bibcite{#2}{#1}}%
    \def\BBA{\BBAA}}\fi\ignorespaces}

  %load this package unless you have loaded it earlier
  \usepackage{ifthen}

  %new citation commands. Add more as needed, using the existing ones as templates
  %hyperref support is added by using the commands \hyper@natlinkstart and \hyper@natlinkend
  \newcommand{\mshortcite}[2][]{\hyper@natlinkstart{#2}\ifthenelse{\equal{#1}{}}{\shortcite{#2}}{\shortcite[#1]{#2}}\hyper@natlinkend}
  \newcommand{\mshortciteA}[2][]{\hyper@natlinkstart{#2}\ifthenelse{\equal{#1}{}}{\shortciteA{#2}}{\shortciteA[#1]{#2}}\hyper@natlinkend}
  \newcommand{\mfullciteA}[2][]{\hyper@natlinkstart{#2}\ifthenelse{\equal{#1}{}}{\fullciteA{#2}}{\fullciteA[#1]{#2}}\hyper@natlinkend}
  \newcommand{\mshortciteR}[2][]{\hyper@natlinkstart{#2}\ifthenelse{\equal{#1}{}}{\shortciteR{#2}}{\shortciteR[#1]{#2}}\hyper@natlinkend}
  \newcommand{\mciteyear}[2][]{\hyper@natlinkstart{#2}\ifthenelse{\equal{#1}{}}{\citeyear{#2}}{\citeyear[#1]{#2}}\hyper@natlinkend}
  \newcommand{\mciteyearR}[2][]{\hyper@natlinkstart{#2}\ifthenelse{\equal{#1}{}}{\citeyearR{#2}}{\citeyearR[#1]{#2}}\hyper@natlinkend}
  \newcommand{\mshortciteS}[2][]{\hyper@natlinkstart{#2}\ifthenelse{\equal{#1}{}}{\shortciteS{#2}}{\shortciteS[#1]{#2}}\hyper@natlinkend}
  \newcommand{\mshortciteauthor}[1]{\hyper@natlinkstart{#1}\shortciteauthor{#1}\hyper@natlinkend}
  \newcommand{\mfullciteauthor}[1]{\hyper@natlinkstart{#1}\fullciteauthor{#1}\hyper@natlinkend}

\else

  %default definitions when not using pdflatex
  \let\mcite\shortcite
  \let\mcitea\shortciteA
  \let\mcitear\fullciteA
  \let\mciter\shortciteR
  \let\mciteyear\citeyear
  \let\mciteyearr\citeyearR
  \let\mcites\shortciteS
  \let\mciteauthor\shortciteauthor
  \let\mciteauthorr\fullciteauthor
  \let\mcitetable\mciter

\fi

%use this command unless it is already invoked later in the preamble
\makeatother

就是这样！

在序言中使用这些代码片段将使hyperrefJAIR 文章获得几乎完全的支持。请注意，theapa新的引用命令中缺少某些功能，例如尖括号中的可选参数，或使用单个引用命令引用多个参考文献。

如果你只想使用theapawithout jair，只需替换

\usepackage{jair, theapa, rawfonts}

经过

\usepackage{theapa}

更新：我注意到，此解决方案仅适用于pdflatex，但不能用于生成 DVI->PS，因为 DVI 驱动程序无法处理跨行引用的链接。解决方案是仅对pdflatex使用启用新的引用命令ifpdf。代码已相应更新。

Answer