texlive[64639] Master: coolfn (6oct22)

commits+karl at tug.org commits+karl at tug.org
Thu Oct 6 22:01:00 CEST 2022


Revision: 64639
          http://tug.org/svn/texlive?view=revision&revision=64639
Author:   karl
Date:     2022-10-06 22:00:59 +0200 (Thu, 06 Oct 2022)
Log Message:
-----------
coolfn (6oct22)

Modified Paths:
--------------
    trunk/Master/tlpkg/bin/tlpkg-ctan-check
    trunk/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc

Added Paths:
-----------
    trunk/Master/texmf-dist/doc/latex/coolfn/
    trunk/Master/texmf-dist/doc/latex/coolfn/README
    trunk/Master/texmf-dist/doc/latex/coolfn/coolfndocumentation.pdf
    trunk/Master/texmf-dist/doc/latex/coolfn/coolfndocumentation.tex
    trunk/Master/texmf-dist/tex/latex/coolfn/
    trunk/Master/texmf-dist/tex/latex/coolfn/coolfn.sty
    trunk/Master/tlpkg/tlpsrc/coolfn.tlpsrc

Added: trunk/Master/texmf-dist/doc/latex/coolfn/README
===================================================================
--- trunk/Master/texmf-dist/doc/latex/coolfn/README	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/coolfn/README	2022-10-06 20:00:59 UTC (rev 64639)
@@ -0,0 +1,15 @@
+coolfn - a package for cool footnotes
+
+version: 1.0.0
+
+This package provides formatting for footnotes in long legal documents, using hanging indents to make them look nicer
+
+This work may be distributed and/or modified under the conditions of the
+LaTeX Project Public License (LPPL), version 1.3 or later. 
+
+
+For suggestions, feature requests, and bug reports, please use the project's
+GitHub site:  https://github.com/ezgranet/coolfn
+
+Version history: 
+06/10/2022 Package creation
\ No newline at end of file


Property changes on: trunk/Master/texmf-dist/doc/latex/coolfn/README
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/latex/coolfn/coolfndocumentation.pdf
===================================================================
(Binary files differ)

Index: trunk/Master/texmf-dist/doc/latex/coolfn/coolfndocumentation.pdf
===================================================================
--- trunk/Master/texmf-dist/doc/latex/coolfn/coolfndocumentation.pdf	2022-10-06 20:00:22 UTC (rev 64638)
+++ trunk/Master/texmf-dist/doc/latex/coolfn/coolfndocumentation.pdf	2022-10-06 20:00:59 UTC (rev 64639)

Property changes on: trunk/Master/texmf-dist/doc/latex/coolfn/coolfndocumentation.pdf
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/latex/coolfn/coolfndocumentation.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/coolfn/coolfndocumentation.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/coolfn/coolfndocumentation.tex	2022-10-06 20:00:59 UTC (rev 64639)
@@ -0,0 +1,179 @@
+\documentclass[12pt]{article}
+\usepackage{coolfn}
+\usepackage{textcsc}
+\usepackage{xcolor}
+\usepackage{fontspec}\definecolor{darkspringgreen}{rgb}{0.09, 0.45, 0.27}
+\usepackage{titlesec}
+\titleformat{\subsection}
+  {\bfseries}{\thesection.\thesubsection}{1em}{\normalfont\bfseries}
+\usepackage[hidelinks]{hyperref}
+\usepackage{hologo}
+\usepackage[british]{babel}
+\usepackage[useregional]{datetime2}
+\DTMlangsetup[en-GB]{ord=omit}
+\definecolor{LightGray}{gray}{0.9}
+%\usepackage{mathpazo}
+\IfFontExistsTF{Palatine Parliamentary}{%
+\setromanfont[SmallCapsFeatures={LetterSpace=10},
+RawFeature={+calt,+hlig,+liga,+dlig,+onum,+pnum},
+BoldFont={Palatine Parliamentary Bold},
+ItalicFont={Palatine Parliamentary Italic}
+]{Palatine Parliamentary Regular}
+}{\setromanfont[RawFeature={+onum,+pnum}]{TeX Gyre PagellaX}}
+\setmonofont[Scale=.9,BoldFont=Source Code Pro Bold]{Source Code Pro}
+
+\usepackage{minted}
+\date{6 October 2022\\\smallskip\ttfamily Version \coolfnversionnumber}
+\author{Elijah Z Granet\thanks{e-mail: \href{mailto:ezg21 at cantab.ac.uk}{\ttfamily ezg21 at cantab.ac.uk}}}
+
+\title{\texttt{coolfn}:\\A package for a cool way to typeset footnotes}
+\begin{document}
+\maketitle
+\tableofcontents
+\clearpage
+\section{Overview}
+Legal writing, for better or for worse,\footnote{Almost certainly for the worse, except in the very rare situations where the author is capable of mastering the art of distinctive discursive footnote writing.  Far more authors think that they can pull off this delicate technique than \textit{actually} are capable of doing so. } often involves very long and discursive footnotes replete with a series of often doubtfully relevant citations (perhaps with blockquotes of  even more doubtful relevance).\footnote{Here, it is apt to note, as Parke \textcsc{B} said in Parke B in \textit{Mirehouse v Rennel} (1833) 1 Cl \& F 527, 546, that:
+\begin{quote}
+Our common law system consists in the applying to new combinations of circumstances those rules of law which we derive from legal principles and judicial precedents; and for the sake of attaining uniformity, consistency and certainty, we must apply those rules, where they are not plainly unreasonable or inconvenient, to all cases which arise; and we are not at liberty to reject them, and to abandon all analogy to them, in those to which they have not yet been judicially applied, because we think that the rules are not as convenient and reasonable as we ourselves could have devised.\end{quote}} Consequently, the formatting of footnotes for clear numbering, delineation of internal quotations and paragraphs, and clarity takes on a great importance.
+
+This is a subjective question, on which the typographic authorities offer many suggestions. This package simply provides a way of formatting long footnotes the author thinks is, for lack of a better word, cool. It uses a clear column of numbers separated from the footnote, of sufficient width to accommodate triple digit footnote numbers.  A hanging indent emphasises the footnote as the sideways mirror of the text, reflecting the paragraph but in a different way.\footnote{Think of the classic mirroring of the main text having the case name and the footnote the legal citation.} There is no footnote rule and a very slight increase in the parskip to help the eye distinguish multi-paragraph footnotes.\footnote{Which are usually a bad idea, but should at least look nice if they must be used.}
+\section{Usage}
+The package has no options, and the only configurable length is the \\\mintinline{latex}{\fnindent}, which sets the indent for the hanging footnotes, and also defines the relationship of the footnote number and main footnote blocks.  By default, this is set to 1 \textcsc{M}, but can be easily changed by using the simple inbuilt \LaTeX renewal macro. For example:
+\begin{quote}
+ \mintinline{latex}{\renewcommand{\fnindent}{1.25em}}.
+\end{quote}
+\section{Development}
+Bugs, feature requests, \textit{etc}, should be submitted to the project's official Githup page: (\url{https://github.com/ezgranet/coolfn/}).
+
+\section{Licence}
+	This project is licensed under the Latex Public Project Licence version 1.3\textit{c}. This documentation is copyright of the author but licensed under \textcsc{CC-BY-SA} 3.0.
+
+\clearpage
+\section{Implementation}
+\begin{minted}[
+framesep=2mm,
+baselinestretch=1.2,
+bgcolor=LightGray,
+fontsize=\footnotesize,
+breaklines,
+firstnumber=last
+]
+{latex}
+
+\def\coolfnversionnumber{1.0.0}
+\ProvidesPackage{coolfn}
+[2022/10/06\coolfnversionnumber\
+ A cool way to format footnotes]
+% This work may be distributed and/or modified under the 
+% conditions of the LaTeX Project Public License, either version 1.3 
+% of this license or (at your option) any later version.
+% The latest version of this license is in
+%   http://www.latex-project.org/lppl.txt
+% and version 1.3 or later is part of all distributions of LaTeX 
+% version 2005/12/01 or later.
+%
+% This work has the LPPL maintenance status `maintained'.
+%
+% The Current Maintainer of this work is Elijah Z Granet
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% FOOTNOTES
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% from https://tex.stackexchange.com/questions/305033/is-there-a-latex-package-that-defines-an-environment-for-parskip-like-capabiliti
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\makeatletter
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% multi paragraph footnotes
+% are inherently pretty bad 
+% but they happen in law
+% so might as well deal with them? so a slight spacing to compensate
+%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\newenvironment{Parskip}{%
+   \par
+   \parskip=0.25\baselineskip \advance\parskip by 0pt plus 1pt
+   \parindent=\z@
+   \def\@listI{\leftmargin\leftmargini
+      \topsep\z@ \parsep\parskip \itemsep\z@}
+   \let\@listi\@listI
+   \@listi
+   \def\@listii{\leftmargin\leftmarginii
+      \labelwidth\leftmarginii\advance\labelwidth-\labelsep
+      \topsep\z@ \parsep\parskip \itemsep\z@}
+   \def\@listiii{\leftmargin\leftmarginiii
+       \labelwidth\leftmarginiii\advance\labelwidth-\labelsep
+       \topsep\z@ \parsep\parskip \itemsep\z@}
+   \partopsep=\z@
+}{\par}
+\makeatother
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% 
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\newcommand{\fnindent}{1em}
+\usepackage{calc}% for maths
+\newlength{\lengtha}
+\setlength{\lengtha}{\textwidth}
+\newlength{\lengthb}%maths again
+\newlength{\lengthc}
+\setlength{\lengthc}{\fnindent}
+\setlength{\lengthb}{1.75\lengthc}%parblock
+\makeatletter
+\@ifclassloaded{memoir}{}{\usepackage{hanging}}
+\makeatother
+ % for hanging paragraphs
+\renewcommand\footnoterule{}
+% ^ no one wants a rule sep for FN!
+\AtBeginDocument{\flushbottom}
+%^just to be safe 
+\makeatletter
+\long\def\@makefntext#1{\leavevmode
+  \@makefnmark\nobreak
+  #1%
+}
+\makeatother
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% the magic
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\makeatletter
+ \renewcommand{\@makefntext}[1]{%
+\begin{minipage}[t]{\lengthb}%
+\noindent\normalfont%
+\@thefnmark%
+\end{minipage}%
+\begin{minipage}[t]{\lengtha-\lengthb}%
+\begin{Parskip}\begin{hangparas}{\lengthc}{1}
+\noindent#1\end{hangparas}\end{Parskip}%
+\end{minipage}%
+}
+\makeatother
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\end{minted}
+
+
+
+
+
+
+
+
+\section{Version History}
+\subsection{\texttt{1.0.0}}
+
+\ttfamily 6 October 2022: Package creation
+
+	
+\end{document}
\ No newline at end of file


Property changes on: trunk/Master/texmf-dist/doc/latex/coolfn/coolfndocumentation.tex
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/Master/texmf-dist/tex/latex/coolfn/coolfn.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/coolfn/coolfn.sty	                        (rev 0)
+++ trunk/Master/texmf-dist/tex/latex/coolfn/coolfn.sty	2022-10-06 20:00:59 UTC (rev 64639)
@@ -0,0 +1,100 @@
+\def\coolfnversionnumber{1.0.0}
+\ProvidesPackage{coolfn}
+[2022/10/06\coolfnversionnumber\
+ A cool way to format footnotes]
+% This work may be distributed and/or modified under the 
+% conditions of the LaTeX Project Public License, either version 1.3 
+% of this license or (at your option) any later version.
+% The latest version of this license is in
+%   http://www.latex-project.org/lppl.txt
+% and version 1.3 or later is part of all distributions of LaTeX 
+% version 2005/12/01 or later.
+%
+% This work has the LPPL maintenance status `maintained'.
+%
+% The Current Maintainer of this work is Elijah Z Granet
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% FOOTNOTES
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% from https://tex.stackexchange.com/questions/305033/is-there-a-latex-package-that-defines-an-environment-for-parskip-like-capabiliti
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\makeatletter
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% multi paragraph footnotes
+% are inherently pretty bad 
+% but they happen in law
+% so might as well deal with them? so a slight spacing to compensate
+%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\newenvironment{Parskip}{%
+   \par
+   \parskip=0.25\baselineskip \advance\parskip by 0pt plus 1pt
+   \parindent=\z@
+   \def\@listI{\leftmargin\leftmargini
+      \topsep\z@ \parsep\parskip \itemsep\z@}
+   \let\@listi\@listI
+   \@listi
+   \def\@listii{\leftmargin\leftmarginii
+      \labelwidth\leftmarginii\advance\labelwidth-\labelsep
+      \topsep\z@ \parsep\parskip \itemsep\z@}
+   \def\@listiii{\leftmargin\leftmarginiii
+       \labelwidth\leftmarginiii\advance\labelwidth-\labelsep
+       \topsep\z@ \parsep\parskip \itemsep\z@}
+   \partopsep=\z@
+}{\par}
+\makeatother
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% 
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\newcommand{\fnindent}{1em}
+\usepackage{calc}% for maths
+\newlength{\lengtha}
+\setlength{\lengtha}{\textwidth}
+\newlength{\lengthb}%maths again
+\newlength{\lengthc}
+\setlength{\lengthc}{\fnindent}
+\setlength{\lengthb}{1.75\lengthc}%parblock
+\makeatletter
+\@ifclassloaded{memoir}{}{\usepackage{hanging}}
+\makeatother
+ % for hanging paragraphs
+\renewcommand\footnoterule{}
+% ^ no one wants a rule sep for FN!
+\AtBeginDocument{\flushbottom}
+%^just to be safe 
+\makeatletter
+\long\def\@makefntext#1{\leavevmode
+  \@makefnmark\nobreak
+  #1%
+}
+\makeatother
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% the magic
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\makeatletter
+ \renewcommand{\@makefntext}[1]{%
+\begin{minipage}[t]{\lengthb}%
+\noindent\normalfont%
+\@thefnmark%
+\end{minipage}%
+\begin{minipage}[t]{\lengtha-\lengthb}%
+\begin{Parskip}\begin{hangparas}{\lengthc}{1}
+\noindent#1\end{hangparas}\end{Parskip}%
+\end{minipage}%
+}
+\makeatother
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%


Property changes on: trunk/Master/texmf-dist/tex/latex/coolfn/coolfn.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	2022-10-06 20:00:22 UTC (rev 64638)
+++ trunk/Master/tlpkg/bin/tlpkg-ctan-check	2022-10-06 20:00:59 UTC (rev 64639)
@@ -216,7 +216,7 @@
     context-visualcounter
     continue contour contracard conv-xkv convbkmk
     cooking cooking-units cookingsymbols
-    cool coollist coolstr coolthms cooltooltips coop-writing
+    cool coolfn coollist coolstr coolthms cooltooltips coop-writing
     coordsys copyedit copyrightbox cormorantgaramond correctmathalign coseoul
     countriesofeurope counttexruns courier courier-scaled courierten
     courseoutline coursepaper

Modified: trunk/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc
===================================================================
--- trunk/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc	2022-10-06 20:00:22 UTC (rev 64638)
+++ trunk/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc	2022-10-06 20:00:59 UTC (rev 64639)
@@ -245,6 +245,7 @@
 depend cooking
 depend cooking-units
 depend cool
+depend coolfn
 depend coollist
 depend coolstr
 depend coolthms

Added: trunk/Master/tlpkg/tlpsrc/coolfn.tlpsrc
===================================================================


More information about the tex-live-commits mailing list.