Emacs package for previewing LaTeX fragments such as in doxygen comments. Other use-cases are MathJax snippets in html pages and LaTeX equations in stackexchange questions.
Install texfrag via Melpa by <M-x>package-install<RET>texfrag<RET>
.
Switch the customization option texfrag-global-mode
on to activate texfrag-mode
in all buffers with supported major modes.
If you want to activate texfrag only in a specific major mode add texfrag-mode
to
its mode hook. This works out of the box if the major mode is derived from one of
the modes registered in texfrag-setup-alist
.
A buffer with activated texfrag has an additional sub-menu "TeX".
There you find menu-items for generating AUCTeX previews at point for
region and for the full document.
The usual key-sequences from AUCTeX such as C-c C-p C-p
for Toggle preview at point
are also available.
At the time of writing the list of supported major modes is:
html-mode
$$...$$
, \[...\]
, $...$
, \(...\)
, \begin{...}...\end{...}
are recognized in the body of the document&
, >
, and <
are translated to &
, >
, and <
in the LaTeX codeeww-mode
html-mode
file://...
)sx-question-mode
html-mode
prog-mode
(formulas in doxygen comments)
\f$...\f$
, \f[...\f]
, \f{...}...\f}
, and \f{...}{...\f}
are recognized within comments of the source code
(example for the last case: \f{align*}{E=mc^2\f}
)trac-wiki-mode
^{{{\n#!latex\n...^}}}
(thereby ^
stands for beginning of line, and \n
for a linebreak), $...$
, \(...\)
, \[...\]
, and \begin{...}...\end{...}
org-mode
$...$
, \(...\)
, \[...\]
, and \begin{...}...\end{...}
org-html-with-latex
is set internally to 'dvipng
because only that variant works with texfrag
texfrag-org-header
for texfrag-header-function
that ensures that org LaTeX header options are recognizedadoc-mode
latexmath:[...]
[latexmath]
image:...[]
:imagesdir:
are resolved recursively, as required for adoc:local-attr:
for texfrag; The first occurence of an attribute wins. E.g., with the following global attributes texfrag would use /temp
as image directory and asciidoctor
would use the subdirectory images
.
:local-attr: :imagesdir: /temp
:imagesdir: images
All major modes derived from the listed modes are automatically also supported.
Please, inspect the help of the variable texfrag-setup-alist
for a complete list of supported modes.
texfrag-global-mode
and texfrag-preview-buffer-at-start
turned on.