summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/skb/doc/user-guide/slides
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/skb/doc/user-guide/slides')
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/about.tex18
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/applicability.tex37
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/example-art-tex1.tex24
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/example-art-tex2.tex25
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/example-art-tex3.tex25
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/example-art-toc.tex19
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/intent.tex29
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/manual-acrbib.tex35
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/manual-figures-exa.tex22
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/manual-figures-exna.tex21
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/manual-figures-opt.tex25
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/manual-figures.tex29
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/manual-haf.tex37
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/manual-listings.tex36
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/manual-lists.tex37
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/manual-optional-text.tex36
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/manual-paths.tex37
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/manual-pdfinfo.tex32
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/manual-skbem.tex31
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/manual-slides1.tex35
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/manual-slides2.tex31
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/separate-cs.tex28
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/separate-parts-baf.tex35
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/separate-parts-pc1.tex36
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/separate-parts-pc2.tex39
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/separate.tex40
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/start-config-cmd.tex26
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/start-config-opt.tex26
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/start-distribution.tex26
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/start-folders.tex25
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/start-installation.tex46
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/start-rebuild1.tex26
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/start-rebuild2.tex20
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/start-used-options.tex33
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/story-long1.tex32
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/story-long2.tex40
-rw-r--r--macros/latex/contrib/skb/doc/user-guide/slides/story-short.tex37
37 files changed, 1136 insertions, 0 deletions
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/about.tex b/macros/latex/contrib/skb/doc/user-guide/slides/about.tex
new file mode 100644
index 0000000000..74c754fd61
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/about.tex
@@ -0,0 +1,18 @@
+\mode
+<presentation>
+
+\begin{frame}{The \LaTeX~ SKB Package}
+ \label{about}
+
+ \skbinput[from=rep]{abstract}
+ \opt{anim}{\uncover<6->{}}
+\end{frame}
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{about}}
+\bigskip
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/applicability.tex b/macros/latex/contrib/skb/doc/user-guide/slides/applicability.tex
new file mode 100644
index 0000000000..468ca9e7e0
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/applicability.tex
@@ -0,0 +1,37 @@
+\mode
+<presentation>
+
+\begin{frame}{Applicability and Side Effects}
+ \label{applicability}
+
+ \opt{anim}{\tmpHighlight<2>}{The SKB can be helpful if you}
+ \begin{itemize}
+ \opt{anim}{\tmpHighlight<3>}{\item \opt{anim}{\textit<3>}{Need to organise large amount of 'stuf'}}
+ \opt{anim}{\tmpHighlight<4>}{\item \opt{anim}{\textit<4>}{Want to reorganise `stuff'}}
+ \opt{anim}{\tmpHighlight<5>}{\item \opt{anim}{\textit<5>}{Plan to maintain a personal repository}}
+ \end{itemize}
+
+ \opt{anim}{\tmpHighlight<6>}{The SKB has side effects (and cannot do coffee for you either)}
+ \begin{itemize}
+ \opt{anim}{\tmpHighlight<7>}{\item \opt{anim}{\textit<7>}{Separating content from structure makes content (almost) context-free}}
+ \opt{anim}{\tmpHighlight<8>}{\item \opt{anim}{\textit<8>}{Changes in content effect (potentially) multiple documents of different type}}
+ \opt{anim}{\tmpHighlight<9>}{\item \opt{anim}{\textit<9>}{Versioning and change logging becomes (almost) impossible}}
+ \opt{anim}{\tmpHighlight<10>}{\item \opt{anim}{\textit<10>}{Your style of writing documents might need to change}}
+ \opt{anim}{\tmpHighlight<11>}{\item \opt{anim}{\textit<11>}{Cross-references need to be used carefully}}
+ \end{itemize}
+
+ \opt{anim}{\uncover<12->{}}
+\end{frame}
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{applicability}}
+\bigskip
+
+\skbinput[from=rep]{applicability}
+\clearpage
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/example-art-tex1.tex b/macros/latex/contrib/skb/doc/user-guide/slides/example-art-tex1.tex
new file mode 100644
index 0000000000..b7bbf056bb
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/example-art-tex1.tex
@@ -0,0 +1,24 @@
+\mode
+<presentation>
+
+\begin{frame}{An Example Article -- \TeX~code}
+ \label{example:art:tex1}
+
+ \begin{example}[start of the tex file]
+ \lstinputlisting[style=beamer-example,language=TeX,firstline=1,lastline=8]{\skbfileroot{examples/example}}
+ \end{example}
+\end{frame}
+
+
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{example:art:tex1}}
+\bigskip
+
+\skbinput[from=rep]{example-article}
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/example-art-tex2.tex b/macros/latex/contrib/skb/doc/user-guide/slides/example-art-tex2.tex
new file mode 100644
index 0000000000..739a9a5549
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/example-art-tex2.tex
@@ -0,0 +1,25 @@
+\mode
+<presentation>
+
+\begin{frame}{An Example Article -- \TeX~code}
+ \label{example:art:tex2}
+
+ \begin{example}[loading inital text]
+ \lstinputlisting[style=beamer-example,language=TeX,firstline=10,lastline=10]{\skbfileroot{examples/example}}
+ \end{example}
+
+ \begin{example}[a section called Introduction]
+ \lstinputlisting[style=beamer-example,language=TeX,firstline=12,lastline=20]{\skbfileroot{examples/example}}
+ \end{example}
+
+\end{frame}
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{example:art:tex2}}
+\bigskip
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/example-art-tex3.tex b/macros/latex/contrib/skb/doc/user-guide/slides/example-art-tex3.tex
new file mode 100644
index 0000000000..0bfc8f909d
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/example-art-tex3.tex
@@ -0,0 +1,25 @@
+\mode
+<presentation>
+
+\begin{frame}{An Example Article -- \TeX~code}
+ \label{example:art:tex3}
+
+ \begin{example}[more sections]
+ \lstinputlisting[style=beamer-example,language=TeX,firstline=22,lastline=25]{\skbfileroot{examples/example}}
+ \end{example}
+
+ \begin{example}[finishing the tex file]
+ \lstinputlisting[style=beamer-example,language=TeX,firstline=27]{\skbfileroot{examples/example}}
+ \end{example}
+
+\end{frame}
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{example:art:tex3}}
+\bigskip
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/example-art-toc.tex b/macros/latex/contrib/skb/doc/user-guide/slides/example-art-toc.tex
new file mode 100644
index 0000000000..d08d51a325
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/example-art-toc.tex
@@ -0,0 +1,19 @@
+\mode
+<presentation>
+
+\begin{frame}{An Example Article -- The produced TOC}
+ \label{example:art:tex:toc}
+
+ \begin{example}
+ \lstinputlisting[style=beamer-example]{\skbfileroot{examples/example-toc}}
+ \end{example}
+\end{frame}
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{example:art:tex:toc}}
+\bigskip
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/intent.tex b/macros/latex/contrib/skb/doc/user-guide/slides/intent.tex
new file mode 100644
index 0000000000..fd39299475
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/intent.tex
@@ -0,0 +1,29 @@
+\mode
+<presentation>
+
+\begin{frame}{The Intent}
+ \label{intent}
+
+ \begin{itemize}
+ \opt{anim}{\tmpHighlight<2>}{\item \opt{anim}{\textit<2>}{Maintain repository for Long-living Documents using \LaTeX}}
+ \opt{anim}{\tmpHighlight<3>}{\item \opt{anim}{\textit<3>}{Provide easy access to `stuff': text, figures, code examples, ...}}
+ \opt{anim}{\tmpHighlight<4>}{\item \opt{anim}{\textit<4>}{Reuse `stuff' rather than copy'n paste it all the time}}
+ \opt{anim}{\tmpHighlight<5>}{\item \opt{anim}{\textit<5>}{Allow easy creation of different documents using the same `stuff'}}
+ \opt{anim}{\tmpHighlight<6>}{\item \opt{anim}{\textit<6>}{Limit \LaTeX~specific code, simplify the interface between User and \LaTeX}}
+ \end{itemize}
+
+ \opt{anim}{\uncover<7->{}}
+
+\end{frame}
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{intent}}
+\bigskip
+
+\skbinput[from=rep]{intent}
+\clearpage
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/manual-acrbib.tex b/macros/latex/contrib/skb/doc/user-guide/slides/manual-acrbib.tex
new file mode 100644
index 0000000000..c85c4b4c60
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/manual-acrbib.tex
@@ -0,0 +1,35 @@
+\mode
+<presentation>
+
+\begin{frame}{Acronyms and References}
+ \label{manual:acrbib}
+
+ Load Acronym Database
+ \begin{itemize}
+ \item \cmd{\skbacronyms} will load the Acronymnym Database
+ \item Should be called right at the place you want to have the list of acronyms printed
+ \end{itemize}
+
+ \bigskip
+
+ Load References
+ \begin{itemize}
+ \item \cmd{\skbbibtex} will load the reference list
+ \item Should be called before starting with the document
+ \end{itemize}
+
+\end{frame}
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{manual:acrbib}}
+\bigskip
+
+\skbinput[from=rep]{manual/acr-bib}
+
+\clearpage
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/manual-figures-exa.tex b/macros/latex/contrib/skb/doc/user-guide/slides/manual-figures-exa.tex
new file mode 100644
index 0000000000..43fe50cea6
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/manual-figures-exa.tex
@@ -0,0 +1,22 @@
+\mode
+<presentation>
+
+\begin{frame}{\opt{anim}{skbfigure: Multiinclude/Animation Example}\opt{noanim}{skbfigure: and the scaled to textwidth}}
+ \label{exa:multiinclude}
+
+ \opt{anim}{\multiinclude[<+>][start=0,format=pdf,graphics={width=\textwidth}]{\skbfilefig{multiexample/dpe}}}
+ \opt{noanim}{\skbfigure[width=\textwidth]{multiexample/dpe-14}}
+
+ \skbslidecite{\cite{vandermeer-sven:inproceedings:in:2000}}{Figure}
+\end{frame}
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{exa:multiinclude}}
+\bigskip
+
+\nocite{vandermeer-sven:inproceedings:in:2000}
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/manual-figures-exna.tex b/macros/latex/contrib/skb/doc/user-guide/slides/manual-figures-exna.tex
new file mode 100644
index 0000000000..b1c0545175
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/manual-figures-exna.tex
@@ -0,0 +1,21 @@
+\mode
+<presentation>
+
+\begin{frame}{skbfigure: Simple Figure, Rescaled and Centered}
+ \label{exa:simple}
+
+ \skbfigure[center,width=.5\textwidth]{multiexample/dpe-14}
+
+ \skbslidecite{\cite{vandermeer-sven:inproceedings:in:2000}}{Figure}
+\end{frame}
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{exa:simple}}
+\bigskip
+
+\nocite{vandermeer-sven:inproceedings:in:2000}
+
+\mode
+<all> \ No newline at end of file
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/manual-figures-opt.tex b/macros/latex/contrib/skb/doc/user-guide/slides/manual-figures-opt.tex
new file mode 100644
index 0000000000..d59b1b6d29
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/manual-figures-opt.tex
@@ -0,0 +1,25 @@
+\mode
+<presentation>
+
+\begin{frame}{Options for skbfigure}
+ \label{manual:figures:opt}
+
+ \begin{tabular*}{\textwidth}{ >{\scriptsize}p{.18\textwidth} >{\scriptsize}p{.75\textwidth}}
+ \skbinput[from=rep]{manual/skbfigure-opt-table}
+ \end{tabular*}
+
+\end{frame}
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{manual:figures:opt}}
+\bigskip
+
+\skbinput[from=rep]{manual/figures2}
+
+\clearpage
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/manual-figures.tex b/macros/latex/contrib/skb/doc/user-guide/slides/manual-figures.tex
new file mode 100644
index 0000000000..11fd1b90b0
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/manual-figures.tex
@@ -0,0 +1,29 @@
+\mode
+<presentation>
+
+\begin{frame}{Figures}
+ \label{manual:figures}
+
+ \begin{block}{Classic \LaTeX~Example}
+ \lstinputlisting[style=beamer-example,language=TeX]{\skbfileroot{examples/figure-classic}}
+ \end{block}
+
+ \begin{block}{\skbem[code]{skbfigure}}
+ \lstinputlisting[style=beamer-exampleLN,language=TeX]{\skbfileroot{examples/skbfigure}}
+ \end{block}
+
+\end{frame}
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{manual:figures}}
+\bigskip
+
+\skbinput[from=rep]{manual/figures}
+
+\clearpage
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/manual-haf.tex b/macros/latex/contrib/skb/doc/user-guide/slides/manual-haf.tex
new file mode 100644
index 0000000000..7e2d4c504e
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/manual-haf.tex
@@ -0,0 +1,37 @@
+\mode
+<presentation>
+
+\begin{frame}{Headings and Files}
+ \label{manual:haf}
+
+ \begin{block}{\skbem[code]{skbheading}}
+ \lstinputlisting[style=beamer-example,language=TeX]{\skbfileroot{examples/skbheading}}
+ \end{block}
+
+ \begin{block}{\skbem[code]{skbinput}}
+ \lstinputlisting[style=beamer-exampleLN,language=TeX]{\skbfileroot{examples/skbinput}}
+ \end{block}
+
+ \scriptsize{
+ \begin{itemize}
+ \item\skbem[code]{from}: pub, rep, fig, sli
+
+ \item\skbem[code]{level}: book, part, title, chapter, section, subsection, subsubsection
+ \end{itemize}
+ }
+
+\end{frame}
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{manual:haf}}
+\bigskip
+
+\skbinput[from=rep]{manual/headings-and-files}
+
+\clearpage
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/manual-listings.tex b/macros/latex/contrib/skb/doc/user-guide/slides/manual-listings.tex
new file mode 100644
index 0000000000..7eaf02b5c0
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/manual-listings.tex
@@ -0,0 +1,36 @@
+\mode
+<presentation>
+
+\begin{frame}{Styles and Support for Listings}
+ \label{manual:listing}
+
+ \begin{itemize}
+ \item A few pre-defined styles provided
+ \item Most of them set a small type writer font
+ \item Some provide for line numbers
+ \item \cmd{\lstdefinestyle} used to reset style to basic parameters
+ \end{itemize}
+
+ \begin{example}[use within normal text]
+ \lstinputlisting[style=beamer-example,language=TeX,lastline=2]{\skbfileroot{examples/listings}}
+ \end{example}
+
+ \begin{example}[use for beamer frames]
+ \lstinputlisting[style=beamer-example,language=TeX,firstline=3]{\skbfileroot{examples/listings}}
+ \end{example}
+
+\end{frame}
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{manual:listing}}
+\bigskip
+
+\skbinput[from=rep]{manual/listing}
+
+\clearpage
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/manual-lists.tex b/macros/latex/contrib/skb/doc/user-guide/slides/manual-lists.tex
new file mode 100644
index 0000000000..b1eae67b28
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/manual-lists.tex
@@ -0,0 +1,37 @@
+\mode
+<presentation>
+
+\begin{frame}{Lists}
+ \label{manual:lists}
+
+ Two new environments for lists
+ \begin{itemize}
+ \item \cmd{\skbnotelist} for replacing itemize
+ \item \cmd{\skbnoteenum} for replacing enumerate
+ \end{itemize}
+
+ Both do nothing but chaning \cmd{itemsep} and \cmd{parskip}
+ \begin{itemize}
+ \item Set to 0
+ \item Same effect as \cmd{\tightlist} in the memoir package
+ \end{itemize}
+
+ \bigskip
+
+ Both enviroments do \skbem[italic]{nothing} if the memoir package is used!
+
+\end{frame}
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{manual:lists}}
+\bigskip
+
+\skbinput[from=rep]{manual/lists}
+
+\clearpage
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/manual-optional-text.tex b/macros/latex/contrib/skb/doc/user-guide/slides/manual-optional-text.tex
new file mode 100644
index 0000000000..b611710656
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/manual-optional-text.tex
@@ -0,0 +1,36 @@
+\mode
+<presentation>
+
+\begin{frame}{Optional Text -- Versions and Optional}
+ \label{manual:optiona-text}
+
+ \begin{itemize}
+ \item Supports the packages version and optional
+ \item Comes with 6 defined modes, automatically configured
+ \begin{itemize}
+ \item text -- normal text, i.e. in an article
+ \item slide -- slides, i.e. beamer frames
+ \item note -- annotated slides, i.e. beamerarticle
+ \item anim/noanim -- animated and non-animated slides/frames
+ \item memoir -- used when memoir package is loaded
+ \end{itemize}
+ \end{itemize}
+
+ \begin{example}
+ \lstinputlisting[style=beamer-example,language=TeX]{\skbfileroot{examples/optional-text}}
+ \end{example}
+\end{frame}
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{manual:optiona-text}}
+\bigskip
+
+\skbinput[from=rep]{manual/optional-text}
+
+\clearpage
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/manual-paths.tex b/macros/latex/contrib/skb/doc/user-guide/slides/manual-paths.tex
new file mode 100644
index 0000000000..ef049a0cdd
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/manual-paths.tex
@@ -0,0 +1,37 @@
+\mode
+<presentation>
+
+\begin{frame}{Commands to access Path and Filenames directly}
+ \label{manual:paths}
+
+ \begin{itemize}
+ \item \cmd{\skbfileroot} -- the root directory
+ \item \cmd{\skbpathroot} -- with 1 argument, the root-dir/\#1
+ \item \cmd{\skbfileacr} -- the acronym directory and file
+ \item \cmd{\skbfilebib} -- the reference directory and file
+ \item \cmd{\skbpathbib} -- the reference directory
+ \item \cmd{\skbfilerep} -- with 1 argument, the repository-dir/\#1
+ \item \cmd{\skbfilepub} -- with 1 argument, the publish-dir/\#1
+ \item \cmd{\skbfilefig} -- with 1 argument, the figure-dir/\#1
+ \item \cmd{\skbfilesli} -- with 1 argument, the slide-dir/\#1
+ \end{itemize}
+
+ \begin{example}
+ \lstinputlisting[style=beamer-example,language=TeX]{\skbfileroot{examples/paths}}
+ \end{example}
+
+\end{frame}
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{manual:paths}}
+\bigskip
+
+\skbinput[from=rep]{manual/path-commands}
+
+\clearpage
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/manual-pdfinfo.tex b/macros/latex/contrib/skb/doc/user-guide/slides/manual-pdfinfo.tex
new file mode 100644
index 0000000000..10718f6e00
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/manual-pdfinfo.tex
@@ -0,0 +1,32 @@
+\mode
+<presentation>
+
+\begin{frame}{Macros for PDF Info}
+ \label{manual:pdfinfo}
+
+ Macros to set information, call them anywere in your document:
+ \begin{itemize}
+ \item \cmd{\skbtitle} -- the title
+ \item \cmd{\skbauthor} -- the author
+ \item \cmd{\skbsubject} -- the subject
+ \item \cmd{\skbkeywords} -- the keywords
+ \item date -- will be set automatically to today
+ \end{itemize}
+
+ SKB automatically calls the \cmd{\skbpdfinfo} macro at the end of the main document
+
+\end{frame}
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{manual:pdfinfo}}
+\bigskip
+
+\skbinput[from=rep]{manual/pdfinfo}
+
+\clearpage
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/manual-skbem.tex b/macros/latex/contrib/skb/doc/user-guide/slides/manual-skbem.tex
new file mode 100644
index 0000000000..4f29b7fe83
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/manual-skbem.tex
@@ -0,0 +1,31 @@
+\mode
+<presentation>
+
+\begin{frame}{Emphasising Text}
+ \label{manual:skbem}
+
+ \begin{block}{\LaTeX example for \skbem[code]{skbinput}}
+ \lstinputlisting[style=beamer-example,language=TeX]{\skbfileroot{examples/skbem}}
+ \end{block}
+
+ \bigskip
+
+ \begin{block}{And the result}
+ \skbinput{examples/skbem}
+ \end{block}
+
+\end{frame}
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{manual:skbem}}
+\bigskip
+
+\skbinput[from=rep]{manual/skbem}
+
+\clearpage
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/manual-slides1.tex b/macros/latex/contrib/skb/doc/user-guide/slides/manual-slides1.tex
new file mode 100644
index 0000000000..868318158f
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/manual-slides1.tex
@@ -0,0 +1,35 @@
+\mode
+<presentation>
+
+\begin{frame}{Slides}
+ \label{manual:slides1}
+
+ Use \cmd{\skbslide} and \cmd{\skbslidecite} to integrate slides from outside the \LaTeX~universe
+ \begin{itemize}
+ \item Load PDF slides with or without \LaTeX~annotations
+ \item Load the PDF and/or the \LaTeX~from any SKB known path
+ \item Add standardised citation for the slides to the annotation
+ \end{itemize}
+
+ Example with Microsoft Powerpoint
+ \begin{itemize}
+ \item Take a Powerpoint presentation and print all slides into a 4x3 format, individual PDF
+ \item Write or reuse existing anotations using \LaTeX~(and \BibTeX~etc.)
+ \item Produce handouts using the SKB and present the slides using Powerpoint
+ \end{itemize}
+
+\end{frame}
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{manual:slides1}}
+\bigskip
+
+\skbinput[from=rep]{manual/slides}
+
+\clearpage
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/manual-slides2.tex b/macros/latex/contrib/skb/doc/user-guide/slides/manual-slides2.tex
new file mode 100644
index 0000000000..e7d4ef5723
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/manual-slides2.tex
@@ -0,0 +1,31 @@
+\mode
+<presentation>
+
+\begin{frame}{Slides}
+ \label{manual:slides2}
+
+ \begin{block}{\skbem[code]{skbslide}}
+ \lstinputlisting[style=beamer-exampleLN,language=TeX]{\skbfileroot{examples/skbslide}}
+ \end{block}
+
+ \bigskip
+
+ \begin{block}{\skbem[code]{skbslidecite}}
+ \lstinputlisting[style=beamer-exampleLN,language=TeX]{\skbfileroot{examples/skbslidecite}}
+ \end{block}
+
+\end{frame}
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{manual:slides2}}
+\bigskip
+
+\skbinput[from=rep]{manual/slides2}
+
+\clearpage
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/separate-cs.tex b/macros/latex/contrib/skb/doc/user-guide/slides/separate-cs.tex
new file mode 100644
index 0000000000..1a6a19e4e0
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/separate-cs.tex
@@ -0,0 +1,28 @@
+\mode
+<presentation>
+
+\begin{frame}{Separate Content from Structure}
+ \label{separate:cs}
+
+ \begin{example}
+ \skbinput[from=fig]{dirtree/repository}
+ \end{example}
+
+
+\end{frame}
+
+
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{separate:cs}}
+\bigskip
+
+\skbinput[from=rep]{separate/separate-cs}
+
+\clearpage
+
+\mode
+<all> \ No newline at end of file
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/separate-parts-baf.tex b/macros/latex/contrib/skb/doc/user-guide/slides/separate-parts-baf.tex
new file mode 100644
index 0000000000..6e858d881c
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/separate-parts-baf.tex
@@ -0,0 +1,35 @@
+\mode
+<presentation>
+
+\begin{frame}{Separate Parts of the Document, Part I}
+ \label{separate:parts:baf}
+
+ \begin{itemize}
+ \item Create a folder for data
+ \begin{itemize}
+ \item Acronyms, References, ...
+ \end{itemize}
+ \item Create a folder for figures
+ \end{itemize}
+
+ \begin{block}{Bibliography, Acronyms and Figures}
+ \skbinput[from=fig]{dirtree/baf}
+ \end{block}
+
+\end{frame}
+
+
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{separate:parts:baf}}
+\bigskip
+
+\skbinput[from=rep]{separate/separate-parts-baf}
+
+\clearpage
+
+\mode
+<all> \ No newline at end of file
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/separate-parts-pc1.tex b/macros/latex/contrib/skb/doc/user-guide/slides/separate-parts-pc1.tex
new file mode 100644
index 0000000000..0af7e6fd02
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/separate-parts-pc1.tex
@@ -0,0 +1,36 @@
+\mode
+<presentation>
+
+\begin{frame}{Separate Parts of the Document, Part II}
+ \label{separate:parts:pc1}
+
+ Publications and Content
+
+ \begin{itemize}
+ \item Now look into published documents, there are different types
+ \begin{itemize}
+ \item Articles, Books, Lecture Notes, Presentations, ...
+ \end{itemize}
+ \end{itemize}
+
+ \begin{block}{The Folder \skbem[code]{publish}}
+ \skbinput[from=fig]{dirtree/publish}
+ \end{block}
+
+\end{frame}
+
+
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{separate:parts:pc1}}
+\bigskip
+
+\skbinput[from=rep]{separate/separate-parts-pc}
+
+\clearpage
+
+\mode
+<all> \ No newline at end of file
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/separate-parts-pc2.tex b/macros/latex/contrib/skb/doc/user-guide/slides/separate-parts-pc2.tex
new file mode 100644
index 0000000000..fbea4b5de5
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/separate-parts-pc2.tex
@@ -0,0 +1,39 @@
+\mode
+<presentation>
+
+\begin{frame}{Separate Parts of the Document, Part III}
+ \label{separate:parts:pc2}
+
+ Publications: Articles
+
+ \begin{itemize}
+ \item Now look into articles, there are a few of them, i.e.
+ \begin{itemize}
+ \item Object Naming (\skbem[code]{naming.tex})
+ \item Object Models (\skbem[code]{object-models.tex})
+ \item Protocols (\skbem[code]{protocols.tex})
+ \end{itemize}
+ \item And a separate folder with the links to repository files (\skbem[code]{tex})
+ \end{itemize}
+
+ \begin{block}{The Folder \skbem[code]{publish/articles}}
+ \skbinput[from=fig]{dirtree/publish-art}
+ \end{block}
+
+\end{frame}
+
+
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{separate:parts:pc2}}
+\bigskip
+
+\skbinput[from=rep]{separate/separate-parts-pc2}
+
+\clearpage
+
+\mode
+<all> \ No newline at end of file
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/separate.tex b/macros/latex/contrib/skb/doc/user-guide/slides/separate.tex
new file mode 100644
index 0000000000..a65f0b53dd
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/separate.tex
@@ -0,0 +1,40 @@
+\mode
+<presentation>
+
+\begin{frame}{The Concept: Separate Things}
+ \label{separate}
+
+ \opt{anim}{\tmpHighlight<2-8>}{\opt{anim}{\textbf<2-8>}{Separate as much as you can (but not more)}}
+
+ \begin{itemize}
+ \opt{anim}{\tmpHighlight<3>}{\item \opt{anim}{\textit<3>}{Separate content of a document from its structure}}
+ \begin{itemize}
+ \opt{anim}{\tmpHighlight<4>}{\item \opt{anim}{\textit<4>}{Identify small, coherent blocks of information}}
+ \opt{anim}{\tmpHighlight<5>}{\item \opt{anim}{\textit<5>}{Put them in a separate folder: the repository}}
+ \end{itemize}
+ \end{itemize}
+
+ \begin{itemize}
+ \opt{anim}{\tmpHighlight<6>}{\item \opt{anim}{\textit<6>}{Separate the different parts of a document}}
+ \begin{itemize}
+ \opt{anim}{\tmpHighlight<7>}{\item \opt{anim}{\textit<7>}{Documentation reason (publish) from repository}}
+ \opt{anim}{\tmpHighlight<8>}{\item \opt{anim}{\textit<8>}{Code, figures, examples, acronyms, references}}
+ \end{itemize}
+ \end{itemize}
+
+ \opt{anim}{\uncover<9->{}}
+\end{frame}
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{separate}}
+\bigskip
+
+\skbinput[from=rep]{separate/separate}
+
+\clearpage
+
+\mode
+<all> \ No newline at end of file
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/start-config-cmd.tex b/macros/latex/contrib/skb/doc/user-guide/slides/start-config-cmd.tex
new file mode 100644
index 0000000000..e537eb3c4f
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/start-config-cmd.tex
@@ -0,0 +1,26 @@
+\mode
+<presentation>
+
+\begin{frame}{Configuration: \cmd{\skbconfig}}
+ \label{start:config:cmd}
+
+ \begin{example}[variations for \cmd{\skbconfig}]
+ \lstinputlisting[style=beamer-example,language=TeX]{\skbfileroot{examples/skbconfig}}
+ \end{example}
+\end{frame}
+
+
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{start:config:cmd}}
+\bigskip
+
+\skbinput[from=rep]{getting-started/config-cmd}
+
+\clearpage
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/start-config-opt.tex b/macros/latex/contrib/skb/doc/user-guide/slides/start-config-opt.tex
new file mode 100644
index 0000000000..658532fb13
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/start-config-opt.tex
@@ -0,0 +1,26 @@
+\mode
+<presentation>
+
+\begin{frame}{Configuration: Options}
+ \label{start:config:opt}
+ \begin{tabular*}{\textwidth}{ >{\scriptsize}p{.1\textwidth} >{\scriptsize}p{.65\textwidth} >{\scriptsize}p{.15\textwidth}}
+ \skbinput[from=rep]{getting-started/config-opt-table}
+ \end{tabular*}
+
+\end{frame}
+
+
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{start:config:opt}}
+\bigskip
+
+\skbinput[from=rep]{getting-started/config-opt}
+
+\clearpage
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/start-distribution.tex b/macros/latex/contrib/skb/doc/user-guide/slides/start-distribution.tex
new file mode 100644
index 0000000000..02531a3517
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/start-distribution.tex
@@ -0,0 +1,26 @@
+\mode
+<presentation>
+
+\begin{frame}{The SKB Distribution}
+ \label{start:distribution}
+
+ \begin{block}{distribution contents}
+ \skbinput[from=fig]{dirtree/skb-distribution}
+ \end{block}
+\end{frame}
+
+
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{start:distribution}}
+\bigskip
+
+\skbinput[from=rep]{getting-started/distribution}
+
+\clearpage
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/start-folders.tex b/macros/latex/contrib/skb/doc/user-guide/slides/start-folders.tex
new file mode 100644
index 0000000000..00300525f9
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/start-folders.tex
@@ -0,0 +1,25 @@
+\mode
+<presentation>
+
+\begin{frame}{Creating a Directory Structure}
+ \label{start:folders}
+
+ \begin{block}{The Directory Structure used in this Guide}
+ \skbinput[from=fig]{dirtree/complete}
+ \end{block}
+
+\end{frame}
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{start:folders}}
+\bigskip
+
+\skbinput[from=rep]{getting-started/folders}
+
+\clearpage
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/start-installation.tex b/macros/latex/contrib/skb/doc/user-guide/slides/start-installation.tex
new file mode 100644
index 0000000000..affd4ef230
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/start-installation.tex
@@ -0,0 +1,46 @@
+\mode
+<presentation>
+
+\begin{frame}{Installation}
+ \label{start:installation}
+
+ First
+ \begin{itemize}
+ \item Go to your \LaTeX distribution
+ \end{itemize}
+
+ Classes and Style Files
+ \begin{itemize}
+ \item Create a folder \skbem[code]{tex/latex/skb}
+ \item Copy \skbem[code]{run/*} into that folder (\skbem[code]{tex/latex/skb})
+ \item Update filename database of your \LaTeX distribution
+ \end{itemize}
+
+ Documentation
+ \begin{itemize}
+ \item Create a folder \skbem[code]{doc/latex/skb}
+ \item Copy \skbem[code]{doc/*} into that folder (\skbem[code]{doc/latex/skb})
+ \end{itemize}
+
+ Source
+ \begin{itemize}
+ \item Create a folder \skbem[code]{source/latex/skb}
+ \item Copy \skbem[code]{source/*} into that folder (\skbem[code]{source/latex/skb})
+ \end{itemize}
+\end{frame}
+
+
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{start:installation}}
+\bigskip
+
+\skbinput[from=rep]{getting-started/installation}
+
+\clearpage
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/start-rebuild1.tex b/macros/latex/contrib/skb/doc/user-guide/slides/start-rebuild1.tex
new file mode 100644
index 0000000000..5a939b18eb
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/start-rebuild1.tex
@@ -0,0 +1,26 @@
+\mode
+<presentation>
+
+\begin{frame}{Rebuilding the SKB}
+ \label{start:rebuild1}
+
+ \begin{block}{Class/Style Files and Documentation}
+ \lstinputlisting[style=beamer-example,language=TeX,lastline=19]{\skbfileroot{examples/rebuild}}
+ \end{block}
+\end{frame}
+
+
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{start:rebuild1}}
+\bigskip
+
+\skbinput[from=rep]{getting-started/rebuild}
+
+\clearpage
+
+\mode
+<all> \ No newline at end of file
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/start-rebuild2.tex b/macros/latex/contrib/skb/doc/user-guide/slides/start-rebuild2.tex
new file mode 100644
index 0000000000..9e88662162
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/start-rebuild2.tex
@@ -0,0 +1,20 @@
+\mode
+<presentation>
+
+\begin{frame}{Rebuilding the SKB}
+ \label{start:rebuild2}
+
+ \begin{block}{Documentation -- Presentations and Notes}
+ \lstinputlisting[style=beamer-example,language=TeX,firstline=21]{\skbfileroot{examples/rebuild}}
+ \end{block}
+\end{frame}
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{start:rebuild2}}
+\bigskip
+
+\mode
+<all> \ No newline at end of file
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/start-used-options.tex b/macros/latex/contrib/skb/doc/user-guide/slides/start-used-options.tex
new file mode 100644
index 0000000000..c6a7c34be6
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/start-used-options.tex
@@ -0,0 +1,33 @@
+\mode
+<presentation>
+
+\begin{frame}{Confguration: View Options Used}
+ \label{start:used:options}
+
+ \begin{itemize}
+ \item Macro that can be used to show configuration options
+ \item Shows the Change Log and actually used options
+ \item Uses package warning to printout information
+ \item Automatically called at the end of processing main document
+ \end{itemize}
+
+ \begin{example}[Root path Change Log and Option]
+ \lstinputlisting[style=beamer-example,firstline=2,lastline=3]{\skbfileroot{examples/used-options}}
+ \lstinputlisting[style=beamer-example,firstline=12,lastline=13]{\skbfileroot{examples/used-options}}
+ \end{example}
+
+\end{frame}
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{start:used:options}}
+\bigskip
+
+\skbinput[from=rep]{getting-started/used-options}
+
+\clearpage
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/story-long1.tex b/macros/latex/contrib/skb/doc/user-guide/slides/story-long1.tex
new file mode 100644
index 0000000000..1b65587a51
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/story-long1.tex
@@ -0,0 +1,32 @@
+\mode
+<presentation>
+
+\begin{frame}{The Story, long version, Part I}
+ \label{story:long:one}
+
+ The Problems I was facing
+ \begin{itemize}
+ \opt{anim}{\tmpHighlight<2>}{\item \opt{anim}{\textit<2>}{Ideas/concepts hidden and unaccessible}}
+ \opt{anim}{\tmpHighlight<3>}{\item \opt{anim}{\textit<3>}{Many documents in many different formats}}
+ \opt{anim}{\tmpHighlight<4>}{\item \opt{anim}{\textit<4>}{Reuse of `stuff' requires lots of work, and involves copy and paste}}
+ \opt{anim}{\tmpHighlight<5>}{\item \opt{anim}{\textit<5>}{Many different versions of very similar `stuff', no time for maintenance}}
+ \opt{anim}{\tmpHighlight<6>}{\item \opt{anim}{\textit<6>}{Same for text, figures, examples, tables, lists, acronyms, references; all created `stuff'}}
+ \end{itemize}
+
+ \opt{anim}{\uncover<7->{}}
+
+\end{frame}
+
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{story:long:one}}
+\bigskip
+
+\skbinput[from=rep]{story/long}
+\clearpage
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/story-long2.tex b/macros/latex/contrib/skb/doc/user-guide/slides/story-long2.tex
new file mode 100644
index 0000000000..fd765a332e
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/story-long2.tex
@@ -0,0 +1,40 @@
+\mode
+<presentation>
+
+\begin{frame}{The Story, long version, Part II}
+ \label{story:long:two}
+
+ \opt{anim}{\tmpHighlight<2>}{Solution: Create a (unified) document repository}
+ \begin{itemize}
+ \opt{anim}{\tmpHighlight<3>}{\item \opt{anim}{\textit<3>}{Then use it as source to generate documents}}
+ \opt{anim}{\tmpHighlight<4>}{\item \opt{anim}{\textit<4>}{Leave text, heading text, figures etc. in the repository}}
+ \opt{anim}{\tmpHighlight<5>}{\item \opt{anim}{\textit<5>}{Helps to keep information updated (no more copy and paste)}}
+ \opt{anim}{\tmpHighlight<6>}{\item \opt{anim}{\textit<6>}{Only a few rules, little effort for maintanance}}
+ \end{itemize}
+
+ \opt{anim}{\tmpHighlight<7>}{An Example from 2009 (first version of the SKB)}
+ \begin{itemize}
+ \opt{anim}{\tmpHighlight<8>}{\item \opt{anim}{\textit<8>}{Moved 4 lecture notes, 2 presentations, 1 book chapter, 2 books and 4 articles}}
+ \opt{anim}{\tmpHighlight<9>}{\item \opt{anim}{\textit<9>}{Created 1,314 files in 87 folders, but:}}
+ \begin{itemize}
+ \opt{anim}{\tmpHighlight<10>}{\item \opt{anim}{\textit<10>}{Removed about 100 pages of douplicated `stuff}}
+ \opt{anim}{\tmpHighlight<11>}{\item \opt{anim}{\textit<11>}{Removed many many duplicated figures}}
+ \opt{anim}{\tmpHighlight<12>}{\item \opt{anim}{\textit<12>}{Also found tons of errors from re-using already reused `stuff'}}
+ \end{itemize}
+ \end{itemize}
+
+ \opt{anim}{\uncover<13->{}}
+
+\end{frame}
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{story:long:two}}
+\bigskip
+
+\skbinput[from=rep]{story/long2}
+\clearpage
+
+\mode
+<all>
diff --git a/macros/latex/contrib/skb/doc/user-guide/slides/story-short.tex b/macros/latex/contrib/skb/doc/user-guide/slides/story-short.tex
new file mode 100644
index 0000000000..f4dd613880
--- /dev/null
+++ b/macros/latex/contrib/skb/doc/user-guide/slides/story-short.tex
@@ -0,0 +1,37 @@
+\mode
+<presentation>
+
+\begin{frame}{The Story, short version}
+ \label{story:short}
+
+ \opt{anim}{\tmpHighlight<2>}{After 10 years writing documents...and not maintaining them properly}
+ \begin{itemize}
+ \opt{anim}{\tmpHighlight<3>}{\item \opt{anim}{\textit<3>}{My `stuff' got distributed in multiple dimensions}}
+ \opt{anim}{\tmpHighlight<4>}{\item \opt{anim}{\textit<4>}{Some hidden in emails, on shared discs, external document systems, web sites}}
+ \opt{anim}{\tmpHighlight<5>}{\item \opt{anim}{\textit<5>}{Finding anything became almost impossible}}
+ \opt{anim}{\tmpHighlight<6>}{\item \opt{anim}{\textit<6>}{Tried many tools, none really helped to organise my `mess'}}
+ \end{itemize}
+
+ \opt{anim}{\tmpHighlight<7>}{Early 2009, I decided to reorganise \skbem[italic]{everything}}
+ \begin{itemize}
+ \opt{anim}{\tmpHighlight<7>}{\item \opt{anim}{\textit<7>}{Well-defined set of tools/applications: PHP, \LaTeX, \BibTeX, Inkscape, SQLite, Java}}
+ \opt{anim}{\tmpHighlight<8>}{\item \opt{anim}{\textit<8>}{Then I started writing the \LaTeX~part for the SKB}}
+ \opt{anim}{\tmpHighlight<9>}{\item \opt{anim}{\textit<9>}{This now became the SKB package}}
+ \end{itemize}
+
+ \opt{anim}{\uncover<10->{}}
+
+\end{frame}
+
+
+\mode
+<article>
+
+\resizebox{\textwidth}{!}{\includeslide{story:short}}
+\bigskip
+
+\skbinput[from=rep]{story/short}
+\clearpage
+
+\mode
+<all>