Every time I need to copy a latex paragraph and put it in my source code as a doxygen documentation, I need to put a \f next to each $ and do other modifications.
Isn't there an easier way to tell doxygen that this whole paragraph contains only latex and thus should be fully interpreted as latex code?
Thanks in advance.
It appears not to be possible to include LaTeX format .tex files directly. Depending on the complexity of the LaTeX files, a possibility would be to write a script which makes the required modifications. Related questions that give further background and suggestions are How to include LaTeX snippets directly in Doxygen comments and Including LaTeX documentation as comments in source code. Please come back and answer if you find a good solution to this problem.
Related
Is it possible to use plantUML inside a latex document?
One workaround would be to convert plantUML into tikzpicture and integrate it in the latex document. That seems a bit too much effort to me, especially with updates.
I am using overleaf and TeXiFy, the document generation should work on both latex editors.
If a direct integration is possible, I would like to see an example.
thanks
I'd like to create multiple documents (output as PDFs after running pdflatex) whose source is from one file.
Example:
\documentclass{article}
\begin{document}
This text will appear in the first PDF.
\end{document}
\begin{document}
This text will appear in the second PDF.
\end{document}
This would be particularly useful because:
I could keep everything in 1 file, with a single, consistent preamble.
I could use ifthen or other loops to automatically generate various alternative forms of a document.
AFAIK this is not possible without some preprocessing of your file, i.e. using a scripting language to produce two separate documents then compiling them separately. Even then I don't think it's a good idea.
The first reason you think this would be useful is handled by putting your preamble in a separate document that is included in as many documents as you want using \include. The second aspect can be handled by using Makefiles and putting the conditional branching to build particular versions of a document in there.
I wrote a really simple preprocessor for LaTeX that embeds Ruby code directly into .tex files for this purpose and use the ERB template engine. Here's the source code on Google Code, if you want to take a look. There's not much to it, though I regularly use it from a Ant/latexmk-based build script and it has proved very useful for generating multiple version of my résumé. It works equally well on Linux/Mac OS X/Windows, assuming you have a working LaTex and Ruby installation.
I've used Sphinx to document a Python library. So far this works great, I get nice HTML and LaTeX output. Concerning Latex, Sphinx generates a complete standalone document with lots of special packages and configurations.
But, I would like to integrate the generated Latex files within an already existing Latex project (more precise: in the appendix of a book). In particular I want the Sphinx-generated documentation pages to have the header, footer and section heading styles of the parent document. I guess I could somehow transfer the relevant parts by manually removing unneeded stuff and adjusting various options in the tex files generated by Sphinx. However, probably this is going to be a very tedious fiddling taking too much of my time (thinking of conflicting packages and options I have to detect and fix).
Does Sphinx' Latex-Builder support such a use case? If not, is there a more general approach how to merge independent Latex-documents?
Thanks for any hints!
It seems there is no generally valid answer to this question. I've asked this question on the sphinx mailing list and received an answer which basically says one has to manually extract and partly convert the relevant parts of the latex code generated by sphinx - a less expensive solution does not yet exist.
For my Master Thesis I am writing a Latex document where I must put all the research I do. This document is reviewed periodically by my thesis advisors once or twice per month. Since this is a big document I'd like to automatically highlight what's new in the document since the last revision same way like Word or Openoffice do.
So my question is, given that I have a Latex document controlled by Subversion, what is the best way to create a pdf highlighting the differences between the HEAD and a previous version?
Say that I want:
New text in a red coloured font
New images and tables with a light red background
Deleted text marked as a footnote or something similar
If not all are possible, which ones could be implemented?
Thanks.
Check out latexdiff. It is much better than simple diff programs because it understands LaTeX and won't mark changes that are simply extra spaces, or reformatted lines in the tex file.
There are several packages which could manage revisions. I'd like to use some version control system like git to manage and show changes.
You could use a diff program. I recommend DiffMerge from Source Forge.
i like wdiff. available on an *nix platform.
you can use
wdiff -w "\fbox{" -x "}" -y "\fbox{\fbox{" -z "}}" ...
I created revdiff to build diff versions of my papers before sending them to reviewers. They have told me several times that the result was really helpfull. Hope it can be useful for you.
Find it here: http://pedromateo.github.io/revdiff-LaTeX/
Does anyone know where I could find the code that LaTeX uses to typeset inside the tabular environment? In the past I have looked in style files but I don't know where to find intrinsic LaTeX commands.
See the PDF file of the LaTeX sources, chapter lttab.dtx.