# LaTeX output local lists on root document

This is a followup question for this question, where Christian Hupfer provided me a great solution for a certain problem: I wanted to list the occurrences of special commands within a section at the beginning of that section. That works perfectly well.

Now I want to expand the scope of this thing a bit by displaying the contents of all those lists on one page, preferably at the beginning of the document. I see that the code works by using local lists that have limited scope. Is it somehow possible to add a global lists for each section, so these could be accessed from outside the section? I couldn't find any helpful information on this on the net.

• With other words, you want to have some kind of a List of Persons for the whole document? – user31729 Feb 14 '18 at 7:46
• Yes and no, I mean some kind of overview which person occurs in which scene (section) of the document. Like the Output of \DisplayPersons in each section aggregated on page. Maybe it would be enough to know how to create a token list for each section, like including the section number in the token list name, and how to iterate over these... Or maybe where these token lists are documeted... Thanks in advance! – LukeLR Feb 14 '18 at 23:40
• I'll take a look later on. Basically, you're requesting an index – user31729 Feb 15 '18 at 10:58
• @ChristianHupfer Do you think, you might find the time to give me some hints or point me to the right direction? :) – LukeLR Mar 14 '18 at 20:57
• I haven't forgot this question, but I am little bit short of time ... – user31729 Mar 14 '18 at 20:59

This extends the previous solution I gave in the answer linked to by the O.P.

Basically, I apply the same strategy as storing the appearance of a person on a per section base again, by collection the section numbers in which a person appears with labels and then extract this list again and setting up a \ListOfPersons table, made with long table, with hyperlinks to the relevant sections.

I think, the code can be condensed a little bit, but here you go:

\documentclass{scrartcl}

\usepackage{array}
\usepackage{longtable}
\usepackage{xcolor}
\usepackage{refcount}
\usepackage{xparse}
\usepackage{hyperref}

\newcolumntype{L}[1]{>{\raggedright}p{#1}}
\newcolumntype{R}[1]{>{\raggedleft}p{#1}}

\ExplSyntaxOn
\seq_new:N \g_luke_listofpersons_seq
\seq_new:N \l_luke_listofpersons_seq

\seq_if_in:NnF \g_luke_listofpersons_seq {#1} {
\seq_gput_right:Nn \g_luke_listofpersons_seq {#1}
\seq_gremove_duplicates:N \g_luke_listofpersons_seq
\seq_new:c {g_luke_#1_scene_seq }
}
\int_compare:nNnT {\number\value{section}} > {0} {
\seq_gput_right:cx {g_luke_#1_scene_seq } {\thesection}
}
}

\seq_gput_right:Nn \l_luke_listofpersons_seq {#1}
\int_compare:nNnT {\number\value{section}} > {0} {
\seq_gput_right:cx {g_luke_#1_scene_seq } {\thesection}
}
%  \seq_show:c {g_luke_#1_scene_seq }
}

\seq_if_in:NnF \l_luke_listofpersons_seq {#1} {#2}
}

\NewDocumentCommand{\DisplayPersons}{}{%
\seq_clear:N \l_luke_listofpersons_seq
\group_begin:
\seq_clear:N \l_tmpa_seq
\seq_map_inline:Nn \g_luke_listofpersons_seq {%
\IfRefUndefinedExpandable{##1\thesection}{}{
\seq_put_right:Nn \l_tmpa_seq {\use:c{##1h}}
}
}
\seq_if_empty:NF \l_tmpa_seq {
\PrePersonList
\seq_use:Nn \l_tmpa_seq {,~}
\PostPersonList
}
\group_end:
}

\cs_generate_variant:Nn \seq_set_from_clist:Nn {Nx}

% This creates the table entry line per person, by 'cracking' the stored list of sections into the relevant section number and then provides a hyper link
\cs_new:Npn \generatelistofpersonstableline {
\seq_map_inline:Nn \g_luke_listofpersons_seq  {
\seq_set_from_clist:Nx \l_tmpa_seq {\getrefnumber{person::##1}}
\seq_if_empty:NF \l_tmpa_seq {
\use:c{##1h} &     \seq_set_from_clist:Nx \l_tmpa_seq {\getrefnumber{person::##1}}
\int_set:Nn \l_tmpa_int {\seq_count:N \l_tmpa_seq}
\int_zero:N \l_tmpb_int
\seq_map_inline:Nn \l_tmpa_seq {
\int_incr:N \l_tmpb_int
\else
####1
\fi
\int_compare:nNnF {\l_tmpa_int} = {\l_tmpb_int} {
,\space
}
}
\tabularnewline
}
}
}

\NewDocumentCommand{\ListOfPersons}{}{%
\begin{longtable}{L{5cm}R{10cm}}
\bfseries Person & \bfseries Sections \tabularnewline
\generatelistofpersonstableline
\end{longtable}
}
\makeatletter

\NewDocumentCommand{\storelistofpersons}{}{%
\seq_map_inline:Nn \g_luke_listofpersons_seq  {
\protected@edef\@currentlabel{\seq_use:cn {g_luke_##1_scene_seq}{,}}
\label{person::##1}%
% ##1 \space \seq_use:cn {g_luke_##1_scene_seq}  {,}
% \par
}
}
\makeatother

\AtEndDocument{%
\storelistofpersons%
}

\ExplSyntaxOff

\NewDocumentCommand{\PostPersonList}{}{%
\bigskip%

}

\NewDocumentCommand{\displayindividualperson}{m}{%
\textbf{#1}%
}

\NewDocumentCommand{\PrePersonList}{}{%
{\large \bfseries Persons in Section \thesection}

}

\makeatletter
\NewDocumentCommand{\NewPerson}{m+m}{%
% Add this person to the global list
% Now define the personal \...x command
\expandafter\NewDocumentCommand\csname #1x\endcsname{+m}{%
%Check if the person has been called in the local section already
% Add the personal to the local list, i.e. per section
% Check whether the label has been defined already
\protected@edef\@currentlabel{\thesection.#1}\label{#1\thesection}
}%
\textsc{#1:} ##1%
}% End of the \...x command
\expandafter\NewDocumentCommand\csname #1h\endcsname{}{%
#2{#1}%
}
}% End of \NewPerson
\makeatother

\NewPerson{tom}{\colorbox{green}}
\NewPerson{frodo}{\colorbox{yellow}}
\NewPerson{Gandalf}{\fcolorbox{yellow}{yellow!60!blue}}
\NewPerson{Paulo}{\colorbox{green}}
\NewPerson{David}{\colorbox{orange}}

\begin{document}

\ListOfPersons

\section{In the supermarket}
\DisplayPersons
\tomx{Hi, I'm Tom!}

\frodox{Hi, I'm Frodo!}

\section{At TeX.SE}

\DisplayPersons

\frodox{Hi, I'm Frodo!}

\frodox{I am going to Mordor}

\Gandalfx{Cast the ring into the fire!}

\tomx{Waiting for Godot}

\section{In TeX.SE Chat}

\DisplayPersons

\Paulox{Quack!}

\Gandalfx{Quack!}

\Davidx{I've got a recipe for Duck in Orange Sauce}

\tomx{That's marvellous}

\frodox{Pineapple pizza!}

\end{document}


• ahahah The lord of the rings :-)+1. – Sebastiano Mar 19 '18 at 0:27
• @Sebastiano I didn't know that Paulo and David played a role in that movie :) – CarLaTeX Mar 19 '18 at 17:44
• @CarLaTeX: Don't you know Tolkien's Duck Chronicles of Middle Earth? ;-) – user31729 Mar 19 '18 at 17:46
• @ChristianHupfer Ooooh, I immediately search for it on Amazon :) – CarLaTeX Mar 19 '18 at 17:46
• @CarLaTeX ahahahahahahaah. – Sebastiano Mar 19 '18 at 17:51