Spell labels

[raphael-proust]

It would be useful to be able to specify a label for the spells. That would allow hyperlinking from a spell list to a spell description. The following is a suggestion/use-case:

\section{Spell List}
…
\hyperlink{Some Magic}{spell:some-magic}
…

\section{Spell Descriptions}
…
\begin{spell}[label=spell:some-magic]
    {Some Magic}
    …
\end{spell}
…

[BrianCriswell]

Here is some code that I can import in later. I am working on an international move, and time is in short supply!

%  
%Page target for setting up "see LINK on page ##"
%
\newcommand{\pagetarget}[2]{
\phantomsection%
\label{#1}
\hypertarget{#1}{#2}
}

\newcommand\pagelink[2]{%
\hyperlink{#1}{#2}\iftoggle{bool-bg-print}{ \textbf{\textit{pg.~\pageref{#1}}}}{}%
}

The pagetarget macro sets up both label and hypertarget. In your use case, only the hypertarget portion is useful, but pagelink could be used in an entirely different part of the book. In that case, the spell could be referenced, and if it is the print version where a hyperlink does not show up and is not useful, the page number is added for quick reference.

As for adding it the target label, is there not an easy way to convert the provided spell name to convert to lowercase and change all other punctuation to dashes?

[benwebber]

As for adding it the target label, is there not an easy way to convert the provided spell name to convert to lowercase and change all other punctuation to dashes?

I spent a bit of time trying to figure this out. I couldn't find any packages that "slugify" a string.

It's easy to lowercase the name and replace certain characters using the \lccode trick, but you have to specify the characters yourself. I couldn't figure out a way to strip all non-alphanumeric characters.

[BrianCriswell]

With the conversion to LaTeX3, this should be significantly easier whether through a regex replace or through other means. Although the ref I used in #164 doesn't do any special handling of non-alphanumeric characters.

[benwebber]

It's also easy to write a "slugify" function in Lua and use LuaTeX (I've done this locally). I've also used Lua to replace the dice calculations (it's faster than fp and xfp/LaTeX3). Better LuaTeX support (rather, taking advantage of it) is one of my goals for this package.

[BrianCriswell]

Maybe it would work better to just add an option for the link text? Then the function will take care of the busywork but allow the user to set define the text.