summaryrefslogtreecommitdiff
path: root/support/texplate/doc
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2020-02-03 03:02:01 +0000
committerNorbert Preining <norbert@preining.info>2020-02-03 03:02:01 +0000
commit34897eebd22c3de968b64f09bb4a371d96cb0b89 (patch)
tree19a50e54fca63f1f6482d6cb4c2fdee676fd97b1 /support/texplate/doc
parente05dc0bb38b16bfb9ba35591285e40af0adaadc4 (diff)
CTAN sync 202002030302
Diffstat (limited to 'support/texplate/doc')
-rw-r--r--support/texplate/doc/texplate-manual.pdfbin103717 -> 104886 bytes
-rw-r--r--support/texplate/doc/texplate-manual.tex44
2 files changed, 39 insertions, 5 deletions
diff --git a/support/texplate/doc/texplate-manual.pdf b/support/texplate/doc/texplate-manual.pdf
index 98d06b0ca4..19afbe5c8f 100644
--- a/support/texplate/doc/texplate-manual.pdf
+++ b/support/texplate/doc/texplate-manual.pdf
Binary files differ
diff --git a/support/texplate/doc/texplate-manual.tex b/support/texplate/doc/texplate-manual.tex
index 6fe19fb5e4..56dbe5e5f3 100644
--- a/support/texplate/doc/texplate-manual.tex
+++ b/support/texplate/doc/texplate-manual.tex
@@ -17,7 +17,7 @@
\newcommand{\shortopt}[1]{{\ttfamily-#1}}
\newcommand{\longopt}[1]{{\ttfamily{-}{-}#1}}
\newcommand{\macro}[1]{{\ttfamily\textbackslash#1}}
-\newcommand{\texplateversion}{1.0.1}
+\newcommand{\texplateversion}{1.0.2}
\title{A gentle introduction to \texplate:\\ a document structure creation tool}
\author{Island of \TeX}
@@ -242,7 +242,7 @@ For starters, a template has an identifier, a name that logically represents the
Observe that \texplate's lookup system is case-sensitive, so make sure to always reference the correct name.
\end{disclaimer}
-Although there are no hard limitations on a template name, it is advisable to keep it short and concise, with no spaces whatsoever\footnote{Another Carlislean statement would remind us that people that put spaces in their file names deserve no sympathy. At all.}. As a consequence, potential issues with extended characters in the Unicode range and command line escaping are avoided, and thus our beloved tool might just work as expected.
+Although there are no hard limitations on a template name, it is advisable to keep it short and concise, with no spaces whatsoever\footnote{Another Carlislean statement would remind us that people who put spaces in their file names deserve no sympathy. At all.}. As a consequence, potential issues with extended characters in the Unicode range and command line escaping are avoided, and thus our beloved tool might just work as expected.
\section{Directory lookup}
\label{sec:directorylookup}
@@ -252,7 +252,7 @@ Although there are no hard limitations on a template name, it is advisable to ke
\begin{enumerate}
\item\inline{\textasciitilde/.texplate/templates} which refers to a path structure from the user home directory.
-\item\inline{<APP>/templates} which refers to a path structure from the application directory (with \inline{<APP>} denoting the location where \texplate\ is installed).
+\item The application's resources which refers to a files within the JAR file. You can use a ZIP viewer to look at the templates there.
\end{enumerate}
For instance, as a means to illustrate the concept of directory lookup, consider the following command line command:
@@ -396,7 +396,7 @@ The output (i.e., the template merged with the provided data) will be written to
\item When running \texplate, this is the expected output to be displayed in the command line (note that the layout is slightly modified due to space constraints in this user manual):
\begin{code}
-TeXplate 1.0.1, a document structure creation tool
+TeXplate 1.0.2, a document structure creation tool
Copyright (c) 2020, Island of TeX
All rights reserved.
@@ -597,8 +597,42 @@ gitlab.com/islandoftex/texplate
Happy \TeX ing with \texplate!
-\section*{License}
+\chapter*{License}
\texplate\ is licensed under the New BSD License. Please note that the New BSD License has been verified as a GPL-compatible free software license by the Free Software Foundation, and has been vetted as an open source license by the Open Source Initiative.
+\chapter*{Changelog}
+
+\section*{1.0.2 (current)}
+
+\subsection*{Fixed}
+
+\begin{itemize}
+\item \texplate\ now finds its templates even on Windows.
+\end{itemize}
+
+\subsection*{Changed}
+
+\begin{itemize}
+\item \texplate\ now finishes its transition to Kotlin. We did not change any functionality in the course of this change.
+\item Templates are now provided as resources from the JAR instead of a separate folder on the hard drive.
+\end{itemize}
+
+\section*{1.0.1 (2020-01-17)}
+
+\subsection*{Changed}
+
+\begin{itemize}
+\item \texplate\ will now distribute only non-generic template file names. In the system's template directory, we search for \inline{texplate-<name>.toml} as well.
+\end{itemize}
+
+\section*{1.0.0 (2020-01-15)}
+
+\subsection*{Added}
+
+\begin{itemize}
+\item Base functionality and default templates.
+\item User manual.
+\end{itemize}
+
\end{document}