summaryrefslogtreecommitdiff
path: root/Master/texmf-dist
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-05-23 23:31:58 +0000
committerKarl Berry <karl@freefriends.org>2012-05-23 23:31:58 +0000
commitd027611c70ba34bcd9423386d0541c67bf2b0a0c (patch)
tree4abf7627a388e285678c69174cf9c667b865f750 /Master/texmf-dist
parent9317ffb0b5ad516c982745d58db8a33405f262ac (diff)
sidenotes (23may12)
git-svn-id: svn://tug.org/texlive/trunk@26610 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist')
-rw-r--r--Master/texmf-dist/doc/latex/sidenotes/sidenotes.pdfbin195212 -> 196316 bytes
-rw-r--r--Master/texmf-dist/doc/latex/sidenotes/sn.bib6
-rw-r--r--Master/texmf-dist/doc/latex/sidenotes/sn_usage_bibtex.pdfbin0 -> 132887 bytes
-rw-r--r--Master/texmf-dist/doc/latex/sidenotes/sn_usage_bibtex.tex74
-rw-r--r--Master/texmf-dist/source/latex/sidenotes/sidenotes.dtx5
-rw-r--r--Master/texmf-dist/tex/latex/sidenotes/sidenotes.sty4
6 files changed, 87 insertions, 2 deletions
diff --git a/Master/texmf-dist/doc/latex/sidenotes/sidenotes.pdf b/Master/texmf-dist/doc/latex/sidenotes/sidenotes.pdf
index 01d223a39e1..7928ca6a3de 100644
--- a/Master/texmf-dist/doc/latex/sidenotes/sidenotes.pdf
+++ b/Master/texmf-dist/doc/latex/sidenotes/sidenotes.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/sidenotes/sn.bib b/Master/texmf-dist/doc/latex/sidenotes/sn.bib
new file mode 100644
index 00000000000..faa23a7cc30
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/sidenotes/sn.bib
@@ -0,0 +1,6 @@
+@book{nobel:bcs,
+ title = {Nobel Lectures, Physics 1971-1980},
+ year = {1992},
+ publisher = {World Scientific Publishing Co., Singapore},
+ editor={Stig Lundqvist}
+} \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/sidenotes/sn_usage_bibtex.pdf b/Master/texmf-dist/doc/latex/sidenotes/sn_usage_bibtex.pdf
new file mode 100644
index 00000000000..ef10bd85d8f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/sidenotes/sn_usage_bibtex.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/sidenotes/sn_usage_bibtex.tex b/Master/texmf-dist/doc/latex/sidenotes/sn_usage_bibtex.tex
new file mode 100644
index 00000000000..f33e9faaa79
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/sidenotes/sn_usage_bibtex.tex
@@ -0,0 +1,74 @@
+\documentclass{book}
+
+\usepackage[bibtex]{sidenotes}
+
+% provide some simple layout
+\usepackage[paperwidth=210mm, paperheight=297mm, left=50pt, top=50pt, textwidth=345pt, marginparsep=25pt, marginparwidth=124pt, textheight=692pt, footskip=50pt]{geometry}
+\pagestyle{empty}
+\captionsetup{width=\marginparwidth, font=footnotesize, skip = 0pt}
+\renewcommand{\thefootnote}{\fnsymbol{footnote}}
+
+\begin{document}
+\nobibliography{sn}
+\bibliographystyle{plainnat}
+%
+\chapter{Usage of the \textbf{sidenotes} package}
+The package provides a number of macros to typeset rich content in the margin. Please read the output of this \LaTeX{} file and look at the input file while doing so. We start with the \verb+\sidenote+ macro.
+
+\section{\texttt{\textbackslash sidenote[number]\{text\}}}
+It is very similar to \verb+\footnote+ and tries to emulate its behavior.\sidenote{But like the name says, the note is put in the margin, hence the name sidenote.} It has the same parameters as footnote. The sidenote moves up or down (floats) to not overlap with other floats in the margin.\sidenote{Note how this paragraph is slightly moved down.} All the sidenotes are subsequently numbered. The first, optional parameter will manually change the numbering of the sidenote.\sidenote[666]{This note is evil.}
+
+\section{\texttt{\textbackslash sidenotemark[number]}}
+Sidenote tries to mimic the footnote behavior and provides the same solutions. Sometimes it is not possible to directly call a sidenote macro, e.g. in particular environments. Then, you can also use \verb+\sidenotemark+ macro.\sidenotemark{} If a number is given, that number is used.\sidenotemark[99]{} This puts a mark at the current position.
+
+\section{\texttt{\textbackslash sidenotetext[number]\{text\}}}
+Afterwards,\sidenotetext{Please note, how the numbering still counts from the last usual call} outside of the environment that causes the trouble, it is possible the call \verb+\sidenotetext{text}+ to actually make the sidenote. The optional parameter will again manually change the numbering of the sidenote.\sidenotetext[93]{Then, you have to make sure the number match!}
+
+\section{\texttt{\textbackslash sidestyle}}
+\renewcommand{\sidestyle}{\raggedright\footnotesize}
+You can use \verb+\renewcommand{\sidestyle}{something}+, if you want to change the font, text size, text color or something else of the sidenotes.\sidenote{Here, we changed sidestyle to raggedright.}
+\renewcommand{\sidestyle}{\footnotesize\em}
+The default value is \verb+\footnotesize+, \verb+\sidestyle+ is the prefix for all sidenotes.\sidenote{Here, we changed to \texttt{\textbackslash em}} Please note that the values do not add up, \verb+\sidestyle+ is overwritten by every use of \verb+\renewcommand{\sidestyle}{...}+.%
+\renewcommand{\sidestyle}{\footnotesize}%
+\sidenote{Back to default behavior.}
+
+\section{\texttt{\textbackslash sidecite\{citekey\}}}
+The macro \verb+\sidecite+ puts a citation in the margin. It uses the bibentry package and has the same set of parameters. We add a citation of the \textsc{bcs}-theory here as an example.\sidecite{nobel:bcs} The behavior is the same as in \verb+\sidenote+ and auto floating.
+
+\section{\texttt{\textbackslash sidecaption\{captiontext\}}}
+The \verb+\sidecaption+ macro can be used if the caption of a figure or table is supposed to be in the margin. Please note, that the formatting is done by the caption package.
+\begin{figure}[h]
+\sidecaption{I am a caption, but in the margin.}
+\fbox{\rule{\textwidth}{0mm}\rule{0mm}{1.5cm}} % \includegraphics{image}
+\end{figure}
+Simply use \verb+\sidecaption+ instead of \verb+\caption+ in the figure environment.
+
+\section{\texttt{sidefigure}}
+The sidefigure environment puts a figure and its caption in the margin. Instead of \verb+\begin{figure}+ use \verb+\begin{sidefigure}+. Please note, that the use of caption before \verb+\includegraphics+ puts the caption in line with the top of the figure and the use after \verb+\includegraphics+ puts it in line with the bottom of the actual figure. The formatting is done by the caption package.
+\begin{sidefigure}
+\fbox{\rule{0mm}{1.2cm}\rule{\marginparwidth}{0mm}} % \includegraphics{image}
+\caption{This is a figure with its caption in the margin.}
+\end{sidefigure}
+
+\section{\texttt{sidetable}}
+The sidetable environment works similarly to sidefigure, but with table environments. Use \verb+\begin{sidetable}+ instead of \verb+\begin{table}+. The formatting is also done with help of the caption package.
+\begin{sidetable}
+ \centering
+ % \fontfamily{ppl}\selectfont
+ \begin{tabular}{lllll}
+ \hline
+ Hg&Sn&Pb&Cd&Tl \\
+ \hline
+ 0.50&0.47&0.48&0.5&0.5\\
+ \end{tabular}
+ \caption{This is a table in the margin}
+\end{sidetable}
+
+\section{Technical notes and further macros}
+Sometimes it is useful to put text in the margin without a mark in the text. This can be achieved with \verb+\marginpar{text}+.
+
+The \verb+\sidecaption+ macro relies on the marginnote package by Markus Kohm and is used by the sidenotes package automatically.
+
+When writing the package, we tried to be as general as possible. Someone can e.g.\ use sidenotes mixed with footnotes.\footnote{Here, we have a footnote as well. The marker was changed to symbols to avoid confusion with the same numbers as sidenotes.} Also, the package tries to provide only functionality and does not know anything about formatting such as margin text size, color or anything else. Only \verb+\sidestyle+ was added for convenience.
+
+\end{document}
diff --git a/Master/texmf-dist/source/latex/sidenotes/sidenotes.dtx b/Master/texmf-dist/source/latex/sidenotes/sidenotes.dtx
index cafc5a6cbc2..63184c9097f 100644
--- a/Master/texmf-dist/source/latex/sidenotes/sidenotes.dtx
+++ b/Master/texmf-dist/source/latex/sidenotes/sidenotes.dtx
@@ -19,7 +19,7 @@
%</driver>
%<package>\ProvidesPackage{sidenotes}[%
%<*driver|package>
- 2011/11/10 v0.80 rich text in the margin for LaTeX]
+ 2011/11/29 v0.81 rich text in the margin for LaTeX]
%</driver|package>
%<package>\RequirePackage{marginnote} % puts the stuff in the margin and provides an offset option instead of a float
%<package>\RequirePackage{caption} % handles the figure caption (in the margin)
@@ -182,6 +182,7 @@
% Introduce the sidenote macro with an additional optional argument postfix to set the offset.
% \changes{v0.53}{2011/10/07}{bugfix, now optional number and offset possible}
% \changes{v0.80}{2011/11/10}{unstar the newcommand.}
+% \changes{v0.81}{2011/11/29}{added a comma between subsequent sidenotes}
% \begin{macrocode}
\newcommand{\sidenote}[2][]{%
\ifthenelse{\isempty{#1}}%
@@ -189,6 +190,7 @@
\sidenotetext{#2}}%
{\sidenotemark[#1]%
\sidenotetext[#1]{#2}}%
+\@ifnextchar\sidenote{\kern-0.07em\textsuperscript{,}}{\@ifnextchar\sidecite{\kern-0.07em\textsuperscript{,}}{ }}%
}
% \end{macrocode}
% \end{macro}
@@ -205,6 +207,7 @@
\setcounter{sidenote}{#1}%
\textsuperscript{\thesidenote}% print out the argument otherwise
\setcounter{sidenote}{\value{@sidenotes@buffer}}}%
+\@ifnextchar\sidenote{\textsuperscript{,}}{}%
\ignorespaces%
}%
% \end{macrocode}
diff --git a/Master/texmf-dist/tex/latex/sidenotes/sidenotes.sty b/Master/texmf-dist/tex/latex/sidenotes/sidenotes.sty
index 477c72a6d06..0337e8ee4d8 100644
--- a/Master/texmf-dist/tex/latex/sidenotes/sidenotes.sty
+++ b/Master/texmf-dist/tex/latex/sidenotes/sidenotes.sty
@@ -13,7 +13,7 @@
%% about the files the work consists of.
%%
\ProvidesPackage{sidenotes}[%
- 2011/11/10 v0.80 rich text in the margin for LaTeX]
+ 2011/11/29 v0.81 rich text in the margin for LaTeX]
\RequirePackage{marginnote} % puts the stuff in the margin and provides an offset option instead of a float
\RequirePackage{caption} % handles the figure caption (in the margin)
\RequirePackage{xifthen} % provide an if command
@@ -33,6 +33,7 @@
\sidenotetext{#2}}%
{\sidenotemark[#1]%
\sidenotetext[#1]{#2}}%
+\@ifnextchar\sidenote{\kern-0.07em\textsuperscript{,}}{\@ifnextchar\sidecite{\kern-0.07em\textsuperscript{,}}{ }}%
}
\newcommand{\sidenotemark}[1][]{%
\nobreak\hspace{0.1pt}\nobreak%
@@ -43,6 +44,7 @@
\setcounter{sidenote}{#1}%
\textsuperscript{\thesidenote}% print out the argument otherwise
\setcounter{sidenote}{\value{@sidenotes@buffer}}}%
+\@ifnextchar\sidenote{\textsuperscript{,}}{}%
\ignorespaces%
}%
\newcommand{\sidenotetext}[2][]{%