summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/lualatex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2020-05-07 21:27:27 +0000
committerKarl Berry <karl@freefriends.org>2020-05-07 21:27:27 +0000
commit4f11b4d0bdb77414ff4011c754536656f7708bf0 (patch)
tree3c118dfe94ed718aa12cd55783b9a69cba86a9bd /Master/texmf-dist/doc/lualatex
parent5fc116fc34329b711fe6a8a155f71c42a5ff03c7 (diff)
unitconv (7may20)
git-svn-id: svn://tug.org/texlive/trunk@55060 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/lualatex')
-rw-r--r--Master/texmf-dist/doc/lualatex/unitconv/Changes1
-rw-r--r--Master/texmf-dist/doc/lualatex/unitconv/README.md16
-rw-r--r--Master/texmf-dist/doc/lualatex/unitconv/unitconv-doc.pdfbin0 -> 69514 bytes
-rw-r--r--Master/texmf-dist/doc/lualatex/unitconv/unitconv-doc.tex216
4 files changed, 233 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/lualatex/unitconv/Changes b/Master/texmf-dist/doc/lualatex/unitconv/Changes
new file mode 100644
index 00000000000..bf2c7386aa1
--- /dev/null
+++ b/Master/texmf-dist/doc/lualatex/unitconv/Changes
@@ -0,0 +1 @@
+0.01 2020-05-07 - first CTAN version
diff --git a/Master/texmf-dist/doc/lualatex/unitconv/README.md b/Master/texmf-dist/doc/lualatex/unitconv/README.md
new file mode 100644
index 00000000000..8bef4b5b655
--- /dev/null
+++ b/Master/texmf-dist/doc/lualatex/unitconv/README.md
@@ -0,0 +1,16 @@
+# README #
+Package unitconv can conver t a TeX length or a given
+value with unit into another unit, Supported are all
+TeX units and also m and km. The output can be in
+scientic notation for large values.
+
+This package needs lualatex!
+
+% This file is distributed under the terms of the LaTeX Project Public
+% License from CTAN archives in directory macros/latex/base/lppl.txt.
+% Either version 1.3 or, at your option, any later version.
+%
+% Copyright 2020 Herbert Voss hvoss@tug.org
+%
+
+%% $Id: README.md 1177 2020-05-07 15:38:43Z herbert $
diff --git a/Master/texmf-dist/doc/lualatex/unitconv/unitconv-doc.pdf b/Master/texmf-dist/doc/lualatex/unitconv/unitconv-doc.pdf
new file mode 100644
index 00000000000..6932069f0d5
--- /dev/null
+++ b/Master/texmf-dist/doc/lualatex/unitconv/unitconv-doc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/lualatex/unitconv/unitconv-doc.tex b/Master/texmf-dist/doc/lualatex/unitconv/unitconv-doc.tex
new file mode 100644
index 00000000000..c0dfa1de4b1
--- /dev/null
+++ b/Master/texmf-dist/doc/lualatex/unitconv/unitconv-doc.tex
@@ -0,0 +1,216 @@
+%% $Id: unitconv-doc.tex 1177 2020-05-07 15:38:43Z herbert $
+\listfiles
+\documentclass[english,parskip=half]{scrartcl}
+\usepackage{libertinus}
+\setmonofont[Scale=MatchLowercase,FakeStretch=0.9]{AnonymousPro}
+\usepackage{babel}
+\usepackage[autostyle]{csquotes}
+
+\usepackage{unitconv}
+\usepackage{showexpl,xltabular,nicefrac,booktabs}
+\lstset{basicstyle=\ttfamily\small}
+
+\title{Convert a length into one with another unit
+with Lua\TeX}
+\author{Herbert Voß}
+\parindent=0pt
+
+\begin{document}
+\maketitle
+\tableofcontents
+\section{Using}
+
+\begin{verbatim}
+\usepackage{unitconv}
+\end{verbatim}
+
+
+\section{Macros}
+
+\begin{verbatim}
+\convTeXLength*[<unit>][<digits>]{<TeX length>}
+\convLength*[<unit>][<digits>]{<value>}[<unit>]
+\end{verbatim}
+
+The star version prints the number in scientific notation.
+The default setting for the unit is \verb|cm|
+and for the number of digits \verb|-1| (print all digits).
+The dynamic units \verb|em|, \verb|ex|, and \verb|mu| depend on the
+current fontsize.
+
+\begin{itemize}
+\item This package works only with \verb|lualatex|!
+\item With \textsf{AmsMath} you have to load the package before \texttt{unitconv}.
+\end{itemize}
+
+
+\section{The units}
+
+\def\Index#1{#1}%
+\begin{tabular}{@{}>{\bfseries\ttfamily}c l @{}}\toprule
+\rmfamily\normalfont\emph{Short}& \emph{Long} \\\midrule
+\Index{bp} & Big Point (72\,bp/in) \\
+\Index{cc} & Cîcero (1\,cc=12\,dd) \\
+\Index{cm} & Centimeter \\
+\Index{dd} & Didôt ($1157\,\mathrm{dd}=1238\,\mathrm{pt}$) \\
+\Index{em} & Width of »M« in the current font \\
+\Index{ex} & Height of »x« in the current font \\
+\Index{in} & Inch (72.27\,pt) \\
+\Index{km} & Kilometer \\
+\Index{m} & Meter \\
+\Index{mm} & Millimeter \\
+\Index{mu} & Math unit (1\,mu=\nicefrac{1}{18}em) \\
+\Index{pc} & Pica (12\,pt/pc) \\
+\Index{pt} & (\TeX-)Points ($\nicefrac{1}{72.27}$\,Inch) \\
+\Index{px} & Pixel, 1\,px=\nicefrac{1}{72}in (pdf\TeX)\\
+\Index{sp} & Scaled Point (65536\,sp/pt) \\
+\bottomrule
+\end{tabular}
+
+
+\section{Examples}
+\subsection{Converting a \TeX\ length}
+
+\begin{LTXexample}[width=0.5\linewidth]
+The current example linewidth is
+\the\linewidth, which is
+
+\convTeXLength{\linewidth}\\
+\convTeXLength[bp]{\linewidth}\\
+\convTeXLength[cc]{\linewidth}\\
+\convTeXLength[dd]{\linewidth}\\
+\convTeXLength[em]{\linewidth}\\
+\convTeXLength[ex]{\linewidth}\\
+\convTeXLength[in]{\linewidth}\\
+\convTeXLength[km]{\linewidth}\\
+\convTeXLength[m]{\linewidth}\\
+\convTeXLength[mm]{\linewidth}\\
+\convTeXLength[mu]{\linewidth}\\
+\convTeXLength[pc]{\linewidth}\\
+\convTeXLength[pt]{\linewidth}\\
+\convTeXLength[px]{\linewidth}\\
+\convTeXLength*[sp]{\linewidth}
+\end{LTXexample}
+
+\begin{LTXexample}[width=0.5\linewidth]
+The current character width of M
+is 1\,em, which is
+
+\convTeXLength{1em}\\
+\convTeXLength[bp]{1em}\\
+\convTeXLength[cc]{1em}\\
+\convTeXLength[dd]{1em}\\
+\convTeXLength[em]{1em}\\
+\convTeXLength[ex]{1em}\\
+\convTeXLength[in]{1em}\\
+\convTeXLength[km]{1em}\\
+\convTeXLength[m]{1em}\\
+\convTeXLength[mm]{1em}\\
+\convTeXLength[mu]{1em}\\
+\convTeXLength[pc]{1em}\\
+\convTeXLength[pt]{1em}\\
+\convTeXLength[px]{1em}\\
+\convTeXLength*[sp]{1em}
+\end{LTXexample}
+
+
+\begin{LTXexample}[width=0.5\linewidth]
+The current example linewidth is
+\the\linewidth, which is
+
+\convTeXLength[bp][3]{\linewidth}\\
+\convTeXLength[cc][3]{\linewidth}\\
+\convTeXLength[cm][3]{\linewidth}\\
+\convTeXLength[dd][3]{\linewidth}\\
+\convTeXLength[em][3]{\linewidth}\\
+\convTeXLength[ex][3]{\linewidth}\\
+\convTeXLength[in][3]{\linewidth}\\
+\convTeXLength[km][3]{\linewidth}\\
+\convTeXLength[m][3]{\linewidth}\\
+\convTeXLength[mm][3]{\linewidth}\\
+\convTeXLength[mu][3]{\linewidth}\\
+\convTeXLength[pc][3]{\linewidth}\\
+\convTeXLength[pt][3]{\linewidth}\\
+\convTeXLength[px][3]{\linewidth}\\
+\convTeXLength*[sp][3]{\linewidth}
+\end{LTXexample}
+
+\begin{LTXexample}[width=0.5\linewidth]
+The current width of the letter M is
+1\,em, which is
+
+\convTeXLength[bp][3]{1em}\\
+\convTeXLength[cc][3]{1em}\\
+\convTeXLength[cm][3]{1em}\\
+\convTeXLength[dd][3]{1em}\\
+\convTeXLength[em][3]{1em}\\
+\convTeXLength[ex][3]{1em}\\
+\convTeXLength[in][3]{1em}\\
+\convTeXLength[km][3]{1em}\\
+\convTeXLength[m][3]{1em}\\
+\convTeXLength[mm][3]{1em}\\
+\convTeXLength[mu][3]{1em}\\
+\convTeXLength[pc][3]{1em}\\
+\convTeXLength[pt][3]{1em}\\
+\convTeXLength[px][3]{1em}\\
+\convTeXLength*[sp][3]{1em}
+\end{LTXexample}
+
+\begin{LTXexample}[width=0.5\linewidth]
+The current example linewidth is
+\the\linewidth, which is
+
+\convTeXLength[bp][-1]{\linewidth}\\
+\convTeXLength[cc][0]{\linewidth}\\
+\convTeXLength[cm][1]{\linewidth}\\
+\convTeXLength[dd][2]{\linewidth}\\
+\convTeXLength[em][3]{\linewidth}\\
+\convTeXLength[ex][4]{\linewidth}\\
+\convTeXLength[in][5]{\linewidth}\\
+\convTeXLength[km][6]{\linewidth}\\
+\convTeXLength[m][7]{\linewidth}\\
+\convTeXLength[mm][8]{\linewidth}\\
+\convTeXLength[mu][9]{\linewidth}\\
+\convTeXLength[pc][10]{\linewidth}\\
+\convTeXLength[pt][11]{\linewidth}\\
+\convTeXLength[px][12]{\linewidth}\\
+\convTeXLength*[sp][13]{\linewidth}
+\end{LTXexample}
+
+
+
+\begin{LTXexample}[width=0.5\linewidth]
+\convTeXLength[em][2]{1}\\ % default is cm
+\convTeXLength[em][2]{2}\\
+\convTeXLength[em][2]{3}
+\end{LTXexample}
+
+
+
+\begin{LTXexample}[width=0.5\linewidth]
+The current example linewidth is
+\the\linewidth, which is
+
+\convTeXLength[em][2]{\linewidth}\\
+\convTeXLength[ex][2]{\linewidth}\\
+\convTeXLength[mu][2]{\linewidth}
+
+\Huge Test\\
+\convTeXLength[em][2]{\linewidth}\\
+\convTeXLength[ex][2]{\linewidth}\\
+\convTeXLength[mu][2]{\linewidth}
+\end{LTXexample}
+
+\subsection{Converting a value with given unit into another one}
+
+\begin{LTXexample}[width=0.5\linewidth]
+\convLength[m]{1.2345}[km]\\
+\convLength[cm]{1.2345}[km]\\
+\convLength*[mm]{1.2345}[km]\\
+\convLength[bp]{1.2345}[km]\\
+\convLength[km][4]{3499402.985833}[bp]
+\end{LTXexample}
+
+
+
+\end{document}