texlive[58593] Master: scrlayer-fancyhdr (21mar21)
commits+karl at tug.org
commits+karl at tug.org
Sun Mar 21 22:42:35 CET 2021
Revision: 58593
http://tug.org/svn/texlive?view=revision&revision=58593
Author: karl
Date: 2021-03-21 22:42:35 +0100 (Sun, 21 Mar 2021)
Log Message:
-----------
scrlayer-fancyhdr (21mar21)
Modified Paths:
--------------
trunk/Master/tlpkg/bin/tlpkg-ctan-check
trunk/Master/tlpkg/libexec/ctan2tds
trunk/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc
Added Paths:
-----------
trunk/Master/texmf-dist/doc/latex/scrlayer-fancyhdr/
trunk/Master/texmf-dist/doc/latex/scrlayer-fancyhdr/LICENSE.md
trunk/Master/texmf-dist/doc/latex/scrlayer-fancyhdr/README.md
trunk/Master/texmf-dist/doc/latex/scrlayer-fancyhdr/scrlayer-fancyhdr.pdf
trunk/Master/texmf-dist/source/latex/scrlayer-fancyhdr/
trunk/Master/texmf-dist/source/latex/scrlayer-fancyhdr/scrlayer-fancyhdr.dtx
trunk/Master/texmf-dist/tex/latex/scrlayer-fancyhdr/
trunk/Master/texmf-dist/tex/latex/scrlayer-fancyhdr/scrlayer-fancyhdr.sty
trunk/Master/tlpkg/tlpsrc/scrlayer-fancyhdr.tlpsrc
Added: trunk/Master/texmf-dist/doc/latex/scrlayer-fancyhdr/LICENSE.md
===================================================================
--- trunk/Master/texmf-dist/doc/latex/scrlayer-fancyhdr/LICENSE.md (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/scrlayer-fancyhdr/LICENSE.md 2021-03-21 21:42:35 UTC (rev 58593)
@@ -0,0 +1,19 @@
+----------------------------------------------------------------------------
+
+This work may be distributed and/or modified under the conditions of the
+LaTeX Project Public License, version 1.3c of the license. 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 2005/12/01
+or later. This work has the LPPL maintenance status “maintained”.
+The current maintainer and author of this work is Markus Kohm.
+
+----------------------------------------------------------------------------
+
+Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz
+in der Version 1.3c, verteilt und/oder verändert werden. Die aktuelle
+Version dieser Lizenz ist http://www.latex-project.org/lppl.txt und
+Version 1.3c oder später ist Teil aller Verteilungen von LaTeX 2005/12/01
+oder später. Dieses Werk hat den LPPL-Verwaltungs-Status „maintained”
+Der aktuelle Verwalter und Autor dieses Werks ist Markus Kohm.
+
+----------------------------------------------------------------------------
Property changes on: trunk/Master/texmf-dist/doc/latex/scrlayer-fancyhdr/LICENSE.md
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/latex/scrlayer-fancyhdr/README.md
===================================================================
--- trunk/Master/texmf-dist/doc/latex/scrlayer-fancyhdr/README.md (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/scrlayer-fancyhdr/README.md 2021-03-21 21:42:35 UTC (rev 58593)
@@ -0,0 +1,88 @@
+# `scrlayer-fancyhdr` — combining [`fancyhdr`](https://www.ctan.org/pkg/fancyhdr) with [KOMA-Script](https://www.ctan.org/pkg/koma-script)'s [`scrlayer`](https://www.ctan.org/pkg/scrlayer)
+
+------------------------------------------------------------------------------
+
+LaTeX package `scrlayer-fancyhdr`
+Copyright (c) 2008—2021 Markus Kohm
+Release: 2021-03-17 v0.2
+License: LPPL 1.3c (see LICENSE.md)
+CTAN Location: https://ctan.org/pkg/scrlayer-fancyhdr
+
+------------------------------------------------------------------------------
+
+## Summary
+
+`scrlayer-fancyhdr` is a LaTeX package, that uses
+[KOMA-Script](https://www.ctan.org/pkg/koma-script)'s
+[`scrlayer`](https://www.ctan.org/pkg/scrlayer) to redefine the page styles of
+package [`fancyhdr`](https://www.ctan.org/pkg/fancyhdr). This allows the
+combination of features of `fancyhdr` with features of `scrlayer`.
+
+Before KOMA-Script v3.33 `scrlayer-fancyhdr` was part of KOMA-Script itself.
+It still depends on KOMA-Script package
+[`scrlayer`](https://www.ctan.org/pkg/scrlayer) at least version 3.33. It
+also depends on [`fancyhdr`](https://www.ctan.org/pkg/fancyhdr). Currently
+version 3 and 4 up to 4.0.1 are supported and tested.
+
+## Status
+
+This is an early release of an experimental package.
+
+## Installation
+
+We recommend to use the package manager of your TeX distribution to install
+packages. However, if you need to install `scrlayer-fancyhdr` manually, you
+can either use a semi-manual installation or a completely manual installation.
+
+### Semi-manual Installation
+
+For a semi-manual installation you can first create a local clone
+of the repository:
+
+```bash
+git clone https://github.com/komascript/scrlayer-fancyhdr.git
+```
+
+Then enter the directory created while cloning the repository:
+
+```bash
+cd scrlayer-fancyhdr
+```
+
+Last, but not least use `l3build` to install it locally with manual and
+sources:
+
+```bash
+l3build install --full
+```
+
+or without manual and sources:
+
+```bash
+l3build install
+```
+
+### Completely Manual Installation
+
+To do a completely manual installation, download `scrlayer-fancyhdr.dtx`.
+Then extract it using:
+
+```bash
+tex scrlayer-fancyhdr.dtx
+```
+
+To create the manual use:
+
+```bash
+pdflatex scrlayer-fancyhdr.dtx
+mkindex scrlayer-fancyhdr
+biber scrlayer-fancyhdr
+pdflatex scrlayer-fancyhdr.dtx
+pdflatex scrlayer-fancyhdr.dtx
+```
+
+Now, you can either install it in the proper directory (see the
+documentation of your TeX distribution) or copy `scrlayer-fancyhdr.sty`
+to your document directory.
+
+------------------------------------------------------------------------------
Property changes on: trunk/Master/texmf-dist/doc/latex/scrlayer-fancyhdr/README.md
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/latex/scrlayer-fancyhdr/scrlayer-fancyhdr.pdf
===================================================================
(Binary files differ)
Index: trunk/Master/texmf-dist/doc/latex/scrlayer-fancyhdr/scrlayer-fancyhdr.pdf
===================================================================
--- trunk/Master/texmf-dist/doc/latex/scrlayer-fancyhdr/scrlayer-fancyhdr.pdf 2021-03-21 21:41:11 UTC (rev 58592)
+++ trunk/Master/texmf-dist/doc/latex/scrlayer-fancyhdr/scrlayer-fancyhdr.pdf 2021-03-21 21:42:35 UTC (rev 58593)
Property changes on: trunk/Master/texmf-dist/doc/latex/scrlayer-fancyhdr/scrlayer-fancyhdr.pdf
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
Added: trunk/Master/texmf-dist/source/latex/scrlayer-fancyhdr/scrlayer-fancyhdr.dtx
===================================================================
--- trunk/Master/texmf-dist/source/latex/scrlayer-fancyhdr/scrlayer-fancyhdr.dtx (rev 0)
+++ trunk/Master/texmf-dist/source/latex/scrlayer-fancyhdr/scrlayer-fancyhdr.dtx 2021-03-21 21:42:35 UTC (rev 58593)
@@ -0,0 +1,577 @@
+% \iffalse^^A meta-comment
+% ======================================================================
+% scrlayer-fancyhdr.dtx
+% Copyright (c) Markus Kohm, 2021
+%
+% This file is part of the LaTeX2e package `scrlayer-fancyhdr'.
+%
+% This work may be distributed and/or modified under the conditions of
+% the LaTeX Project Public License, version 1.3c of the license.
+% 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 and of this work.
+%
+% This work has the LPPL maintenance status "author-maintained".
+%
+% The Current Maintainer and author of this work is Markus Kohm.
+%
+% This work consists of the files `scrlayer-fancyhdr.dtx' and
+% `README.md'.
+% ----------------------------------------------------------------------
+% scrlayer-fancyhdr.dtx
+% Copyright (c) Markus Kohm, 2021
+%
+% Diese Datei ist Teil des LaTeX2e Pakets `scrlayer-fancyhdr'.
+%
+% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
+% Version 1.3c.
+% Die neuste Version dieser Lizenz ist
+% http://www.latex-project.org/lppl.txt
+% und Version 1.3c ist Teil aller Verteilungen von LaTeX
+% Version 2005/12/01 und dieses Werks.
+%
+% Dieses Werk hat den LPPL-Verwaltungs-Status "author-maintained"
+% (allein durch den Autor verwaltet).
+%
+% Der Aktuelle Verwalter und Autor dieses Werkes ist Markus Kohm.
+%
+% Dieses Werk besteht aus den Dateien `scrlayer-fancyhdr.dtx' und
+% `README.md'.
+% ======================================================================
+%
+%<identify>%%% docstrip run: identify
+%<init>%%% docstrip run: init
+%<options>%%% docstrip run: options
+%<body>%%% docstrip run: body
+%<*dtx>
+\ifx\ProvidesFile\undefined\def\ProvidesFile#1[#2]{}\fi
+\ProvidesFile{scrlayer-fancyhdr.dtx}[2021-03-17 v0.2
+ source of package scrlayer-scrpage]
+%</dtx>
+%<*package>
+%<identify>\NeedsTeXFormat{LaTeX2e}[1995/12/01]
+%<identify>\ProvidesPackage{scrlayer-fancyhdr}[2021-03-17 v0.2
+%<identify> combining fancyhdr with KOMA-Script's scrlayer]
+%</package>
+%<*dtx>
+\ifx\documentclass\undefined
+ \input docstrip.tex
+ \generate{%
+ \file{scrlayer-fancyhdr.sty}{%
+ \from{scrlayer-fancyhdr.dtx}{package,identify}%
+ \from{scrlayer-fancyhdr.dtx}{package,init}%
+ \from{scrlayer-fancyhdr.dtx}{package,options}%
+ \from{scrlayer-fancyhdr.dtx}{package,body}%
+ }%
+ }
+\else
+ \let\endbatchfile\relax
+\fi
+\endbatchfile
+\documentclass{scrdoc}
+\addtolength{\textwidth}{-1em}
+\addtolength{\marginparwidth}{2em}
+\addtolength{\oddsidemargin}{2em}
+\usepackage[english]{babel}
+\usepackage{csquotes}
+\usepackage{biblatex}
+\usepackage{listings}
+\usepackage{scrhack}
+\usepackage{xpatch}
+
+\begin{filecontents}[force]{\jobname.bib}
+ at Misc{ package:fancyhdr,
+ language= {english},
+ author = {Piet van Oostrum},
+ title = {{\Package{fancyhdr}}\,---\,Extensive control of page headers and
+ footers in {\LaTeXe}},
+ date = {2021-01-28},
+ edition = {4.0.1},
+ url = {https://www.ctan.org/pkg/fancydr},
+ urldate = {2021-02-18}
+}
+
+ at Misc{ package:koma-script,
+ language= {english},
+ author = {Markus Kohm},
+ title = {{\Package{koma-script}}\,---\,A bundle of versatile classes and
+ packages},
+ date = {2021-03-01},
+ edition = {3.33},
+ url = {https://www.ctan.org/pkg/koma-script},
+ urldate = {2021-03-01}
+}
+
+ at Misc{ package:scrlayer,
+ language= {english},
+ author = {Markus Kohm},
+ title = {{\Package{scrlayer}}\,---\,Manage text `layers' within
+ {\KOMAScript}},
+ date = {2021-03-01},
+ edition = {3.33},
+ url = {https://www.ctan.org/pkg/koma-script},
+ urldate = {2021-03-01}
+}
+\end{filecontents}
+
+\addbibresource{\jobname.bib}
+\xpretocmd\DescribeMacro{\ifhmode\else\bigskip\noindent\fi}{}{}
+\xpretocmd\DescribeEnv{\ifhmode\else\bigskip\noindent\fi}{}{}
+\xpretocmd\DescribeOption{\ifhmode\else\bigskip\noindent\fi}{}{}
+
+\CodelineIndex
+\RecordChanges
+\GetFileInfo{scrlayer-fancyhdr.dtx}
+\title{The \texttt{scrlayer} interface \texttt{scrlayer-fancyhdr}%
+ \footnote{This is version \fileversion\ of file \texttt{\filename}.}}
+\date{\filedate}
+\author{Markus Kohm}
+
+\newenvironment{Explain}{\par}{\par}
+\newcommand*{\length}{}
+\let\length\Length
+\let\endlength\endLength
+\let\Macro\cs
+\let\Length\Macro
+\let\Package\textsf
+\let\Class\Package
+\let\File\texttt
+\let\Option\texttt
+\newcommand*{\KOption}[1]{\Option{#1}\texttt{=}}
+\newcommand*{\OptionValue}[2]{\Option{#1}\texttt{=}\PValue{#2}}
+\let\Counter\texttt
+\let\Environment\texttt
+\let\ShowOutput\quote
+\let\endShowOutput\endquote
+\let\Pagestyle\texttt
+\newcommand*{\Parameter}[1]{\texttt{\marg{#1}}\linebreak[1]}
+\newcommand*{\OParameter}[1]{\texttt{\oarg{#1}}\linebreak[1]}
+\newcommand*{\MParameter}[2]{\texttt{(\meta{#1},\meta{#2})}\linebreak[1]}
+\providecommand\PParameter[1]{\mbox{\texttt{\{#1\}}}\linebreak[1]}
+\let\PName\meta
+\let\PValue\texttt
+\providecommand*{\autoref}[1]{\expandafter\AUTOREF#1:}
+\providecommand*{\AUTOREF}{}
+\makeatletter
+\def\AUTOREF#1:#2:{%
+ \edef\@tempa{#1}%
+ \edef\@tempb{tab}\ifx\@tempa\@tempb table~\fi
+ \edef\@tempb{sec}\ifx\@tempa\@tempb section~\fi
+ \ref{#1:#2}%
+}
+\makeatother
+\providecommand*{\IndexCmd}[2][]{}
+\providecommand*{\textnote}[2][]{}
+
+\lstnewenvironment{lstcode}{\lstset{language=[LaTeX]TeX}}{}
+\sloppy% YOU SHOULD NOT DO THIS!!!
+
+\begin{document}
+\maketitle
+\tableofcontents
+\DocInput{\filename}
+\printbibliography
+\PrintChanges
+\PrintIndex
+\end{document}
+% \fi^^A meta-comment
+%
+% \changes{v0.0}{2018/09/01}{start of interface}
+% \changes{v0.2}{2021/02/18}{package is no longer part of \KOMAScript}
+%
+% \changes{v0.0}{2018/09/05}{some user documentation}
+% \section{The Purpose of this Package}
+% This package has been made to give users a chance to combine the features of
+% Piet van Oostrum's \Package{fancyhdr} \autocite{package:fancyhdr} with the
+% features of \Package{scrlayer} \autocite{package:scrlayer}. In other words:
+% It has been made to combine the page layers of \Package{scrlayer} with the
+% page styles of \Package{fancyhdr}.
+%
+% In this combination compatibility with \Package{fancyhdr} is the first aim!
+% Usability and the freedom provided by \Package{scrlayer} is only the second
+% one. Compatibility with other packages or classes of \KOMAScript{}
+% \cite{package:koma-script} is not a primary aim. Perhaps it will become an
+% optional feature in future. Abolishing any real or virtual limitations of
+% \Package{fancyhdr} other than make it possible to use layers is not an aim
+% and will not be an aim in future.
+%
+% If you need a better combination of page styles and layers, you should
+% either use the low level interface of \Package{scrlayer} to define your page
+% styles or\,---\,and this is the recommendation of the author\,---\,use
+% \Package{scrlayer-scrpage} instead of \Package{scrlayer-fancyhdr} or
+% \Package{fancyhdr}. If you need more compatibility with other parts of
+% \KOMAScript, i.\,e.\@ with the \KOMAScript{} classes, you should use
+% \Package{scrlayer-scrpage} instead of \Package{scrlayer-fancyhdr} or
+% \Package{fancyhdr}.
+%
+%
+% \section{How it works}
+% To combine \Package{fancyhdr} and \Package{scrlayer},
+% \Package{scrlayer-scrpage} loads both packages. After loading
+% \Package{fancyhdr} it redefines page style \Pagestyle{@fancy} (up to
+% \Package{fancyhdr} version 3.10) resp. \Pagestyle{f at nch@fancycore} (from
+% \Package{fancyhdr} version 4) to make it a layer page style of
+% \Package{scrlayer} using the newly defined layers \texttt{fancy.head.even},
+% \texttt{fancy.head.odd}, \texttt{fancy.foot.even} and
+% \texttt{fancy.foot.odd}. The \texttt{\dots head\dots} layers are background
+% layers like the page head of \Package{fancyhdr}'s page styles (or other
+% usual page styles). The \texttt{\dots foot\dots} layers are foreground
+% layers like the page footer of \Package{fancyhdr}'s page styles (or other
+% usual page styles). The \texttt{\dots even} layers are restricted to even
+% pages, that means left side pages in two-sided documents. The \texttt{\dots
+% odd} layers are restricted to odd pages, that means right side pages in
+% two-sided documents or all pages in single-sided documents.
+%
+% \DescribeMacro\ps@@fancy
+% \DescribeMacro\ps at f@nch at fancycore
+% \DescribeMacro\ps at fancyplain
+% \DescribeMacro\ps at plain@fancy
+% Note: Page style \Pagestyle{@fancy} (up to \Package{fancyhdr} version 3.10)
+% resp. \Pagestyle{f at nch@fancycore} (from \Package{fancyhdr} version 4) is an
+% internal basic page style of package \Package{fancyhdr}. It is used for the
+% user page style \Pagestyle{fancy}. The user page style \Pagestyle{fancy} is
+% also used for \Package{fancyhdr}'s deprecated page style
+% \Pagestyle{fancyplain}, that also redefines page style \Pagestyle{plain} to
+% be \Package{fancyhdr}'s internal page style \Pagestyle{plain at fancy}, that
+% also uses \Pagestyle{fancy} but with \Macro{if at fancyplain} set to
+% \Macro{iftrue}. There is also a deprecated command
+% \Macro{fancyplain}\Parameter{plain code}\Parameter{fancy code}, that uses
+% the \meta{plain code} if \Macro{if at fancyplain} is \Macro{iftrue} and
+% \meta{fancy code} if \Macro{if at fancyplain} is \Macro{iffalse}.
+%
+% Note: Page styles defined using \Package{fancyhdr}'s command
+% \Macro{fancypagestyle} also always use page style \Pagestyle{fancy} and so
+% the internal basic page style \Pagestyle{@fancy} (up to \Package{fancyhdr}
+% version 3.10) resp. \Pagestyle{f at nch@fancycore} (from \Package{fancyhdr}
+% version 4).
+%
+% As a result of the two notes above, every page style of \Package{fancyhdr}
+% always uses the same internal basic page style \Pagestyle{@fancy} (up to
+% \Package{fancyhdr} version 3.10) resp. \Pagestyle{f at nch@fancycore} (from
+% \Package{fancyhdr} version 4). As a result of redefining page style
+% \Pagestyle{@fancy} (up to \Package{fancyhdr} version 3.10)
+% resp. \Pagestyle{f at nch@fancycore} (from \Package{fancyhdr} version 4) to be
+% a layer page style, users can add layers to or remove layers from all
+% \Package{fancyhdr} page styles by adding layers to or remove layers from
+% page style \Pagestyle{@fancy} (up to \Package{fancyhdr} version 3.10)
+% resp. \Pagestyle{f at nch@fancycore} (from \Package{fancyhdr} version 4). You
+% cannot add layers to or remove layers from \Package{fancyhdr}'s single page
+% styles \Pagestyle{fancy}, \Pagestyle{fancyplain}, \Pagestyle{plain at fancy} or
+% the page styles defined using \Macro{fancypagestyle} directly. So using
+% layers is a all or nothing feature with \Package{scrlayer-scrpage}. However,
+% you can use the second argument of \Macro{fancypagestyle} to add or remove
+% layers whenever one of the \Package{fancyhdr} page styles is activated. So
+% this is a move from the \Package{scrlayer} interface of adding or removing
+% layers to single page styles to the \Package{fancyhdr} interface of defining
+% modifications of page style \Pagestyle{fancy}.
+%
+% Another such movement from an \Package{scrlayer} user interface to a
+% \Package{fancyhdr} user interface is the decision whether or not automatic
+% running heads are used. \Package{scrlayer} provides the options
+% \Option{automark} and \Option{manualmark} and commands \Macro{automark} and
+% \Macro{manualmark} to do this decision and also to configure commands like
+% \Macro{partmark}, \Macro{chaptermark}, \Macro{sectionmark} etc. With
+% \Package{scrlayer-fancyhdr} also using page style \Pagestyle{@fancy} (up to
+% \Package{fancyhdr} version 3.10) resp. \Pagestyle{f at nch@fancycore} (from
+% \Package{fancyhdr} version 4) does switch to automatic running heads. The
+% first activation of page style \Pagestyle{fancy} still redefines
+% \Macro{chaptermark} and \Macro{sectionmark}, if a class with \Macro{chapter}
+% is used, or \Macro{sectionmark} and \Macro{subsectionmark}, if a class
+% without \Macro{chapter} is used. However, you still can use
+% \Macro{manualmark} and \Macro{automark} after switching to a
+% \Package{fancyhdr} page style to configure the running heads. So this
+% movement is only partial.
+%
+% \DescribeMacro\ps at headings
+% \DescribeMacro\ps at myheadings
+% \DescribeMacro\ps at plain
+% Note: Currently, neither \Package{scrlayer} nor \Package{fancyhdr} nor
+% \Package{scrlayer-fancyhdr} do redefine page styles \Pagestyle{headings} or
+% \Pagestyle{myheadings} by default. And neither \Package{scrlayer} nor
+% \Package{fancyhdr} nor \Package{scrlayer-fancyhdr} do redefine page style
+% \Pagestyle{plain} unless you are activating the deprecated
+% \Package{fancyhdr} page style \Pagestyle{fancyplain}. So if you like to use
+% layers on \Pagestyle{plain} pages, i.\,e. usually the first page of a
+% chapter or part or the page with a title head, you have to either use
+% \Package{fancyhdr}'s deprecated page style \Pagestyle{fancyplain} or
+% redefine page style \Pagestyle{plain} either using \Macro{fancypagestyle} as
+% documented in the \Package{fancyhdr} manual or using
+% \Macro{DeclareNewPageStyleByLayers}, documented in the \KOMAScript{} manual.
+% However from version 4.0 \Package{fancyhdr} provides options
+% \Option{myheadings} and \Option{headings} to redefine the corresponding page
+% style. \Package{scrlayer-fancyhdr} also provides these options and passes
+% them to \Package{fancyhdr}.
+%
+% \DescribeMacro\ps at empty
+% \DescribeMacro\ps@@empty
+% Note: Pagestyle \Pagestyle{empty} is somehow special. \Package{scrlayer}
+% redefines it to be a layer page style. And \Package{fancyhdr}'s internal
+% page style \Pagestyle{@empty} is the same like \Pagestyle{empty}. So
+% \Pagestyle{@empty} also uses the layers of \Pagestyle{empty} but you should
+% not try to modify it directly using the interface of
+% \Package{scrlayer}. Moreover, if \Package{fancyhdr} is loaded before
+% \Package{scrlayer-scrpage}, \Package{fancyhdr}'s internal page style
+% \Pagestyle{@empty} is not a copy of \Package{scrlayer}'s layer page style
+% \Pagestyle{empty} but the original standard page style
+% \Pagestyle{empty}. However, with \Package{scrlayer-fancyhdr} package
+% \Package{fancyhdr} does not longer use the internal page style
+% \Pagestyle{@empty}. So you would not need to know this.
+%
+% \section{How to use the Package}
+%
+% To use the package you have to load it, e.\,g., using:
+%\begin{verbatim}
+% \usepackage{scrlayer-fancyhdr}
+%\end{verbatim}
+% instead of loading \Package{scrlayer} and \Package{fancyhdr} or before or
+% after loading one of these packages. However it is recommended to replace
+% loading \Package{scrlayer} and \Package{fancyhdr} by loading
+% \Package{scrlayer-fancyhdr} because this avoids option
+% clashes. \Package{scrlayer-fancyhdr} provides all options of
+% \Package{scrlayer} and \Package{fancyhdr} and passes them to
+% \Package{scrlayer} resp. \Package{fancyhdr}. Nevertheless
+% sometimes it may be useful to be able to additionally load
+% \Package{scrlayer} or \Package{fancyhdr}.
+%
+% \DescribeMacro\ps@@fancy
+% \DescribeMacro\ps at f@nch at fancycore
+% \DescribeMacro\ps at fancy
+% \DescribeMacro\ps at fancyplain
+% \DescribeMacro\ps at plain@fancy
+% \DescribeMacro\fancypagestyle
+% After this you should be able to use the page styles and commands of
+% \Package{fancyhdr} and to add layers to or remove layers from the
+% \Package{fancyhdr}'s internal basic page style \Package{@fancy} (up to
+% \Package{fancyhdr} version 3.10) resp. \Pagestyle{f at nch@fancycore} (from
+% \Package{fancyhdr} version 4). Note, you are not able to add layers to or
+% remove layers from \Package{fancyhdr}'s page styles \Pagestyle{fancy},
+% \Pagestyle{fancyplain}, \Pagestyle{plain at fancy} or page styles defined by
+% \Macro{fancypagestyle}. However adding layers to or removing layers from
+% \Pagestyle{@fancy} (up to \Package{fancyhdr} version 3.10)
+% resp. \Pagestyle{f at nch@fancycore} (from \Package{fancyhdr} version 4) will
+% always change all these page styles!
+%
+% \DescribeMacro\ps at plain
+% \DescribeMacro\ps at headings
+% \DescribeMacro\ps at myheadings
+% \DescribeMacro\ps at empty
+% Note: Loading \Package{scrlayer-fancyhdr} will not make page style
+% \Pagestyle{plain} nor \Pagestyle{headings} nor \Pagestyle{myheadings} or any
+% other page style but \Pagestyle{empty} to automatically be a layer page
+% style! But if you are using option \Option{headings} or \Option{myheadings}
+% package \Package{fancyhdr} redefines the corresponding page styles to be
+% \Package{fancyhdr} page styles\,---\,and so become layer page styles.
+%
+% \section{Known Issues}
+%
+% Please note, the follow issues are either notes to the package author or
+% notes to the user to avoid them reporting the same issues again and
+% again. Listing these issues does not say they are bugs or features.
+%
+% \begin{itemize}
+% \item
+% \DescribeMacro\ps at fancy
+% \DescribeMacro\ps at f@nch at fancycore
+% \DescribeMacro\ps at fancyplain
+% \DescribeMacro\fancypagestyle
+% \DescribeMacro\ps@@fancy
+% You are not able to add layers to the user level page style
+% \Pagestyle{fancy} or \Pagestyle{fancyplain} or any page style defined by
+% \Macro{fancypagestyle} but only to the internal page style
+% \Pagestyle{@fancy} (if you are using \Package{fancyhdr} up to version
+% 3.10) resp. \Pagestyle{f at nch@fancycore} (if you are using
+% \Package{fancyhdr} from version 4). This is intended as explained in this
+% manual.
+% \item
+% \DescribeMacro\ps@@empty
+% Using \Package{fancyhdr}'s internal page style \Pagestyle{@empty}
+% could have strange results. However, there is a simple solution for this:
+% Don't use the internal \Pagestyle{@empty} but always the user level page
+% style \Pagestyle{empty}!
+% \item
+% \DescribeMacro\ps@@fancy
+% \DescribeMacro\ps at f@nch at fancycore
+% The vertical position of the page header does differ a little bit, if
+% \Package{scrlayer-fancyhdr} is used instead of \Package{fancyhdr}. This
+% could be fixed by a modification of the layers \texttt{fancy.head.odd} and
+% \texttt{fancy.head.even} using \Option{addvoffset}. More tests are needed.
+% \end{itemize}
+%
+%\iffalse
+%</dtx>
+%\fi
+%
+% \StopEventually{}
+%
+% \section{Implementation of \Package{scrlayer-fancyhdr}}
+% \label{sec:scrlayer-fancyhdr}
+%
+% \iffalse
+%<*package>
+% \fi
+%
+% This section if for developers only.
+%
+% We need \Package{scrlayer} at least version 2021/02/15,
+% \begin{macrocode}
+%<*init>
+\RequirePackage{scrlayer}[2021/02/15]
+%</init>
+% \end{macrocode}
+% Because before \cs{scrlayer at do@inherited at options} would not be defined. And
+% we need it, to inherit all options of \Package{scrlayer}.
+% \begin{macrocode}
+%<*options>
+\scrlayer at do@inherited at options{\scrlayer at inherit@option}
+%</options>
+% \end{macrocode}
+%
+% And the very first thing at the body, after definition of the options is to
+% process the options.
+% \begin{macrocode}
+%<*body>
+\KOMAProcessOptions
+%</body>
+% \end{macrocode}
+%
+% Note: The main problem of this interface is, that it tries to implement the
+% user interface of package \Package{fancyhdr} by Piet van Oostrum, that is
+% completely different from \Package{scrlayer} and not really compatible with
+% \Package{scrlayer}, using \Package{scrlayer}. This means, that
+% \Package{scrlayer-fancyhdr} never can be a drop-in replacement of
+% \Package{fancyhdr}. Nevertheless it can help to let \Package{scrlayer} and
+% \Package{fancyhdr} coexist. To do so
+% \begin{itemize}
+% \item the lowest level of \Package{fancyhdr} should not be the page style
+% but a layer
+% \item the page styles of \Package{fancyhdr} should be layer page styles
+% \item init code of the page styles of \Package{fancyhdr} should use the
+% layer page init code
+% \end{itemize}
+% Currently it is unsure whether it would be best to do a new implementation
+% or to load original \Package{fancyhdr} and to only modify some things. First
+% I'll try the second method. Currently we explicitly provide the options of
+% \Package{fancyhdr}.
+% \begin{macrocode}
+%<*options>
+\DeclareOption{nocheck}{\PassOptionsToPackage{nocheck}{fancyhdr}}
+\DeclareOption{compatV3}{\PassOptionsToPackage{compatV3}{fancyhdr}}
+\DeclareOption{myheadings}{\PassOptionsToPackage{myheadings}{fancyhdr}}
+\DeclareOption{headings}{\PassOptionsToPackage{headings}{fancyhdr}}
+%</options>
+% \end{macrocode}
+% \begin{macrocode}
+%<*body>
+\RequirePackage{fancyhdr}
+%</body>
+% \end{macrocode}
+%
+% We need at least one new layer for the new layer page style
+% \Pagestyle{fancy}. However, it could be useful to have not only one but
+% four layers (even side head, odd side head, even side foot, odd side foot).
+% \begin{macrocode}
+%<*body>
+\DeclareNewLayer[%
+ background,oddpage,
+ head,
+ contents={\hb at xt@ \layerwidth{%
+ \f at nch@head\f at nch@Oolh\f at nch@olh\f at nch@och\f at nch@orh\f at nch@Oorh}}
+]{fancy.head.odd}
+\DeclareNewLayer[%
+ background,evenpage,
+ head,
+ contents={\hb at xt@ \layerwidth{%
+ \f at nch@head\f at nch@Oelh\f at nch@elh\f at nch@ech\f at nch@erh\f at nch@Oerh}}
+]{fancy.head.even}
+\DeclareNewLayer[%
+ foreground,oddpage,
+ foot,
+ contents={\hb at xt@ \layerwidth{%
+ \f at nch@foot\f at nch@Oolf\f at nch@olf\f at nch@ocf\f at nch@orf\f at nch@Oorf}}
+]{fancy.foot.odd}
+\DeclareNewLayer[%
+ foreground,evenpage,
+ foot,
+ contents={\hb at xt@ \layerwidth{%
+ \f at nch@foot\f at nch@Oelf\f at nch@elf\f at nch@ecf\f at nch@erf\f at nch@Oerf}}
+]{fancy.foot.even}
+% \end{macrocode}
+% \begin{macro}{\ps at f@nch at fancycore}
+% \changes{0.1.3558}{2021/02/15}{support for \Package{fancyhdr} 4}
+% \begin{macro}{\ps@@fancy}
+% \begin{macro}{\@mkboth}
+% And have to create a layer page style from this new layers, but we do not
+% redefine page style \Pagestyle{fancy} but the low level page style
+% \Pagestyle{@fancy} (up to \Package{fancyhdr} version 3.10)
+% resp. \Pagestyle{f at nch@fancycore} (from \Package{fancyhdr} version 4.0).
+%
+% \Package{fancyhdr} does some initialization at the very first call
+% of \cs{pagestyle{fancy}}. To do so \Package{fancyhdr} first uses a different
+% page style definition, that does the initialization and redefines the page
+% style afterwards. This is still active with \Package{scrlayer-fancyhdr}.
+% Additionally, \Package{fancyhdr} redefines \cs{@mkboth} at every selection
+% of the internal page style \Pagestyle{@fancy}
+% resp. \Pagestyle{f at nch@fancycore}. This can be adapted using the
+% \Option{onselect} feature of the new layer page style \Pagestyle{@fancy}
+% resp. \Pagestyle{f at nch@fancycore}. In my opinion, the
+% |\let\@mkboth\markboth| used by page style \Pagestyle{headings} of, e.\,g.,
+% the standard classes or the \KOMAScript{} classes would be best
+% here. However, \Package{fancyhdr} uses the uncommon
+% |\def\@mkboth{\protect\markboth}|, which would fail if a class or package
+% tests \cs{@mkboth} using |\ifx\@mkboth\markboth|. However, \KOMAScript's
+% \cs{IfActiveMkBoth} (see the \Package{scrbase} chapter in the \KOMAScript{}
+% manual) does also recognize the \Package{fancyhdr} definition and copying
+% this is more compatible with \Package{fancyhdr}.
+% \begin{macrocode}
+\@ifpackagelater{fancyhdr}{2019/03/21}{%
+ \DeclarePageStyleByLayers[
+ onselect={\def\@mkboth{\protect\markboth}},
+ ]{f at nch@fancycore}{%
+ fancy.head.odd,fancy.head.even,fancy.foot.odd,fancy.foot.even
+ }%
+}{%
+ \DeclarePageStyleByLayers[
+ onselect={\def\@mkboth{\protect\markboth}},
+ ]{@fancy}{%
+ fancy.head.odd,fancy.head.even,fancy.foot.odd,fancy.foot.even
+ }%
+}
+%</body>
+% \end{macrocode}
+% Note: Redefining page style \Pagestyle{@fancy}
+% resp. \Pagestyle{f at nch@fancycore} instead of \Pagestyle{fancy}
+% does also mean, that features like options \Option{automark} and
+% \Option{manualmark} resp. \cs{automark} and \cs{manualmark} are not fully
+% supported by \Package{scrlayer-fancyhdr}. Also currently the font features
+% of the \KOMAScript{} classes are not supported by
+% \Package{scrlayer-fancyhdr}. However you are now able to combine other
+% features of \Package{scrlayer} with features of \Package{fancyhdr} and you
+% can, e.g., use \Package{scrlayer-notecolumn} with
+% \Package{scrlayer-fancyhdr}.
+% \end{macro}%^^A \@mkboth
+% \end{macro}%^^A \ps@@fancy
+% \end{macro}%^^A \ps at f@nch at fancycore
+%
+% A future release of \Package{scrlayer-fancyhdr} may even provide the font
+% features of the \KOMAScript{} classes and a working
+% \Option{markcase}. However, in this case I would have to redefine the
+% initial page style \Pagestyle{fancy} and the layers above.
+%
+% \iffalse
+%</package>
+% \fi
+%
+% \Finale
+%
+\endinput
+%
+% End of file `scrlayer-fancyhdr.dtx'.
+%
+
+%%% Local Variables:
+%%% mode: doctex
+%%% mode: flyspell
+%%% ispell-local-dictionary: "en_GB"
+%%% TeX-master: t
+%%% End:
Property changes on: trunk/Master/texmf-dist/source/latex/scrlayer-fancyhdr/scrlayer-fancyhdr.dtx
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/Master/texmf-dist/tex/latex/scrlayer-fancyhdr/scrlayer-fancyhdr.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/scrlayer-fancyhdr/scrlayer-fancyhdr.sty (rev 0)
+++ trunk/Master/texmf-dist/tex/latex/scrlayer-fancyhdr/scrlayer-fancyhdr.sty 2021-03-21 21:42:35 UTC (rev 58593)
@@ -0,0 +1,80 @@
+%%
+%% This is file `scrlayer-fancyhdr.sty',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% scrlayer-fancyhdr.dtx (with options: `package,identify')
+%% scrlayer-fancyhdr.dtx (with options: `package,init')
+%% scrlayer-fancyhdr.dtx (with options: `package,options')
+%% scrlayer-fancyhdr.dtx (with options: `package,body')
+%%
+%% IMPORTANT NOTICE:
+%%
+%% For the copyright see the source file.
+%%
+%% Any modified versions of this file must be renamed
+%% with new filenames distinct from scrlayer-fancyhdr.sty.
+%%
+%% For distribution of the original source see the terms
+%% for copying and modification in the file scrlayer-fancyhdr.dtx scrlayer-fancyhdr.dtx scrlayer-fancyhdr.dtx scrlayer-fancyhdr.dtx.
+%%
+%% This generated file may be distributed as long as the
+%% original source files, as listed above, are part of the
+%% same distribution. (The sources need not necessarily be
+%% in the same archive or directory.)
+%%% docstrip run: identify
+\NeedsTeXFormat{LaTeX2e}[1995/12/01]
+\ProvidesPackage{scrlayer-fancyhdr}[2021-03-17 v0.2
+ combining fancyhdr with KOMA-Script's scrlayer]
+%%% docstrip run: init
+\RequirePackage{scrlayer}[2021/02/15]
+%%% docstrip run: options
+\scrlayer at do@inherited at options{\scrlayer at inherit@option}
+\DeclareOption{nocheck}{\PassOptionsToPackage{nocheck}{fancyhdr}}
+\DeclareOption{compatV3}{\PassOptionsToPackage{compatV3}{fancyhdr}}
+\DeclareOption{myheadings}{\PassOptionsToPackage{myheadings}{fancyhdr}}
+\DeclareOption{headings}{\PassOptionsToPackage{headings}{fancyhdr}}
+%%% docstrip run: body
+\KOMAProcessOptions
+\RequirePackage{fancyhdr}
+\DeclareNewLayer[%
+ background,oddpage,
+ head,
+ contents={\hb at xt@ \layerwidth{%
+ \f at nch@head\f at nch@Oolh\f at nch@olh\f at nch@och\f at nch@orh\f at nch@Oorh}}
+]{fancy.head.odd}
+\DeclareNewLayer[%
+ background,evenpage,
+ head,
+ contents={\hb at xt@ \layerwidth{%
+ \f at nch@head\f at nch@Oelh\f at nch@elh\f at nch@ech\f at nch@erh\f at nch@Oerh}}
+]{fancy.head.even}
+\DeclareNewLayer[%
+ foreground,oddpage,
+ foot,
+ contents={\hb at xt@ \layerwidth{%
+ \f at nch@foot\f at nch@Oolf\f at nch@olf\f at nch@ocf\f at nch@orf\f at nch@Oorf}}
+]{fancy.foot.odd}
+\DeclareNewLayer[%
+ foreground,evenpage,
+ foot,
+ contents={\hb at xt@ \layerwidth{%
+ \f at nch@foot\f at nch@Oelf\f at nch@elf\f at nch@ecf\f at nch@erf\f at nch@Oerf}}
+]{fancy.foot.even}
+\@ifpackagelater{fancyhdr}{2019/03/21}{%
+ \DeclarePageStyleByLayers[
+ onselect={\def\@mkboth{\protect\markboth}},
+ ]{f at nch@fancycore}{%
+ fancy.head.odd,fancy.head.even,fancy.foot.odd,fancy.foot.even
+ }%
+}{%
+ \DeclarePageStyleByLayers[
+ onselect={\def\@mkboth{\protect\markboth}},
+ ]{@fancy}{%
+ fancy.head.odd,fancy.head.even,fancy.foot.odd,fancy.foot.even
+ }%
+}
+\endinput
+%%
+%% End of file `scrlayer-fancyhdr.sty'.
Property changes on: trunk/Master/texmf-dist/tex/latex/scrlayer-fancyhdr/scrlayer-fancyhdr.sty
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/Master/tlpkg/bin/tlpkg-ctan-check
===================================================================
--- trunk/Master/tlpkg/bin/tlpkg-ctan-check 2021-03-21 21:41:11 UTC (rev 58592)
+++ trunk/Master/tlpkg/bin/tlpkg-ctan-check 2021-03-21 21:42:35 UTC (rev 58593)
@@ -677,7 +677,7 @@
schule schulschriften schwalbe-chess
sciposter scientific-thesis-cover scontents
scratch scratch3 scratchx screenplay screenplay-pkg
- scrjrnl scrlttr2copy scsnowman
+ scrjrnl scrlayer-fancyhdr scrlttr2copy scsnowman
sdaps sdrt sduthesis
secdot secnum section sectionbox sectionbreak sectsty seealso
selectp selinput selnolig semantex semantic semantic-markup semaphor
Modified: trunk/Master/tlpkg/libexec/ctan2tds
===================================================================
--- trunk/Master/tlpkg/libexec/ctan2tds 2021-03-21 21:41:11 UTC (rev 58592)
+++ trunk/Master/tlpkg/libexec/ctan2tds 2021-03-21 21:42:35 UTC (rev 58593)
@@ -2974,6 +2974,7 @@
'schedule' => 'latex', # requires interaction
'schemata' => 'tex',
'scontents' => 'etex',
+ 'scrlayer-fancyhdr' => 'etex',
'secnum' => 'tex',
'silence' => 'latex -translate-file=empty.tcx', # no 8-bit
'skdoc' => 'tex',
Modified: trunk/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc
===================================================================
--- trunk/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc 2021-03-21 21:41:11 UTC (rev 58592)
+++ trunk/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc 2021-03-21 21:42:35 UTC (rev 58593)
@@ -1063,6 +1063,7 @@
depend schedule
depend schooldocs
depend scontents
+depend scrlayer-fancyhdr
depend scrlttr2copy
depend sdaps
depend sdrt
Added: trunk/Master/tlpkg/tlpsrc/scrlayer-fancyhdr.tlpsrc
===================================================================
More information about the tex-live-commits
mailing list.