Improve/test refs

[wiobber]

\ref / \hyperref to labels do not work properly

(Mail PZachlin)

[wiobber]

Existing label/ref commands:

Command	Purpose	Needs hyperref?
\label{key}	Marks a place for referencing	❌ No
\ref{key}	Inserts number of label	❌ / ✅ Clickable if hyperref
\pageref{key}	Page number of label	❌ / ✅ Clickable if hyperref
\hyperref[key]{text}	Link to label with custom text	✅ Yes
\hypertarget{htkey}{}	Define a custom anchor	✅ Yes
\hyperlink{htkey}{text}	Link to \hypertarget{htkey}	✅ Yes
\url{url}	Inserts url	❌ / ✅ Clickable if hyperref
\href{url}{text}	External link	✅ Yes

Suggestion for \xmref

Command	Command with [text]
\xmref{key}	\xmref[text]{key}
	\xmref[type=hypertarget,text]{htkey}
$\xmref{key}$	$\xmref[text]{key}$ (NOT IMPLEMENTED)
\xmref{url}	\xmref[text]{url}
\xmref[type=url]{url}	\xmref[[type=url,text]{url}

Notes:

• This would probably also replace \link ?
• Relation \hypertarget and \ref to put anchors to be investigated (in LaTeX, PDF and HTML !)
• text should not contain comma's, unless in braces, ie {text, more text}
• PDF to be decided:
  • if url print url unless text is available, then print text with the urlin footnote?
  • quid with key and no text? Use \ref, but how to implement with link to other activity?
  • needs changes in xake/server ...?