☰

Was sollte das vierte Argument von \contentsline sein, wenn ich manuell in die TOC-Datei schreibe?

tag-icon • tag-icon table-of-contents hyperref package-writing
Was sollte das vierte Argument von \contentsline sein, wenn ich manuell in die TOC-Datei schreibe?

Ich möchte mein Inhaltsverzeichnis manuell ändern. Der Grund dafür ist, dass mein Dokument nicht so sehr aus „Abschnitten“, sondern eher aus „Übungen“ besteht. Ich habe einen benutzerdefinierten Befehl dafür geschrieben und es funktioniert fast. Die folgenden Befehle werden in eine benutzerdefinierte .styDatei geschrieben und nachher geladen hyperref:

\def\numberline@exer#1{%
\makebox[50pt][l]{\bf Ex. #1\hspace*{1em}}
}

\def\exercise#1{%
\section*{#1}\refstepcounter{exercise}\phantomsection%
\write\@auxout{%
    \protect\@writefile{toc}{%
        \protect\contentsline {section}{\numberline@exer{\theexercise}Title}{\thepage}%
{????}% This is the fourth argument, defined by hyperref
        }%
    }%
}

Dies macht im Grunde genau das, was ich will, außer dass kein Lesezeichen erstellt wird. Das liegt wahrscheinlich am vierten Argument. Ich habe versucht, herauszufinden, wie hyperrefredefines funktioniert \contentsline, aber ich finde es hyperref.styunmöglich, das zu verstehen.

Meine Frage ist also: Was sollte das vierte Argument in meiner Definition sein? Ich würde auch gerne wissen, wie dieses vierte Argument funktioniert, aber das hat keine hohe Priorität.

NB: Ich bin nicht daran interessiert, Pakete zu installieren, mit denen Inhaltsverzeichnisse angepasst werden können. Ich mache das nur aus Übungsgründen und würde daher sehr gerne meine eigene .styDatei dafür verwenden.

Antwort1

Normalerweise \contentslinesollten alle Änderungen von usw. vor dem Laden erfolgen hyperref, anschließend muss das 4thArgument von berücksichtigt werden \contentsline, das von hinzugefügt wird hyperref.

Das 4thArgument ist der Hyperanker, also etwas wie section.1oder east.17.

Der Hyperanker kann mit eingefügt werden \@currentHref, was den richtigen Anker liefern sollte, da \phantomsectionverwendet wurde.

Um das Lesezeichen hinzuzufügen, verwenden Sie \Hy@writebookmark, da \contentslineselbst die Lesezeichen nicht hinzufügt, dies geschieht im Wrapper-Befehl \addcontentsline, der hier „umgangen“ wird.

\documentclass{article}


\usepackage[bookmarksopen]{hyperref}


\newcounter{exercise}


\makeatletter

\def\numberline@exer#1{%
\makebox[50pt][l]{\bfseries Ex. #1\hspace*{1em}}
}

\def\exercise#1{%
  \phantomsection
  \refstepcounter{exercise}
  \section*{#1}%
  \Hy@writebookmark{\csname theexercise\endcsname}{#1}{\@currentHref}{\toclevel@section}{toc}
  \write\@auxout{%
    \protect\@writefile{toc}{%
      \protect\contentsline {section}{\numberline@exer{\theexercise}#1}{\thepage}{\@currentHref}%
    }%
  }%

}
\makeatother

\usepackage{blindtext}

\begin{document}
\tableofcontents

\section{First section}\label{foosection}

\clearpage

\blindtext[3]
\exercise{Foo}
\blindtext[2]


\end{document}

Bildbeschreibung hier eingeben

AktualisierenEine Version mit dem üblichen \addcontentsline:

\documentclass{article}


\usepackage[bookmarksopen]{hyperref}


\newcounter{exercise}


\makeatletter

\newcommand*\l@exercise[2]{%
  \ifnum \c@tocdepth >\z@
    \addpenalty\@secpenalty
    \addvspace{1.0em \@plus\p@}%
    \setlength\@tempdima{3.8em}%
    \begingroup
      \parindent \z@ \rightskip \@pnumwidth
      \parfillskip -\@pnumwidth
      \leavevmode \bfseries
      \advance\leftskip\@tempdima
      \hskip -\leftskip
      #1\nobreak\hfil \nobreak\hb@xt@\@pnumwidth{\hss #2}\par
    \endgroup
  \fi}



\let\toclevel@exercise\toclevel@section

\newcommand{\exercisebetter}[1]{%
  \refstepcounter{exercise}
  \section*{#1}%
  \addcontentsline{toc}{exercise}{\protect\numberline{Ex: \theexercise}#1}
}


\makeatother

\usepackage{blindtext}

\begin{document}
\tableofcontents

\section{First section}\label{foosection}

\clearpage

\blindtext[3]

\exercisebetter{Foobar}
\blindtext[2]


\end{document}

Antwort2

Ich würde empfehlen, nicht \write\@auxoutdirekt zu verwenden, sondern zu verwenden \addcontentsline. \addcontentslinerespektiert \nofileund verwendet automatisch \protected@write, sodass Sie verwenden können, \protectum fragile Befehle zu schützen. Und hyperrefbehandelt automatisch Lesezeichen usw., wenn Sie verwenden \addcontentsline. Sie müssen also nicht wissen, wie Sie das 4. Argument von „ \contentsadded by“ festlegen hyperref. Eine sehr einfache Lösung, die unabhängig davon funktioniert, ob verwendet wird hyperrefoder nicht (und unabhängig davon, ob hyperrefvor oder nach dem zusätzlichen Code geladen wird), wäre:

\documentclass{article}
\usepackage[bookmarksopen]{hyperref}

\providecommand*{\texorpdfstring}[2]{#1}% Needed if `hyperref` is not used.
\newcounter{exercise}
\makeatletter
\def\numberline@exer#1{%
  \texorpdfstring{\makebox[50pt][l]{\bfseries Ex. #1\hspace*{1em}}}{Ex. #1}
}

\newcommand\l@exercise{\l@section}
\newcommand*{\exercise}{%
  \@dblarg\@exercise
}
\newcommand*{\@exercise}[2][]{%
  \refstepcounter{exercise}%
  \section*{#2}%
  \addcontentsline{toc}{exercise}{\protect\numberline@exer{\theexercise}#1}%
}
\let\toclevel@exercise\toclevel@section
\makeatother

\usepackage{blindtext}

\begin{document}
\tableofcontents

\section{First section}\label{foosection}

\clearpage

\blindtext[3]
\exercise{Foo}
\blindtext[2]
\exercise[Bar]{Foo-Bar}
\blindtext

\end{document}

Bei dieser Lösung gibt es \exerciseauch \sectionein optionales Argument zum Setzen und Ändern des Textes für das Inhaltsverzeichnis. Siehe \exercise[Bar]{Foo-Bar}im Beispiel.

verwandte Informationen