summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/lualatex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2023-09-07 20:15:22 +0000
committerKarl Berry <karl@freefriends.org>2023-09-07 20:15:22 +0000
commit591fa942532c9208ae10e82bea8f929861005501 (patch)
treef1040d8478a679a69581fabb4e5ea41d3aaf6ce5 /Master/texmf-dist/doc/lualatex
parentbb9f4360575ae459a789b6602d209e55f7be6e84 (diff)
odsfile (7sep23)
git-svn-id: svn://tug.org/texlive/trunk@68201 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/lualatex')
-rw-r--r--Master/texmf-dist/doc/lualatex/odsfile/odsfile.pdfbin94940 -> 97289 bytes
-rw-r--r--Master/texmf-dist/doc/lualatex/odsfile/odsfile.tex33
-rw-r--r--Master/texmf-dist/doc/lualatex/odsfile/pokus.odsbin11019 -> 12024 bytes
3 files changed, 30 insertions, 3 deletions
diff --git a/Master/texmf-dist/doc/lualatex/odsfile/odsfile.pdf b/Master/texmf-dist/doc/lualatex/odsfile/odsfile.pdf
index 7ea30cb63f9..20e61a2d0fe 100644
--- a/Master/texmf-dist/doc/lualatex/odsfile/odsfile.pdf
+++ b/Master/texmf-dist/doc/lualatex/odsfile/odsfile.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/lualatex/odsfile/odsfile.tex b/Master/texmf-dist/doc/lualatex/odsfile/odsfile.tex
index 9aefc2a8909..e3b5fcda789 100644
--- a/Master/texmf-dist/doc/lualatex/odsfile/odsfile.tex
+++ b/Master/texmf-dist/doc/lualatex/odsfile/odsfile.tex
@@ -8,7 +8,7 @@
\author{Michal Hoftich (\url{michal.h21@gmail.com})}
\title{The \textsf{odsfile} package:\\
accessing of the \textsf{opendocument spreadsheet} from \LaTeX{}
-documents\thanks{Version 0.7, last revisited 2022-12-13.}
+documents\thanks{Version 0.8, last revisited 2023-09-07.}
}
\usepackage[english]{babel}
\lstloadlanguages{[LaTeX]Tex}
@@ -36,7 +36,7 @@ This is \LuaLaTeX{} package and \textsf{lua} library for working with
Their contents can be read as \LaTeX{} tables, can be pass to macros,
you can also add new data to existing spreadsheets.
-\ods format consist of number of |xml| files packed in the |zip| file.
+The \ods format consist of number of |xml| files packed in the |zip| file.
This package uses \LuaTeX's zip library, LuaXML library\footnote{Pure |lua| library
for working with |xml| files, it is available form CTAN or \url{https://github.com/michal-h21/LuaXML}} and lua scripting to read |xml| content from this archive,
which means that it is not possible to use this package with pdf\LaTeX{} or \XeLaTeX.
@@ -205,6 +205,26 @@ command
\end{description}
+\subsection{Character escaping}
+
+To prevent compilation errors, \textsf{odsfile} escapes characters that have special meaning in \LaTeX,
+for example backslashes or dollar characters. In some cases, you may want to
+execute the \TeX\ code that is saved in the spreadsheet. In that case, use the \texttt{escape} option:
+
+\begin{description}
+
+\item[escape] Set the value to false to ignore special characters in the cell data.
+\end{description}
+
+The following example prints the left cell in the last row in table in bold, because the original
+spreadsheet contains the \verb|\textbf{bold}| command.
+
+\begin{LTXexample}
+\begin{tabular}{lll}
+\includespread[sheet=List1,columns=head,escape=false]
+\end{tabular}
+\end{LTXexample}
+
\section{Templates}\label{sec:tpl}
@@ -272,7 +292,7 @@ Position specifies cell, where data should be added, if you leave it blank, it w
You can explicitly load \ods file with \marginpar{\cmd{\loadodsfile}}\cmd{\loadodsfile}\oarg{key val list}\marg{filename}. This can be useful, if you only want to write some data to the file, otherwise it is better to use \cmd{\includespread}.
-For saving spreadsheets modified with |AddRow|, you can use \cmd{\savespreadsheet}\marginpar{\cmd{\savespreadsheet}}. This command uses call to external |zip| utility, so you should have installed it and you have to call lua\LaTeX with |lualatex --shell-escape filename|. Lua\LaTeX also must have write permissions for accessing the \ods file. This command creates file |content.xml| in the current directory, so if externall call fails, you can run
+For saving spreadsheets modified with |AddRow|, you can use \cmd{\savespreadsheet}\marginpar{\cmd{\savespreadsheet}}. This command uses call to external |zip| utility, so you should have installed it and you have to call Lua\LaTeX\ with |lualatex --shell-escape filename|. Lua\LaTeX\ also must have write permissions for accessing the \ods file. This command creates file |content.xml| in the current directory, so if externall call fails, you can run
\begin{verbatim}
zip -r filename.ods content.xml
\end{verbatim}
@@ -381,6 +401,13 @@ CC & 5 & 7
\section{Changes}
\begin{description}
+ \item[v0.8]
+ \begin{itemize}
+ \item added the escape option for enabling or disabling of the character escaping
+ \item fixed handling of merged cells in ranges
+ \item fixed escaping of backslashes
+ \item fixed row insertion
+ \end{itemize}
\item[v0.7]
\begin{itemize}
\item Fixed character escaping. Unescaped ``\%,\#,\$, \_ and \&'' characters will be escaped to prevent compilation errors.
diff --git a/Master/texmf-dist/doc/lualatex/odsfile/pokus.ods b/Master/texmf-dist/doc/lualatex/odsfile/pokus.ods
index 52bdbf4cc30..c54ad84a696 100644
--- a/Master/texmf-dist/doc/lualatex/odsfile/pokus.ods
+++ b/Master/texmf-dist/doc/lualatex/odsfile/pokus.ods
Binary files differ