summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/hackthefootline
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-01-30 21:04:41 +0000
committerKarl Berry <karl@freefriends.org>2018-01-30 21:04:41 +0000
commit1b674ef86fe17b1011f19a929dfd82253eb90995 (patch)
tree6772c47029840206eb69323587b58e309bf5d161 /Master/texmf-dist/doc/latex/hackthefootline
parent26b507ff1e2b1d8acaaf4bb212f149f39c436821 (diff)
hackthefootline (30jan18)
git-svn-id: svn://tug.org/texlive/trunk@46494 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/hackthefootline')
-rw-r--r--Master/texmf-dist/doc/latex/hackthefootline/README.md8
-rw-r--r--Master/texmf-dist/doc/latex/hackthefootline/doc/hackthefootline-doc.pdfbin165479 -> 179011 bytes
-rw-r--r--Master/texmf-dist/doc/latex/hackthefootline/doc/hackthefootline-doc.tex58
-rw-r--r--Master/texmf-dist/doc/latex/hackthefootline/doc/hackthefootline-examples.pdfbin86505 -> 86495 bytes
-rw-r--r--Master/texmf-dist/doc/latex/hackthefootline/doc/hackthefootline-examples.tex6
5 files changed, 38 insertions, 34 deletions
diff --git a/Master/texmf-dist/doc/latex/hackthefootline/README.md b/Master/texmf-dist/doc/latex/hackthefootline/README.md
index 5ca0a825fcc..f8de445941f 100644
--- a/Master/texmf-dist/doc/latex/hackthefootline/README.md
+++ b/Master/texmf-dist/doc/latex/hackthefootline/README.md
@@ -1,17 +1,17 @@
# hackthefootline
-## Arbitrary footline selection for LaTeX beamer's standard themes.
+## Arbitrary footline selection and configuration for LaTeX beamer's standard themes.
Some `beamer` themes provide footlines -- and some do not.
Now, if one wants to have a footline, he is restricted to the (outer) themes providing them or loads multiple themes. On top of that, these provided footlines are only configurable by redefining them as a whole, which is quite uncomfortable and yields many lines of additional code.
-`hackthefootline` is a package taking over, defining and redefining different footlines, so they can be configured using key-value syntax. Also, it is possible (but *not* recommended) to switch between different footline types during a presentation.
+`hackthefootline` is a package taking over, defining and redefining different footlines, so they can be configured using key-value syntax. Also, it is possible (but *not* recommended as it might distract your audience) to switch between different footline types during a presentation.
### Dependencies
-`hackthefootline` depends on the `pgfkeys` package and -- obviously -- on the `beamer` class.
+`hackthefootline` depends on the packages `ifthen` and `pgfkeys` and -- obviously -- on the `beamer` class.
-Additional sophisticated features included also require `appendixnumberbeamer`, `etoolbox`, `calc` and `numprint`, but these four dependencies can be resolved by passing some options to the `hackthefootline` package.
+Additional sophisticated features included also require `appendixnumberbeamer` (only when using beamer v3.48 and older), `etoolbox`, `calc` and `numprint`, but these four dependencies can be resolved by passing some options to the `hackthefootline` package.
### License
This work is licensed under the LPPL 1.3c or any later version.
diff --git a/Master/texmf-dist/doc/latex/hackthefootline/doc/hackthefootline-doc.pdf b/Master/texmf-dist/doc/latex/hackthefootline/doc/hackthefootline-doc.pdf
index 6fe185b639a..3c4fd7485ed 100644
--- a/Master/texmf-dist/doc/latex/hackthefootline/doc/hackthefootline-doc.pdf
+++ b/Master/texmf-dist/doc/latex/hackthefootline/doc/hackthefootline-doc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/hackthefootline/doc/hackthefootline-doc.tex b/Master/texmf-dist/doc/latex/hackthefootline/doc/hackthefootline-doc.tex
index 14f5ed168f5..437d5308f13 100644
--- a/Master/texmf-dist/doc/latex/hackthefootline/doc/hackthefootline-doc.tex
+++ b/Master/texmf-dist/doc/latex/hackthefootline/doc/hackthefootline-doc.tex
@@ -1,5 +1,5 @@
-%% This is file 'hackthefootline-doc.tex', Version 2018-01-16
-%% Copyright 2017 Sebastian Friedl <sfr682k@t-online.de>
+%% This is file 'hackthefootline-doc.tex', Version 2018-01-29
+%% Copyright 2017-18 Sebastian Friedl <sfr682k@t-online.de>
%%
%% 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.
@@ -16,7 +16,7 @@
%% -------------------------------------------------------------------------------------------
%%
%% The hackthefootline package is a tool providing arbitrary footline selection and
-%% configuration for LaTeX beamer's standard themes (other themes may also work, of course)
+%% configuration for LaTeX beamer's standard themes (it may work with other themes as well)
%%
%% -------------------------------------------------------------------------------------------
%%
@@ -77,7 +77,7 @@
\title{The \texttt{\bfseries hackthefootline} package \\ {\large\url{https://github.com/SFr682k/hackthefootline}}}
\author{Sebastian Friedl \\ \href{mailto:sfr682k@t-online.de}{\ttfamily sfr682k@t-online.de}}
-\date{2018/01/16}
+\date{2018/01/29}
\hypersetup{pdftitle={The hackthefootline package},pdfauthor={Sebastian Friedl}}
@@ -97,9 +97,12 @@
\medskip
\begin{abstract}
- \noindent%
- \textbf{Arbitrary footline selection and configuration for \LaTeX\ \texttt{beamer}'s standard themes.}
+ \parindent0pt\noindent%
+ \textbf{Arbitrary footline selection and configuration for \LaTeX\ \texttt{beamer}'s standard themes.} \\
"hackthefootline" is a package taking over, defining and redefining different footlines, so they can be configured using key-value syntax.
+
+ \medskip
+ The basic layout of the two- and three-column footline is based on the original \LaTeX\ beamer split and infolines outer themes written by Till Tantau.
\end{abstract}
@@ -116,6 +119,10 @@
Since "hackthefootline" is designed to modify "beamer"'s footlines, it is incompatible to any other document class. Therefore, load this package only in "beamer" documents!
\medskip
+ \DescribeMacro{ifthen}
+ This package is required to compare the length of some boxes.
+
+ \medskip
\DescribeMacro{pgfkeys}
"hackthefootline" heavily depends on the "pgfkeys" package for handling the whole key-value stuff.
@@ -124,7 +131,8 @@
\medskip
\DescribeMacro{appendixnumber-}\DescribeMacro{beamer}
- The "appendixnumberbeamer" package implements a simple solution for appendix frames not being calculated into the total number of frames
+ \textit{\bfseries Only required when using \texttt{beamer} version 3.48 and older.}
+ This package is only required when using "beamer" version 3.48 or older. If you are using "beamer" version 3.49 or later\footnote{i. e. \TeX{}Live 2018 and later}, "hackthefootline" will rely on "beamer"'s internal appendix frame numbering mechanisms.
\medskip
\DescribeMacro{etoolbox}
@@ -142,9 +150,18 @@
However, the four latter dependencies can be removed by using some package options. See section \ref{behavioropts} for further details.
+ \subsection*{Notice: Behavior inside the presentation's appendix}
+ \addcontentsline{toc}{subsection}{Notice: Behavior inside the presentation's appendix}
+ By default, appendix frames are \emph{not} counted into the total number of frames when using "hackthefootline". Appendix frame numbers will be counted from 1 when using fraction frame numbers. \\
+ Also, frame numbers won't be displayed on footlines inside the appendix until this is changed using the means of the "\htfconfig" command.
+
+ \medskip
+ This behavior can be suppressed by passing the "countappendixframes" option.
+
+
\subsection*{License}
\addcontentsline{toc}{subsection}{License}
- \textcopyright\ 2017 Sebastian Friedl
+ \textcopyright\ 2017-18 Sebastian Friedl
\smallskip
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.
@@ -162,22 +179,8 @@
\end{itemize}
- \subsection*{Acknowledgement}
- \addcontentsline{toc}{subsection}{Acknowledgement}
- The basic layout of the two-- and three--column footline is based on the original \LaTeX\ beamer split and infolines outer themes written by Till Tantau.
-
-
- \subsection*{Notice: Behavior inside the presentation's appendix}
- \addcontentsline{toc}{subsection}{Notice: Behavior inside the presentation's appendix}
- By default, this package \emph{does not count appendix frames} into the total number of frames and resets the counter for frame numbers to 1 as soon as the "\appendix" command is used. Also, frame numbers won't be displayed on footlines inside the appendix.
-
- \medskip
- This behavior can be suppressed by passing the \texttt{countappendixframes} option.
-
-
\clearpage
-
@@ -263,9 +266,11 @@
\item[none]
Remove the footline completely
\end{description}
- This key is provided although it is \emph{not} recommended to change its value within a document.
- When initializing "hackthefootline" using a column option and switching to the "none" style, there will be a whitespace \enquote{reserved} for the footline left. \\
- The other way round, when initializing "hackthefootline" without a column option and switching to a footline, the footline will be cut off at half of its height.
+
+ Although the "cols" key's value changes, the other keys' values stay the same. \textbf{If you change the number of columns of a footline, the other keys should be adjusted as well.}
+
+ \medskip
+ \emph{Warning:} Changing this key's value too often might distract your audience.
}
\DescribeOption{title}{short, long, none}{%
@@ -337,7 +342,7 @@
- \section{Default configurations} \label{defaultconfig}% TODO: Real pictures
+ \section{Default configurations} \label{defaultconfig}
Depending on the selected number of columns, the default configuration of the footlines is as follows:
\subsection*{One--column footline}
@@ -360,7 +365,6 @@
- % TODO: rewrite, more examples from "real" beamer documents
\section{Examples}
\subsection{Setting up \texttt{hackthefootline}}\label{examples-setup}
\paragraph{Example 1:}
diff --git a/Master/texmf-dist/doc/latex/hackthefootline/doc/hackthefootline-examples.pdf b/Master/texmf-dist/doc/latex/hackthefootline/doc/hackthefootline-examples.pdf
index 178db6caf8f..c81238f80f9 100644
--- a/Master/texmf-dist/doc/latex/hackthefootline/doc/hackthefootline-examples.pdf
+++ b/Master/texmf-dist/doc/latex/hackthefootline/doc/hackthefootline-examples.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/hackthefootline/doc/hackthefootline-examples.tex b/Master/texmf-dist/doc/latex/hackthefootline/doc/hackthefootline-examples.tex
index 6536301c1bb..1c42246ad41 100644
--- a/Master/texmf-dist/doc/latex/hackthefootline/doc/hackthefootline-examples.tex
+++ b/Master/texmf-dist/doc/latex/hackthefootline/doc/hackthefootline-examples.tex
@@ -1,5 +1,5 @@
-%% This is file 'hackthefootline-examples.tex', Version 2018-01-16
-%% Copyright 2017 Sebastian Friedl <sfr682k@t-online.de>
+%% This is file 'hackthefootline-examples.tex', Version 2018-01-29
+%% Copyright 2017-18 Sebastian Friedl <sfr682k@t-online.de>
%%
%% 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.
@@ -16,7 +16,7 @@
%% -------------------------------------------------------------------------------------------
%%
%% The hackthefootline package is a tool providing arbitrary footline selection and
-%% configuration for LaTeX beamer's standard themes (other themes may also work, of course)
+%% configuration for LaTeX beamer's standard themes (it may work with other themes as well)
%%
%% -------------------------------------------------------------------------------------------
%%