#+TITLE: org-special-blocks.el --- turn blocks into LaTeX envs and HTML divs #+AUTHOR: Chris Gray #+OPTIONS: ^:{} author:nil #+STARTUP: odd # This file is released by its authors and contributors under the GNU # Free Documentation license v1.3 or later, code examples are released # under the GNU General Public License v3 or later. * General WARNING: although the general ideas described herein are still valid, the implementation has changed starting with version 8.0. In particular, the file =org-special-blocks.el= does not exist any longer, so you cannot load it as described below: the "Loading it" section is obsolete. Special blocks are now part of Orgmode proper. =org-special-blocks= turns org blocks into LaTeX environments and HTML divs. * How to use it ** Quick Example After loading =org-special-blocks=, you can begin using blocks in org files. For example, let's look at Fermat's Last Theorem: : #+begin_theorem : If an integer $n$ is greater than 2, then the equation $a^n + b^n = c^n$ : has no solutions in non-zero integers $a$, $b$, and $c$. : #+end_theorem : #+begin_proof : I have a truly /marvelous/ proof of this proposition that this margin is too : narrow to contain. : #+end_proof This is exported into LaTeX as follows: : \begin{theorem} : If an integer $n$ is greater than 2, then the equation $a^n + b^n = c^n$ : has no solutions in non-zero integers $a$, $b$, and $c$. : \end{theorem} : \begin{proof} : I have a truly \emph{marvelous} proof of this proposition that this : margin is too narrow to contain. : \end{proof} Note that the standard org markup works inside the blocks. If you were to use LaTeX environments inside an org file, this would not be true. Also make sure that the name of the environment is something that LaTeX knows about -- otherwise it will not be able to compile your file. The org file can also be exported into HTML. In that case, the exported file would look something like this: :
: ... :
:
: ... :