Dokumentation mit l3doc.cls

Dokumentation mit l3doc.cls

Ich habe versucht, meine Paketdokumentation von ltxdocin zu konvertieren l3docund bin dabei auf mehrere Hindernisse gestoßen.

Zuerst muss ich mich \ProvidesExplFilean die Arbeit machen. Ich habe versucht, so etwas zu machen:

% \iffalse meta-comment
%<*driver|package>
\GetIdInfo $Id: test.dtx 1.0 2024/02/04 I. M. A. Person <[email protected]> $
     {description of package}
%</driver|package>
%<*driver>
\ProvidesExplFile{\ExplFileName.dtx}
%</driver>
%<package>\NeedsTeXFormat{LaTeX2e}
%<package>\RequirePackage{expl3}
%<package>\ProvidesExplPackage{\ExplFileName}
%<*driver|package>
   {\ExplFileDate}{\ExplFileVersion}{\ExplFileDescription}
%</driver|package>
%<*driver>
\documentclass[12pt]{l3doc}
\begin{document}
  \DocInput{test.dtx}
\end{document}
%</driver>
% \fi
%
% \title{The \pkg{test} package\thanks{This document corresponds to
%   \textsf{test}~\ExplFileVersion, dated \ExplFileDate.}}
% \author{me}
% \date{\ExplFileDate}
% \maketitle
% \begin{documentation}
% \section{Documentation}
% \end{documentation}
% \iffalse
%<*package>
%<@@=test>
% \fi
%
% \begin{implementation}
% \section{Implementation}
% \end{implementation}
%
% \Finale
% \iffalse
%</package>
% \fi
\endinput

Dies führt jedoch zu einem Fehler. Ich konnte es zum Laufen bringen, wenn ich \ProvidesFileanstelle von ProvidesExplFilewie folgt verwende:

% \iffalse meta-comment
%<*driver|package>
\GetIdInfo $Id: test.dtx 1.0 2024/01/26 I. M. A. Person <[email protected]> $
     {description of package}
%</driver|package>
%<*driver>
\ProvidesFile{\ExplFileName.dtx}
    [\ExplFileDate\space v\ExplFileVersion\space\ExplFileDescription]
%</driver>
%<package>
%<package>\NeedsTeXFormat{LaTeX2e}
%<package>\RequirePackage{expl3}
%<package>\ProvidesExplPackage{\ExplFileName}
%<package>   {\ExplFileDate}{\ExplFileVersion}{\ExplFileDescription}
%<*driver>
\documentclass[12pt]{l3doc}
\begin{document}
  \DocInput{test.dtx}
\end{document}
%</driver>
% \fi

Was mache ich falsch?

verwandte Informationen