view docs/_latex/my-doc-style.sty @ 777:93d1d6506492

There is no need for the README to contain the repository path
author Franz Glasner <fzglas.hg@dom66.de>
date Sat, 16 May 2026 01:53:53 +0200
parents 48deafc1fd2f
children 47ae57d92ed3
line wrap: on
line source

% -*- coding: utf-8 -*-
%
% Some font hacks for my Sphinx PDF documents
%
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{my-doc-style}[%
  2026/05/15 v0.2 (Franz Glasner) Some style customizations (title et al.)]
\RequirePackage{xkeyval}

% A key compatible with options processing but bool (because DeclareBoolOptionX)
% If given than the Sphinx standard titlepage is used without changes.
\define@boolkey{my-doc-style.sty}{stdtitle}[true]{}

\ExecuteOptionsX{stdtitle=false}
\ProcessOptionsX\relax

%
% For the title page: "Last updated on ..."
%
\DeclareRobustCommand*\vcsrevision[1]{\gdef\mds@vcs@revision{#1}}
\DeclareRobustCommand*\builddate[1]{\gdef\mds@builddate{#1}}
\vcsrevision{}
\builddate{}
%
% If the option "stdtitle" was not enabled augment the titlepage with
% the documentation build date and the VCS revision id.
%
\csname ifKV@my-doc-style.sty@stdtitle\endcsname
  \relax
\else
  % \sphinxmaketitle calls the macro \@thanks: abuse this
  \gdef\@thanks{%
    \ifx\mds@builddate\@empty\relax%
      \ifx\mds@vcs@revision\@empty\relax%
      \else%
        \hfill\normalsize\textsf{(rv:\mds@vcs@revision )}%
      \fi%
    \else%
      \hfill\normalsize\textsf{Last updated on \mds@builddate%
      \ifx\mds@vcs@revision\@empty\relax\else\enspace(rv:\mds@vcs@revision )\fi}
    \fi%
  }
\fi

\endinput