summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/langsci-affiliations/langsci-affiliations.dtx
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/langsci-affiliations/langsci-affiliations.dtx')
-rw-r--r--macros/latex/contrib/langsci-affiliations/langsci-affiliations.dtx492
1 files changed, 492 insertions, 0 deletions
diff --git a/macros/latex/contrib/langsci-affiliations/langsci-affiliations.dtx b/macros/latex/contrib/langsci-affiliations/langsci-affiliations.dtx
new file mode 100644
index 0000000000..1cbb13c3ec
--- /dev/null
+++ b/macros/latex/contrib/langsci-affiliations/langsci-affiliations.dtx
@@ -0,0 +1,492 @@
+% \iffalse meta-comment
+% !TeX program = xelatex
+% !TeX encoding = utf-8
+%<*internal>
+\begingroup
+%</internal>
+%<*install>
+\input{l3docstrip.tex}
+\keepsilent
+\askforoverwritefalse
+\preamble
+------------------------------------------------------------------------------
+
+langsci-affiliations collects, orders, and outputs author-affiliation pairs.
+It makes use of data types from LaTeX3.
+
+The package is aimed to be helpful to class authors, i.e. those who design
+and maintain document templates in publishing houses, universities, etc. The
+package is probably of only limited use to document authors/end users.
+
+langsci-affiliations was developed at Language Science Press to help in the
+production of scientific texts in linguistics.
+
+Copyright (C) 2021 by Felix Kopecky, Language Science Press
+
+This work consists of the file langsci-affiliations.dtx
+ and the derived files langsci-affiliations.ins,
+ langsci-affiliations.pdf.
+
+It may be distributed and/or modified under the conditions of the
+LaTeX Project Public License (LPPL), either version 1.3c of this
+license or (at your option) any later version. The latest version
+of this license is at <http://www.latex-project.org/lppl.txt>.
+
+This work is ``maintained'' (per LPPL maintenance status) by
+Felix Kopecky <felix.kopecky@langsci-press.org>.
+
+The development version can be found at
+
+ https://github.com/langsci/langsci-affiliations
+
+for those who are interested. Pull requests are welcome.
+
+Please report any bugs or feature requests to
+
+ https://github.com/langsci/langsci-affiliations/issues
+
+------------------------------------------------------------------------------
+\endpreamble
+\declarepreamble\minimalpreamble
+\endpreamble
+\postamble
+\endpostamble
+\usedir{tex/latex/langsci-affiliations}
+\generate{\file{\jobname.sty}{\from{\jobname.dtx}{package}}}
+%</install>
+%<install>\endbatchfile
+%<*internal>
+\usepreamble\minimalpreamble
+\usepostamble\defaultpostamble
+\usedir{source/latex/langsci-affiliations}
+\generate{\file{\jobname.ins}{\from{\jobname.dtx}{install}}}
+\endgroup
+%</internal>
+%<*driver>
+\documentclass{l3doc}
+\usepackage{langsci-affiliations}
+\usepackage[british]{babel}
+\usepackage{tikz}
+ \usetikzlibrary{arrows, arrows.meta, positioning}
+\usepackage{enumitem}
+ \setlist[description]{font=\normalfont}
+\begin{document}
+ \DocInput{\jobname.dtx}
+\end{document}
+%</driver>
+% \fi
+% \title{\pkg{langsci-affiliations}}
+% \author{Felix Kopecky\thanks{\protect\url{mailto:felix.kopecky@langsci-press.org}.
+% Please submit bug reports and feature requests to
+% \protect\url{https://github.com/langsci/langsci-affiliations/issues}.
+% }}
+% \date{Version 1.0.0 -- \today}
+% \maketitle
+% \frenchspacing
+% \begin{documentation}
+% \section{User guide}
+% This package provides a command \cmd{\ResolveAffiliations}, which collects author--affiliation pairs and outputs them according to the user configuration. It is aimed at class authors, i.e. maintainers of document templates in publishing houses, universities, etc. It is probably not that useful to document authors.
+
+% \begin{function}{\ResolveAffiliations}
+% \begin{syntax}
+% \cs{ResolveAffiliations} \oarg{options} \marg{pairs of authors and affiliations}
+% \end{syntax}
+% Takes the \marg{pairs of authors and affiliations}, orders them internally and outputs them according to the \oarg{options}.
+%
+% \marg{Pairs of authors and affiliations} is a list of authors and affiliations, where authors are separated by \verb+and+ and affiliations by \verb+;+. Affiliations are given within a phantom command \cs{affiliation} within the \marg{pairs} argument -- i.e. the command is not defined by this package and possibly existing definitions are left unchanged.
+%
+% For example:
+%
+% \begin{verbatim}
+% \ResolveAffiliations{
+% A. U. Thor\affiliation{University of the Moon; University of Mars}
+% and B. U. Thor\affiliation{University of Mars}
+% }
+% \end{verbatim}
+% results in:\\
+%
+% \noindent\ResolveAffiliations[output authors font=\normalsize]{
+% A. U. Thor\affiliation{University of the Moon; University of Mars}
+% and B. U. Thor\affiliation{University of Mars}
+% }\\
+%
+% The output can be customised using the \oarg{options}. They are described below.
+% \end{function}
+
+% \begin{function}{\SetupAffiliations}
+% \begin{syntax}
+% \cs{SetupAffiliations} \marg{options}
+% \end{syntax}
+% Options can be set either globally or locally. With \cs{SetupAffiliations}\marg{options}, they apply globally. If they are set with \cs{ResolveAffiliations}\oarg{options}, they apply locally.
+%
+% \begin{description}[style=nextline]
+% \item[|mark style =| \meta{style}\hfill (initially |alphabetic|)] Controls which markers should be used in the indexes of affiliations. Can be a either of \{|alphabetic|, |numeric|, |circled|, |none|\}.
+% \item[|output affiliation =| \meta{boolean}\hfill (initially |true|)] Affiliations are output if true, otherwise not.
+% \item[|output in groups =| \meta{boolean}\hfill (initially |true|)] If |true|, authors and affiliations are output in the same line. When |false| each author and affiliation gets its own line.
+% \item[|output authors font =| \meta{font commands}\hfill (initially |\cs{Large}|)] Stores the font settings for the ouput of authors.
+% \item[|output affiliation font =| \meta{font commands}\hfill (initially |\cs{normalsize}|)] Stores the font settings for outputting affiliations.
+% \end{description}
+%
+% \noindent Output separators between authors and affiliations are customisable as well:
+%
+% \begin{description}[style=nextline]
+% \item[|separator between two =| \meta{tokens}\hfill (initially |\char`~\&\char`~|)]
+% If there are only two authors, use these \meta{tokens} to separate them.
+% \item[|separator between multiple =| \meta{tokens}\hfill (initially |,\char`~|)]
+% If there are more than two authors, use these \meta{tokens} to separate every pair except the last one.
+% \item[|separator between final two =| \meta{tokens}\hfill (initially |\char`~\&\char`~|)]
+% Use these \meta{tokens} to separate the last pair of authors if ther are more than two.
+% \item[|separator between affiliations =| \meta{tokens}\hfill (initially |,|)]
+% Use these to separate affiliations after each authors. The affiliations in the affiliation line are always separated by a space ().
+% \end{description}
+%
+% \noindent The way the input is digested can be customised with these two settings:
+%
+% \begin{description}[style=nextline]
+% \item[|input names separator =| \meta{tokens}\hfill (initially |\char`~and\char`~|)]
+% Separates the author names in the input.
+% \item[|input affiliation separator =| \meta{tokens}\hfill (intially |;|)]
+% Separates the affiliations in the input, within dummy command \cs{affiliation}.
+% \end{description}
+%
+% \end{function}
+% \end{documentation}
+%
+% \newpage
+%
+% \begin{implementation}
+% \section{Implementation}
+% \begin{macrocode}
+%<*package>
+% \end{macrocode}
+% \begin{macrocode}
+%<@@=affiliations>
+% \end{macrocode}
+% \begin{macrocode}
+\RequirePackage{xparse}
+\ProvidesExplPackage {langsci-affiliations}
+{2021-02-17} {1.0.0}
+{A LaTeX3 package to collect and order authors and affiliations}
+% \end{macrocode}
+
+% \begin{macro}{\ResolveAffiliations}
+% The top-level document command. It is grouped to keep assignments local.
+% \begin{macrocode}
+\NewDocumentCommand{\ResolveAffiliations}{ O{} +m }
+ {%
+ \group_begin:
+ \keys_set:nn { affiliations } { #1 }%
+ \exp_args:No \affiliations_resolve:n { #2 }%
+ \group_end:
+ }
+% \end{macrocode}
+% \end{macro}
+
+% \begin{macro}{\SetupAffiliations}
+% A command to define options.
+% \begin{macrocode}
+\NewDocumentCommand{\SetupAffiliations}{ m }
+ {%
+ \keys_set:nn { affiliations } { #1 }
+ }
+% \end{macrocode}
+% \end{macro}
+% \begin{macrocode}
+\keys_define:nn { affiliations }
+ {
+ mark~style .tl_set:N
+ = \l__affiliations_style_tl,
+ mark~style .initial:n
+ = { alphabetic },
+ output~affiliation .bool_set:N
+ = \l__affiliations_output_affiliation_bool,
+ output~affiliation .initial:n
+ = { true },
+ output~in~groups .bool_set:N
+ = \l__affiliations_output_grouped_bool,
+ output~in~groups .initial:n
+ = { true },
+ separator~between~two .tl_set:N
+ = \l__affiliations_separator_between_two_tl,
+ separator~between~two .initial:n
+ = {~\&~},
+ separator~between~multiple .tl_set:N
+ = \l__affiliations_separator_between_mult_tl,
+ separator~between~multiple .initial:n
+ = {,~},
+ separator~between~final~two .tl_set:N
+ = \l__affiliations_separator_between_last_two_tl,
+ separator~between~final~two .initial:n
+ = {~\&~},
+ separator~between~affiliations .tl_set:N
+ = \l__affiliations_afil_separator_tl,
+ separator~between~affiliations .initial:n
+ = {,},
+ output~authors~font .cs_set:Np
+ = \__affiliations_output_authors_font:,
+ output~authors~font .initial:n
+ = {\Large},
+ output~affiliation~font .cs_set:Np
+ = \__affiliations_output_affiliation_font:,
+ output~affiliation~font .initial:n
+ = {\normalsize},
+ input~names~separator .tl_set:N
+ = \l__affiliations_input_names_sep_tl,
+ input~names~separator .initial:n
+ = {~and~},
+ input~affiliation~separator .tl_set:N
+ = \l_affiliations_input_afil_sep_tl,
+ input~affiliation~separator .initial:n
+ = {;}
+ }
+% \end{macrocode}
+% \begin{variable}[int]{
+% \prop_put:Nxx,
+% \prop_put:Nnx,
+% \seq_set_split:Nvn,
+% \l__affiliations_tmpa_clist,
+% \l__affiliations_tmpa_int,
+% \l__affiliations_affiliations_seq,
+% \l__affiliations_authors_seq,
+% \l__affiliations_names_seq,
+% \l__affiliations_tmpa_seq,
+% \l__affiliations_tmpb_seq,
+% \l__affiliations_tmpa_tl,
+% \l__affiliations_tmpb_tl,
+% \l__affiliations_output_prop,
+% \l__affiliations_affiliations_prop}
+% Internal variants and variables
+% \begin{macrocode}
+
+\cs_generate_variant:Nn \prop_put:Nnn { Nxx }
+\cs_generate_variant:Nn \prop_put:Nnn { Nnx }
+\cs_generate_variant:Nn \seq_set_split:Nnn { NVn }
+\clist_new:N \l__affiliations_tmpa_clist
+\int_new:N \l__affiliations_tmpa_int
+\prop_new:N \l__affiliations_tmpa_prop
+\seq_new:N \l__affiliations_affiliations_seq
+\seq_new:N \l__affiliations_authors_seq
+\seq_new:N \l__affiliations_names_seq
+\seq_new:N \l__affiliations_tmpa_seq
+\seq_new:N \l__affiliations_tmpb_seq
+\tl_new:N \l__affiliations_tmpa_tl
+\tl_new:N \l__affiliations_tmpb_tl
+\prop_new:N \l__affiliations_output_prop
+\prop_new:N \l__affiliations_affiliations_prop
+% \end{macrocode}
+% \end{variable}
+% \begin{variable}[int]{\l__affiliations_icons_prop}
+% The data for the |circled| mark style. Since this uses the \cs{char}, it is
+% only available in XeLaTeX.
+% \begin{macrocode}
+\prop_const_from_keyval:Nn \l__affiliations_icons_prop
+ {
+ 0 = \char"2460, 1 = \char"2461, 2 = \char"2462, 3 = \char"2463,
+ 4 = \char"2464, 5 = \char"2465, 6 = \char"2466, 7 = \char"2467,
+ 8 = \char"2468, 9 = \char"2469, 10 = \char"246A, 11 = \char"246B,
+ 12 = \char"246C, 13 = \char"246D, 14 = \char"246E, 15 = \char"246F,
+ 16 = \char"2470, 17 = \char"2471, 18 = \char"2472, 19 = \char"2473
+ }
+% \end{macrocode}
+% \end{variable}
+% \begin{macro}[int]{\__affiliations_resolve_affiliations:}
+% A helper macro to order affiliations. Is called by
+% \cs{affiliations_resolve:n}.
+% \begin{macrocode}
+\cs_new:Npn \__affiliations_resolve_affiliations: #1#2
+ {
+ \clist_clear:N \l__affiliations_tmpa_clist
+ \tl_if_empty:nTF {#2}
+ {
+ \prop_put:Nnn \l__affiliations_output_prop {#1} {}
+ }
+ {
+ \seq_set_split:NVn \l__affiliations_tmpa_seq
+ \l_affiliations_input_afil_sep_tl
+ { #2 }
+ \seq_map_inline:Nn \l__affiliations_tmpa_seq
+ {
+ \prop_get:NnNTF \l__affiliations_affiliations_prop
+ {##1}
+ \l__affiliations_tmpa_tl
+ {
+ \clist_put_right:NV \l__affiliations_tmpa_clist
+ \l__affiliations_tmpa_tl
+ }
+ {
+ %Not yet present
+ \clist_put_right:Nx \l__affiliations_tmpa_clist
+ {
+ \prop_count:N \l__affiliations_affiliations_prop
+ }
+ \prop_put:Nnx \l__affiliations_affiliations_prop {##1}
+ { \prop_count:N \l__affiliations_affiliations_prop }
+ }
+ }
+ \prop_put:NnV \l__affiliations_output_prop
+ {#1}
+ \l__affiliations_tmpa_clist
+ }
+ }
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}[int]{\__affiliations_output_affiliations:}
+% A helper macro that outputs the list of affiliations, usually below
+% the list of authors.
+% \begin{macrocode}
+\cs_new:Nn \__affiliations_output_affiliations:
+ {
+ \prop_map_inline:Nn \l__affiliations_affiliations_prop
+ {
+ \int_set:Nn \l__affiliations_tmpa_int { ##2 }
+ \str_case_e:nn { \l__affiliations_style_tl }
+ {
+ {alphabetic}
+ {
+ \textsuperscript{\int_to_alph:n{ \int_eval:n
+ { \l__affiliations_tmpa_int + 1 }
+ } }
+ }
+ {numeric}
+ { \textsuperscript{\int_eval:n {\l__affiliations_tmpa_int + 1} } }
+ {circled}
+ {
+ \prop_item:Nn \l__affiliations_icons_prop
+ {\l__affiliations_tmpa_int}
+ }
+ {none} { }
+ }
+ ##1 ~
+ }
+ }
+% \end{macrocode}
+% \end{macro}
+% \begin{macro}[int]{\__affiliations_return_afil_text:n}
+% A helper macro that returns the affiliation marks.
+% \begin{macrocode}
+\cs_new:Npn \__affiliations_return_afil_text:n #1
+ {
+ \int_set:Nn \l__affiliations_tmpa_int { #1 }
+ \str_case_e:nn { \l__affiliations_style_tl }
+ {
+ {alphabetic}
+ {
+ \seq_put_right:Nx \l__affiliations_tmpb_seq
+ { \int_to_alph:n{ \int_eval:n {#1 + 1} } }
+ }
+ {numeric}
+ {
+ \seq_put_right:Nx \l__affiliations_tmpb_seq
+ { \int_eval:n {\l__affiliations_tmpa_int + 1} }
+ }
+ {circled}
+ {
+ \seq_put_right:Nx \l__affiliations_tmpb_seq
+ { \prop_item:Nn \l__affiliations_icons_prop
+ { \l__affiliations_tmpa_int} }
+ }
+ {none} { }
+ }
+ }
+% \end{macrocode}
+% \end{macro}
+
+% \begin{macro}[int]{\__affiliations_output_authors:}
+% A helper macro to output the list of authors, with affiliation marks (if any).
+% \begin{macrocode}
+\cs_new:Nn \__affiliations_output_authors:
+ {
+ \seq_clear:N \l__affiliations_tmpa_seq
+ \prop_map_inline:Nn \l__affiliations_output_prop
+ {
+ \seq_clear:N \l__affiliations_tmpb_seq
+ \clist_map_function:nN {##2} \__affiliations_return_afil_text:n
+ \tl_set:Nn \l__affiliations_tmpb_tl
+ {
+ \seq_use:Nn \l__affiliations_tmpb_seq
+ {\l__affiliations_afil_separator_tl}
+ }
+ \seq_put_right:Nx \l__affiliations_tmpa_seq
+ {
+ \tl_rescan:nn {} {##1}
+ \exp_not:N \textsuperscript{\tl_use:N \l__affiliations_tmpb_tl}
+ }
+ }
+ \seq_use:Nnnn \l__affiliations_tmpa_seq
+ {\l__affiliations_separator_between_two_tl}
+ {\l__affiliations_separator_between_mult_tl}
+ {\l__affiliations_separator_between_last_two_tl}
+ }
+% \end{macrocode}
+% \end{macro}
+
+% \begin{macro}[int]{\affiliations_resolve:n}
+% The main macro.
+% \begin{macrocode}
+\cs_new:Npn \affiliations_resolve:n #1
+ {
+ \seq_set_split:NVn \l__affiliations_names_seq
+ \l__affiliations_input_names_sep_tl
+ { #1 }
+ \seq_map_inline:Nn \l__affiliations_names_seq
+ {
+ \seq_clear_new:N \l__affiliations_names_tmp_seq
+ \seq_set_split:Nnn \l__affiliations_names_tmp_seq { \affiliation }
+ { ##1 }
+ \prop_put:Nxx \l__affiliations_tmpa_prop
+ { \seq_item:Nn \l__affiliations_names_tmp_seq {1} }
+ { \seq_item:Nn \l__affiliations_names_tmp_seq {2} }
+ }
+ \bool_if:NTF \l__affiliations_output_affiliation_bool
+ {
+ \bool_if:NTF \l__affiliations_output_grouped_bool
+ {
+ \prop_map_function:NN \l__affiliations_tmpa_prop
+ \__affiliations_resolve_affiliations:
+ \group_begin:
+ \__affiliations_output_authors_font:
+ \__affiliations_output_authors:
+ \group_end:\\[0.5ex]
+ \group_begin:
+ \__affiliations_output_affiliation_font:
+ \__affiliations_output_affiliations:
+ \group_end:
+ }
+ {
+ \prop_map_inline:Nn \l__affiliations_tmpa_prop
+ {
+ \__affiliations_output_authors_font:
+ \tl_rescan:nn {} {##1}\\[0.5ex]
+ \group_begin:
+ \__affiliations_output_affiliation_font:
+ \tl_rescan:nn {} {##2}
+ \group_end:
+ \medskip\\
+ }
+ }
+ }
+ {
+ \group_begin:
+ \__affiliations_output_authors_font:
+ \seq_clear:N \l__affiliations_tmpa_seq
+ \prop_map_inline:Nn \l__affiliations_tmpa_prop
+ {
+ \seq_put_right:Nx \l__affiliations_tmpa_seq
+ {\tl_rescan:nn {} {##1} }
+ }
+ \seq_use:Nnnn \l__affiliations_tmpa_seq
+ {\l__affiliations_separator_between_two_tl}
+ {\l__affiliations_separator_between_mult_tl}
+ {\l__affiliations_separator_between_last_two_tl}
+ \group_end:
+ }
+ }
+% \end{macrocode}
+% \end{macro}
+% \begin{macrocode}
+%</package>
+% \end{macrocode}
+%
+% \end{implementation}
+
+% \PrintIndex