dsek.sty

%%% D-sek common package

\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{dsek}[2022/09/26]

\RequirePackage{expl3}

\ExplSyntaxOn

\RequirePackage{xparse}
\RequirePackage{graphicx}
\RequirePackage{enumitem}
\RequirePackage{xcolor}
\RequirePackage{soul}

\str_new:N \g_dsek_image_dir_str
\str_gset:Nn \g_dsek_image_dir_str { images/ }

\bool_new:N \g_dsek_in_color_bool

%%% Options
%% Graphics in color or in black and white by default?
\DeclareOption{color}{\bool_set_true:N \g_dsek_in_color_bool}
\DeclareOption{bw}   {\bool_set_false:N \g_dsek_in_color_bool}

\ProcessOptions\relax

%%% Commands
%% Snippets

\tl_const:Nn \c_dsek_long_name_tl {D-sektionen~inom~TLTH}
\NewDocumentCommand \Dseklongname {} {\tl_use:N \c_dsek_long_name_tl}

\tl_const:Nn \c_idet_name_tl {iDét}
\NewDocumentCommand \idet {} {\tl_use:N \c_idet_name_tl}

% Commitees

\tl_const:Nn \c_medaljk_name_tl {Medaljelelekommitén}
\NewDocumentCommand \medaljk {} {\tl_use:N \c_medaljk_name_tl}

% Positions

\tl_const:Nn \c_overphos_name_tl {Øverphøs}
\NewDocumentCommand \overphos {} {\tl_use:N \c_overphos_name_tl}

\tl_const:Nn \c_overpeppare_name_tl {Øverpeppare}
\NewDocumentCommand \overpeppare {} {\tl_use:N \c_overpeppare_name_tl}

\tl_const:Nn \c_medaljk_member_name_tl {Medaljelelekommitémedlem}
\NewDocumentCommand \medaljkmedlem {} {\tl_use:N \c_medaljk_member_name_tl}

%% Graphics

\dim_new:N \l_dsek_height_dim

% A helper command for creating graphic commands
\cs_new_protected:Npn \__dsek_graphic:nn #1#2 {
  \group_begin:

  \bool_set_eq:NN \l_dsek_in_color_bool \g_dsek_in_color_bool

  \dim_set:Nn \l_dsek_height_dim {10pt}

  % Define how options passed are going to be handled
  \keys_define:nn { dsek / graphics } {
    bw     .bool_set_inverse:N = \l_dsek_in_color_bool,
    bw     .default:n = {true},

    color  .bool_set:N = \l_dsek_in_color_bool,
    color  .default:n = {true},

    height .dim_set:N = \l_dsek_height_dim,
  }

  % Process the options
  \keys_set:nn { dsek / graphics } { #2 }

  % Actually insert the graphics
  \includegraphics[height = \l_dsek_height_dim] {
    \g_dsek_image_dir_str #1
    \bool_if:NTF \l_dsek_in_color_bool
      {-color}
      {-bw}
  }
  \group_end:
}

\cs_generate_variant:Nn \__dsek_graphic:nn { nx }

\NewDocumentCommand{\Dsymbol}{ O{} } {
  \__dsek_graphic:nx { D-symbol } { #1 , color=false }
}

\NewDocumentCommand{\Dseksigil}{ O{} } {
  \__dsek_graphic:nx { D-guild-sigil } { #1 }
}

\NewDocumentCommand{\Cprogsigil}{ O{} } {
  \__dsek_graphic:nx { C-program-sigil } { #1 }
}

\NewDocumentCommand{\Dprogsigil}{ O{} } {
  \__dsek_graphic:nx { D-program-sigil } { #1 }
}

%% Marking changes

\NewDocumentCommand{\add}{ m } {
  \sethlcolor{yellow}
  \hl{#1}
}

\cs_new_eq:NN \läggtill \add

\NewDocumentCommand{\strike}{ m } {
  \sethlcolor{red}
  \hl{#1}
  \sethlcolor{yellow}
}

\cs_new_eq:NN \stryk \strike

%% Lists

\NewDocumentEnvironment{boldlist}{ m } {
  \begin{itemize}[label=\textbf{ #1 },
                  labelsep=.5em]
} {
  \end{itemize}
}

%%% Att lists

\newcounter{DsekAttList} % Number of att-lists
\setcounter{DsekAttList}{0}

\newcounter{DsekAttListItem} % Item in the att-list

\tl_const:Nn \c_dsek_att_list_enumerated_format_tl {
  \stepcounter{DsekAttListItem}
  {\footnotesize {\color{gray}\arabic{DsekAttListItem}}}~\textbf{att}
}

\tl_const:Nn \c_dsek_att_list_plain_format_tl {
  \textbf{att}
}

\bool_new:N \l__dsek_enumerate_bool
\tl_new:N \l__dsek_att_list_format_tl

\NewDocumentCommand \attlistformat { } {
  \tl_use:N \l__dsek_att_list_format_tl
}

\NewDocumentEnvironment{attlist}{ o } {
  \setcounter{DsekAttListItem}{0}
  \stepcounter{DsekAttList}

  \group_begin:

  % We use attlist:<num> labels to know the item count of attlists so that we
  % can number them dynamically.  If there are more than 3 items we want to
  % enumerate them.
  \int_compare:nNnTF {\getrefnumber{attlist:\arabic{DsekAttList}}} > {3}{
    \bool_set_true:N \l__dsek_enumerate_bool
  } {
    \bool_set_false:N \l__dsek_enumerate_bool
  }

  \keys_define:nn { dsek / attlist } { % Declare option keys
    num .bool_set:N = \l__dsek_enumerate_bool,
    num .default:n = {true},

    nonum .bool_set_inverse:N = \l__dsek_enumerate_bool,
    nonum .default:n = {true},
  }

  \IfValueT{#1} {\keys_set:nn { dsek / attlist } { #1 }} % Process keys

  \bool_if:NTF \l__dsek_enumerate_bool {
    \tl_gset_eq:NN \l__dsek_att_list_format_tl
                   \c_dsek_att_list_enumerated_format_tl
  } {
    \tl_gset_eq:NN \l__dsek_att_list_format_tl
                   \c_dsek_att_list_plain_format_tl
  }

  \begin{enumerate}[label=\attlistformat,
                    labelsep=.5em,]

} {
  \tl_set:Nx \@currentlabel { \arabic{\@enumctr} }
  \label{attlist:\arabic{DsekAttList}}
  \end{enumerate}
  \group_end:
}

%% Handy commands to be used in att-lists
\NewDocumentCommand \att { m } {
  \item #1
}

\NewDocumentCommand \attdesc { m m } {
  \item #1 \begin{description} \item \textit{#2} \end{description}
}

%% Signatures

\dim_new:N \g_dsek_sign_space_height
\dim_gset:Nn \g_dsek_sign_space_height {15mm}

\NewDocumentCommand{\setsignspaceheight}{ m }{
  \dim_gset:Nn \g_dsek_sign_space_height { #1 }
}

\dim_new:N \g_dsek_sign_space_min_width
\dim_gset:Nn \g_dsek_sign_space_min_width {40mm}

\NewDocumentCommand{\setsignspaceminwidth}{ m }{
  \dim_gset:Nn \g_dsek_sign_space_min_width { #1 }
}

\dim_new:N \l__dsek_sign_width
\str_new:N \l__dsek_sign_filename

\NewDocumentCommand{\signature}{ o m m m } {
  \group_begin:
  \dim_zero_new:N \l__dsek_sign_space_height
  \dim_set_eq:NN \l__dsek_sign_space_height \g_dsek_sign_space_height

  \settowidth{\l__dsek_sign_width}{#2}
  \settowidth{\l_tmpa_dim}{#3}

  \dim_set:Nn \l__dsek_sign_width {
    \dim_max:nn {\l_tmpa_dim} {\l__dsek_sign_width}
  }

  \settowidth{\l_tmpa_dim}{#4}

  \dim_set:Nn \l__dsek_sign_width {
    \dim_max:nn {\l_tmpa_dim} {\l__dsek_sign_width}
  }

  \dim_set:Nn \l__dsek_sign_width {
    \dim_max:nn {\g_dsek_sign_space_min_width} {\l__dsek_sign_width}
  }

  \keys_define:nn { dsek / signatures } {
    hspace   .dim_set:N = \l__dsek_sign_space_height,
    width    .dim_set:N = \l__dsek_sign_width,
    signfile .str_set:N = \l__dsek_sign_filename_tl
  }

  \IfValueT{#1} {\keys_set:nn { dsek / signatures } { #1 }}

  \begin{tabular}{l}
    #2 \\
    \parbox[c][\l__dsek_sign_space_height]{\l__dsek_sign_width}{
      \str_if_empty:NF \l__dsek_sign_filename_tl {
        \includegraphics[
          keepaspectratio=true,
          width=\l__dsek_sign_width,
          height=\g_dsek_sign_space_height
        ] {
          \tl_use:N \l__dsek_sign_filename_tl
        }
      }
    }  \\
    #3 \\
    #4 \\
    \phantom{}
  \end{tabular}
  \hspace{2em}
  \group_end:
}

\ExplSyntaxOff