summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/changelog
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2019-07-07 20:21:15 +0000
committerKarl Berry <karl@freefriends.org>2019-07-07 20:21:15 +0000
commit4bb8268658d74c470f29e6f75b2e7dca72b0f134 (patch)
tree39b0274415cb012b47bd17d49d0ac4aa08d6d683 /Master/texmf-dist/doc/latex/changelog
parentd2feb6daf6bb87d92a2a816be0e5c0633ea29e3a (diff)
changelog (7jul19)
git-svn-id: svn://tug.org/texlive/trunk@51574 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/changelog')
-rw-r--r--Master/texmf-dist/doc/latex/changelog/changelog.pdfbin41606 -> 46076 bytes
-rw-r--r--Master/texmf-dist/doc/latex/changelog/changelog.tex89
2 files changed, 75 insertions, 14 deletions
diff --git a/Master/texmf-dist/doc/latex/changelog/changelog.pdf b/Master/texmf-dist/doc/latex/changelog/changelog.pdf
index d93f161a082..bc54571d96f 100644
--- a/Master/texmf-dist/doc/latex/changelog/changelog.pdf
+++ b/Master/texmf-dist/doc/latex/changelog/changelog.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/changelog/changelog.tex b/Master/texmf-dist/doc/latex/changelog/changelog.tex
index 5802746cdc2..22a62221959 100644
--- a/Master/texmf-dist/doc/latex/changelog/changelog.tex
+++ b/Master/texmf-dist/doc/latex/changelog/changelog.tex
@@ -1,4 +1,11 @@
\documentclass{ltxguidex}
+% for demonstrating translations
+\usepackage[german, american]{babel}
+%\babelprovide{chinese}
+%\usepackage{translations}
+%\DeclareLanguage{Chinese}
+%\DeclareTranslation{Chinese}{changelog-added}{新增}
+
\usepackage{fontspec}
\errorcontextlines=10
\usepackage{changelog}
@@ -6,19 +13,6 @@
\newcommand{\cl}{\ctan{changelog}}
\newcommand{\keepachangelog}{\https{keepachangelog.com}}
-% a list of colors; use \color{colorname}
-\makeatletter
-\newenvironment{colorlist}
- {\begin{itemize}
- \let\old@item\item
- \renewcommand{\item}[1]{%
- \old@item[\fcolorbox{black}{##1}{\vphantom{X}\hspace{1em}}]
- \texttt{##1}
- }
- }
- {\end{itemize}}
-\makeatother
-
\makeatletter
\renewcommand{\SX@explpreset}{
language=[LaTeX]TeX,
@@ -39,7 +33,7 @@
\author{Rebecca Turner\thanks{Brandeis University; \email{rebeccaturner@brandeis.edu}}}
\title{The \cl\ Package}
-\date{2019/04/15 2.0.0}
+\date{2019/07/06 2.1.0}
\begin{document}
\maketitle
@@ -259,11 +253,78 @@ Prints the ``revoked release'' notice:
\href{https://keepachangelog.com/en/1.0.0/#yanked}{yanked releases on
\texttt{keepachangelog.com}}.
+\section{Translations}
+
+Want to use \cl\ in a non-English document? Great! Thanks to a contribution
+by Holger Schieferdecker (see section~\ref{s:contrib} below), \cl\ comes
+with translations for English, German, and support for adding new
+translations. To use built-in translations, simply load \ctan{babel} with
+the desired language:
+\begin{otherlanguage}{german}
+\begin{LTXexample}
+% In the preamble:
+% \usepackage[german]{babel}
+
+\begin{changelog}[section=false, author=Holger Schieferdecker]
+ \begin{version}[v=1.0.0]
+ \added
+ \item Features!
+ \end{version}
+\end{changelog}
+\end{LTXexample}
+\end{otherlanguage}
+
+\subsection{Creating new translations}
+
+\cl\ uses the \ctan{translations} package to provide translations, and a
+complete translation looks like this:
+\begin{latexcode}
+\documentclass{article}
+\usepackage[english]{babel}
+\usepackage{translations}
+\DeclareTranslation{English}{changelog-Added}{Added}
+\DeclareTranslation{English}{changelog-Changed}{Changed}
+\DeclareTranslation{English}{changelog-Deprecated}{Deprecated}
+\DeclareTranslation{English}{changelog-Removed}{Removed}
+\DeclareTranslation{English}{changelog-Fixed}{Fixed}
+\DeclareTranslation{English}{changelog-Security}{Security}
+\DeclareTranslation{English}{changelog-Miscellaneous}{Miscellaneous}
+\DeclareTranslation{English}{changelog-Unreleased}{Unreleased}
+\DeclareTranslation{English}{changelog-Yanked}{YANKED}
+\begin{document}
+% ...
+\end{document}
+\end{latexcode}
+Refer to the
+\href{http://mirrors.ctan.org/macros/latex/contrib/translations/translations_en.pdf}{\texttt{translations}
+package documentation} and the
+\href{http://mirrors.ctan.org/macros/latex/required/babel/base/babel.pdf}{\texttt{babel}
+package documentation} for more information.
+
+If you create a translation, please \href{mailto:637275@gmail.com}{send me
+an email} and I'll incorporate the translation into \cl's next release!
+
+\section{Contributors}%
+\label{s:contrib}
+
+\begin{description}
+ \item[Rebecca Turner] Original implementation.
+ \item[Holger Schieferdecker]
+ Internationalization support and German translations.
+\end{description}
+
\section{Changelog}
This is this package's actual changelog --- not an example!
\begin{changelog}[author=Rebecca Turner, section=false]
+\begin{version}[v=2.1.0, date=2019-06-29,
+ author={Holger Schieferdecker}]
+\added
+ \item Internationalization support.
+ \item German translations.
+\end{version}
+
\begin{version}[v=2.0.0, date=2019-04-15]
\added
\item Better error handling; more informative messages for empty