diff options
author | Karl Berry <karl@freefriends.org> | 2023-09-07 20:15:22 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2023-09-07 20:15:22 +0000 |
commit | 591fa942532c9208ae10e82bea8f929861005501 (patch) | |
tree | f1040d8478a679a69581fabb4e5ea41d3aaf6ce5 /Master/texmf-dist/doc/lualatex | |
parent | bb9f4360575ae459a789b6602d209e55f7be6e84 (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.pdf | bin | 94940 -> 97289 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/lualatex/odsfile/odsfile.tex | 33 | ||||
-rw-r--r-- | Master/texmf-dist/doc/lualatex/odsfile/pokus.ods | bin | 11019 -> 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 Binary files differindex 7ea30cb63f9..20e61a2d0fe 100644 --- a/Master/texmf-dist/doc/lualatex/odsfile/odsfile.pdf +++ b/Master/texmf-dist/doc/lualatex/odsfile/odsfile.pdf 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 Binary files differindex 52bdbf4cc30..c54ad84a696 100644 --- a/Master/texmf-dist/doc/lualatex/odsfile/pokus.ods +++ b/Master/texmf-dist/doc/lualatex/odsfile/pokus.ods |