The cb2Bib Annote module is named after the BibTeX key annote. Annote is not for a ‘one reference annotation’ though. Instead, Annote is for short notes that interrelate several references. Annote takes a plain text note, with minimal or no markup, inserts the bibliographic citations, and converts it to a HTML page with links to the referenced documents.
From within cb2Bib, to write a note, type Alt+A, enter a filename, either new or existing, and once in Annote, type E to start the editor. Each time you save the document the viewer will be updated. For help on Annote’s syntax type F1. If cb2Bib was compiled without Annote’s Viewer, typing Alt+A will start the editor and HTML viewing will be committed to the default web browser.
From the command line, typing
cb2bib --html-annote annote.tex
will produce the HTML file annote.tex.html.
See also Configuring Annote and cb2Bib Command Line.
Annote Syntax
The resulting HTML file for the following listing can be seen at annote.tex.html.
% annote.tex
%\c2b_bibtex_directory{/home/constans/Documents/BibReferences}
%\c2b_makeindex
\newcommand{\RR}{\mathbb{R}}
\newcommand{\mnial}[3]{(#1 - #2)^#3}
\title{cb2Bib Annote}
\begin{abstract}
This documents describes cb2Bib Annote. It succinctly lists Annote's minimalists
syntax.
\end{abstract}
\section{cb2Bib Directives}
\subsection{Make Index}
\begin{verbatim}
%\c2b_makeindex
\end{verbatim}
\subsection{BibTeX Directory}
\begin{verbatim}
%\c2b_bibtex_directory{/home/constans/Documents/BibReferences}
\end{verbatim}
\section{Simple Markup}
\subsection{Uniform Resource Locator}
\begin{verbatim}
- URL: https://www.molspaces.com/cb2bib/doc/c2bannote/
- Named URL: https://www.molspaces.com/cb2bib/doc/c2bannote/[cb2Bib Annote]
- On a blank window: _https://www.molspaces.com/cb2bib/doc/c2bannote/[cb2Bib Annote]
\end{verbatim}
\subsubsection{Example}
- URL: https://www.molspaces.com/cb2bib/doc/c2bannote/
- Named URL: https://www.molspaces.com/cb2bib/doc/c2bannote/[cb2Bib Annote]
- On a blank window: _https://www.molspaces.com/cb2bib/doc/c2bannote/[cb2Bib Annote]
\subsection{Bibliographic Citations}
\begin{verbatim}
\cite {key}
\end{verbatim}
\subsubsection{Example}
Citing cb2Bib \cite{cb2bib_key}.
\section{LaTeX Markup}
\subsection{Document Sections}
\begin{verbatim}
\title{Title string}
\end{verbatim}
\begin{verbatim}
\section{Section string}
\end{verbatim}
\begin{verbatim}
\subsection{Section string}
\end{verbatim}
\begin{verbatim}
\subsubsection{Section string}
\end{verbatim}
\subsection{Document Environments}
\begin{verbatim}
% env = abstract, equation, itemize, and verbatim
\begin{env}
\end{env}
\end{verbatim}
- Note. equation rendering requires MathJax \cite{jsmath_key, mathjax_key}
\subsubsection{Examples}
\begin{verbatim}
\begin{itemize}
\item Description 1
\item Description 2
\end{itemize}
\end{verbatim}
\begin{itemize}
\item Description 1
\item Description 2
\end{itemize}
\begin{verbatim}
\begin{equation}
\int_D ({\nabla\cdot} F)dV=\int_{\partial D} F\cdot ndS
\end{equation}
\end{verbatim}
\begin{equation}
\int_D ({\nabla\cdot} F)dV=\int_{\partial D} F\cdot ndS
\end{equation}
\subsection{Mathematical Macros}
\begin{verbatim}
\newcommand{name}[number of arguments]{definition}
\end{verbatim}
\subsubsection{Example}
\begin{verbatim}
\newcommand{\RR}{\mathbb{R}}
\newcommand{\mnial}[3]{(#1 - #2)^#3}
... a subset of $\RR$ values ... ... the monomial is $\mnial{a}{x}{2} > 0$
for $x \ne 0$, and $\mnial{a}{x}{3} \mnial{c}{x}{3}$ for $x < a \land x < c$ or
$x > a \land x > c$ ...
\end{verbatim}
... a subset of $\RR$ values ... ... the monomial is $\mnial{a}{x}{2} > 0$
for $x \ne 0$, and $\mnial{a}{x}{3} \mnial{c}{x}{3}$ for $x < a \land x < c$ or
$x > a \land x > c$ ...
\section{MathJax Example}
\begin{verbatim}
% Example from https://www.mathjax.org/#demo
When $a \ne 0$, there are two solutions to \(ax^2 + bx + c = 0\) and they are
$$x = {-b \pm \sqrt{b^2-4ac} \over 2a}.$$
\end{verbatim}
When $a \ne 0$, there are two solutions to \(ax^2 + bx + c = 0\) and they are
$$x = {-b \pm \sqrt{b^2-4ac} \over 2a}.$$