<?xml version="1.0" encoding="UTF-8"?>

<record version="1" id="21">
 <title>Manual Linking Controls and LaTeX Examples</title>
 <created>2026-09-01 03:29:29</created>
 <modified>2026-09-01 03:29:29</modified>
 <creator id="1" name="bloftin"/>
 <modifier id="1" name="bloftin"/>
 <comment>Got the whole article in after solving the rendering issue server side with Issue #198</comment>
 <author id="1" name="bloftin"/>
 <content>\documentclass{article}
\usepackage{amsmath}
\usepackage{amssymb}
\usepackage{amsfonts}
\usepackage[colorlinks=true,linkcolor=blue,citecolor=blue,urlcolor=blue]{hyperref}


\providecommand{\PMlinkexternal}[2]{\href{#2}{#1}}

\title{Manual Linking Controls and LaTeX Examples}
\author{}
\date{}

\begin{document}

\maketitle


\section{Manual Linking Controls and LaTeX Examples}

PhysicsLibrary automatically links encyclopedia terms when it can resolve them
unambiguously. Manual linking controls let authors guide that process when the
automatic linker needs help, when a phrase should not be linked, or when a link
should point to a specific object, file, or external source.

This document is both a short user manual and a reference page of examples. It is
intended for authors writing encyclopedia entries, collaboration documents, and
site documentation.

\section{Automatic links}

When an article mentions a known concept such as vector, matrix, quaternion, or
Euler angle, PhysicsLibrary may automatically link that phrase to an encyclopedia
entry.

For example, this sentence intentionally mentions a vector, a matrix, and a
quaternion.

Automatic links are useful, but authors sometimes need more control. The manual
commands below are used for that.

\section{Link to an encyclopedia entry by canonical name}

Use \verb|\PMlinkname| when the visible link text should differ from the target
entry name.

\begin{verbatim}
\PMlinkname{direction cosine matrix}{DirectionCosineMatrix}
\PMlinkname{quaternion representation}{Quaternion}
\PMlinkname{Euler 3-2-1 sequence}{Euler321Sequence}
\end{verbatim}

Rendered example:

The attitude can be represented by a
\PMlinkname{direction cosine matrix}{DirectionCosineMatrix}, a
\PMlinkname{quaternion}{Quaternion}, or an
\PMlinkname{Euler 3-2-1 sequence}{Euler321Sequence}.

This is useful when the text should read naturally but the target object has a
different canonical name.

\end{document}</content>
</record>
