summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/colourchange
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-03-16 22:20:09 +0000
committerKarl Berry <karl@freefriends.org>2011-03-16 22:20:09 +0000
commitd2871f05b887f37df342f185c4162dac3abde4b3 (patch)
tree8f63d5fe804e0ee0f66a7f67bb93d5692cf3ccfd /Master/texmf-dist/doc/latex/colourchange
parent87bfbbe2f2976a2f84c0ba07e94a8cc3664d70b8 (diff)
new latex package colourchange (14mar11)
git-svn-id: svn://tug.org/texlive/trunk@21741 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/colourchange')
-rw-r--r--Master/texmf-dist/doc/latex/colourchange/README76
-rw-r--r--Master/texmf-dist/doc/latex/colourchange/colourchangedoc.pdfbin0 -> 233311 bytes
-rw-r--r--Master/texmf-dist/doc/latex/colourchange/colourchangedoc.tex93
3 files changed, 169 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/colourchange/README b/Master/texmf-dist/doc/latex/colourchange/README
new file mode 100644
index 00000000000..3138fbff337
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/colourchange/README
@@ -0,0 +1,76 @@
+This is the README for colourchange.sty.
+
+Changes colour of beamer structural elements (e.g. the bars of outerthemes).
+This is done either manually or automatically.
+
+Don't use a colour theme or full theme (which sometimes call colour themes).
+You should be OK calling inner themes and outer themes separately (although some look better than others at the moment: see bottom of readme).
+You need to compile twice for it to work.
+
+Requires packages etoolbox and calc.
+Also needs some other stuff that is loaded by beamer.
+Use with other classes at your own risk.
+
+%------------------------------
+% Summary of commands
+%------------------------------
+
+\selectcolourchanges{first}{second} takes two arguments: the starting colour and the final colour of the presentation.
+These should be colours already understood by beamer.
+Beamer uses xcolor, so you can define colours with xcolor commands and then use them in \selectcolourchanges.
+That's what I do for the defaults.
+
+\selectmanualcolour{colour}
+Changes the structure colour.
+Use between frames.
+Can't guarantee this won't do weird stuff if you also have slidechange or framechange on.
+
+Both commands also come with an american spelling version.
+\selectcolorchanges and \selectmanualcolor are defined to be the same as the above two commands.
+%------------------------------
+% Summary of options
+%------------------------------
+
+defaultstyle
+Turns on default inner and outerthemes.
+Or rather, it will do soon.
+That is, it turns on my favourite version of the theme, not the "beamer default" ones.
+This is just a shortcut for:
+\useoutertheme[footline=authorinstitutetitle]{miniframes}
+\useinnertheme{rectangles}
+Simple.
+
+draft
+The draft option turns off colour changing.
+Good for speeding up compilation when drafting.
+
+slidechange
+Colour changes every slide.
+
+framechange
+Colour changes every frame.
+
+%------------------------------
+% To do list
+%------------------------------
+
+Make sure it works with all base inner/outer themes.
+ - smoothbars, smoothtree do some shading-fu that breaks colourchange.sty's basic approach.
+Check it doesn't hopelessly break article or handout modes
+Make a .dtx
+
+%------------------------------
+% Other stuff
+%------------------------------
+
+Currently licensed under GPL v3. http://www.gnu.org/licenses/gpl-3.0.html
+
+Original author and current maintainer: Seamus Bradley
+tex@seamusbradley.net
+
+Many thanks to the tex.stackexchange.com community for their help.
+In particular, TH's answer to this question:
+http://tex.stackexchange.com/q/7126/215
+
+And Herbert's answer to this question:
+http://tex.stackexchange.com/q/7427/215
diff --git a/Master/texmf-dist/doc/latex/colourchange/colourchangedoc.pdf b/Master/texmf-dist/doc/latex/colourchange/colourchangedoc.pdf
new file mode 100644
index 00000000000..af01cfa3e73
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/colourchange/colourchangedoc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/colourchange/colourchangedoc.tex b/Master/texmf-dist/doc/latex/colourchange/colourchangedoc.tex
new file mode 100644
index 00000000000..4a01434bedb
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/colourchange/colourchangedoc.tex
@@ -0,0 +1,93 @@
+\documentclass{scrartcl}
+ %Warning: I use a modified vc script so this will not compile unless you remove the \GITTag from the footer or download the modified version from my website.
+\immediate\write18{./vc}
+\input{vc}
+\usepackage[T1]{fontenc}
+\usepackage{scrpage2}
+\pagestyle{scrheadings}
+\setkomafont{pagefoot}{\small\normalfont\sffamily}
+\ifoot[\GITTag\ \VCDateISO]{\GITTag\ \VCDateISO}
+\ofoot[\GITAbrHash]{\GITAbrHash}
+\usepackage{microtype}
+\usepackage{url}
+\usepackage{libertine}
+\usepackage{inconsolata}
+\author{Seamus Bradley}
+\title{The colourchange package}
+\usepackage{listings}
+\lstloadlanguages{[LaTeX]TeX} % I need to tell listings how I want code typeset. Here come some options:
+\lstset{%
+ basicstyle=\ttfamily\small,
+ commentstyle=\itshape\ttfamily\small,
+ showspaces=false,
+ showstringspaces=false,
+ breaklines=true,
+ breakautoindent=true,
+ captionpos=t,
+ frame=single,
+ escapeinside={(*}{*)},
+}
+\begin{document}
+\maketitle
+
+\vspace{-2\normalbaselineskip}
+\begin{center}
+ \small \url{tex@seamusbradley.net}\\
+ \url{http://www.seamusbradley.net/tex.php}
+\end{center}
+
+\section{Introduction}
+
+The \lstinline+colourchange+ package provides options for changing the colour of beamer's structural elements.
+There are two ways to do this: manual and automatic.
+
+\section{Manual}
+
+The command \lstinline+\selectmanualcolour+ sets the colour to its argument.
+It accepts any named colour understood by \lstinline+xcolor+.
+
+\section{Automatic}
+
+There are two options that automatically change the colour: \lstinline+slidechange+ and \lstinline+framechange+.
+Pass one of these to the package as an option and the colour of the structure will slowly change from one colour to another.
+To set what colours the transition should be between, use: \lstinline+\selectcolourchange{first}{second}+ which makes the colour transition from
+ \lstinline+first+ to \lstinline+second+ over the course of the presentation.
+
+You will need to compile twice to see the effect since \lstinline+colourchange+ needs to know how many slides there are so it knows how far
+ through the presentation it is at a given point.
+
+\section{Usage}
+I have been testing this by calling it as a standard package, I'm not sure how \lstinline+\usecolortheme+ deals with package options.
+So if you want to use the manual colour changing option, all you need is: \lstinline+\usepackage{colourchange}+.
+If you want one of the automatic colourchange options call \lstinline+\usepackage[slidechange]{colourchange}+ or
+ \lstinline+\usepackage[framechange]{colourchange}+.
+
+You can pass the option \lstinline+defaultstyle+ to the package, this sets up the structural elements (the inner and outer theme) so that they use the colours.
+Otherwise, you can use Beamer's own \lstinline+\useinnnertheme+ and \lstinline+\useoutertheme+ to use the themes Beamer defines.
+Call inner and outer themes separately.
+Some ``all inclusive'' themes call a colour theme themselves and this can lead to only some elements changing colour.
+
+Use the \lstinline+draft+ option to turn off the colour transitions.
+
+\section{Known problems}
+
+The \lstinline+smoothbars+ and \lstinline+smoothtrees+ outer themes do some funky stuff with shading and colours, so they aren't currently supported.
+All other outer and inner themes looked alright.
+Testing was, however, pretty basic: not all combinations were tested.
+
+\section{How it works}
+
+It's a pretty simple package really.
+Just like (some) basic beamer colour themes it defines all the components of the inner and outer themes
+ in terms of one ``master colour'' called \lstinline+structure+.
+Then all it does is use various ways of changing this colour.
+The manual option just gives you a way of changing this colour on the fly.
+The two automatic ways basically fiddle with beamer slide and frame creation internals to set the structure colour whenever a new frame/slide is created.
+See the \lstinline+.sty+ file for details.
+
+\end{document}
+
+%%% Local Variables:
+%%% mode: latex
+%%% TeX-master: t
+%%% End: