From 4f11b4d0bdb77414ff4011c754536656f7708bf0 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 7 May 2020 21:27:27 +0000 Subject: unitconv (7may20) git-svn-id: svn://tug.org/texlive/trunk@55060 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/lualatex/unitconv/Changes | 1 + Master/texmf-dist/doc/lualatex/unitconv/README.md | 16 ++ .../doc/lualatex/unitconv/unitconv-doc.pdf | Bin 0 -> 69514 bytes .../doc/lualatex/unitconv/unitconv-doc.tex | 216 +++++++++++++++++++++ 4 files changed, 233 insertions(+) create mode 100644 Master/texmf-dist/doc/lualatex/unitconv/Changes create mode 100644 Master/texmf-dist/doc/lualatex/unitconv/README.md create mode 100644 Master/texmf-dist/doc/lualatex/unitconv/unitconv-doc.pdf create mode 100644 Master/texmf-dist/doc/lualatex/unitconv/unitconv-doc.tex (limited to 'Master/texmf-dist/doc/lualatex') 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 Binary files /dev/null and b/Master/texmf-dist/doc/lualatex/unitconv/unitconv-doc.pdf 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*[][]{} +\convLength*[][]{}[] +\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} -- cgit v1.2.3