在长表中嵌入索引或词汇表，并在参数中自动执行超链接和分隔符

Question

我问这个问题已经很久了，我相信我的答案是对的。

基本思路如下，使用一个\rc包含三个参数的宏。第一个参数用于实际代码（index 生成的表中的第一列和第二列）。此代码嵌入在\mintinlineminted v2.0 alpha 3 中的新命令中，可下载这里)。第二个参数用于索引中的第三列，我用它来“解释”每一行。第三个参数将设置从文档中的点到附录/索引页的来回链接。（索引中的箭头将带您到您进行调用的点\rc，而将marginpar带您到索引。）

代码如下。索引样式和所有内容将自动生成，可独立运行*。

编辑如果您希望真正复制并粘贴下面的代码，您可能需要适合math.pyminted 的样式文件和词法分析器。我已经上传了样式这里和词法分析器这里。

\documentclass{article}
\usepackage{longtable}
\usepackage{imakeidx}
\usepackage{multirow}
\usepackage{booktabs}
\usepackage{ragged2e}
\usepackage{xcolor}
\usepackage{array}
\usepackage{geometry}
\usepackage{minted}
\usepackage[T1]{fontenc}
\usepackage{filecontents}
\usepackage{kantlipsum}
\usepackage{hyperref}

\newcommand{\code}{\mintinline[style=euryris]{r}}

% some stuff for the index layout
\begin{filecontents}{index_rc.ist}
preamble "\\let\\HoldMyBeer\\hyperpage\n
\\renewcommand\\hyperpage\\mygobble\n
\\begin{theindex}\n\\noindent{\\renewcommand\\arraystretch{2.45}\\begin{longtable}[h]{>{\\RaggedRight\\arraybackslash}m{\\dimexpr.2\\linewidth-2\\tabcolsep} >{\\RaggedRight\\arraybackslash}m{\\dimexpr.3\\linewidth-2\\tabcolsep} >{\\RaggedRight\\arraybackslash}m{\\dimexpr.4\\linewidth-2\\tabcolsep} >{\\centering\\arraybackslash}m{\\dimexpr.1\\linewidth-2\\tabcolsep}} \\textbf{\\textcolor{blue}{R}} code & Syntax & Gebruik & Link
\\\\*\\noalign{\\vspace*{2.5ex}}\\pagebreak[1]
\\hline
\\endhead\\mygobble"
postamble "\n\\end{longtable}}\n\\end{theindex}\n\\let\\hyperpage\\HoldMyBeer\n"
item_0 "\\\\\n\\mymacro"
delim_0 ""
\end{filecontents}

\begin{filecontents}{index-begrip.ist}
preamble "\\let\\HoldMyBeer\\hyperpage\n
\\renewcommand\\hyperpage\\mygobble\n
\\begin{theindex}\n\\noindent{\\renewcommand\\arraystretch{2.7}\\begin{longtable}[h]{>{\\RaggedRight\\arraybackslash}m{\\dimexpr.225\\linewidth-2\\tabcolsep} >{\\RaggedRight\\arraybackslash}m{\\dimexpr.65\\linewidth-2\\tabcolsep} >{\\RaggedRight\\arraybackslash}m{\\dimexpr.1\\linewidth-2\\tabcolsep}} Begrip & Betekenis & Link
\\\\*\\noalign{\\vspace*{2.5ex}}\\pagebreak[1]
\\hline
\\endhead\\mygobble"
postamble "\n\\end{longtable}}\n\\end{theindex}\n\\let\\hyperpage\\HoldMyBeer\n"
item_0 "\\\\\n\\begripmacro"
delim_0 ""
\end{filecontents}

\begin{filecontents}{index_glossary.ist}
headings_flag 1
heading_prefix "{\\bfseries \\scshape "
heading_suffix "}\\nopagebreak\n"
symhead_positive "Symbolen"
symhead_negative "symbolen"
item_0 " \n  \\itshape\\item  "
item_1 " \n  \\itshape\\item  "
item_2 " \n  \\itshape\\item  "
delim_0 " \\dotfill "
delim_1 " \\dotfill "
delim_2 " \\dotfill "
\end{filecontents}

\makeindex[name = rc, title = \textbf{\textcolor{blue}{R}} commando's,options=-s index_rc,columns=1]
\makeindex[options= -s index_glossary]
\makeindex[name = begrip, title = Begrippenlijst,options=-s index-begrip,columns=1]

\makeatletter
\newcommand{\target}[1]{\Hy@raisedlink{\hypertarget{#1}{}\relax}} 
\makeatother 

\ExplSyntaxOn

\tl_new:N \g__ioiooiioio_link_name_tl

\NewDocumentCommand{\mymacro}{ m m m } 
 {
  \ioiooiioio_setargs:nnn { #1 } { #2 } { #3 }
  \ioiooiioio_print: 
 }

\seq_new:N \l__ioiooiioio_first_col_seq
\seq_new:N \l__ioiooiioio_second_col_seq
\tl_new:N \l__ioiooiioio_table_body_tl
\int_new:N \l__ioiooiioio_step_int
\int_new:N \l__ioiooiioio_args_int

\cs_new_protected:Npn \ioiooiioio_setargs:nnn #1 #2 #3
 {
  \seq_set_split:Nnn \l__ioiooiioio_first_col_seq { , } { #1 }
  \seq_set_split:Nnn \l__ioiooiioio_second_col_seq { , } { #2 }
  \tl_clear:N \l__ioiooiioio_table_body_tl
  \tl_gclear:N \g__ioiooiioio_link_name_tl
  \int_zero:N \l__ioiooiioio_step_int
  \int_zero:N \l__ioiooiioio_args_int
  \tl_gset:Nn \g__ioiooiioio_link_name_tl { #3 }
  \int_set:Nn \l__ioiooiioio_args_int { \seq_count:N \l__ioiooiioio_first_col_seq }
  \seq_mapthread_function:NNN
     \l__ioiooiioio_first_col_seq
     \l__ioiooiioio_second_col_seq
     \__ioiooiioio_fill_body:nn
 }

\cs_new_protected:Npn \__ioiooiioio_fill_body:nn #1 #2
  {
    \int_incr:N \l__ioiooiioio_step_int
    \int_compare:nTF { \l__ioiooiioio_step_int = \c_one }
  {    
    \tl_put_right:Nn \l__ioiooiioio_table_body_tl { 
    & \target{ appendix.rc. \g__ioiooiioio_link_name_tl }\code{#1(} & #2 & 
    }
   }   
    {
   \int_compare:nTF { \l__ioiooiioio_step_int = \l__ioiooiioio_args_int }
   {
    \tl_put_right:Nn \l__ioiooiioio_table_body_tl { 
    & \code{#1)} & #2 & 
    }
   }
   {
    \tl_put_right:Nn \l__ioiooiioio_table_body_tl { 
    & \code{#1} & #2 & }
   }
   } 
    \int_compare:nT { \l__ioiooiioio_step_int = \c_one }
  {
     \tl_put_right:Nx \l__ioiooiioio_table_body_tl
       {
         \exp_not:N \multirow { \int_use:N \l__ioiooiioio_args_int } { * } 
           {
             \exp_not:N \hyperlink 
               { doc.rc.\g__ioiooiioio_link_name_tl } 
               { $ \leftarrow $ }
           }
       }
  }
     \int_compare:nTF { \l__ioiooiioio_step_int = \l__ioiooiioio_args_int} 
       {
         \tl_put_right:Nn \l__ioiooiioio_table_body_tl
           { \\ } 
       }
       {
       \tl_put_right:Nn \l__ioiooiioio_table_body_tl
           { \\* }
       }
   }

\cs_new_protected:Npn \ioiooiioio_print:
 {
 \multirow{ \int_use:N \l__ioiooiioio_args_int }{*}
 { 
\begingroup\edef\code{\endgroup\noexpand\mintinline[style=euryris]{r}{\seq_item:Nn \l__ioiooiioio_first_col_seq { \c_one }()}}\code 
 } 
 \l__ioiooiioio_table_body_tl
   }

\NewDocumentCommand{\mymargin}{ m } 
 {
  \ioiooiooio_determine_args:n { #1 } 
  \ioiooiooio_print: 
 }

\seq_new:N \l__ioiooiooio_arguments_seq
\tl_new:N \l__ioiooiooio_mapped_args_tl

\cs_new_protected:Npn \ioiooiooio_determine_args:n #1 
 {
  \seq_set_split:Nnn \l__ioiooiooio_arguments_seq { , } { #1 }
  \tl_clear:N \l__ioiooiooio_mapped_args_tl
  \seq_map_function:NN
     \l__ioiooiooio_arguments_seq
     \__ioiooiooio_mapped_args:nn
 }

\cs_new_protected:Npn \__ioiooiooio_mapped_args:nn #1 
  {
    \tl_put_right:Nn \l__ioiooiooio_mapped_args_tl { #1 }
   }

\cs_new_protected:Npn \ioiooiooio_print:
 {
\begingroup\edef\code{\endgroup\noexpand\mintinline[style=euryris]{r}{\seq_item:Nn \l__ioiooiooio_arguments_seq { \c_one }()}}\code 
 } 

\ExplSyntaxOff
\newcommand{\mygobble}[1]{}%
\newcommand{\marginbox}[2]{\marginpar[]{\resizebox{\ifdim\width>\marginparwidth\marginparwidth\else\width\fi}{!}{\hyperlink{#1}{#2\marginformat}}}}
\newcommand{\marginformat}{~$\rightarrow$}
\newcommand{\rc}[3]{
\index[rc]{{#1}{#2}{#3}}
\target{doc.rc.#3}
\marginbox{appendix.rc.#3}{\mymargin{#1}}
}

\newcommand{\begripmacro}[3]{#1&\target{appendix.begrip.#3}#2&\hyperlink{doc.begrip.#3}{$\leftarrow$}}
\newcommand{\begrip}[3]{
\index[begrip]{{#1}{#2}{#3}}
\target{doc.begrip.#3}
\marginbox{appendix.begrip.#3}{\textit{#1}}
}

\begin{document}

\code{read.table()} % mintinline works fine before using index

abc

some more indices\index{index}\index{test}

Really really really really really really really really really really really really really really really really really really really really really really really really really really really really really really really long line.\begrip{een}{begrip}{longline}

\kant[1-3]A really long sentence involving nothing related Kant, but is fully explanatory.\rc{read.table,een,twee,drie}{stuff,meer,stuff,stuff}{stuff} \\ \kant[4]

\printindex[rc] 

\printindex[begrip] % define an arbitrary glossary style
\printindex % other indexes work just fine

\code{read.table()} % mintinline also works fine after using index

\end{document}

BUGLIST 和注释

\rc：

要使用宏（如上\code例所示），请改用\protect\code{...}。
里面的引号\code不起作用。请使用两个引号，例如\rc{read.table,""filename""}{...}{...}。
使用\code{"..."} 还需要双引号或索引项不会出现.（我甚至不知道这是如何工作的，但我只想在这里提一下）
$...$ 目前不支持在宏中使用类似的数学环境\rc。
报告您发现的任何其他错误。

Answer 1