texlive[61371] Master: autopuncitems (21dec21)
commits+karl at tug.org
commits+karl at tug.org
Tue Dec 21 22:50:06 CET 2021
Revision: 61371
http://tug.org/svn/texlive?view=revision&revision=61371
Author: karl
Date: 2021-12-21 22:50:06 +0100 (Tue, 21 Dec 2021)
Log Message:
-----------
autopuncitems (21dec21)
Modified Paths:
--------------
trunk/Master/tlpkg/bin/tlpkg-ctan-check
trunk/Master/tlpkg/libexec/ctan2tds
trunk/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc
Added Paths:
-----------
trunk/Master/texmf-dist/doc/luatex/autopuncitems/
trunk/Master/texmf-dist/doc/luatex/autopuncitems/README.md
trunk/Master/texmf-dist/doc/luatex/autopuncitems/autopuncitems.pdf
trunk/Master/texmf-dist/doc/luatex/autopuncitems/autopuncitems.tex
trunk/Master/texmf-dist/tex/luatex/autopuncitems/
trunk/Master/texmf-dist/tex/luatex/autopuncitems/autopuncitems.lua
trunk/Master/texmf-dist/tex/luatex/autopuncitems/autopuncitems.sty
trunk/Master/tlpkg/tlpsrc/autopuncitems.tlpsrc
Added: trunk/Master/texmf-dist/doc/luatex/autopuncitems/README.md
===================================================================
--- trunk/Master/texmf-dist/doc/luatex/autopuncitems/README.md (rev 0)
+++ trunk/Master/texmf-dist/doc/luatex/autopuncitems/README.md 2021-12-21 21:50:06 UTC (rev 61371)
@@ -0,0 +1,28 @@
+# autopuncitems
+
+Automatically punctuate lists by passing the autopunc option to enumitem lists.
+
+# License
+
+Copyright (C) 2021 Kale Ewasiuk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
+ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
+TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
+SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR
+ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE
+OR OTHER DEALINGS IN THE SOFTWARE.
+
Property changes on: trunk/Master/texmf-dist/doc/luatex/autopuncitems/README.md
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/luatex/autopuncitems/autopuncitems.pdf
===================================================================
(Binary files differ)
Index: trunk/Master/texmf-dist/doc/luatex/autopuncitems/autopuncitems.pdf
===================================================================
--- trunk/Master/texmf-dist/doc/luatex/autopuncitems/autopuncitems.pdf 2021-12-21 21:46:58 UTC (rev 61370)
+++ trunk/Master/texmf-dist/doc/luatex/autopuncitems/autopuncitems.pdf 2021-12-21 21:50:06 UTC (rev 61371)
Property changes on: trunk/Master/texmf-dist/doc/luatex/autopuncitems/autopuncitems.pdf
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/luatex/autopuncitems/autopuncitems.tex
===================================================================
--- trunk/Master/texmf-dist/doc/luatex/autopuncitems/autopuncitems.tex (rev 0)
+++ trunk/Master/texmf-dist/doc/luatex/autopuncitems/autopuncitems.tex 2021-12-21 21:50:06 UTC (rev 61371)
@@ -0,0 +1,201 @@
+% Kale Ewasiuk (kalekje at gmail.com)
+% 2021-12-20
+% Copyright (C) 2021 Kale Ewasiuk
+%
+% Permission is hereby granted, free of charge, to any person obtaining a copy
+% of this software and associated documentation files (the "Software"), to deal
+% in the Software without restriction, including without limitation the rights
+% to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+% copies of the Software, and to permit persons to whom the Software is
+% furnished to do so, subject to the following conditions:
+%
+% The above copyright notice and this permission notice shall be included in
+% all copies or substantial portions of the Software.
+%
+% THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
+% ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
+% TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+% PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
+% SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR
+% ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+% ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+% OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE
+% OR OTHER DEALINGS IN THE SOFTWARE.
+
+
+\documentclass[11pt,parskip=half]{scrartcl}
+\setlength{\parindent}{0ex}
+\newcommand{\llcmd}[1]{\leavevmode\llap{\texttt{\detokenize{#1}\ }}}
+\newcommand{\cmd}[1]{\texttt{\detokenize{#1}}}
+\newcommand{\qcmd}[1]{``\cmd{#1}''}
+\RequirePackage{url}
+\RequirePackage{xcolor}
+\RequirePackage{showexpl}
+\lstset{explpreset={justification=\raggedright,pos=r,wide=true}}
+\setlength\ResultBoxRule{0mm}
+\lstset{
+ language=[LaTeX]TeX,
+ basicstyle=\ttfamily\small,
+ commentstyle=\ttfamily\small\color{gray},
+ frame=none,
+ numbers=left,
+ numberstyle=\ttfamily\small\color{gray},
+ prebreak=\raisebox{0ex}[0ex][0ex]{\color{gray}\ensuremath{\hookleftarrow}},
+ extendedchars=true,
+ breaklines=true,
+ tabsize=4,
+}
+\addtokomafont{title}{\raggedright}
+\addtokomafont{author}{\raggedright}
+\addtokomafont{date}{\raggedright}
+\author{Kale Ewasiuk (\url{kalekje at gmail.com})}
+\RequirePackage[yyyymmdd]{datetime}\renewcommand{\dateseparator}{--}
+\date{\today}
+
+
+\usepackage{autopuncitems}
+\setlist{nosep}
+
+\title{autopuncitems}
+
+
+\begin{document}
+\maketitle
+
+\section{Introduction}
+This package provides the \cmd{autopunc} option in the
+\cmd{enumitem} environemnts \cmd{itemize}, \cmd{enumerate}, and \cmd{description}
+to automatically punctuate the items.
+It uses lua pattern matching to modify the environment's contents.
+
+\section{Some commands}
+\llcmd{\APomit}Used in an \cmd{\item} to signify that that item should not be automatically punctuated, and not be counted. Expands to nothing.\\
+\llcmd{\APpass}Used in an \cmd{\item} to signify that that item should not be automatically punctuated, and but still counted. Expands to nothing.\\
+
+\begin{addmargin}[0.8in]{0in}
+\llcmd{\setAPeach{}{}{}}Set the default, second last, and last punctuation point in that order.\\
+\llcmd{\setAPall{}}Set all punctuation points the same.\\
+\llcmd{\setAPdef{}}Set the default punctuation point. \cmd{;} by default.\\
+\llcmd{\setAPseclast{}}Set the second last punctuation point. \cmd{; and} by default.\\
+\llcmd{\setAPlast{}}Set the second last punctuation point. \cmd{.} by default.\\
+
+\llcmd{\enableAPautopassnest}Automatically put an \cmd{\APpass} on items that introduce a nested list. Default behaviour.\\
+\llcmd{\disableAPautopassnest}Do not automatically put an \cmd{\APpass} on items that introduce a nested list.\\
+
+\end{addmargin}
+
+
+\section{Tutorial}
+\subsection{Basic Use}
+
+\begin{LTXexample}
+\begin{itemize}[autopunc]
+ \item one
+ \item two
+ \item three
+ \item four
+\end{itemize}
+\end{LTXexample}
+
+
+\subsection{Demonstrating Pass}
+
+\begin{LTXexample}
+\begin{itemize}[autopunc]
+ \item one
+ \item two
+ \item three \APpass
+ \item four
+\end{itemize}
+\end{LTXexample}
+
+\begin{LTXexample}
+\begin{itemize}[autopunc]
+ \item one
+ \item two
+ \item three \APpass
+ \item four \APpass
+\end{itemize}
+\end{LTXexample}
+
+
+\subsection{Demonstrating Omit}
+
+\begin{LTXexample}
+\begin{itemize}[autopunc]
+ \item one
+ \item two
+ \item three \APomit
+ \item four
+\end{itemize}
+\end{LTXexample}
+
+\begin{LTXexample}
+\begin{itemize}[autopunc]
+ \item one
+ \item two
+ \item three \APomit
+ \item four \APomit
+\end{itemize}
+\end{LTXexample}
+
+\subsection{Nested}
+You must use \cmd{autopunc} on each nested list if you want that sub-list to be automatically punctuated.
+Note that by default, the item introducing (before) a sub-list will not be automatically punctuated.
+
+\begin{LTXexample}
+\begin{itemize}[autopunc]
+ \item one
+ \item two
+ \item three:
+ \begin{enumerate}[autopunc]
+ \item alpha:
+ \begin{description}[autopunc]
+ \item[hello] world
+ \end{description}
+ \item beta
+ \item delta
+ \end{enumerate}
+ \item four
+\end{itemize}
+\end{LTXexample}
+
+
+\subsubsection{If you forget to use APpass}
+If you disable auto-pass nested lists, and don't use \cmd{\APpass}, here is what happens. Notice the extra ``; and'' below hello world and beta.
+\begin{LTXexample}
+\disableAPautopassnest
+\begin{itemize}[autopunc]
+ \item one
+ \item two
+ \item three
+ \begin{enumerate}[autopunc]
+ \item alpha
+ \begin{description}[autopunc]
+ \item[hello] world
+ \end{description}
+ \item beta
+ \end{enumerate}
+ \item four
+\end{itemize}
+\end{LTXexample}
+
+\begin{LTXexample}
+\enableAPautopassnest
+\begin{itemize}[autopunc]
+ \item one
+ \item two
+ \item three
+ \begin{enumerate}
+ \item alpha
+ \begin{description}[autopunc]
+ \item[hello] world
+ \end{description}
+ \item beta
+ \end{enumerate}
+ \item four
+\end{itemize}
+\end{LTXexample}
+
+\end{document}
+
Property changes on: trunk/Master/texmf-dist/doc/luatex/autopuncitems/autopuncitems.tex
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/Master/texmf-dist/tex/luatex/autopuncitems/autopuncitems.lua
===================================================================
--- trunk/Master/texmf-dist/tex/luatex/autopuncitems/autopuncitems.lua (rev 0)
+++ trunk/Master/texmf-dist/tex/luatex/autopuncitems/autopuncitems.lua 2021-12-21 21:50:06 UTC (rev 61371)
@@ -0,0 +1,106 @@
+--% Kale Ewasiuk (kalekje at gmail.com)
+--% 2021-12-20
+--% Copyright (C) 2021 Kale Ewasiuk
+--%
+--% Permission is hereby granted, free of charge, to any person obtaining a copy
+--% of this software and associated documentation files (the "Software"), to deal
+--% in the Software without restriction, including without limitation the rights
+--% to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+--% copies of the Software, and to permit persons to whom the Software is
+--% furnished to do so, subject to the following conditions:
+--%
+--% The above copyright notice and this permission notice shall be included in
+--% all copies or substantial portions of the Software.
+--%
+--% THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
+--% ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
+--% TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+--% PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
+--% SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR
+--% ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+--% ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+--% OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE
+--% OR OTHER DEALINGS IN THE SOFTWARE.
+
+
+local ap = {} -- module table
+
+function ap.rtrim(s)
+ return (s:gsub("^(.-)%s*$", "%1"))
+end
+
+ap.punc = {}
+ap.punc = {'.', '; and'} -- punctuation table, 1 is last val, 2 is 2nd last val
+ap.punc[0] = ';' -- [0] is default punctuation
+ap.total = 0 -- total num of items (int)
+ap.curr = 0 -- current item we're on (int)
+ap.itemp = '\9' -- temporary item, item which WILL be affected by autopunc
+ap.item = '\\item' -- item
+ap.omit = '\\APomit' -- flag for hiding an item from punc and count, acts as if item is not there
+ap.pass = '\\APpass' -- flag for passing item from punc, but still considered in count
+ap.code = 0 -- code for skipping punc if > 0, keep in count if == 1, omit from count if == 2
+
+ap.autopassnested = true
+
+function ap.start(s)
+ ap.curr = 0
+ _, ap.total = s:gsub(ap.itemp, '')
+ local _, omit = s:gsub(ap.omit, '')
+ ap.total = ap.total - omit
+end
+
+function ap.setcode(s)
+ local _, code1 = s:gsub(ap.pass, '', 1)
+ local _, code2 = s:gsub(ap.omit, '', 1)
+ ap.code = code1 + 2*code2
+end
+
+function ap.addcount(s)
+ ap.setcode(s)
+ if ap.code < 2 then -- if not omitting, we still keep counter going
+ ap.curr = ap.curr + 1 -- increment counter
+ end
+end
+
+function ap.getdelim()
+ local d = ''
+ if ap.code == 0 then -- d limiter -- if not passing look at punctuation table for delimiter
+ d = ap.punc[ap.total-ap.curr+1] or ap.punc[0]
+ end
+ return d
+end
+
+function ap.protectnest(s)
+ local x = ''
+ if ap.autopassnested then x = ap.pass..'{}' end
+ s = s:gsub("\0", "\0", 0) -- dummy replacement to make code easier
+ :gsub("\\begin%s*{itemize}", x.."\1%0") -- pad \1 and \2 in inner envirnments
+ :gsub("\\end%s*{itemize}", "%0\2")
+ :gsub("\\begin%s*{enumerate}", x.."\1%0")
+ :gsub("\\end%s*{enumerate}", "%0\2")
+ :gsub("\\begin%s*{description}", x.."\1%0")
+ :gsub("\\end%s*{description}", "%0\2")
+ :gsub("%b\1\2", "\0%0\0") -- use bracket to place \0 (on OUTER) nested lists only
+ :gsub("(%Z*)%z?(%Z*)%z?", -- only affect matches outside list
+ function(a, b) return a:gsub(ap.item, ap.itemp)..b:gsub("[\1\2]", "") end)
+ return s
+end
+
+
+function ap.go(s)
+ s = ap.protectnest(s)
+ ap.start(s) -- start counters
+ --texio.write_nl('yooo...'..s)
+ s = s:gsub(ap.itemp, '\0\0'):gsub('\0', '', 1) -- make all items \0\0 then change first item to one \0
+ s = s:gsub('(%z)(%Z*)(%z?)', -- find betwen \0 .. \0
+ function(it, s, _it) -- discarding duplicate item '_it' that was made in first gsub
+ ap.addcount(s) -- add count, helps determine delimiter
+ return ap.rtrim(it..s)..ap.getdelim()..' '
+ end
+ )
+ s = s:gsub('\0', ap.itemp) -- replace items
+ s = s:gsub(ap.itemp, ap.item) -- replace items
+ return s
+end
+
+return ap
\ No newline at end of file
Property changes on: trunk/Master/texmf-dist/tex/luatex/autopuncitems/autopuncitems.lua
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/Master/texmf-dist/tex/luatex/autopuncitems/autopuncitems.sty
===================================================================
--- trunk/Master/texmf-dist/tex/luatex/autopuncitems/autopuncitems.sty (rev 0)
+++ trunk/Master/texmf-dist/tex/luatex/autopuncitems/autopuncitems.sty 2021-12-21 21:50:06 UTC (rev 61371)
@@ -0,0 +1,56 @@
+% Kale Ewasiuk (kalekje at gmail.com)
+% 2021-12-20
+% Copyright (C) 2021 Kale Ewasiuk
+%
+% Permission is hereby granted, free of charge, to any person obtaining a copy
+% of this software and associated documentation files (the "Software"), to deal
+% in the Software without restriction, including without limitation the rights
+% to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+% copies of the Software, and to permit persons to whom the Software is
+% furnished to do so, subject to the following conditions:
+%
+% The above copyright notice and this permission notice shall be included in
+% all copies or substantial portions of the Software.
+%
+% THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
+% ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
+% TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+% PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
+% SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR
+% ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+% ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+% OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE
+% OR OTHER DEALINGS IN THE SOFTWARE.
+
+
+\ProvidesPackage{autopuncitems}[2021-12-20]
+
+\RequirePackage{enumitem}
+\RequirePackage{luacode}
+
+\luadirect{autopuncitems = require'autopuncitems'}
+
+\newcommand{\APomit}{} % blank flag used in '\item' to hide it from counting and auto
+\newcommand{\APpass}{} % blank flag used in '\item', autopunc is skipped, but count is still
+
+\newcommand{\disableAPautopassnest}{\luadirect{autopuncitems.autopassnested = false}}
+\newcommand{\enableAPautopassnest}{\luadirect{autopuncitems.autopassnested = true}}
+
+\NewDocumentCommand{\setAPeach}{m m m}{\setAPdef{#1}\setAPseclast{#2}\setAPlast{#3}} % set each one, default, second last, last
+\NewDocumentCommand{\setAPall}{m}{\setAPdef{#1}\setAPseclast{#1}\setAPlast{#1}} % set all the same
+\NewDocumentCommand{\setAPdef}{m}{\luadirect{autopuncitems.punc[0] = \luastring{#1}}} % default punc value
+\NewDocumentCommand{\setAPlast}{m}{\luadirect{autopuncitems.punc[1] = \luastring{#1}}} % second last punc value
+\NewDocumentCommand{\setAPseclast}{m}{\luadirect{autopuncitems.punc[2] = \luastring{#1}}} % final punc value
+
+\NewDocumentEnvironment{AutoPuncItemize}{ +b }{
+% \luadirect{texio.write_nl('auto >>>'..autopuncitems.go(\luastringN{#1}))}
+ \luadirect{tex.print(autopuncitems.go(\luastringN{#1}))}
+}{}
+
+\SetEnumitemKey{autopunc}{
+ first*=\expandafter\AutoPuncItemize,
+ after=\endAutoPuncItemize,
+}
+
+
+
Property changes on: trunk/Master/texmf-dist/tex/luatex/autopuncitems/autopuncitems.sty
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/Master/tlpkg/bin/tlpkg-ctan-check
===================================================================
--- trunk/Master/tlpkg/bin/tlpkg-ctan-check 2021-12-21 21:46:58 UTC (rev 61370)
+++ trunk/Master/tlpkg/bin/tlpkg-ctan-check 2021-12-21 21:50:06 UTC (rev 61371)
@@ -62,7 +62,7 @@
auto-pst-pdf-lua autobreak autopdf
authoraftertitle authorarchive authordate authorindex
auto-pst-pdf autoaligne autoarea autofancyhdr automata autonum
- autosp auxhook
+ autopuncitems autosp auxhook
avantgar avremu awesomebox axessibility axodraw2
b1encoding babel
babel-albanian babel-azerbaijani babel-basque
Modified: trunk/Master/tlpkg/libexec/ctan2tds
===================================================================
--- trunk/Master/tlpkg/libexec/ctan2tds 2021-12-21 21:46:58 UTC (rev 61370)
+++ trunk/Master/tlpkg/libexec/ctan2tds 2021-12-21 21:50:06 UTC (rev 61371)
@@ -1880,8 +1880,9 @@
'apnum', 'apnum.tex',
'arabtex', '(arab|heb)tex\.tex|' . $standardtex,
'autoaligne', '\.tex|' . $standardtex,
- 'axessibility','\.lua|' . $standardtex,
- 'babel', 'bl?plain\.tex|' . $standardtex,
+ 'autopuncitems', '\.lua|' . $standardtex,
+ 'axessibility', '\.lua|' . $standardtex,
+ 'babel', 'bl?plain\.tex|' . $standardtex,
'babel-french', '\.lua|' . $standardtex,
'babel-georgian', 'georgiancaps\.tex|' . $standardtex,
'babel-latin', '\.lua|' . $standardtex,
Added: trunk/Master/tlpkg/tlpsrc/autopuncitems.tlpsrc
===================================================================
Modified: trunk/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc
===================================================================
--- trunk/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc 2021-12-21 21:46:58 UTC (rev 61370)
+++ trunk/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc 2021-12-21 21:50:06 UTC (rev 61371)
@@ -58,6 +58,7 @@
depend authorarchive
depend authorindex
depend autofancyhdr
+depend autopuncitems
depend autonum
depend autopdf
depend avremu
More information about the tex-live-commits
mailing list.