summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-11-13 22:50:57 +0000
committerKarl Berry <karl@freefriends.org>2018-11-13 22:50:57 +0000
commitcaa540d3bd4bf29e24b6b489629f0a57b4e29dfe (patch)
tree7fb0c88ba197462094e58167677d92d67c8420b5
parent5f97f13bf9ebf60fb05b259ac1671e1534aa62ec (diff)
eqexpl (13nov18)
git-svn-id: svn://tug.org/texlive/trunk@49151 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/texmf-dist/doc/latex/eqexpl/README.md36
-rw-r--r--Master/texmf-dist/doc/latex/eqexpl/README.ru.md37
-rw-r--r--Master/texmf-dist/doc/latex/eqexpl/eqexpl.pdfbin0 -> 87920 bytes
-rw-r--r--Master/texmf-dist/doc/latex/eqexpl/eqexpl.tex246
-rw-r--r--Master/texmf-dist/tex/latex/eqexpl/eqexpl.sty72
-rwxr-xr-xMaster/tlpkg/bin/tlpkg-ctan-check2
-rw-r--r--Master/tlpkg/tlpsrc/collection-mathscience.tlpsrc1
-rw-r--r--Master/tlpkg/tlpsrc/eqexpl.tlpsrc0
8 files changed, 393 insertions, 1 deletions
diff --git a/Master/texmf-dist/doc/latex/eqexpl/README.md b/Master/texmf-dist/doc/latex/eqexpl/README.md
new file mode 100644
index 00000000000..f7459febc42
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/eqexpl/README.md
@@ -0,0 +1,36 @@
+Explanation of the formulas in LaTeX
+========
+
+The package is licenced under Creative Commons Attribution-ShareAlike
+4.0 International (CC BY-SA 4.0).
+
+The package was developed as an answer to question [on tex.stackexchange.com](https://tex.stackexchange.com/q/95838/119485)
+
+Package `eqexpl` was developed to give the tool to make «perfect»
+explanation to formulas, not just the enumeration.
+
+ I = U / Rs, (1)
+
+ where U --- voltage at the section, V;
+ Rs --- total section resis-
+ tance, Ohm.
+
+Requirements:
+1. The variables (left side) must be aligned right.
+2. The dash must be aligned center one under another.
+3. The explanation (right side) must be justified, the last string
+ must be aligned left and
+ - if the explanation takes more than one line, the left side of
+ explanation must be aligned (second explanation in the example).
+
+The package adds new environment `eqexpl` with a command `\item` with
+one required parameter --- variable to explain. The explanation in
+the example above was made with the code
+
+ \begin{eqexpl}
+ \item{U} voltage at the section, V;
+ \item{Rs} total section resistance, Ohm.
+ \end{exqexpl}
+
+See example `eqexpl.tex` for more details. You can compile it with
+`pdflatex eqexpl.tex`.
diff --git a/Master/texmf-dist/doc/latex/eqexpl/README.ru.md b/Master/texmf-dist/doc/latex/eqexpl/README.ru.md
new file mode 100644
index 00000000000..fe2d720aea7
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/eqexpl/README.ru.md
@@ -0,0 +1,37 @@
+Пояснения к формулам в LaTeX
+========
+
+Пакет распространяется по лицензии Creative Commons
+Attribution-ShareAlike 4.0 International (CC BY-SA 4.0).
+
+Пакет был разработан в качестве ответа на вопрос [на tex.stackexchange.com](https://tex.stackexchange.com/q/95838/119485)
+
+Пакет `eqexpl` был разработан для того, чтобы обеспечить возможность
+давать формулам более осмысленные пояснения, оформление которых
+отличается от простого перечисления.
+
+ I = U / Rs, (1)
+
+ где U --- напряжение на участке, В;
+ Rs --- суммарное сопротивление
+ участка, Ом.
+
+Требования к оформлению:
+1. Поясняемые переменные выравниваются по правому краю.
+2. Тире пояснения выравниваются по центру друг под другом.
+3. Пояснения выравниваются по ширине, последняя строка выравнивается
+ по левому краю, при этом
+ - если левый край пояснения занимает более одной строки, строки
+ должны быть выровнены слева (второе пояснение).
+
+Пакет добавляет новое окружение `eqexpl`, внутри которого команда
+перечисления `\item` имеет обязательный параметр --- поясняемую
+переменную. Пояснение выше выполненяется следующим образом
+
+ \begin{eqexpl}
+ \item{U} напряжение на участке, В;
+ \item{Rs} суммарное сопротивление участка, Ом.
+ \end{exqexpl}
+
+Подробнее смотрите `eqexpl.tex`. Вы можете собрать его с помощью
+команды `pdflatex eqexpl.tex`.
diff --git a/Master/texmf-dist/doc/latex/eqexpl/eqexpl.pdf b/Master/texmf-dist/doc/latex/eqexpl/eqexpl.pdf
new file mode 100644
index 00000000000..d732f6ec105
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/eqexpl/eqexpl.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/eqexpl/eqexpl.tex b/Master/texmf-dist/doc/latex/eqexpl/eqexpl.tex
new file mode 100644
index 00000000000..98fbce150d0
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/eqexpl/eqexpl.tex
@@ -0,0 +1,246 @@
+\documentclass{article}
+\usepackage[T2A,T1]{fontenc}
+\usepackage[utf8]{inputenc}
+\usepackage{hyperref}
+\usepackage{eqexpl}
+
+\begin{document}
+
+\title{eqexpl}
+\author{Konstantin Morenko}
+
+\maketitle
+
+The package is licenced under Creative Commons Attribution-ShareAlike
+4.0 International (CC BY-SA 4.0)
+
+\section{The aim of the package}
+
+The package was developed as an answer to question \href{https://tex.stackexchange.com/q/95838/119485}{on tex.stackexchange.com}
+
+Package was developed to give the tool to make <<perfect>> explanation
+for formulas, not just the enumeration.
+
+\section{Similar packages}
+
+Nomencl: \href{http://ctan.org/pkg/nomencl}{http://ctan.org/pkg/nomencl}
+
+\section{Contributors}
+
+Konstantin Morenko \href{mailto:me@konstantin-morenko.ru}{me@konstantin-morenko.ru}
+
+The package currently hosted on GitHub:
+\href{https://github.com/konstantin-morenko/latex-equation-explanation}{https://github.com/konstantin-morenko/latex-equation-explanation}
+
+\section{Architecture}
+
+The list consist of few lengths:
+\begin{itemize}
+\item width of <<intro>> section (default is empty, 0pt);
+\item width of spaces between elements (default is 2mm);
+\item width of item block (default is 5mm);
+\item width of separator (default is '---');
+\item the rest of the width of a text (used to align left side of the
+ explanation text).
+\end{itemize}
+
+\section{Test list}
+
+\newcommand{\testList}{
+\item{U} voltage at the section, V;
+\item{Rs} total section resistance, Ohm.
+\item{$Very^{46}$}very very very very very very very very very very very
+ very very very very very very very very very very very very very
+ very very very very very very very very very very very very very
+ very very very very very very very very very long line;
+}
+
+This list used for all examples:
+\begin{eqexpl}
+ \testList
+\end{eqexpl}
+
+\section{Configure and examples}
+
+\subsection{Setting eqexplSetSpace}
+
+\noindent Set \verb+\eqexplSetSpace{0mm}+
+
+\eqexplSetSpace{0mm}
+\begin{eqexpl}
+ \testList
+\end{eqexpl}
+
+\vspace{5mm}
+
+\noindent Set \verb+\eqexplSetSpace{}+ (default 2mm)
+
+\eqexplSetSpace{}
+\begin{eqexpl}
+ \testList
+\end{eqexpl}
+
+\vspace{5mm}
+
+\noindent Set \verb+\eqexplSetSpace{10mm}+
+
+\eqexplSetSpace{10mm}
+\begin{eqexpl}
+ \testList
+\end{eqexpl}
+
+\eqexplSetSpace{}
+
+\subsection{Setting eqexplSetIntro}
+
+\noindent Set \verb+\eqexplSetIntro{where}+
+
+\eqexplSetIntro{where}
+\begin{eqexpl}
+ \testList
+\end{eqexpl}
+
+\vspace{5mm}
+
+\noindent Set \verb+\eqexplSetIntro{where we have}+
+
+\eqexplSetIntro{where we have}
+\begin{eqexpl}
+ \testList
+\end{eqexpl}
+
+\eqexplSetIntro{}
+
+\subsection{Setting eqexplSetDelim}
+
+\noindent Set \verb+\eqexplSetDelim{---}+ (default)
+
+\eqexplSetDelim{---}
+\begin{eqexpl}
+ \testList
+\end{eqexpl}
+
+\vspace{5mm}
+
+\noindent Set \verb+\eqexplSetDelim{=}+
+
+\eqexplSetDelim{=}
+\begin{eqexpl}
+ \testList
+\end{eqexpl}
+
+\vspace{5mm}
+
+\noindent Set \verb+\eqexplSetDelim{$\to$}+
+
+\eqexplSetDelim{$\to$}
+\begin{eqexpl}
+ \testList
+\end{eqexpl}
+
+\eqexplSetDelim{---}
+
+\subsection{Setting eqexplSetItemWidth}
+
+\noindent Set \verb+\eqexplSetItemWidth{5mm}+ (default)
+
+\eqexplSetItemWidth{5mm}
+\begin{eqexpl}
+ \testList
+\end{eqexpl}
+
+\vspace{5mm}
+
+\noindent Set \verb+\eqexplSetItemWidth{10mm}+
+
+\eqexplSetItemWidth{10mm}
+\begin{eqexpl}
+ \testList
+\end{eqexpl}
+
+\eqexplSetItemWidth{5mm}
+
+\subsection{Setting item width for 'begin-end' block}
+
+When we have a long variable name (for example \verb+very-very-long+),
+it could lead us to overhelming the variable name as in example below
+
+\begin{eqexpl}
+ \item{$long$} just variable
+ \item{$very-long$} just variable
+ \item{$very-very-long$} just variable
+\end{eqexpl}
+
+User could set a parameter to environment to use custom item width for
+current block in opposition to setting it before block to new value
+and unsetting it to default after the end of the block. For this
+purpose use \verb+\begin{eqexpl}[width]+.
+
+\noindent Set \verb+\begin{eqexpl}[10mm]+
+
+\begin{eqexpl}[10mm]
+ \item{$long$} just variable
+ \item{$very-long$} just variable
+ \item{$very-very-long$} just variable
+\end{eqexpl}
+
+\vspace{5mm}
+
+\noindent Test for backing to default in next block
+
+\begin{eqexpl}
+ \item{$long$} just variable
+ \item{$very-long$} just variable
+ \item{$very-very-long$} just variable
+\end{eqexpl}
+
+\vspace{5mm}
+
+\noindent Set \verb+\begin{eqexpl}[20mm]+
+
+\begin{eqexpl}[20mm]
+ \item{$long$} just variable
+ \item{$very-long$} just variable
+ \item{$very-very-long$} just variable
+\end{eqexpl}
+
+\vspace{5mm}
+
+\noindent Test for backing to default in next block
+
+\begin{eqexpl}
+ \item{$long$} just variable
+ \item{$very-long$} just variable
+ \item{$very-very-long$} just variable
+\end{eqexpl}
+
+\subsection{Setting eqexplItemAlign}
+
+\noindent Set \verb+\eqexplSetItemAlign{r}+ (default)
+
+\eqexplSetItemAlign{r}
+\begin{eqexpl}
+ \testList
+\end{eqexpl}
+
+\vspace{5mm}
+
+\noindent Set \verb+\eqexplSetItemAlign{l}+
+
+\eqexplSetItemAlign{l}
+\begin{eqexpl}
+ \testList
+\end{eqexpl}
+
+\vspace{5mm}
+
+\noindent Set \verb+\eqexplSetItemAlign{c}+
+
+\eqexplSetItemAlign{c}
+\begin{eqexpl}
+ \testList
+\end{eqexpl}
+
+\eqexplSetItemAlign{r}
+
+\end{document}
diff --git a/Master/texmf-dist/tex/latex/eqexpl/eqexpl.sty b/Master/texmf-dist/tex/latex/eqexpl/eqexpl.sty
new file mode 100644
index 00000000000..e07d7d9797b
--- /dev/null
+++ b/Master/texmf-dist/tex/latex/eqexpl/eqexpl.sty
@@ -0,0 +1,72 @@
+\ProvidesPackage{eqexpl}[2018/11/11 v.1]
+\RequirePackage{etoolbox}
+\RequirePackage{calc}
+
+%% Spaces between elements
+\newlength{\eqexplSpaceWidth}
+\newcommand{\eqexplSetSpace}[1]{%
+ \setlength{\eqexplSpaceWidth}{\ifstrempty{#1}{2mm}{#1}}%
+}
+\eqexplSetSpace{}
+
+%% Width of 'intro' (typ. 'where')
+\newcommand{\eqexplSetIntro}[1]{%
+ \def\eqexplIntro{#1}%
+}
+\eqexplSetIntro{}
+
+%% Width of delimiter
+\newcommand{\eqexplSetDelim}[1]{%
+ \def\eqexplDelim{#1}%
+}
+\eqexplSetDelim{---}
+
+%% Width of item
+\newcommand{\eqexplSetItemWidth}[1]{%
+ \def\eqexplItemWidth{#1}%
+}
+\eqexplSetItemWidth{5mm}
+
+%% Align of item
+\newcommand{\eqexplSetItemAlign}[1]{%
+ \def\eqexplItemAlign{#1}%
+}
+\eqexplSetItemAlign{r}
+
+\newlength{\itemWidth}
+\newlength{\leftSideWidth}
+
+\newenvironment{eqexpl}[1][\eqexplItemWidth]{%
+ \let\olditem\item%
+ \setlength{\itemWidth}{#1}%
+ \setlength{\leftSideWidth}{\ifdefempty{\eqexplIntro}{}{\widthof{\eqexplIntro}+%
+ \eqexplSpaceWidth+}%
+ \itemWidth+%
+ \eqexplSpaceWidth+%
+ \widthof{\eqexplDelim}+%
+ \eqexplSpaceWidth}%
+ \newtoggle{eqexplFirstItem}%
+ \toggletrue{eqexplFirstItem}%
+ \renewcommand{\item}[1]{%
+ \olditem \makebox[\leftSideWidth]{%
+ \ifdefempty{\eqexplIntro}{}{
+ \makebox[\widthof{\eqexplIntro}][l]{\iftoggle{eqexplFirstItem}{\eqexplIntro}{}}%
+ \hspace{\eqexplSpaceWidth}%
+ }
+ \makebox[\itemWidth][\eqexplItemAlign]{##1}%
+ \hspace{\eqexplSpaceWidth}%
+ \makebox[\widthof{\eqexplDelim}][c]{\eqexplDelim}%
+ \hspace{\eqexplSpaceWidth}%
+ }%
+ \togglefalse{eqexplFirstItem}%
+ \ignorespaces% https://tex.stackexchange.com/a/44062
+ }%
+ \begin{list}{}{\setlength{\parsep}{0pt}%
+ \setlength{\topsep}{0pt}%
+ \setlength{\itemsep}{0pt}%
+ \setlength{\labelsep}{0pt}%
+ \setlength{\leftmargin}{\leftSideWidth}%
+ \setlength{\itemindent}{-\leftSideWidth}}}{%
+ \end{list}
+}
+\endinput
diff --git a/Master/tlpkg/bin/tlpkg-ctan-check b/Master/tlpkg/bin/tlpkg-ctan-check
index fa765db5193..571b2a557de 100755
--- a/Master/tlpkg/bin/tlpkg-ctan-check
+++ b/Master/tlpkg/bin/tlpkg-ctan-check
@@ -251,7 +251,7 @@ my @TLP_working = qw(
epigrafica epigram epigraph epiolmec eplain
epsdice epsf epsf-dvipdfmx epsincl epslatex-fr
epspdf epspdfconversion epstopdf
- eqell eqlist eqnalign eqname eqnarray eqnnumwarn eqparbox
+ eqell eqexpl eqlist eqnalign eqname eqnarray eqnnumwarn eqparbox
erdc erewhon errata erw-l3
esami es-tex-faq esdiff esint esint-type1 esk eskd eskdx
eso-pic esrelation esstix estcpmm esvect
diff --git a/Master/tlpkg/tlpsrc/collection-mathscience.tlpsrc b/Master/tlpkg/tlpsrc/collection-mathscience.tlpsrc
index 5df620ce2dd..4ae30bf983e 100644
--- a/Master/tlpkg/tlpsrc/collection-mathscience.tlpsrc
+++ b/Master/tlpkg/tlpsrc/collection-mathscience.tlpsrc
@@ -67,6 +67,7 @@ depend eltex
depend emf
depend endiagram
depend engtlc
+depend eqexpl
depend eqnarray
depend eqnnumwarn
depend extarrows
diff --git a/Master/tlpkg/tlpsrc/eqexpl.tlpsrc b/Master/tlpkg/tlpsrc/eqexpl.tlpsrc
new file mode 100644
index 00000000000..e69de29bb2d
--- /dev/null
+++ b/Master/tlpkg/tlpsrc/eqexpl.tlpsrc