From 4f768ab0d8e0b0ea98ecfe2bff8103e212f4e6a7 Mon Sep 17 00:00:00 2001
From: Jan Benda <jan.benda@uni-tuebingen.de>
Date: Tue, 2 Mar 2021 21:03:06 +0100
Subject: [PATCH] updated README

---
 README.md            | 89 +++++++++++++++++++++++++++++++++++++++++++-
 beamerthemelines.sty |  4 --
 lines-example.tex    |  1 +
 3 files changed, 88 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index aec342f..4d22c87 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,88 @@
-# beamerlines
+# beamer lines themes
 
-A LaTeX beamer theme with customizable lines in various places.
\ No newline at end of file
+LaTeX beamer themes with customizable lines in various places.
+
+## LaTeX Style files
+
+The following style files are provided:
+
+- `beamerthemelines.sty`: provides the `lines` theme --- 
+  a general beamer theme (inner, outer and font theme) 
+  with horizontal lines instead/in addition to colored boxes.
+- `beamercolorthemeaptero.sty`: provides a palette of muted colors and
+  the `aptero` color theme fitting not only the `lines` theme.
+- `beamerthemeut.sty`: provides the `ut` theme ---
+  the `lines` theme specifically adapted for the University of Tuebingen.
+- `beamercolorthemeut.sty`: the color palette of the cooperate design
+  of the University of Tuebingen. Used by the `ut` theme.
+
+## Usage of the `lines` theme
+
+The `lines` theme can be used on its own, potentially together with
+the `aptero` or `ut` color theme.
+
+```
+\documentclass[aspectratio=169,t]{beamer}
+\usetheme[author,date,title]{ut}
+
+\title{Line-based themes for beamer}
+\author[Benda]{Jan Benda}
+\institute[T\"ubingen]{Neuroethology, University of T\"ubingen}
+\date[2021]{March 2021}
+\logo{\includegraphics[height=3.5ex]{UT_BM_Rot_RGB}}
+\titlelogo{\includegraphics[height=6ex]{UT_MNF_RGB}}
+\titlegraphic{\includegraphics[width=\textwidth]{efishtitle}}
+
+\begin{document}
+
+\begin{frame}[plain]
+  \titlepage
+\end{frame}
+
+\begin{frame}{First slide}
+  Something to talk about.
+\end{frame}
+
+\end{document}
+```
+
+## Usage of the `ut` theme
+
+When using the `ut` theme, then you need the style files for the
+`lines` theme and the `ut` color theme as well.
+
+```
+\documentclass[aspectratio=169,t]{beamer}
+\usetheme[author,date,title]{ut}
+
+\title{Line-based themes for beamer}
+\author[Benda]{Jan Benda}
+\institute[T\"ubingen]{Neuroethology, University of T\"ubingen}
+\date[2021]{March 2021}
+\logo{\includegraphics[height=3.5ex]{UT_BM_Rot_RGB}}
+\titlelogo{\includegraphics[height=6ex]{UT_MNF_RGB}}
+\titlegraphic{\includegraphics[width=\textwidth]{efishtitle}}
+
+\begin{document}
+
+\begin{frame}[plain]
+  \titlepage
+\end{frame}
+
+\begin{frame}{First slide}
+  Something to talk about.
+\end{frame}
+
+\end{document}
+```
+
+## Examples
+
+See the `lines-example.tex` and the `ut-example.tex` file for examples
+and descriptions of the respective themes.
+
+Run
+```
+> make talks
+``
+to compile them.
diff --git a/beamerthemelines.sty b/beamerthemelines.sty
index a4b2c12..b85cc56 100644
--- a/beamerthemelines.sty
+++ b/beamerthemelines.sty
@@ -470,8 +470,4 @@
 \setbeamerfont{footline}{size=\footnotesize}
 
 
-%%%%% colors %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-\usecolortheme{aptero}
-
 \mode<all>
diff --git a/lines-example.tex b/lines-example.tex
index 3897244..066d27d 100644
--- a/lines-example.tex
+++ b/lines-example.tex
@@ -1,5 +1,6 @@
 \documentclass[10pt,aspectratio=169,t,ignorenonframetext]{beamer}
 \usetheme[author,date,title,page,hidelogo]{lines}
+\usecolortheme{aptero}
 
 \title[Beamer lines]{Lines}
 \subtitle{a line-based theme for beamer}