나는 cleveref를 사용하여 문서 간 참조를 상호 참조하고 make4ht로 컴파일하려고 합니다. 다음 예는 pdflatex로 컴파일되지만 make4ht 또는 htlatex로는 컴파일되지 않습니다.
main.tex:
\documentclass{article}
\usepackage{hyperref}
\usepackage{cleveref}
\begin{document}
\section{First Section} \label{section}
\begin{equation} \label{equation}
\int f(x) dx
\end{equation}
\end{document}
ref.tex:
\documentclass{article}
\usepackage{amsmath}
\usepackage{xr-hyper}
\usepackage{hyperref}
\usepackage{cleveref}
\externaldocument[main-]{main}
\begin{document}
Equation \eqref{main-equation} in \cref{main-section}.
\end{document}
\cref영리한 사용 을 중지하도록 변경하면 \refmake4ht는 여전히 오류 없이 컴파일할 수 없습니다.
[ERROR] htlatex: ./ref.tex 10 Argument of \XR:rEfLiNK has an extra }.
배치 모드를 사용하여 컴파일하면 예상되는 HTML이 생성됩니다. 컴파일하려고 하면 \cref더 많은 오류가 발생하고 배치 모드를 사용하면 참조가 작동하지 않습니다. ref.tex이전 에 컴파일하면 main.tex오류가 없지만 분명히 상호 참조가 작동하지 않습니다.
make4ht xr-hyper 및 hyperref와 거의 동일한 버그가 논의되었습니다.여기그 이후로 수정되었습니다.
이 문제를 해결하는 방법을 아는 사람이 있나요? 그리고 어떤 프로젝트에 버그를 보고하는 것이 좋을까요?
답변1
두 가지 문제가 있습니다. 첫 번째는 TeX4ht aux가 main.tex. 이 작업을 수행하면 모든 레이블을 확인하고 파일에 대한 올바른 링크를 생성하도록 수정합니다 main.html. 그러나 Cleveref는 지정된 레이블의 참조 유형에 대한 메타 정보가 포함된 특수 레이블을 사용합니다. 이러한 특수 라벨에는 접미사 @cref. 우리는 그들을 무시해야 합니다. 이 버전의 xr-hyper.4ht파일은 다음을 수행합니다.
% xr-hyper.4ht (2023-03-10-16:43), generated from tex4ht-4ht.tex
% Copyright 2003-2009 Eitan M. Gurari
% Copyright 2009-2023 TeX Users Group
%
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either
% version 1.3c of this license or (at your option) any
% later version. The latest version of this license is in
% http://www.latex-project.org/lppl.txt
% and version 1.3c or later is part of all distributions
% of LaTeX version 2005/12/01 or later.
%
% This work has the LPPL maintenance status "maintained".
%
% The Current Maintainer of this work
% is the TeX4ht Project <http://tug.org/tex4ht>.
%
% If you modify this program, changing the
% version identification would be appreciated.
\immediate\write-1{version 2023-03-10-16:43}
\let\XR:loop=\XR@loop
\def\XR@loop#1{%
\def\:temp##1.aux{\openin15=##1.xref
\ifeof15
\:warning{missing ##1.xref for ##1.aux}%
\let\:temp\empty
\else
\def\:temp{\input ##1.xref}%
\fi
\closein15 \:temp
}%
\catcode`\:=11
\expandafter\ifx \csname xr:CrossWord\endcsname\relax
\let\xr:CrossWord=\Cross:Word
\def\Cross:Word##1##2{%
\expandafter\let\csname cw:\cw:format{##1##2}\endcsname\:UnDef
\xr:CrossWord{##1}{##2}}%
\fi
%
\:temp#1%
\catcode`\:=12
\XR:loop{#1}%
}
\ExplSyntaxOn
\long\def\XR@test#1#2#3#4\XR@{%
\ifx#1\newlabel
\regex_match:nnTF{@cref}{#2}% we must handle cleveref meta references
{\expandafter\xdef\csname r@\XR@prefix#2\endcsname{#3}}%
{\expandafter\xdef\csname r@\XR@prefix#2\endcsname{\XR:rEfLiNK #3}}%
%
\else\ifx#1\@input
\edef\XR@list{\XR@list#2\relax}%
\fi\fi
\ifeof\@inputcheck\expandafter\XR@aux
\else\expandafter\XR@read\fi}
\ExplSyntaxOff
\def\XRrEfLiNK[#1]#2#3{%
\filename@parse{#1}% Get basename of the linked html file,
% xr:dir\filename@base contains file's directory
\a:xr[\csname xr:dir:\filename@base\endcsname#1]{#2}{}%
% this extra \fi fixes warning about unclosed \ifx, I hope it doesn't break anything
% I cannot find where that \ifx starts
\ifx\hyperrefLabel\:UnDef #3\else \hyperrefLabel\fi \b:xr\fi}
\NewConfigure{xr}{2}
\Configure{xr}{\Link}{\EndLink}
\def\XR:rEfLiNK#1#2#3#4#5{{\xr:rEfLiNK#1}{\xr:rEfLiNK#2}{\xr:rEfLiNK#3}}
\def\xr:rEfLiNK#1#2{\noexpand\XRrEfLiNK[\Get:HFile#2-]{#2}}
\def\Get:HFile#1-#2-{\:LikeRef{)F\:gobble #1F-}}
\Hinput{xr}
\endinput
중요한 코드는 다음과 같습니다.
\ExplSyntaxOn
\long\def\XR@test#1#2#3#4\XR@{%
\ifx#1\newlabel
\regex_match:nnTF{@cref}{#2}% we must handle cleveref meta references
{\expandafter\xdef\csname r@\XR@prefix#2\endcsname{#3}}%
{\expandafter\xdef\csname r@\XR@prefix#2\endcsname{\XR:rEfLiNK #3}}%
%
\else\ifx#1\@input
\edef\XR@list{\XR@list#2\relax}%
\fi\fi
\ifeof\@inputcheck\expandafter\XR@aux
\else\expandafter\XR@read\fi}
\ExplSyntaxOff
LaTeX 3 정규식을 사용하여 @cref레이블을 감지하고 그에 따라 지정된 참조를 선언합니다.
다른 문제는 cleveref.4ht이전 함수에 도입된 특수 외부 파일 링크를 지원해야 하기 때문에 에 있습니다. 이 버전에서는 cleveref.4ht다음 사항을 수정해야 합니다.
% cleveref.4ht (2023-03-10-17:14), generated from tex4ht-4ht.tex
% Copyright 2018-2023 TeX Users Group
%
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either
% version 1.3c of this license or (at your option) any
% later version. The latest version of this license is in
% http://www.latex-project.org/lppl.txt
% and version 1.3c or later is part of all distributions
% of LaTeX version 2005/12/01 or later.
%
% This work has the LPPL maintenance status "maintained".
%
% The Current Maintainer of this work
% is the TeX4ht Project <http://tug.org/tex4ht>.
%
% If you modify this program, changing the
% version identification would be appreciated.
\immediate\write-1{version 2023-03-10-17:14}
% orig:refstepcounter is saved in cleveref-hooks.4ht
\let\cref@old@refstepcounter\orig:refstepcounter%
\def\refstepcounter{%
\@ifnextchar[{\refstepcounter@optarg}{\refstepcounter@noarg}%]
}%
% fix for TeX4ht label mechanism
\def\cref:currentlabel#1{\let\cnt:currentlabel\@currentlabel
\def\:@currentlabel{\ifx \cnt:currentlabel\@currentlabel
\expandafter\the\csname c@#1\endcsname\else \@currentlabel\fi}%
%
\anc:lbl r{#1}%
}
\def\refstepcounter@noarg#1{%
\cref@old@refstepcounter{#1}%
\cref@constructprefix{#1}{\cref@result}%
\@ifundefined{cref@#1@alias}%
{\def\@tempa{#1}}%
{\def\@tempa{\csname cref@#1@alias\endcsname}}%
\protected@xdef\cref@currentlabel{%
[\@tempa][\arabic{#1}][\cref@result]%
\csname p@#1\endcsname\csname the#1\endcsname}%
\cref:currentlabel{#1}%
}%
\def\refstepcounter@optarg[#1]#2{%
\cref@old@refstepcounter{#2}%
\cref@constructprefix{#2}{\cref@result}%
\@ifundefined{cref@#1@alias}%
{\def\@tempa{#1}}%
{\def\@tempa{\csname cref@#1@alias\endcsname}}%
\protected@xdef\cref@currentlabel{%
[\@tempa][\arabic{#2}][\cref@result]%
\csname p@#2\endcsname\csname the#2\endcsname}%
\cref:currentlabel{#2}%
}%
\ifdefined\@firstoffive\else%
\def\@firstoffive#1#2#3#4#5{#1}%
\fi
\def\:tempa#1#2{\bgroup%
\def\rEfLiNK##1##2{\Link{##1}{}}%
\def\XRrEfLiNK[##1]##2##3{\Link[##1]{##2}{}}% handle links from Xr and Xr-hyper
\expandafter\expandafter\expandafter\@firstoffive\csname r@#2\endcsname{}{}{}{}{}%
\cref@getlabel{#2}{\@templabel}%
#1{\@templabel}{}{}%
\EndLink\egroup%
}%
\HLet\@@@setcref=\:tempa
\@ifpackageloaded{amsthm}{
\let\cref@thmnoarg\@thm%
\def\@thm{\@ifnextchar[{\cref@thmoptarg}{\cref@thmnoarg}}%]
\def\:tempb[#1]#2#3#4{%
% call original amsthm theorem definition, but
% disable \:thm in order to prevent infinite loop
\let\:thm\:gobble%
\cref@thmnoarg{#2}%
\o:cref@thmoptarg:[#1]{#2}{#3}{#4}
}%
\HLet\cref@thmoptarg\:tempb%
}{}%
\Hinput{cleveref}
\endinput
중요한 코드는 다음과 같습니다.
\def\:tempa#1#2{\bgroup%
\def\rEfLiNK##1##2{\Link{##1}{}}%
\def\XRrEfLiNK[##1]##2##3{\Link[##1]{##2}{}}% handle links from Xr and Xr-hyper
\expandafter\expandafter\expandafter\@firstoffive\csname r@#2\endcsname{}{}{}{}{}%
\cref@getlabel{#2}{\@templabel}%
#1{\@templabel}{}{}%
\EndLink\egroup%
}%
\HLet\@@@setcref=\:tempa
여기서 선언해야 합니다 \def\XRrEfLiNK[##1]##2##3.
이러한 변경 사항을 적용하면 예제를 컴파일할 수 있습니다.
