summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/skb/user-guide
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/skb/user-guide')
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/database/acronyms.tex28
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/database/bibliography.tex18
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex-styles.bbx37
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/article.bib0
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/book.bib0
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/collection.bib0
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/conference.bib0
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/inbook.bib0
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/incollection.bib0
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/inproceedings.bib10
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/manual.bib0
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/misc.bib0
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/online.bib0
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/proceedings.bib0
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/report.bib0
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/standard.bib10
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/techreport.bib0
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/unpublished.bib0
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/examples/rebuild.tex45
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/figures/dirtree/exa-doc.tex13
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-0.pdfbin0 -> 992 bytes
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-1.pdfbin0 -> 5965 bytes
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-10.pdfbin0 -> 38822 bytes
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-11.pdfbin0 -> 39504 bytes
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-12.pdfbin0 -> 61056 bytes
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-13.pdfbin0 -> 61136 bytes
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-14.pdfbin0 -> 103256 bytes
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-2.pdfbin0 -> 8331 bytes
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-3.pdfbin0 -> 12185 bytes
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-4.pdfbin0 -> 12438 bytes
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-5.pdfbin0 -> 15638 bytes
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-6.pdfbin0 -> 18685 bytes
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-7.pdfbin0 -> 19089 bytes
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-8.pdfbin0 -> 20002 bytes
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-9.pdfbin0 -> 28741 bytes
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/abstract.tex48
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/applicability.tex10
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/exa-doc/documentation.tex88
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/example-article.tex11
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/config-opt-table.tex4
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/config-opt.tex16
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/config.tex2
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/distribution.tex8
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/folders.tex8
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/installation.tex14
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/rebuild.tex33
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/start.tex2
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/used-options.tex4
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/intent.tex6
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/acr-bib.tex2
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/figures.tex6
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/figures2.tex2
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/headings-and-files.tex4
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/listing.tex6
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/lists.tex4
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/manual.tex44
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/optional-text.tex10
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/path-commands.tex8
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/pdfinfo.tex14
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/skbem.tex10
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/skbfigure-opt-table.tex7
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/slides.tex16
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/slides2.tex11
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-cs.tex17
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-final.tex2
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-parts-baf.tex14
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-parts-pc.tex3
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-parts-pc2.tex2
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-parts.tex2
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate.tex4
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/story/long.tex5
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/story/long2.tex4
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/story/short.tex20
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/repository/title.tex2
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/slides/about.tex3
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/slides/applicability.tex22
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/slides/intent.tex13
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/slides/manual-figures-exa.tex22
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/slides/manual-figures-exna.tex21
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/slides/manual-optional-text.tex2
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/slides/manual-pdfinfo.tex2
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/slides/manual-slides1.tex12
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/slides/separate.tex16
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/slides/start-distribution.tex2
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/slides/start-rebuild.tex26
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/slides/start-rebuild1.tex26
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/slides/start-rebuild2.tex20
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/slides/story-long1.tex14
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/slides/story-long2.tex24
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/slides/story-short.tex21
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/ug-slides-anim.tex7
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/ug-slides-load.tex29
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/ug-slides-noanim.tex10
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/ug-slides-notes.tex10
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/user-guide-load.tex2
-rw-r--r--Master/texmf-dist/doc/latex/skb/user-guide/user-guide.tex19
96 files changed, 648 insertions, 309 deletions
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/database/acronyms.tex b/Master/texmf-dist/doc/latex/skb/user-guide/database/acronyms.tex
new file mode 100644
index 00000000000..14006efd139
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/database/acronyms.tex
@@ -0,0 +1,28 @@
+\begin{acronym}[TM Forum]
+\setlength{\itemsep}{0pt}\setlength{\parskip}{0pt}
+ \acro{ANTLR}[ANTLR]{ANother Tool for Language Recognition}
+ \acro{ITU:CMIP}[CMIP]{Common Management Information Protocol}
+ \acro{TeX:CTAN}[CTAN]{the Comprehensice TeX Archive Network}
+ \acro{OMG:GIOP}[GIOP]{The General Inter-ORB Protocol}
+ \acro{W3C:HTML}[HTML]{Hyper Text Markup Language}
+ \acro{W3C:HTTP}[HTTP]{Hyper Text Transfer Protocol}
+ \acro{organisation:IEEE}[IEEE]{Institute of Electrical and Electronic Engineers}
+ \acro{organisation:IETF}[IETF]{Internet Engineering Task Force}
+ \acro{organisation:ITU}[ITU]{International Telecommunication Unit}
+ \acro{ISO:JPG}[JPG]{Joint Photographic Experts Group}
+ \acro{LAMP}[LAMP]{Linux, Apache, MySQL and PHP}
+ \acro{Springer:LNCS}[LNCS]{Lecture Notes in Computer Science}
+ \acro{company:MS}[MS]{Microsoft}
+ \acro{organisation:OMG}[OMG]{Object Management Group}
+ \acro{ISO:PDF}[PDF]{Portable Document Format}
+ \acro{PHP}[PHP]{PHP Hypertext Preprocessor}
+ \acro{ISO:PNG}[PNG]{Portable Network Graphics}
+ \acro{IETF:RFC}[RFC]{Request for Comment}
+ \acro{SDO}[SDO]{Standard Defining Organisation}
+ \acro{A3DS:SKB}[SKB]{Sven's Knowledge Base}
+ \acro{IETF:SNMP}[SNMP]{Simple Network Management Protocol}
+ \acro{ISO:SQL}[SQL]{Structured Query Language}
+ \acro{W3C:SVG}[SVG]{Scalable Vector Graphics}
+ \acro{USB}[USB]{Universal Serial Bus}
+ \acro{organisation:W3C}[W3C]{World Wide Web Consortium}
+\end{acronym} \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/database/bibliography.tex b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibliography.tex
new file mode 100644
index 00000000000..0d0a742835c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibliography.tex
@@ -0,0 +1,18 @@
+\bibliography{\skbpathbib/bibtex/article}
+\bibliography{\skbpathbib/bibtex/book}
+\bibliography{\skbpathbib/bibtex/collection}
+\bibliography{\skbpathbib/bibtex/conference}
+\bibliography{\skbpathbib/bibtex/inbook}
+\bibliography{\skbpathbib/bibtex/incollection}
+\bibliography{\skbpathbib/bibtex/inproceedings}
+\bibliography{\skbpathbib/bibtex/manual}
+\bibliography{\skbpathbib/bibtex/misc}
+\bibliography{\skbpathbib/bibtex/online}
+\bibliography{\skbpathbib/bibtex/proceedings}
+\bibliography{\skbpathbib/bibtex/report}
+\bibliography{\skbpathbib/bibtex/techreport}
+\bibliography{\skbpathbib/bibtex/unpublished}
+\bibliography{\skbpathbib/bibtex/standard}
+
+%my biblatex styles
+\RequireBibliographyStyle{\skbpathbib/bibtex-styles} \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex-styles.bbx b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex-styles.bbx
new file mode 100644
index 00000000000..cc3d2eb63cf
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex-styles.bbx
@@ -0,0 +1,37 @@
+
+\ProvidesFile{bibtex-styles.bbx}
+
+\DeclareBibliographyDriver{standard}{%
+ \usebibmacro{bibindex}%
+ \usebibmacro{author/editor}%
+ \setunit{\labelnamepunct}\newblock
+ \usebibmacro{title}%
+ \newunit
+ \printlist{language}%
+ \newunit\newblock
+ \usebibmacro{byeditor}%
+ \newunit\newblock
+ \usebibmacro{series+number}%
+ \newunit\newblock
+ \printfield{howpublished}%
+ \newunit\newblock
+ \printfield{type}%
+ \newunit
+ \printfield{version}%
+ \newunit
+ \printfield{note}%
+ \newunit\newblock
+ \printlist{organization}%
+ \newunit\newblock
+ \printlist{location}%
+ \newunit\newblock
+ \usebibmacro{date}%
+ \newunit\newblock
+ \printfield{doi}%
+ \newunit\newblock
+ \usebibmacro{url+urldate}%
+ \newunit\newblock
+ \printfield{addendum}%
+ \newunit\newblock
+ \usebibmacro{pageref}%
+ \usebibmacro{finentry}}
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/article.bib b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/article.bib
new file mode 100644
index 00000000000..e69de29bb2d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/article.bib
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/book.bib b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/book.bib
new file mode 100644
index 00000000000..e69de29bb2d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/book.bib
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/collection.bib b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/collection.bib
new file mode 100644
index 00000000000..e69de29bb2d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/collection.bib
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/conference.bib b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/conference.bib
new file mode 100644
index 00000000000..e69de29bb2d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/conference.bib
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/inbook.bib b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/inbook.bib
new file mode 100644
index 00000000000..e69de29bb2d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/inbook.bib
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/incollection.bib b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/incollection.bib
new file mode 100644
index 00000000000..e69de29bb2d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/incollection.bib
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/inproceedings.bib b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/inproceedings.bib
new file mode 100644
index 00000000000..36052c7a0d4
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/inproceedings.bib
@@ -0,0 +1,10 @@
+
+@inproceedings{vandermeer-sven:inproceedings:in:2000,
+ author = {van der Meer, Sven and Arbanowski, Stefan and Steglich, Stephan},
+ booktitle = {Proc. of the 5th IEEE Intelligent Network Workshop (IN 2000)},
+ eventtitle = {5th IEEE Intelligent Network Workshop (IN 2000)},
+ label = {VDM-},
+ title = {Flexible Control of Media Gateways for Service Adaptation},
+ venue = {Cape Town, South Africa},
+ year = {2000},
+}
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/manual.bib b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/manual.bib
new file mode 100644
index 00000000000..e69de29bb2d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/manual.bib
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/misc.bib b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/misc.bib
new file mode 100644
index 00000000000..e69de29bb2d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/misc.bib
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/online.bib b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/online.bib
new file mode 100644
index 00000000000..e69de29bb2d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/online.bib
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/proceedings.bib b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/proceedings.bib
new file mode 100644
index 00000000000..e69de29bb2d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/proceedings.bib
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/report.bib b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/report.bib
new file mode 100644
index 00000000000..e69de29bb2d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/report.bib
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/standard.bib b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/standard.bib
new file mode 100644
index 00000000000..f6aed79e91f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/standard.bib
@@ -0,0 +1,10 @@
+@standard{standard:IETF:RFC:1155,
+ author = {Internet Engineering Task Force},
+ howpublished = {(Standard, STD0016)},
+ label = {IETF1155-},
+ number = {1155},
+ series = {Request for Comments},
+ title = {Structure and identification of management information for TCP/IP-based internets},
+ url = {http://www.ietf.org/rfc/rfc1155.txt},
+ year = {1990},
+}
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/techreport.bib b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/techreport.bib
new file mode 100644
index 00000000000..e69de29bb2d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/techreport.bib
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/unpublished.bib b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/unpublished.bib
new file mode 100644
index 00000000000..e69de29bb2d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/database/bibtex/unpublished.bib
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/examples/rebuild.tex b/Master/texmf-dist/doc/latex/skb/user-guide/examples/rebuild.tex
index 9202df41abe..b7a9029d7ee 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/examples/rebuild.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/examples/rebuild.tex
@@ -1,14 +1,37 @@
-#Rebuild Class and Style files
-$cd run; latex ../source/skb.ins
--> creates: skb.cfg, skb.sty, skbarticle.cls, skbbook.cls,
- skbbeamer.cls, skblncsbeamer.cls and skblncsppt.cls
+## Build style and class files
+$cd run
+latex ../source/skb.ins
+-> creates: skb.cfg, skb.sty and all cls files
-#Rebuild Documentation
+## Build Package Documentation
$cd doc
-$pdflatex ../source/skb.dtx # repeat twice
-$pdflatex user-guide/user-guide # repeat twice
-$pdflatex user-guide/ug-slides-anim # repeat twice
-$pdflatex user-guide/ug-slides-noanim # repeat twice
-$pdflatex user-guide/ug-slides-notes # repeat twice
+$pdflatex ../source/skb.dtx
+$bibtex skb
+$pdflatex ../source/skb.dtx
+$pdflatex ../source/skb.dtx
-# remove all files except the PDFs for cleanup \ No newline at end of file
+## Build User Guide
+$cd doc
+$pdflatex user-guide/user-guide
+$bibtex user-guide
+$pdflatex user-guide/user-guide
+$pdflatex user-guide/user-guide
+
+## Build Presentation with Animations
+$cd doc
+$pdflatex user-guide/ug-slides-anim
+$bibtex user-guide
+$pdflatex user-guide/ug-slides-anim
+$pdflatex user-guide/ug-slides-anim
+
+## Build Presentation without Animations
+$pdflatex user-guide/ug-slides-noanim
+$bibtex user-guide
+$pdflatex user-guide/ug-slides-noanim
+$pdflatex user-guide/ug-slides-noanim
+
+## Build Notes for Presentation
+$pdflatex user-guide/ug-slides-noanim
+$bibtex user-guide
+$pdflatex user-guide/ug-slides-noanim
+$pdflatex user-guide/ug-slides-noanim \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/figures/dirtree/exa-doc.tex b/Master/texmf-dist/doc/latex/skb/user-guide/figures/dirtree/exa-doc.tex
new file mode 100644
index 00000000000..24614c84514
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/figures/dirtree/exa-doc.tex
@@ -0,0 +1,13 @@
+ \dirtree{%^^A
+ .1 [doc/user-guide]\DTcomment{the root path for the \SKB~documentation}.
+ .2 database\DTcomment{acronyms and references are here}.
+ .2 examples\DTcomment{all of our examples are here}.
+ .2 figures\DTcomment{one PDF example and some dirtree figures}.
+ .2 repository\DTcomment{the actual content of user guide and slides}.
+ .3 exa-doc\DTcomment{everything describing the documentation}.
+ .3 getting-started\DTcomment{the general package description}.
+ .3 manual\DTcomment{the user manual, macro descriptions}.
+ .3 separate\DTcomment{the concept of separation in the \SKB}.
+ .3 story\DTcomment{the story, short and long}.
+ .2 slides\DTcomment{all beamer frames for the presentations}.
+ } \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-0.pdf b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-0.pdf
new file mode 100644
index 00000000000..7dc8410073e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-0.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-1.pdf b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-1.pdf
new file mode 100644
index 00000000000..e02a44b967e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-1.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-10.pdf b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-10.pdf
new file mode 100644
index 00000000000..1dc320bce19
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-10.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-11.pdf b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-11.pdf
new file mode 100644
index 00000000000..e0404036075
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-11.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-12.pdf b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-12.pdf
new file mode 100644
index 00000000000..682ef2f503b
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-12.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-13.pdf b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-13.pdf
new file mode 100644
index 00000000000..0a6324e352f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-13.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-14.pdf b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-14.pdf
new file mode 100644
index 00000000000..27da993a8ce
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-14.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-2.pdf b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-2.pdf
new file mode 100644
index 00000000000..38a268f0472
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-2.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-3.pdf b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-3.pdf
new file mode 100644
index 00000000000..44bb285d713
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-3.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-4.pdf b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-4.pdf
new file mode 100644
index 00000000000..910e1ca1fbb
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-4.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-5.pdf b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-5.pdf
new file mode 100644
index 00000000000..9bb88a475e6
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-5.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-6.pdf b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-6.pdf
new file mode 100644
index 00000000000..1414e72444f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-6.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-7.pdf b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-7.pdf
new file mode 100644
index 00000000000..a223e57f3c8
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-7.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-8.pdf b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-8.pdf
new file mode 100644
index 00000000000..8b98bee47d3
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-8.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-9.pdf b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-9.pdf
new file mode 100644
index 00000000000..1bdf60376fb
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/figures/multiexample/dpe-9.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/abstract.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/abstract.tex
index 7496897d5a4..31ecb51323f 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/abstract.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/abstract.tex
@@ -1,10 +1,38 @@
-This package provides macros that help to build a repository for
-long living documents. It focuses on structure and re-use of text, code,
-figures etc. The basic concept is to first separate structure from content
-(i.e. text about a topic from the structure it is presented by) and then
-separating the content from the actual published document, thus enabling
-easy re-use of text blocks in different publications (i.e. text about a
-protocol in a short article about this protocol as well as in a book about
-many protocols); all without constantly copying or changing text. As a side
-effect, using the document classes provided, it hides a lot of LaTeX from
-someone who just wants to write articles and books. \ No newline at end of file
+\opt{text,note}{
+ This \LaTeX~package can help to build a repository for
+ long living documents. It focuses on structure and re-use of text, code,
+ figures etc. The basic concept is to first separate structure from content
+ (i.e. text about a topic from the structure it is presented by) and then
+ separating the content from the actual published document, thus enabling
+ easy re-use of text blocks in different publications (i.e. text about a
+ protocol in a short article about this protocol as well as in a book about
+ many protocols); all without constantly copying or changing text. As a side
+ effect, using the document classes provided, it hides a lot of
+ \LaTeX~from someone who just wants to write articles and books.
+}
+\begin{skbmodeslide}
+\opt{anim}{
+ This \LaTeX~package can help to build a \color{blue}\textbf<2>{repository} \color{black} for
+ long living documents. It focuses on \color{blue}\textbf<3>{structure and re-use} \color{black} of text, code, \newline
+ figures etc. The \color{blue}\textbf<4>{basic concept} \color{black} is to first \color{blue}\textbf<5>{separate} \color{black} structure from content
+ (i.e. text about a topic from the structure it is presented by) and then
+ separating the content from the actual published document, thus \color{blue}\textbf<6>{enabling
+ easy re-use} \color{black} of text blocks in different publications (i.e. text about a
+ protocol in a short article about this protocol as well as in a book about
+ many protocols); all without constantly copying or changing text. As a side
+ effect, using the document classes provided, it hides a lot of
+ \LaTeX~from someone who just wants to write articles and books.
+}
+\opt{noanim}{
+ This \LaTeX~package can help to build a \color{blue}\textbf{repository} \color{black} for
+ long living documents. It focuses on \color{blue}\textbf{structure and re-use} \color{black} of text, code,
+ figures etc. The \color{blue}\textbf{basic concept} \color{black} is to first \color{blue}\textbf{separate} \color{black} structure from content
+ (i.e. text about a topic from the structure it is presented by) and then
+ separating the content from the actual published document, thus \color{blue}\textbf{enabling
+ easy re-use} \color{black} of text blocks in different publications (i.e. text about a
+ protocol in a short article about this protocol as well as in a book about
+ many protocols); all without constantly copying or changing text. As a side
+ effect, using the document classes provided, it hides a lot of
+ \LaTeX~from someone who just wants to write articles and books.
+}
+\end{skbmodeslide} \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/applicability.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/applicability.tex
index dc61e31d43d..d42825b3858 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/applicability.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/applicability.tex
@@ -1,15 +1,15 @@
-\skbheading{Applicability and Side Effects}
+\opt{text}{\skbheading{Applicability and Side Effects}}
-The \SKB~can help you if
+The SKB can help you if
\begin{skbnotelist}
\item You have too many concepts and ideas spread over too many places.
\item You want to re-organise all of your 'stuff'.
\item You plan a 'personal' repository or a well-maintained document base for a single purpose.
- It will be difficult to use the \SKB~for a widely distributed repository that is not
+ It will be difficult to use the \skbacft{A3DS:SKB} for a widely distributed repository that is not
well-maintained, since there are side effects that might run out of control.
\end{skbnotelist}
-The \SKB~has side effects which might cause problems
+The \skbacft{A3DS:SKB} has side effects which might cause problems
\begin{skbnotelist}
\item Separating contents from structure (see below) means that the contents needs to be
almost context-free. Since we can assemble any contents into 'anything' (a book, an article, ...)
@@ -23,6 +23,6 @@ The \SKB~has side effects which might cause problems
effect on lecture notes or annotated beamer slides.
\item Versioning the repository (text and figures) is very difficult.
\item Cross-references need to be used carefully, since a repository file cannot assume that
- the master document uses the (other) file referenced. The \SKB~provides no solution for this
+ the master document uses the (other) file referenced. The SKB provides no solution for this
at the moment (though I have some ideas).
\end{skbnotelist} \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/exa-doc/documentation.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/exa-doc/documentation.tex
new file mode 100644
index 00000000000..66d8dcfd363
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/exa-doc/documentation.tex
@@ -0,0 +1,88 @@
+\skbheading{The SKB Documentation}
+
+The documentation of this package is using most macros the \skbacft{A3DS:SKB} defines, thus
+realising two things in one go: it provides the documentation for the package showing
+its features and it is used to test the the packge while generating the documentation
+(I might say that we do other tests as well). With all that, it can now be also used
+as one example on how to maintain a document repository, and that's exactly what the
+following statements trying to achieve.
+
+As we have seen earlier, the \skbacft{A3DS:SKB} documentation comes in several parts. First, there
+is the documentation on the documented \LaTeX~source code (skb.dtx). Next, there is
+the user guide, which can be compiled along with the documented source (see skb.pdf)
+or as a stand-alone article document (see user-guide.pdf). Since we use our \skbacft{A3DS:SKB} for
+presentations, we provide an animated and a non-animated presentation about the \skbacft{A3DS:SKB}
+(ug-slides-anim.pdf and ug-slides-noanim.pdf) along with annotated slides as a handout
+(ug-slides-notes.pdf). All of these documents use the same source, which includes
+some conditional text. All of these documents `assemble' their content in their specific way
+which quits their purpose best. For instance, the document level are different for the
+headings, the text blocks and tables and figures and examples are ordered in different
+way and some text is incuded in one \skbacft{ISO:PDF} document and not in others.
+
+
+
+
+The documentation has three main parts. The first tells some stories and
+explains the general concepts of the \skbacft{A3DS:SKB}. This part is generated using
+many \skbacft{A3DS:SKB} macros including \cmd{\skbinput} and \cmd{\skbheading}.
+The second part documents the implementation of the \skbacft{A3DS:SKB} package. This part
+uses only some macros for the layout. The last part provides information
+about the history of the package and a change log. This part again uses
+\cmd{\skbinput} and \cmd{\skbheading} and many other \skbacft{A3DS:SKB} macros.
+
+Let's start with the first part, of which this example is again a part of.
+The \skbacft{A3DS:SKB} documentation is split over two main directories: \skbem[code]{publish}
+for the actual article and \skbem[code]{repository}. The folder \skbem[code]{publish/article/tex}
+contains two files, the fiel with the title page of the aticle \skbem[code]{skb.tex} and one for loading the
+repository files \skbem[code]{contents.tex} and creating the intended document structure (levels).
+The file \skbem[code]{user-guide.tex} looks like as follows:
+
+\lstinputlisting[style=genericLN,language=TeX]{\skbfilepub{article/tex/skb-titlepage}}
+
+Line by line the macros calls here have the following effect:
+\begin{skbnotelist}
+ \item Line 1\&2 set the title for the document.
+ \item Line 4 sets the author of the document.
+ \item Line 6 sets the date and version information for the document.
+ \item Line 8\&9 use the \skbacft{A3DS:SKB} macros \cmd{\skbsubject} and \cmd{\skbkeywords} to set the subject
+ and keywords for \skbacft{ISO:PDF} info.
+ \item Line 11 calls \cmd{\maketitle} to create the title minipage (we are in an article class).
+ \item Line 13\&15 start and finish the abstract.
+ \item Line 21 finished the \TeX processing of the file by calling \cmd{\endinput}.
+\end{skbnotelist}
+
+The interesting lines here are number 14 and 19. They use the \skbacft{A3DS:SKB} macro \cmd{\skbinput} to load
+further content. In line 14 it is a file called \skbem[code]{abstract.tex} from the repsitory.
+Note: \cmd{\skbinput} automatically adds the file extension \skbem[code]{.tex} when loading from the repository or publish folders.
+Now the file \skbem[code]{abstract.tex} contains the one paragraph abstract of this document. Nothing else
+special in there.
+
+The other file in the folder \skbem[code]{publish/article/tex} -- \skbem[code]{skb-contents.tex} -- will actually load
+all other files required to build the first part of this document and create the intended document structure
+(i.e. sections and subsections). This file looks like this:
+
+\lstinputlisting[style=genericLN,language=TeX]{\skbfilepub{article/tex/skb-contents}}
+
+The first line uses the classic \LaTeX macro \cmd{\section} to start the section \skbem[italic]{Introduction}.
+All other lines use the \skbacft{A3DS:SKB} macro \cmd{\skbinput} to load files from the repository and associate a \LaTeX document
+level to them. In the case of this document we use sections, subsections and subsubsections. Each of the files loaded here
+with \cmd{\skbinput} will start by calling the \skbacft{A3DS:SKB} macro \cmd{\skbheading} to declare the heading text. For instance, the
+first few lines of the file \skbem[code]{separate-parts.tex} in the repository (loaded in line 7) look like this
+(we show the first 4 lines):
+
+\lstinputlisting[style=genericLN,language=TeX,lastline=4]{\skbfilerep{separate-parts}}
+
+In other words: line 7 of \skbem[code]{contents.tex} calls \cmd{\skbinput} with the option \skbem[code]{from} set
+ro \skbem[code]{rep} and the option \skbem[code]{level} set to \skbem[code]{subsection} and requests to load a file
+called \skbem[code]{separate-parts.tex}. This loaded file then first calls \cmd{\skbheading} to declare a heading text.
+The \skbacft{A3DS:SKB} now will translate use heading tex calling the classic \LaTeX macro \cmd{\subsection}. The rest is done by
+\LaTeX as usual.
+
+If you have a look into the directory \skbem[code]{source/repository} of this distribution, you will see all tex files
+that form part one of this document. You will also see that parts of the documentation, namely code and dirtree figures,
+have been separated out in sub-directories.
+
+Finally, the file \skbem[code]{skb.dtx} uses the \skbacft{A3DS:SKB} macro \cmd{\skbinput} to load the files \skbem[code]{skb-titlepage.tex}
+and \skbem[code]{skb-contents.tex} from the publish folder. You can find that macro call just above \cmd{\StopEventually}
+in \skbem[code]{skb.dtx}. Furthermore, if you look at the very end of \skbem[code]{skb.dtx}, just above \cmd{\Final}, you
+will find the call to \cmd{\skbinput} that loads the file \skbem[code]{history.tex} from the repository. \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/example-article.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/example-article.tex
index 3ca3eb0c633..541c0942ab6 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/example-article.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/example-article.tex
@@ -1,4 +1,4 @@
-\skbheading{A Simple Article}
+\opt{text}{\skbheading{A Simple Article}}
Take the article that describes the state of the art in protocols. Remember, we
have all the contents for that in our \skbem[code]{repository} directory.
@@ -8,9 +8,9 @@ We go the directory that has the published articles
\opt{text}{\lstinputlisting[style=generic,language=TeX]{\skbfileroot{examples/example}}}
-The article uses the class \skbem[code]{skbarticle}. That class will load the \SKB~package and
+The article uses the class \skbem[code]{skbarticle}. That class will load the \skbacft{A3DS:SKB} package and
the memoir class and do all settings we need. It prepares the title page and
-prints the table of contents like any other \LaTeX article. The it uses \cmd{\skbinput}
+prints the table of contents like any other \LaTeX~article. It uses \cmd{\skbinput}
to load files from the repository. The first one is loaded without requesting a level.
In other words, there is some text right at the beginning of our article, without
any special heading, like an abstract.
@@ -21,8 +21,9 @@ what the introduction will be doing: it introduces general protocol concepts wit
to data encoding, protocol message formats, protocols themselves and protocol services.
The last block loads four files with headings categorised as sections.
Using the directory names, we see that the remaining article
-describes the protocols GIOP defined by the OMG, SNMP by the IETF, CMIP by
-the ITU-T and finally HTTP by the W3C.
+describes the protocols \ac{OMG:GIOP} defined by the \ac{organisation:OMG}, \ac{IETF:SNMP} by the
+\ac{organisation:IETF}, \ac{ITU:CMIP} by the \ac{organisation:ITU} and finally \ac{W3C:HTTP} by the
+\ac{organisation:W3C}.
Finally, we load acronyms and bebliography and finishing the article.
This example will create a table of contents similar to this:
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/config-opt-table.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/config-opt-table.tex
index 555ddf42b2a..1b418cc2d4f 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/config-opt-table.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/config-opt-table.tex
@@ -1,4 +1,4 @@
- \skbem[code]{root} & Sets the root path of the \SKB. Everything that the \SKB~
+ \skbem[code]{root} & Sets the root path of the SKB. Everything that the SKB
processes should be located below the root.
& \skbem[code]{/doc} \\
\midrule
@@ -15,7 +15,7 @@
& \skbem[code]{/transparencies} \\
\midrule
\skbem[code]{acr},
- \skbem[code]{acrfile} & The \SKB uses the \skbem[code]{acronym} package and these two macros
+ \skbem[code]{acrfile} & The SKB uses the \skbem[code]{acronym} package and these two macros
dtail the directory (\skbem[code]{acr}) and the file (\skbem[code]{acrfile})
where the acronyms can be found.
& acr: \skbem[code]{database/latex} acrfile: \skbem[code]{acronym} \\
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/config-opt.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/config-opt.tex
index ad96f653629..9b0c23955fd 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/config-opt.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/config-opt.tex
@@ -1,28 +1,28 @@
\DescribeMacro{\skbconfig}
-There are multiple options to configure the \SKB. The following list
+There are multiple options to configure the \skbacft{A3DS:SKB}. The following list
contains all possible options starting with the least significant. That
means that the higher priority settings, which overwrite other settings,
will be listed at the bottom.
\begin{itemize}
- \item Change the file \skbem[code]{skb.sty} in your \LaTeX
+ \item Change the file \skbem[code]{skb.sty} in your \LaTeX~
distribution. This might require administrator (root)
privileges. This option, while possible, is not recommended.
- \item Change the file \skbem[code]{skb.cfg} in your \LaTeX
+ \item Change the file \skbem[code]{skb.cfg} in your \LaTeX~
distribution. This might require administrator (root)
privileges. This option is suitable for a system wide
configuration, say on your own computer or laptop.
\item Create a file \skbem[code]{skblocal.cfg} in your personal
- \LaTeX style/template directory. This will be the most
- convenient way to configure the \SKB. Note: you might need
- to refresh the file database of your \LaTeX distribution.
+ \LaTeX~style/template directory. This will be the most
+ convenient way to configure the \skbacft{A3DS:SKB}. Note: you might need
+ to refresh the file database of your \LaTeX~distribution.
\item Use \cmd{\skbconfig} in your documents.
\end{itemize}
If you chose option 1 we assume you know what you are doing. In case you
chose options 2-3, you can use the macro \cmd{\skbconfig} to do the configuration
-for you. The macro comes with options for all possible settings of the \SKB.
+for you. The macro comes with options for all possible settings of the \skbacft{A3DS:SKB}.
\opt{text}{\autoref{tab:skbconfig:options}}\opt{note}{This slide} describes all options and shows their default value.
-Please note that the \SKB~can currently not handle inputs from directories outside the root hierarchy. However, one can
+Please note that the \skbacft{A3DS:SKB} can currently not handle inputs from directories outside the root hierarchy. However, one can
call \cmd{\skbconfig} anytime to change the root directory, but be carefull with potential side effects!.
\opt{text}{
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/config.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/config.tex
index f0b468e519a..30c06a71b6c 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/config.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/config.tex
@@ -1,4 +1,4 @@
-\skbheading{Confguration: skbconfig}\label{macro:skbconfig}
+\opt{text}{\skbheading{Confguration: skbconfig}\label{macro:skbconfig}}
\opt{text}{
\skbinput[from=rep]{getting-started/config-opt}
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/distribution.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/distribution.tex
index 334a4c4f0a3..6f656435c69 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/distribution.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/distribution.tex
@@ -1,9 +1,9 @@
-\skbheading{The \SKB~Distribution}
+\opt{text}{\skbheading{The SKB Distribution}}
-The \SKB~distribution that one can download from SourceForge or CTAN (CTAN coming soon)
-contains the source files for the \SKB, the generated classes and styles, the generated
+The \skbacft{A3DS:SKB} distribution that one can download from SourceForge or \skbacft{TeX:CTAN}
+contains the source files for the \skbacft{A3DS:SKB}, the generated classes and styles, the generated
documentation and the source files for the user guide.
-\opt{text}{The following example}\opt{note}{This slide} shows the structure and content of the \SKB~distribution.
+\opt{text}{The following example}\opt{note}{This slide} shows the structure and content of the \skbacft{A3DS:SKB} distribution.
\opt{text}{
\begin{longtable}{|>{}p{0.945\textwidth} >{}p{1pt}|}
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/folders.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/folders.tex
index be8dc9a7d19..2389e774492 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/folders.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/folders.tex
@@ -1,6 +1,6 @@
-\skbheading{Creating a Directory Structure}
+\opt{text}{\skbheading{Creating a Directory Structure}}
-The real power (and possibly madness) of the \SKB~comes with the separation of
+The real power (and possibly madness) of the \skbacft{A3DS:SKB} comes with the separation of
different parts of a document into different directory structures. For the user guide,
we assume the \opt{text}{following} general directory structure%
\opt{note}{shown in this slide}%
@@ -20,7 +20,7 @@ To create this structure, go to the directory were you want to put all your
documents, say \skbem[code]{/doc}. Now create the folders \skbem[code]{database},
\skbem[code]{figures}, \skbem[code]{publish} and \skbem[code]{repository} and the
respective sub-folders as shown \opt{text}{above.}\opt{note}{in this slide.} Finally, configure the
-\SKB~by either editing one of the configuration files or adding the following line
+\skbacft{A3DS:SKB} by either editing one of the configuration files or adding the following line
to all of your published documents (and of course change the text \skbem[code]{myfile.tex}
to something that tells you about the location of the configuration change):
@@ -39,7 +39,7 @@ reason (i.e. articles, books, presentations, white papers, work in progress) whi
repository folder contains content, most likely structured following a content-specific
categorisation. The choice of how the directory structure looks like is yours, and of course
you could also have multiple document directories with completely different structures, for instance
-one for computer science publications and one for a gardening book. The \SKB~does not set any
+one for computer science publications and one for a gardening book. The \skbacft{A3DS:SKB} does not set any
limit, since it can be configured very flexibly to your needs
\opt{text}{(please see \autoref{macro:skbconfig} for more details)}%
.
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/installation.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/installation.tex
index b16b6468c6f..d26bf6d994f 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/installation.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/installation.tex
@@ -1,9 +1,11 @@
-\skbheading{Installation}
+\opt{text}{\skbheading{Installation}}
-There are two ways to install the \SKB. The first option is have it
+There are two ways to install the \skbacft{A3DS:SKB}. The first option is have it
automatically installed by your \LaTeX~distribution using \TeX Life
-or the CTAN archive\footnote{Note: This option is not yet supported,
-since the \SKB~has not yet been submitted to CTAN.}. The second option
+or the \skbacft{TeX:CTAN} archive\footnote{Note: Version 0.5 of the \skbacft{A3DS:SKB} has been submitted
+to \skbacft{TeX:CTAN} and is available at http://www.ctan.org/tex-archive/macros/latex/contrib/skb/.
+But it will take a while to reach all mirrors and even longer for TeX Live and
+automatic installation with your prefered \TeX~distribution}. The second option
is a manual installation doing the following steps:
\begin{skbnoteenum}
\item Go to your \LaTeX~distribution to the folder \skbem[code]{tex/latex}.
@@ -23,7 +25,7 @@ following steps. We start with the documentation:
newly created folder \skbem[code]{doc/latex/skb}.
\end{skbnoteenum}
-\noindent And now the source files of the \SKB:
+\noindent And now the source files of the \skbacft{A3DS:SKB}:
\begin{skbnoteenum}
\item Go to your \LaTeX~distribution to the folder \skbem[code]{source/latex}.
\item Create a folder \skbem[code]{skb}.
@@ -31,4 +33,4 @@ following steps. We start with the documentation:
newly created folder \skbem[code]{source/latex/skb}.
\end{skbnoteenum}
-Now you have installed the \SKB~and you are ready to use it. \ No newline at end of file
+Now you have installed the \skbacft{A3DS:SKB} and you are ready to use it. \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/rebuild.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/rebuild.tex
index 584868a1883..6a17be2dc6e 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/rebuild.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/rebuild.tex
@@ -1,31 +1,36 @@
-\skbheading{Rebuild the \SKB~from Source}
+\opt{text}{\skbheading{Rebuild the SKB from Source}}
-The \SKB~class and style files as well as the documentation
+The \skbacft{A3DS:SKB} class and style files as well as the documentation
can be rebuild from its sources very easily. The class and style
-files are part of the documented \LaTeX sources in the file
-\skbem[code]{source/skb.dtx} and the \LaTeX installer (\skbem[code]{source/skb.ins})
+files are part of the documented \LaTeX~sources in the file
+\skbem[code]{source/skb.dtx} and the \LaTeX~installer (\skbem[code]{source/skb.ins})
provides all necessary instructions. Simply follow the steps shown in the first part of
\opt{text}{the following example}\opt{note}{this slide}. All you have to
do then is to copy the files created to your \LaTeX~distribution.
\opt{text}{
- \lstinputlisting[style=generic,language=TeX]{\skbfileroot{examples/rebuild}}
+ \lstinputlisting[style=generic,language=TeX,lastline=5]{\skbfileroot{examples/rebuild}}
}
-The \SKB~documentation comes in several different ways. The file \skbem[code]{source/skb.dtx}
+The \skbacft{A3DS:SKB} documentation comes in several different ways. The file \skbem[code]{source/skb.dtx}
contains the documented source while the files in \skbem[code]{doc/user-guide} can be used
-to generate the User Guide without source documentation, the \SKB~presentation (animated
+to generate the User Guide without source documentation, the \skbacft{A3DS:SKB} presentation (animated
and not animated) and the lecture notes for the presentation.
When processing the file \skbem[code]{source/skb.dtx}, the User Guide will automatically be
-included in the generated PDF if it is found in either of the directories
-\skbem[code]{source/../doc/user-guide} (when using the \SKB~original distribution)
-or \skbem[code]{source/../doc/latex/skb/user-guide} (when the \SKB~is already installed with
-your \LaTeX distribution).
+included in the generated \skbacft{ISO:PDF} if it is found in either of the directories
+\skbem[code]{source/../doc/user-guide} (when using the \skbacft{A3DS:SKB} original distribution)
+or \skbem[code]{source/../doc/latex/skb/user-guide} (when the \skbacft{A3DS:SKB} is already installed with
+your \LaTeX~distribution).
-The second part of \opt{text}{the example above}\opt{note}{this slide} shows how to generate the complete
-\SKB~documentation. Please note that the sequence is partially important, for instance the
+\opt{text}{The following example shows}%
+\opt{note}{The rest of this slide and the next slide show}%
+how to generate the complete \skbacft{A3DS:SKB} documentation. Please note that the sequence is partially important, for instance the
file \skbem[code]{ug-slides-noanim} must be processed before the file \skbem[code]{ug-slides-notes}.
-Please note that the \SKB~documentation is heavily using the \SKB~macros, so you will
+\opt{text}{
+ \lstinputlisting[style=generic,language=TeX,firstline=7]{\skbfileroot{examples/rebuild}}
+}
+
+Please note that the \skbacft{A3DS:SKB} documentation is heavily using the \skbacft{A3DS:SKB} macros, so you will
need to have the style and class files installed before you can rebuild the documentation. \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/start.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/start.tex
index 01695a58b34..7981aeaebba 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/start.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/start.tex
@@ -1 +1 @@
-\skbheading{Getting Started} \ No newline at end of file
+\opt{text}{\skbheading{Getting Started}} \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/used-options.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/used-options.tex
index 40860cde825..d61f82460e1 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/used-options.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/getting-started/used-options.tex
@@ -1,4 +1,4 @@
-\skbheading{Confguration: View Options Used}\label{macro:skboptionsused}
+\opt{text}{\skbheading{Confguration: View Options Used}\label{macro:skboptionsused}}
\DescribeMacro{\skboptionsused}
This macro will print out a warning including the currently used configuration
@@ -14,7 +14,7 @@ but if the configuration for \skbem[code]{fig} has been changed using
This macro is automatically called at the end of processing.
-When creating the documentation for the \SKB~by running \skbem[code]{pdflatex skb.dtx},
+When creating the documentation for the \skbacft{A3DS:SKB} by running \skbem[code]{pdflatex skb.dtx},
the following output will be created:
\lstinputlisting[style=generic]{\skbfileroot{examples/used-options}}
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/intent.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/intent.tex
index 08717f75151..ddc250f74c6 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/intent.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/intent.tex
@@ -1,6 +1,6 @@
-\skbheading{The Intent}
+\opt{text}{\skbheading{The Intent}}
-Provide a \LaTeX package that helps to create and maintain a repository for long-living documents. It's
+Provide a \LaTeX~package that helps to create and maintain a repository for long-living documents. It's
probably not usefull for some short-term articles, however, I learned that most of my short term articles
eventually become part of my long-term documents. Here you go. The repository should allow for easy access
to 'stuff': text blocks, senteces, paragraphs, sections, complete chapters. But also to figures, code
@@ -8,4 +8,4 @@ sniplets, examples, etc. And I do want to limit the amount of repetition of info
I use a certain example in an article I might want to use the same (identical) example in a book or a
presentation or lecture notes. If I only copy the example I have to maintain several sources, and over time
I will not remember which of them is normative. As a side effect, I also want to optimise document creation
-and limit the \LaTeX or document class specific code in my documents. \ No newline at end of file
+and limit the \LaTeX~or document class specific code in my documents. \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/acr-bib.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/acr-bib.tex
index 337183cad4f..b2b1b104522 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/acr-bib.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/acr-bib.tex
@@ -1,4 +1,4 @@
-\skbheading{Loading Acronyms and Bibliographic Information}
+\opt{text}{\skbheading{Loading Acronyms and Bibliographic Information}}
\DescribeMacro{\skbacronyms}
\DescribeMacro{\skbbibtex}
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/figures.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/figures.tex
index bb1f52fd001..bbc4df595fa 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/figures.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/figures.tex
@@ -1,7 +1,7 @@
-\skbheading{Figures}
+\opt{text}{\skbheading{Figures}}
\DescribeMacro{\skbfigure}
-The classic way to add figures to your document is to have a PDF or PNG or JPG
+The classic way to add figures to your document is to have a \skbacft{ISO:PDF} or \skbacft{ISO:PNG} or \skbacft{ISO:JPG}
file ready, include it using \cmd{\includegraphics} while putting it into a box
to resize it (i.e. to the width of the text in your document), putting this
very box into a figure environment so that \LaTeX~can process list of figures etc.
@@ -13,7 +13,7 @@ and of course adding lable and caption to it.%
\opt{note}{The first block of this slide show a \LaTeX~example, which also uses the
center environment.}%
-With the \SKB~macro \cmd{\skbfigure} things become a little bit simplier.
+With the \skbacft{A3DS:SKB} macro \cmd{\skbfigure} things become a little bit simplier.
takes a number of options and one argument.%
\opt{text}{The following code}\opt{note}{The second block on this slide}
shows a number of examples for using this macro.
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/figures2.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/figures2.tex
index a67bd05fa5b..4f516046e71 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/figures2.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/figures2.tex
@@ -1,5 +1,3 @@
-\opt{note}{\skbheading{Figures, Multiinclude}}
-
The last option for the macro \cmd{\skbfigure} is called \skbem[code]{multiinclude}.
It can be used with the beamer package to realise animations by loading a series of
images and showing them in sequence with or without overlaying. If used, this
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/headings-and-files.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/headings-and-files.tex
index 493786d965e..566d1221e11 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/headings-and-files.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/headings-and-files.tex
@@ -1,4 +1,4 @@
-\skbheading{Files and Headings}
+\opt{text}{\skbheading{Files and Headings}}
\DescribeMacro{\skbinput}
\DescribeMacro{\skbheading}
@@ -43,7 +43,7 @@ a few use cases for \cmd{\skbinput}.
}
Let's start with the simpliest form, one argument only shown in line 1.
-The macro will look for a file called myfile.tex in the root directory of the \SKB.
+The macro will look for a file called myfile.tex in the root directory of the \skbacft{A3DS:SKB}.
The file extension .tex is automatically added, and since we did not specify any
special directory the root directory is used instead.
If the file is not found, the macro will throw an error providing the full path and filename it
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/listing.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/listing.tex
index 8a801e4f6e1..2eb16acda6e 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/listing.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/listing.tex
@@ -1,6 +1,6 @@
-\skbheading{Listings Styles and Support}
+\opt{text}{\skbheading{Listings Styles and Support}}
-The \SKB~comes with a few predefined styles for the listing package.
+The \skbacft{A3DS:SKB} comes with a few predefined styles for the listing package.
Most of them use type writer font in scriptsize, arrange a grey
box around the listing and set the keywords to Blue4.
\begin{skbnotelist}
@@ -15,4 +15,4 @@ box around the listing and set the keywords to Blue4.
\DescribeMacro{\lstdefinestyle}
There is also one macro supported, which sets the listing style back to normal, i.e. after changing it in the text. Some macros
-in the \SKB~ make use of this. All that \cmd{\lstdefinestyle} does is setting the basic style back to type writer font. \ No newline at end of file
+in the \skbacft{A3DS:SKB} make use of this. All that \cmd{\lstdefinestyle} does is setting the basic style back to type writer font. \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/lists.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/lists.tex
index f138482750a..8bfe0e254a7 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/lists.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/lists.tex
@@ -1,4 +1,4 @@
-\skbheading{Environments for lists and enumerates}
+\opt{text}{\skbheading{Environments for lists and enumerates}}
\DescribeMacro{\skbnotelist}
\DescribeMacro{\skbnoteenum}
@@ -14,7 +14,7 @@ Both environments do the following:
\item Set \cmd{\parskip} and \cmd{\itemsep} back to thir original value.
\end{skbnotelist}
-Here is an example using first the classic list environment (itemize) and then the \SKB macro
+Here is an example using first the classic list environment (itemize) and then the \skbacft{A3DS:SKB} macro
\cmd{skbnotelist}
\footnote{For those who are interested, the `Lorem Ipsum' is the standard phrase commonly used since the 1500s.}
\footnote{The following examples might have no effect on annotated slides...}
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/manual.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/manual.tex
index 33bbbd28127..144fbd9ceaf 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/manual.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/manual.tex
@@ -1,32 +1,30 @@
\skbheading{User Manual}
-The \SKB~provides macros that simplify file handling and hide some \LaTeX~
+The \skbacft{A3DS:SKB} provides macros that simplify file handling and hide some \LaTeX~
code (i.e. for figures) from the user, thus helping everyone to focus on
the actual document one wants to write. There are a few macros, and they
can be catagorised as follows.
\begin{skbnotelist}
- \item Files and Headings: \cmd{\skbinput} and \cmd{\skbheading} are used
- to load files and manage the headings of documents, i.e. associating
- a heading with a level in the document structure (section, subsection, etc.)
- \item Figures: \cmd{\skbfigure} is your Swiss Army knife for loading figures and
- graphics.
-
-
- \item Path and filenames - these macros provide direct access to \SKB-managed
- paths and filenames.
- \item Input files - here we have a few macros that load .tex files, figures, slides and
- slide annotations.
- \item Emphasising text - some macros that deal with typesetting text in different ways to
- emphasise that text from the surrounding paragraph.
- \item List styles - \SKB~specific environments adding specific behaviour to lists and enumerate
- environments.
- \item Listings - basically a few pre-defined styles for using the listing environment.
- \item PDF Info - some macros that help to set meta information in PDF documents.
- \item Acronyms - some macros that help to load the acronym database and more.
- \item \BibTeX - one macro that loads bibliographic information.
+ \item Installation, rebuilt and configuration: this part deals with the
+ installation of the package with your local \LaTeX~distribution,
+ the rebuilt of the styles, classes and documentation (all of them are
+ provided, but you never know, it might become useful) and the configuration
+ of the \skbacft{A3DS:SKB} using configuration files and the macro \cmd{\skbconfig}.
+ \item Files, figures and slides: the combination of \cmd{\skbheading} and
+ \cmd{\skbinput} will process files and the document level of headings.
+ The macro \cmd{\skbfigure} makes it easy to include figures in your document
+ and the macro \cmd{\skbslide} helps with \skbacft{ISO:PDF} slides and annotations (if
+ you are not using a classic \LaTeX solution such as the beamer package).
+ \item Filenames, acronyms and references: here we deal with macros that provide
+ access to the path and filenames the \skbacft{A3DS:SKB} maintains, plus loading acronym and
+ reference databases.
+ \item Other useful macros: there are some more macros that complete the \skbacft{A3DS:SKB}. There
+ are little helpers for emphasising text, limiting the space between items in some
+ list environments, putting acronyms into footnotes, filling meta information for
+ \skbacft{ISO:PDF} files and last not least macros that help dealing with optional and conditional text.
\end{skbnotelist}
-For the impatient, we start with a few examples. The first one shows how to use the \SKB~to
-produce a simple article. The second one exmplains how the documentation for the \SKB~is
-created using most of the \SKB~macros. Then we detail the usage of all the macros, following
+For the impatient, we start with a few examples. The first one shows how to use the \skbacft{A3DS:SKB} to
+produce a simple article. The second one exmplains how the documentation for the \skbacft{A3DS:SKB} is
+created using most of the \skbacft{A3DS:SKB} macros. Then we detail the usage of all the macros, following
the above introduced categorisation. \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/optional-text.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/optional-text.tex
index 717d4273c58..8180522e372 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/optional-text.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/optional-text.tex
@@ -1,8 +1,8 @@
-\skbheading{Optional Text -- Versions and Optional}
+\opt{text}{\skbheading{Optional Text -- Versions and Optional}}
-The \SKB~provides two means to include text and other \LaTeX commands on an otional
+The \skbacft{A3DS:SKB} provides two means to include text and other \LaTeX~commands on an otional
basis. They are pre-configured and will be automatically set/unset according to the
-three main document types the \SKB~supports:
+three main document types the \skbacft{A3DS:SKB} supports:
\begin{skbnotelist}
\item text -- is equivalent to any classic text document, for instance an article or a book.
\item slide -- is used to idenify slides, for instance beamer frames.
@@ -19,8 +19,8 @@ introduced types. The macros for provided for optional text are:
\item \cmd{\skbmodetext} and options using \skbem[code]{text} -- will be valid if neither beamer nor beamerarticle is loaded (normal text).
\item \cmd{\skbmodeslide} and options using \skbem[code]{slide} -- will be valid if the beamer package is loaded (slides).
\item \cmd{\skbmodenote} and options using \skbem[code]{note} -- will be valid if the beamerarticle package is loaded (annotated slides).
- \item \cmd{\skbmodeanim} and options using \skbem[code]{anim} -- will be valid if the beamer package is loaded and the \SKB~is loaded with the argument \skbem[code]{beameranim}
- \item \cmd{\skbmodenoanim} and options using \skbem[code]{noanim} -- will be valid if the beamer package is loaded and the \SKB~is loaded with the argument \skbem[code]{beamernoanim}
+ \item \cmd{\skbmodeanim} and options using \skbem[code]{anim} -- will be valid if the beamer package is loaded and the \skbacft{A3DS:SKB} is loaded with the argument \skbem[code]{beameranim}
+ \item \cmd{\skbmodenoanim} and options using \skbem[code]{noanim} -- will be valid if the beamer package is loaded and the \skbacft{A3DS:SKB} is loaded with the argument \skbem[code]{beamernoanim}
\item \cmd{\skbmodememoir} and options using \skbem[code]{memoir} -- will be valid if the memoir package is loaded
\end{skbnotelist}
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/path-commands.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/path-commands.tex
index a17958229ad..b00c99dd4b9 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/path-commands.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/path-commands.tex
@@ -1,4 +1,4 @@
-\skbheading{Path and File Names}
+\opt{text}{\skbheading{Path and File Names}}
\DescribeMacro{\skbfileroot}
\DescribeMacro{\skbpathroot}
@@ -9,12 +9,12 @@
\DescribeMacro{\skbfilepub}
\DescribeMacro{\skbfilefig}
\DescribeMacro{\skbfilesli}
-The \SKB~provides a number of macros to directly create path and file names. Most of
-these macros are actually used within the \SKB~, but they might also be useful for
+The \skbacft{A3DS:SKB} provides a number of macros to directly create path and file names. Most of
+these macros are actually used within the \skbacft{A3DS:SKB}, but they might also be useful for
users to access files without using the provided specialised macros (such as \cmd{\skbinput}.
The following macros are provided:
\begin{skbnotelist}
- \item \cmd{\skbpathroot} -- returns the set root path of the \SKB~.
+ \item \cmd{\skbpathroot} -- returns the set root path of the \skbacft{A3DS:SKB}.
\item \cmd{\skbfileroot} -- returns the set root path and adds \skbem[code]{/#1}, i.e. the directory separator and the argument provided.
\item \cmd{\skbfileacr} -- returns the path (including root) and file name for the acronym database.
\item \cmd{\skbfilebib} -- returns the path (including root) and file name for the file that loads the reference database (\BibTeX).
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/pdfinfo.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/pdfinfo.tex
index ba6f8c7664f..ab2c03bed79 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/pdfinfo.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/pdfinfo.tex
@@ -1,19 +1,19 @@
-\skbheading{Macros for PDF Info}
+\opt{text}{\skbheading{Macros for PDF Info}}
\DescribeMacro{\skbtitle}
-The macro \cmd{\skbtitle} will set the title to be used for PDF info. The default for the title is an empty string.
+The macro \cmd{\skbtitle} will set the title to be used for \skbacft{ISO:PDF} info. The default for the title is an empty string.
\DescribeMacro{\skbauthor}
-The macro \cmd{\skbauthor} will set the author information to be used for PDF info. The default for the author is an empty string.
+The macro \cmd{\skbauthor} will set the author information to be used for \skbacft{ISO:PDF} info. The default for the author is an empty string.
\DescribeMacro{\skbsubject}
-The macro \cmd{\skbsubject} will set the subject information to be used for PDF info. The default for the subject is an empty string.
+The macro \cmd{\skbsubject} will set the subject information to be used for \skbacft{ISO:PDF} info. The default for the subject is an empty string.
\DescribeMacro{\skbkeywords}
-The macro \cmd{\skbkeywords} will set the keywords to be used for PDF info. The default for the keywords is an empty string.
+The macro \cmd{\skbkeywords} will set the keywords to be used for \skbacft{ISO:PDF} info. The default for the keywords is an empty string.
\DescribeMacro{\skbpdfinfo}
The macro \cmd{skbpdfinfo} will call the macro \cmd{\pdfinfo} to set the meta information
-in the created PDF output file. The \SKB~automatically calls this macro just before finishing
+in the created \skbacft{ISO:PDF} output file. The \skbacft{A3DS:SKB} automatically calls this macro just before finishing
the process of the main document, using the information provided by the above described macros.
-Furthermore, the date of the PDF file will be set.
+Furthermore, the date of the \skbacft{ISO:PDF} file will be set.
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/skbem.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/skbem.tex
index afa0697c461..a0484c3bab8 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/skbem.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/skbem.tex
@@ -1,19 +1,19 @@
-\skbheading{Emphasising Text}
+\opt{text}{\skbheading{Emphasising Text}}
\DescribeMacro{\skbem}
Highlighting or emphasising text is an important aspect of many technical documents. One can use
-\LaTeX macros directly to set text in italic or bold. This has the disadvantage that there is no
+\LaTeX~macros directly to set text in italic or bold. This has the disadvantage that there is no
meaningful information given as on why that text is treated in a special way. Furthermore, when
the editor requires to change certain highlights, it will be very difficult to go through a large
document and figure out which text is to be changed.
-To prevent that from happening, one can use \LaTeX macros to actually distignguish between different
-highlighted text. A simple start is provided by the \SKB. It is simply because, at the moment, it
+To prevent that from happening, one can use \LaTeX~macros to actually distignguish between different
+highlighted text. A simple start is provided by the \skbacft{A3DS:SKB}. It is simply because, at the moment, it
only supports three different ways and no furhter meaningful information. But it is a start.
The macro \cmd{\skbem} comes with three different options. The option \skbem[code]{bold} will set the
text given in the argument in bold face. Similar, the option \skbem[code]{italic} will set it italic.
-Last not least, the option \skbem[code]{code} will use another \SKB~macro (\cmd{\skbcode}) for typesetting
+Last not least, the option \skbem[code]{code} will use another \skbacft{A3DS:SKB} macro (\cmd{\skbcode}) for typesetting
the argument text. \opt{note}{This slide shows a few examples along with the resulting type setting}%
\opt{text}{The following code shows some examples for the macro: \lstinputlisting[style=generic,language=TeX]{\skbfileroot{examples/skbem}}}%
\opt{text}{And here the tinal type setting of that example:
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/skbfigure-opt-table.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/skbfigure-opt-table.tex
index a4d99c65d76..0ec954dd2bd 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/skbfigure-opt-table.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/skbfigure-opt-table.tex
@@ -1,30 +1,23 @@
\skbem[code]{width} & Set the width to be used with \cmd{resizebox} and \cmd{includegraphics}.
\\
-
\midrule
\skbem[code]{height} & Set the height to be used with \cmd{resizebox} and \cmd{includegraphics}.
\\
-
\midrule
\skbem[code]{center} & Use center environment.
\\
-
\midrule
\skbem[code]{figure} & Use figure environment.
\\
-
\midrule
\skbem[code]{position} & The position to be used within figure environment. This option will be ignored if not combined with \skbem[code]{figure}.
\\
-
\midrule
\skbem[code]{caption} & The caption to be used. Ignored if the option \skbem[code]{figure} is not used.
\\
-
\midrule
\skbem[code]{label} & The label to be used. Ignored if the option \skbem[code]{figure} is not used.
\\
-
\midrule
\skbem[code]{multiinclide} & The label to be used. Ignored if the option \skbem[code]{figure} is not used.
\\ \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/slides.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/slides.tex
index 28fd83db9dc..20ca3c28981 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/slides.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/slides.tex
@@ -1,22 +1,22 @@
-\skbheading{Slides}
+\opt{text}{\skbheading{Slides}}
\DescribeMacro{\skbslide}
-This macro helps to create lecture notes (handouts) using PDF slides and \LaTeX~notes
-without using the beamer package. The reason for adding this to the \SKB~ was to integrate
+This macro helps to create lecture notes (handouts) using \skbacft{ISO:PDF} slides and \LaTeX~notes
+without using the beamer package. The reason for adding this to the \skbacft{A3DS:SKB} was to integrate
slides from sources outside the \LaTeX~universe (i.e. Microsoft Powerpoint). Some of my
presentations are done using Powerpoint, but for handouts I do prefer using \LaTeX~thus
benefiting from many of the automated features it provides (references, acronyms). As a nice
-side effect, the output generated is scalable (assuming that the PDF sources of the slides
+side effect, the output generated is scalable (assuming that the \skbacft{ISO:PDF} sources of the slides
contain scalable images rather than bitmaps, which can be easily realised using for instance
Inkscape's EMF export within Microsoft Powerpoint slides).
The macro \cmd{\skbslide}
-provides all means to include PDF slides with or without annotations, annotations only and
+provides all means to include \skbacft{ISO:PDF} slides with or without annotations, annotations only and
it can load the annotations using different mechanisms.
The macro offers two options to set the input
path for the slides and the annotations: \skbem[code]{slidefrom} and \skbem[code]{notefrom}.
-If \skbem[code]{slidefrom} is used, then the slide (PDF) file will be loaded from the requested path (\skbem[code]{sli}, \skbem[code]{rep} or \skbem[code]{pub}).
-If \skbem[code]{notefrom} is used, then the annotation (TEX) file will be loaded from the requested path (\skbem[code]{sli}, \skbem[code]{rep} or \skbem[code]{pub}).
+If \skbem[code]{slidefrom} is used, then the slide (\skbacft{ISO:PDF}) file will be loaded from the requested path (\skbem[code]{sli}, \skbem[code]{rep} or \skbem[code]{pub}).
+If \skbem[code]{notefrom} is used, then the annotation (\TeX~) file will be loaded from the requested path (\skbem[code]{sli}, \skbem[code]{rep} or \skbem[code]{pub}).
The default path for slides and annotations is the path for slides.
The third option \skbem[code]{annotate} requests to load annotations. If not used, no annotations will be loaded. It can be used in
@@ -24,7 +24,7 @@ combination with the two arguments to automated loading annotations.
The two arguments of this macro define the files for the slide and the annotation. They can be used as followes:
\begin{skbnotelist}
- \item Argument 1 is the slide to be loaded. If a name if given, we load the PDF using \cmd{\inputgraphics} with width being \cmd{\textwidth}. If no
+ \item Argument 1 is the slide to be loaded. If a name if given, we load the \skbacft{ISO:PDF} using \cmd{\inputgraphics} with width being \cmd{\textwidth}. If no
name is given, no slide will be loaded.
\item Argument 2 is the file with the annotations in combination with the option \skbem[code]{annotate}. If this option is not used then
no annotations will be loaded. If the option is used and no name is given, then the annotation is loaded from a file with the
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/slides2.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/slides2.tex
index d66933cea58..65123752cfa 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/slides2.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/manual/slides2.tex
@@ -1,9 +1,9 @@
This provides the following combinations for \cmd{\skbslide}
\begin{skbnotelist}
- \item Slide only: argument 1 has the name for the PDF, argument 2 is empty
- \item Annotation only: argument 1 is empty, argument 2 has the name for the TEX, option \skbem[code]{annotate} used
- \item Slide with Annotation 1: argument 1 has the name for the PDF, argument 2 has the name for the TEX, option \skbem[code]{annotate} used
- \item Slide with Annotation 2: argument 1 has the name for the PDF, argument is empty, option \skbem[code]{annotate} used
+ \item Slide only: argument 1 has the name for the \skbacft{ISO:PDF}, argument 2 is empty
+ \item Annotation only: argument 1 is empty, argument 2 has the name for the \TeX~file, option \skbem[code]{annotate} used
+ \item Slide with Annotation 1: argument 1 has the name for the \skbacft{ISO:PDF}, argument 2 has the name for the \TeX~file, option \skbem[code]{annotate} used
+ \item Slide with Annotation 2: argument 1 has the name for the \skbacft{ISO:PDF}, argument is empty, option \skbem[code]{annotate} used
\item do nothing: leave both arguments empty
\end{skbnotelist}
@@ -25,5 +25,6 @@ It takes two arguments, the first one for the type of citation and the second on
\opt{text}{Here a simple example:}\opt{note}{This second block on this slide shows a simple example.}
\opt{text}{\lstinputlisting[style=genericLN,language=TeX]{\skbfileroot{examples/skbslidecite}}}%
The first line states that the slide contains material from a book of Tannenbaum and the second line
-states that the annotation contains material from an IETF RFC standard documents (RFC 1155). Since this
+states that the annotation contains material from an \skbacft{organisation:IETF} \skbacft{IETF:RFC}
+standard documents (\cite{standard:IETF:RFC:1155}). Since this
macro is very simple, any content can be given for the two arguments. \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-cs.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-cs.tex
index 69928632346..a03580eb546 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-cs.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-cs.tex
@@ -1,4 +1,4 @@
-\skbheading{Separate Content from Structure: the Repository Folder}
+\opt{text}{\skbheading{Separate Content from Structure: the Repository Folder}}
Now, separating the structure from the content first. The structure of a
document (we stay with classic text documents like articles, books, etc.
@@ -8,19 +8,20 @@ meticulous person might add 'characters' and mention that there are more
ways to think about a document's structure. But that person is not me. The
structure I used fits the purpose (as of now), if it doesn't anymore I
will look further.}. We collect sentences and paragraphs but separate them
-from headings. \LaTeX is doing that already with the macros for chapters and
+from headings. \LaTeX~is doing that already with the macros for chapters and
sections. We go one step further and provide a generic way to identify a
-heading with the \SKB~macro \cmd{\setheading}. This allows to select the appropriate
-\LaTeX heading level at a later stage having the context of that later stage in mind
+heading with the \skbacft{A3DS:SKB} macro \cmd{\setheading}. This allows to select the appropriate
+\LaTeX~heading level at a later stage having the context of that later stage in mind
(i.e. it might be a section in an article but a chapter in a book). Now we create
a structure for the resulting files in our repository, adding meaningful names to
the directories and files. Obviously the names of these folders should provide some
idea about the general characterisation of the files they contain. Example? Well, if you collect
-information from Standard Defining Organisations (SDOs) the top folder
+information from \acs{SDO} the top folder
could be named \skbem[code]{sdo} and the sub-folders using the
-respective SDO acronyms, such as \skbem[code]{omg} for the OMG and
-\skbem[code]{ieee} for the IEEE and \skbem[code]{ietf} for the IETF. We put all this in
-a folder named repository, making it explicit that here is were we find all our normative content.
+respective \ac{SDO} acronyms, such as \skbem[code]{omg} for the \skbacft{organisation:OMG} and
+\skbem[code]{ieee} for the \skbacft{organisation:IEEE} and \skbem[code]{ietf} for the
+\skbacft{organisation:IETF}. We put all this in a folder named repository, making it explicit
+that here is were we find all our normative content.
\opt{text}{The following example}\opt{note}{This slide} shows how that looks like.
\opt{text}{
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-final.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-final.tex
index caad6a5d4f9..d4b63521a50 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-final.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-final.tex
@@ -1,4 +1,4 @@
-\skbheading{The Final Directory Structure}
+\opt{text}{\skbheading{The Final Directory Structure}}
As this is the final and complete root directory of our repository:
\begin{longtable}{|>{}p{0.945\textwidth} >{}p{1pt}|}
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-parts-baf.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-parts-baf.tex
index 68b70195a31..927e8666fc7 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-parts-baf.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-parts-baf.tex
@@ -1,6 +1,6 @@
-\skbheading{Bibliography, Acronyms and Figures}
+\opt{text}{\skbheading{Bibliography, Acronyms and Figures}}
-So the combination of \LaTeX and \BibTeX already helps us for this separation.
+So the combination of \LaTeX~and \BibTeX~already helps us for this separation.
Using the acronym package, we can extend this to acronyms. Looking into the highly
common re-use of figures, we should look into this as well. Let's take the organisation
of bibliographic information as a template. I store them using \BibTeX and process them
@@ -11,9 +11,9 @@ and biblatex classification, i.e. inproceedings, article, book, thesis, standard
Now, I can do the same for figures: put them into a special folder (we can call it
\skbem[code]{figures} for the moment), which contains the source of the figures and the
-generated formats I need for my documents (usually PDF, some PNG). Now I can reference these
+generated formats I need for my documents (usually \skbacft{ISO:PDF}, some \skbacft{ISO:PNG}). Now I can reference these
figures from the repository as well as for other use cases, such as web publishing or
-presentations\footnote{My figures are exclusively in SVG using inkscape (www.inkscape.org).
+presentations\footnote{My figures are exclusively in \skbacft{W3C:SVG} using inkscape (www.inkscape.org).
This has the advantage of a standardised, text-based format with many export options. All my
figures are in a single root folder, structured very similar to the
document folders created above, but separated from it. This makes re-use of figures very easy.}.
@@ -26,7 +26,7 @@ acronyms used in a document out of a (potentially large) database.
One might also want to create other specific structures, such as for programming code. Dont'
stop yourself, it's easier to combine things later (if the separation is not effective) than
to separate things that are hugely integrated into each other. For one of my internal projects,
-a parser generation environment based on ANTLR, I created a special folder for the EBNF specifications
+a parser generation environment based on \skbacft{ANTLR}, I created a special folder for the EBNF specifications
along with railroad diagrams. Now I can use them in my book and my papers.
Now we name the folders for the separated content. This is straight forward, although you might want
@@ -34,8 +34,8 @@ to use different names (don't worry, the skb supports that). We add to the alrea
folder the things we need for figures (\skbem[code]{figures}) and combine acronyms and \BibTeX in a
folder called \skbem[code]{database}, separating the data from all other content~\footnote{Now, the
reason for the database folder and it's structure
-is that the whole \SKB~contains more databases, all of which reside here. If you want to simply apply this
-to \LaTeX documents you might want to use a different strutural approach.}.%
+is that the whole \skbacft{A3DS:SKB} contains more databases, all of which reside here. If you want to simply apply this
+to \LaTeX~documents you might want to use a different strutural approach.}.%
\opt{note}{This slide shows the resulting directory structure}%
\opt{text}{
Now the directory structure looks like this:
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-parts-pc.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-parts-pc.tex
index 4e1119290ed..a3dacd52a8b 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-parts-pc.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-parts-pc.tex
@@ -1,5 +1,4 @@
\opt{text}{\skbheading{Publications and Content}}
-\opt{note}{\skbheading{Publications and Content, Part II}}
Here is were it might get slightly more complicated than in the first few
steps. And you might see already that the reason for that is separation!
@@ -18,7 +17,7 @@ sheets) and a particular structure of our document that fits the purpose.
That means we organise and structure our content every time according to
these constrains. Thus we need a new directory structure for that, since
we will not reuse that as often as our 'stuff' itself. Remember, we use
-the skb macro \cmd{\skbheading} for headings, not the classical \LaTeX macros
+the skb macro \cmd{\skbheading} for headings, not the classical \LaTeX~macros
like \cmd{\section}, so our files effectively do not contain much information
about their place in the structure, only that they claim one
\footnote{Currently experimental, but soon to be ready, there will be an extension
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-parts-pc2.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-parts-pc2.tex
index 4835a3ae736..d9473f86132 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-parts-pc2.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-parts-pc2.tex
@@ -1,5 +1,3 @@
-\opt{note}{\skbheading{Publications and Content, Part II}}
-
We could, and it usually makes sense to do so, go one step further in that
separation. This time within the documents in the \skbem[code]{published}
folder. The reason is the structure of \LaTeX~documents: they do need some
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-parts.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-parts.tex
index ab4323b99c9..f445b6df312 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-parts.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate-parts.tex
@@ -1,4 +1,4 @@
-\skbheading{Separating different Parts of a Document}
+\opt{text}{\skbheading{Separating different Parts of a Document}}
The next step is to separate the remaining parts of a document based
on their semantics. You are probably doing that already if you
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate.tex
index a74073972c7..2679eb3e369 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/separate/separate.tex
@@ -1,4 +1,4 @@
-\skbheading{The Concept: Separate Things}
+\opt{text}{\skbheading{The Concept: Separate Things}}
You already got the idea that separation is important, reading about published documents and
a normative repository. The basic idea is: think separation -- separate as much as you can, but
@@ -10,7 +10,7 @@ want to facilitate re-usability, we have to:
\item separate the different parts of a document.
\end{skbnoteenum}
-For the impatient:
+\noindent For the impatient:
\begin{skbnoteenum}
\item Separating content from structure means to identify small, coherent blocks of information, i.e.
text describing a certain aspect or an example, and put them separated into the repository folder.
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/story/long.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/story/long.tex
index 081a16dd14d..b03ebcb51ae 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/story/long.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/story/long.tex
@@ -1,5 +1,4 @@
\opt{text}{\skbheading{The Long Story}}
-\opt{note}{\skbheading{The Long Story, Part I}}
Over several years of writing documents (articles, books, reports, standards, research proposals)
ideas and concepts became distributed (actually a euphemism for 'hidden') within many many documents
@@ -9,11 +8,11 @@ are manifold:
\begin{skbnotelist}
\item Ideas/concepts are hidden, often un-accessible and, as I experienced, search tools are of limited help.
\item The documents are written in all sorts of formats or available only in (usually proprietary) binary
- formats. Ever tried to open a document written in MS WinWord 6.0 with customised document
+ formats. Ever tried to open a document written in \skbacft{company:MS} WinWord 6.0 with customised document
template in a newer version of the same programme? You know then what I am talking about.
\item Reusing the ideas/concepts, once found in a document and managed to open that very document,
usually involves huge amount of re-formatting. This will produce mistakes. Ever tried to
- use a {\scshape Bib}\TeX) generated reference list, found in a PDF file in a new article?
+ use a {\scshape Bib}\TeX) generated reference list, found in a \skbacft{ISO:PDF} file in a new article?
I found better ways to spend my nights and weekends (yes, I am married and I have a garden).
\item Over time, it can become very difficult to distinguish between different versions of a
document, concept and/or idea. As it happens in real life, things move on even in computing
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/story/long2.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/story/long2.tex
index 60ddd759ea2..27eaeea3fb5 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/story/long2.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/story/long2.tex
@@ -1,5 +1,3 @@
-\opt{note}{\skbheading{The Long Story, Part II}}
-
A solution is to create a unified document repository, then use
this repository as 'normative source' to create documents for specific
purposes while leaving the text blocks, headings, figures, presentations,
@@ -23,7 +21,7 @@ times). I ended up with 1,314 files in 87 folders, which create 9 articles, 2
books, 1 textbook, 3 lecture notes and this document (note: the number of
articles increased, because I could re-assemble 'stuff' for new uses,
spending some five minutes per one new article). I did remove roughly 100
-pages of text (take the classic Spring LNCS format and you get the point
+pages of text (take the classic Spring \skbacft{Springer:LNCS} format and you get the point
of the number of characters) and some 40 figures (all duplicates). I did
find way too many errors in the original sources (most of which have been
created by 're-using' them earlier from even more-original-sources).
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/story/short.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/story/short.tex
index 26824e29408..330f72a1066 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/story/short.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/story/short.tex
@@ -1,4 +1,4 @@
-\skbheading{The Short Story}
+\opt{text}{\skbheading{The Short Story}}
I have written papers, done a lot of presentations, provided some book chapters,
still working on a book, participated in many research proposals and projects, and
@@ -6,7 +6,7 @@ created tons of notes and figures. As of early 2009, most of that information wa
distributed over the repositories of different projects and organisations I worked
for, in some document management systems, on several websites, databases, my preferred
email client (which changed twice), different computers and later even different
-external hard drives and USB sticks. Looking for specific text or a particular figure
+external hard drives and \skbacft{USB} sticks. Looking for specific text or a particular figure
could easily end in a days work. Tools like desktop search engines can help to find
'stuff'. I used them, but if they found anything it was hard to maintain the context
it was written in and some formats or sources were out of reach for them. Even worse
@@ -15,17 +15,17 @@ jobs and several years, all I had is kind of a very messy base of knowledge, wel
somewhere, thus very difficult to locate and impossible to maintain.
So I started early 2009 to re-organise my 'stuff'. At the same time, I did realise that
-moving away from \LaTeX was part of the problem (and I thought using the other text
-processor would help, it actually didn't, long-term). So \LaTeX became, again, the
+moving away from \LaTeX~was part of the problem (and I thought using the other text
+processor would help, it actually didn't, long-term). So \LaTeX~became, again, the
text processor of choice, and with it the ability for a complete different approach
-to organise my 'stuff'. This was the moment the \SKB~was created. \SKB~stands for Sven's
-Knowledge Base. The \LaTeX package \skbem[code]{skb}, described in this article, forms part of a larger
-software system that uses SQLite databases, a small PHP framework, Apache for HTML access
+to organise my 'stuff'. This was the moment the \skbacft{A3DS:SKB} was created. \skbacft{A3DS:SKB} stands for Sven's
+Knowledge Base. The \LaTeX~package \skbem[code]{skb}, described in this article, forms part of a larger
+software system that uses \skbacft{ISO:SQL}ite databases, a small \skbacft{PHP} framework, Apache for \skbacft{W3C:HTML} access
and recently also a Java port.
My document repository uses the \skbem[code]{skb} package, so most of my documents are eventually
-\LaTeX documents. I am saying eventually because I still use other tools (like Microsoft's Powerpoint),
+\LaTeX~documents. I am saying eventually because I still use other tools (like Microsoft's Powerpoint),
but integrate their output in my repository. I do all my figures these days using Inkscape, so the source
-is SVG and the output for \LaTeX documents PDF. For editing the text files I do flip between UE Studio
-and LeD. Parts of the content (such as acronyms and bibliographic information) are maintained in SQLite
+is \skbacft{W3C:SVG} and the output for \LaTeX~documents \skbacft{ISO:PDF}. For editing the text files I do flip between UE Studio
+and LeD. Parts of the content (such as acronyms and bibliographic information) are maintained in \skbacft{ISO:SQL}ite
databases and exported to \LaTeX. This package now shows how I build my documents. \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/repository/title.tex b/Master/texmf-dist/doc/latex/skb/user-guide/repository/title.tex
index 7adbfcdcd60..aebb60ffad3 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/repository/title.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/repository/title.tex
@@ -1 +1 @@
-\skbheading{The \SKB User Guide} \ No newline at end of file
+\skbheading{The SKB User Guide} \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/slides/about.tex b/Master/texmf-dist/doc/latex/skb/user-guide/slides/about.tex
index bcd75140c72..779f420b36a 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/slides/about.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/slides/about.tex
@@ -1,10 +1,11 @@
\mode
<presentation>
-\begin{frame}{The \LaTeX~\SKB~Package}
+\begin{frame}{The \LaTeX~ SKB Package}
\label{about}
\skbinput[from=rep]{abstract}
+ \opt{anim}{\uncover<6->{}}
\end{frame}
\mode
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/slides/applicability.tex b/Master/texmf-dist/doc/latex/skb/user-guide/slides/applicability.tex
index aa398b04b2c..a5c654adcc4 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/slides/applicability.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/slides/applicability.tex
@@ -4,21 +4,23 @@
\begin{frame}{Applicability and Side Effects}
\label{applicability}
- The \SKB~can be helpful if you
+ \opt{anim}{\tmpHighlight<2>}{The SKB can be helpful if you}
\begin{itemize}
- \item Need to organise large amount of 'stuf'
- \item Want to reorganise `stuff'
- \item Plan to maintain a personal repository
+ \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}
- The \SKB~has side effects (and cannot do coffee for you either)
+ \opt{anim}{\tmpHighlight<6>}{The SKB has side effects (and cannot do coffee for you either)}
\begin{itemize}
- \item Separating content from structure makes content (almost) context-free
- \item Changes in content effect (potentially) multiple documents of different type
- \item Versioning and change logging becomes (almost) impossible
- \item Your style of writing documents might need to change
- \item Cross-references between parts of `stuff' need to be used carefully
+ \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}
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/slides/intent.tex b/Master/texmf-dist/doc/latex/skb/user-guide/slides/intent.tex
index 2a8fef21d16..03e305ad28f 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/slides/intent.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/slides/intent.tex
@@ -5,12 +5,15 @@
\label{intent}
\begin{itemize}
- \item Maintain repository for Long-living Documents using \LaTeX
- \item Provide easy access to `stuff': text, figures, code examples, ...
- \item Reuse `stuff' rather than copy'n paste it all the time
- \item Allow easy creation of different documents using the same `stuff'
- \item Limit \LaTeX specific code, simplify the interface between User and \LaTeX
+ \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
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/slides/manual-figures-exa.tex b/Master/texmf-dist/doc/latex/skb/user-guide/slides/manual-figures-exa.tex
new file mode 100644
index 00000000000..4b4490d8960
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/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/Master/texmf-dist/doc/latex/skb/user-guide/slides/manual-figures-exna.tex b/Master/texmf-dist/doc/latex/skb/user-guide/slides/manual-figures-exna.tex
new file mode 100644
index 00000000000..ac39592e048
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/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/Master/texmf-dist/doc/latex/skb/user-guide/slides/manual-optional-text.tex b/Master/texmf-dist/doc/latex/skb/user-guide/slides/manual-optional-text.tex
index 03840da4296..461ac672b20 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/slides/manual-optional-text.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/slides/manual-optional-text.tex
@@ -12,7 +12,7 @@
\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
+ \item memoir -- used when memoir package is loaded
\end{itemize}
\end{itemize}
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/slides/manual-pdfinfo.tex b/Master/texmf-dist/doc/latex/skb/user-guide/slides/manual-pdfinfo.tex
index 604fe4ecc2c..3db2d9b3d6e 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/slides/manual-pdfinfo.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/slides/manual-pdfinfo.tex
@@ -13,7 +13,7 @@
\item date -- will be set automatically to today
\end{itemize}
- \SKB~automatically calls the \cmd{\skbpdfinfo} macro at the end of the main document
+ SKB automatically calls the \cmd{\skbpdfinfo} macro at the end of the main document
\end{frame}
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/slides/manual-slides1.tex b/Master/texmf-dist/doc/latex/skb/user-guide/slides/manual-slides1.tex
index d89b54f2e20..9b27f35b7dd 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/slides/manual-slides1.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/slides/manual-slides1.tex
@@ -4,18 +4,18 @@
\begin{frame}{Slides}
\label{manual:slides1}
- Use \cmd{\skbslide} and \cmd{\skbslidecite} to integrate slides from outside the \LaTeX universe
+ 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 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 PDFs
- \item Write or reuse existing anotations using \LaTeX (and \BibTeX etc.)
- \item Produce handouts using the \SKB and present the slides using Powerpoint
+ \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}
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/slides/separate.tex b/Master/texmf-dist/doc/latex/skb/user-guide/slides/separate.tex
index b020c48dfca..1ea58f716f6 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/slides/separate.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/slides/separate.tex
@@ -4,23 +4,25 @@
\begin{frame}{The Concept: Separate Things}
\label{separate}
- Separate as much as you can (but not more)
+ \opt{anim}{\tmpHighlight<2-8>}{\opt{anim}{\textbf<2-8>}{Separate as much as you can (but not more)}}
\begin{itemize}
- \item Separate content of a document from its structure
+ \opt{anim}{\tmpHighlight<3>}{\item \opt{anim}{\textit<3>}{Separate content of a document from its structure}}
\begin{itemize}
- \item Identify small, coherent blocks of information
- \item Put them in a separate folder: the repository
+ \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}
- \item Separate the different parts of a document
+ \opt{anim}{\tmpHighlight<6>}{\item \opt{anim}{\textit<6>}{Separate the different parts of a document}}
\begin{itemize}
- \item Documentation reason (publish) from repository
- \item Code, figures, examples, acronyms, references
+ \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}
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/slides/start-distribution.tex b/Master/texmf-dist/doc/latex/skb/user-guide/slides/start-distribution.tex
index 65be4df0de9..ab493a0a704 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/slides/start-distribution.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/slides/start-distribution.tex
@@ -1,7 +1,7 @@
\mode
<presentation>
-\begin{frame}{The \SKB~Distribution}
+\begin{frame}{The SKB Distribution}
\label{start:distribution}
\begin{block}{distribution contents}
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/slides/start-rebuild.tex b/Master/texmf-dist/doc/latex/skb/user-guide/slides/start-rebuild.tex
deleted file mode 100644
index 4a70817dbad..00000000000
--- a/Master/texmf-dist/doc/latex/skb/user-guide/slides/start-rebuild.tex
+++ /dev/null
@@ -1,26 +0,0 @@
-\mode
-<presentation>
-
-\begin{frame}{Rebuilding the \SKB}
- \label{start:rebuild}
-
- \begin{block}{Class/Style Files and Documentation}
- \lstinputlisting[style=beamer-example,language=TeX]{\skbfileroot{examples/rebuild}}
- \end{block}
-\end{frame}
-
-
-
-
-\mode
-<article>
-
-\resizebox{\textwidth}{!}{\includeslide{start:rebuild}}
-\bigskip
-
-\skbinput[from=rep]{getting-started/rebuild}
-
-\clearpage
-
-\mode
-<all> \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/slides/start-rebuild1.tex b/Master/texmf-dist/doc/latex/skb/user-guide/slides/start-rebuild1.tex
new file mode 100644
index 00000000000..e5c1181d38a
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/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/Master/texmf-dist/doc/latex/skb/user-guide/slides/start-rebuild2.tex b/Master/texmf-dist/doc/latex/skb/user-guide/slides/start-rebuild2.tex
new file mode 100644
index 00000000000..294d3e8b857
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/skb/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/Master/texmf-dist/doc/latex/skb/user-guide/slides/story-long1.tex b/Master/texmf-dist/doc/latex/skb/user-guide/slides/story-long1.tex
index e56429c1525..137a1fc4af4 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/slides/story-long1.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/slides/story-long1.tex
@@ -6,15 +6,19 @@
The Problems I was facing
\begin{itemize}
- \item Ideas/concepts hidden and unaccessible
- \item Many documents in many different formats
- \item Reuse of `stuff' requires lots of work, and involves copy and paste
- \item Many different versions of very similar `stuff', no time for maintenance
- \item Same for text, figures, examples, tables, lists, acronyms, references; all created `stuff'
+ \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>
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/slides/story-long2.tex b/Master/texmf-dist/doc/latex/skb/user-guide/slides/story-long2.tex
index 783fdcdb550..342a0efe91b 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/slides/story-long2.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/slides/story-long2.tex
@@ -4,25 +4,27 @@
\begin{frame}{The Story, long version, Part II}
\label{story:long:two}
- Solution: Create a (unified) document repository
+ \opt{anim}{\tmpHighlight<2>}{Solution: Create a (unified) document repository}
\begin{itemize}
- \item Then use it as source to generate documents
- \item Leave text, heading text, figures etc. in the repository
- \item Helps to keep information updated (no more copy and paste)
- \item Only a few rules, little effort for maintanance
+ \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}
- An Example from 2009 (first version of the \SKB)
+ \opt{anim}{\tmpHighlight<7>}{An Example from 2009 (first version of the SKB)}
\begin{itemize}
- \item Moved 4 lecture notes, 2 presentations, 1 book chapter, 2 books and 4 articles
- \item Created 1,314 files in 87 folders, but:
+ \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}
- \item Removed about 100 pages of douplicated `stuff
- \item Removed many many duplicated figures
- \item Also found tons of errors from re-using already reused `stuff'
+ \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
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/slides/story-short.tex b/Master/texmf-dist/doc/latex/skb/user-guide/slides/story-short.tex
index a30a4849371..bb3d01cc7ec 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/slides/story-short.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/slides/story-short.tex
@@ -4,20 +4,23 @@
\begin{frame}{The Story, short version}
\label{story:short}
- After 10 years writing documents...and not maintaining them properly
+ \opt{anim}{\tmpHighlight<2>}{After 10 years writing documents...and not maintaining them properly}
\begin{itemize}
- \item My `stuff' got distributed in multiple dimensions
- \item Some hidden in emails, on shared discs, external document systems, web sites
- \item Finding anything became almost impossible
- \item Tried many tools, none really helped to organise my `mess'
+ \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}
- Early 2009, I decided to reorganise \skbem[italic]{everything}
+ \opt{anim}{\tmpHighlight<7>}{Early 2009, I decided to reorganise \skbem[italic]{everything}}
\begin{itemize}
- \item Well-defined set of tools/applications: PHP, \LaTeX, \BibTeX, Inkscape, SQLite, Java
- \item Then I started writing the \LaTeX part for the \SKB
- \item This now became the \SKB package
+ \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}
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/ug-slides-anim.tex b/Master/texmf-dist/doc/latex/skb/user-guide/ug-slides-anim.tex
index 9889966e988..4bca46a2e23 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/ug-slides-anim.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/ug-slides-anim.tex
@@ -1,11 +1,12 @@
\documentclass[beameranim]{skbbeamer}
\IfFileExists{ug-slides-load}
- {\skbconfig[root=./,pub=]{ug-slides-anim.tex}}{}
+ {\skbconfig[root=./]{ug-slides-anim.tex}}{}
\IfFileExists{user-guide/ug-slides-load}
- {\skbconfig[root=user-guide,pub=]{ug-slides-anim.tex}}{}
+ {\skbconfig[root=user-guide]{ug-slides-anim.tex}}{}
-\usepackage{dirtree}
+\skbconfig[pub=,acr=database,bib=database]{ug-slides-anim.tex}
+\skbbibtex
\mode<presentation>
{
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/ug-slides-load.tex b/Master/texmf-dist/doc/latex/skb/user-guide/ug-slides-load.tex
index 7221e9c25a0..f3b83053179 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/ug-slides-load.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/ug-slides-load.tex
@@ -1,4 +1,6 @@
-\skbconfig[sli=slides]{skb-presentation}
+\skbconfig[sli=slides]{ug-slides-load}
+
+\opt{anim}{\def\tmpHighlight<#1>{\temporal<#1>{\color{gray}}{\color{blue}}{\color{black}}}}
\AtBeginSubsection[]
{
@@ -7,17 +9,11 @@
\end{frame}
}
-\title[User Guide]{The \SKB~User Guide}
-%\subtitle{}
+\title[User Guide]{The SKB User Guide}
+\subtitle{Version 0.51, 12-May-2011}
\author[Sven van der Meer]{Sven van der Meer}
-%\institute[WIT]
-%{
-% Department of Computer Science\\
-% University of Somewhere
-%}
-
-%\date[Sven's LNCS]{M.Sc. Computer Science}
+\date{Create and maintain a repository for long-living documents}
\skbtitle{The SKB User Guide}
\skbauthor{Sven van der Meer}
@@ -35,7 +31,7 @@
\end{frame}
}
-\section{The \LaTeX~\SKB~Package}
+\section{The \LaTeX~ SKB Package}
\subsection{The Idea}
\skbinput[from=sli]{about}
\skbinput[from=sli]{intent}
@@ -51,21 +47,24 @@
\skbinput[from=sli]{separate-parts-pc1}
\skbinput[from=sli]{separate-parts-pc2}
-\section{User Manual}
+\mode<presentation>{\section{User Manual}}
+\only<article>{\skbinput[from=rep,level=section]{manual/manual}\clearpage}
\subsection{Getting Started}
\skbinput[from=sli]{start-distribution}
\skbinput[from=sli]{start-installation}
- \skbinput[from=sli]{start-rebuild}
+ \skbinput[from=sli]{start-rebuild1}
+ \only<presentation>{\skbinput[from=sli]{start-rebuild2}}
\skbinput[from=sli]{start-config-opt}
\skbinput[from=sli]{start-config-cmd}
\skbinput[from=sli]{start-used-options}
\skbinput[from=sli]{start-folders}
- \only<article>{\skbinput[from=rep]{manual/manual}\clearpage}
\subsection{Headings, Files, Figures, Slides, Paths, Acronyms and References}
\skbinput[from=sli]{manual-haf}
\skbinput[from=sli]{manual-figures}
\skbinput[from=sli]{manual-figures-opt}
+ \skbinput[from=sli]{manual-figures-exna}
+ \skbinput[from=sli]{manual-figures-exa} \only<article>{\clearpage}
\skbinput[from=sli]{manual-slides1}
\skbinput[from=sli]{manual-slides2}
\skbinput[from=sli]{manual-paths}
@@ -83,4 +82,4 @@
\skbinput[from=sli]{example-art-tex1}
\skbinput[from=sli]{example-art-tex2}
\skbinput[from=sli]{example-art-tex3} \only<article>{\clearpage}
- \only<presentation>{\skbinput[from=sli]{example-art-toc}}
+ \only<presentation>{\skbinput[from=sli]{example-art-toc}} \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/ug-slides-noanim.tex b/Master/texmf-dist/doc/latex/skb/user-guide/ug-slides-noanim.tex
index 8594eb66204..33beff414d3 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/ug-slides-noanim.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/ug-slides-noanim.tex
@@ -1,11 +1,11 @@
-\documentclass[beameranim]{skbbeamer}
-
+\documentclass[beamernoanim]{skbbeamer}
\IfFileExists{ug-slides-load}
- {\skbconfig[root=./,pub=]{ug-slides-noanim.tex}}{}
+ {\skbconfig[root=./]{ug-slides-noanim.tex}}{}
\IfFileExists{user-guide/ug-slides-load}
- {\skbconfig[root=user-guide,pub=]{ug-slides-noanim.tex}}{}
+ {\skbconfig[root=user-guide]{ug-slides-noanim.tex}}{}
- \usepackage{dirtree}
+ \skbconfig[pub=,acr=database,bib=database]{ug-slides-noanim.tex}
+ \skbbibtex
\mode<presentation>
{
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/ug-slides-notes.tex b/Master/texmf-dist/doc/latex/skb/user-guide/ug-slides-notes.tex
index 2af8ee8c101..728b628c656 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/ug-slides-notes.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/ug-slides-notes.tex
@@ -2,14 +2,18 @@
\setjobnamebeamerversion{ug-slides-noanim}
\IfFileExists{ug-slides-load}
- {\skbconfig[root=./,pub=]{ug-slides-notes.tex}}{}
+ {\skbconfig[root=./]{ug-slides-notes.tex}}{}
\IfFileExists{user-guide/ug-slides-load}
- {\skbconfig[root=user-guide,pub=]{ug-slides-notes.tex}}{}
+ {\skbconfig[root=user-guide]{ug-slides-notes.tex}}{}
- \usepackage{dirtree}
+ \skbconfig[pub=,acr=database,bib=database]{ug-slides-notes.tex}
+ \skbbibtex
\begin{document}
\skbinput[from=pub]{ug-slides-load}
+ \section{Acronyms}
+ \skbacronyms
+ \printbibliography
\end{document}
\endinput \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/user-guide-load.tex b/Master/texmf-dist/doc/latex/skb/user-guide/user-guide-load.tex
index 7da386fba42..2457c41ae12 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/user-guide-load.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/user-guide-load.tex
@@ -30,6 +30,7 @@
\subsection{Other useful Macros}
\skbinput[from=rep,level=subsubsection]{manual/skbem}
\skbinput[from=rep,level=subsubsection]{manual/lists}
+ \skbinput[from=rep,level=subsubsection]{manual/pdfinfo}
\skbinput[from=rep,level=subsubsection]{manual/listing}
\skbinput[from=rep,level=subsubsection]{manual/optional-text}
@@ -37,5 +38,4 @@
\skbinput[from=rep]{example-article}
%^^A\skbinput[from=rep,level=section]{um}
-%^^A \skbinput[from=rep,level=subsection]{example-article}
%^^A \skbinput[from=rep,level=subsection]{example-dtx} \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/skb/user-guide/user-guide.tex b/Master/texmf-dist/doc/latex/skb/user-guide/user-guide.tex
index c579b344228..65ebfbf9cff 100644
--- a/Master/texmf-dist/doc/latex/skb/user-guide/user-guide.tex
+++ b/Master/texmf-dist/doc/latex/skb/user-guide/user-guide.tex
@@ -1,23 +1,25 @@
\documentclass{skbarticle}
\IfFileExists{user-guide}
- {\skbconfig[root=./,pub=]{user-guide.tex}}{}
+ {\skbconfig[root=./]{user-guide.tex}}{}
\IfFileExists{user-guide/user-guide}
- {\skbconfig[root=user-guide,pub=]{user-guide.tex}}{}
+ {\skbconfig[root=user-guide]{user-guide.tex}}{}
+\skbconfig[pub=,acr=database,bib=database]{user-guide.tex}
+\skbbibtex
\begin{document}
- \title{The \SKB~User Guide}
+ \title{The SKB User Guide}
\author{Sven van der Meer}
- \date{2010-08-04 v0.5}
+ \date{Version 0.51, 12-May-2011}
\maketitle
\begin{abstract}
\skbinput[from=rep]{abstract}
\end{abstract}
\footnote{
- Note: This article is part of the \SKB~package. It is typeset separated from
+ Note: This article is part of the \skbacft{A3DS:SKB} package. It is typeset separated from
the original documentation to show the usage of the \cmd{\skbarticle} class
- and to provide an example for the usage of the \SKB.
+ and to provide an example for the usage of the \skbacft{A3DS:SKB}.
}
\tableofcontents*
@@ -29,5 +31,10 @@
\skbinput[from=pub]{user-guide-load}
+ \section*{Acronyms}
+ \skbacronyms
+
+ \printbibliography
+
\end{document}
\endinput \ No newline at end of file