Got both of the main template formats from sphinx rendering.

Todo:
 [ ] Fill with NB data
 [ ] Move latex around and make use of latex base

README.rst

@@ -1,33 +1,22 b''
 ================================================================
- nbconvert: conversion utilities for the IPython notebook format
+ nbconvert Sphinx-Latex Jinja2 templates
 ================================================================
 
 Overview
 ========
 
 nbconvert provides command line utilities to convert to and from IPython
-notebooks and standard formats:
-
--   ReST
--   Markdown
--   HTML
--   PDF
--   Python script
-
-As these tools mature, these utilities will be merged into IPython.
+notebooks and standard formats.  However, the latex formatting leaves
+something to be desired.  This repository contains a port of the beautiful
+and popular Sphinx latex styles for nbconvert.
 
 Requirements
 ============
 
 Sphinx-Latex:
 
     $ sudo apt-get install texlive-full
 
 see http://jimmyg.org/blog/2009/sphinx-pdf-generation-with-latex.html
         
-Running Tests
-=============
-
-Using nbconvert
-===============
 

templates/tex/latex_base.tplx

@@ -1,214 +1,224 b''
 ((*- extends 'display_priority.tplx' -*))
 
 ((* block in_prompt *))((* endblock in_prompt *))
 
 ((* block output_prompt *))((* endblock output_prompt *))
 
 ((* block codecell *))\begin{codecell}((( super() )))
 \end{codecell}
 ((* endblock *))
 
 ((* block input *))
 \begin{codeinput}
 \begin{lstlisting}
 ((( cell.input )))
 \end{lstlisting}
 \end{codeinput}
 ((* endblock input *))
 
 
 ((= Those Two are for error displaying
 even if the first one seem to do nothing, 
 it introduces a new line
 
 =))
 ((* block pyerr *))((( super() )))
 ((* endblock pyerr *))
 
 ((* block traceback_line *))
 ((( line |indent| rm_ansi )))((* endblock traceback_line *))
 ((= .... =))
 
 
 ((*- block output_group -*))
 \begin{codeoutput}
 ((( super() )))
 \end{codeoutput}((* endblock *))
 
 ((*- block data_png -*))
 \begin{center}
 \includegraphics[width=0.7\textwidth, height=0.9\textheight, keepaspectratio]{(((output.key_png)))}
 \par
 \end{center}
 ((*- endblock -*))
 
 ((*- block data_svg -*))
 \begin{center}
 \includegraphics[width=0.7\textwidth]{(((output.key_svg)))}
 \par
 \end{center}
 ((*- endblock -*))
 
 ((* block pyout *))
 ((( output.text)))
 ((* endblock pyout *))
 
 ((* block data_text *))
 \begin{verbatim}
 ((( output.text )))
 \end{verbatim}
 ((* endblock *))
 
 ((* block stream *))
 \begin{verbatim}
 ((( output.text)))
 \end{verbatim}
 ((* endblock stream *))
 
 
 
-
+((=
+%Doesn't work on my machine yet. TODO: Fix this.
 ((* block markdowncell scoped *))((( cell.source | markdown2latex )))
 ((* endblock markdowncell *))
+=))
 
 ((* block headingcell scoped *))
 \section{((( cell.source)))}
 ((* endblock headingcell *))
 
 ((* block rawcell scoped *))
 ((( cell.source | pycomment )))
 ((* endblock rawcell *))
 
 ((* block unknowncell scoped *))
 unknown type  (((cell.type)))
 ((* endblock unknowncell *))
 
 
 
-((* block body *))\begin{document}
-((( super() )))
-\end{document}
-((* endblock*))
+((* block body *))
+
+	((* block bodyBegin *))
+	\begin{document}
+	((* endblock bodyBegin *))
+	
+	((( super() )))
+
+	((* block bodyEnd *))
+	\end{document}
+	((* endblock bodyEnd *))
+((* endblock body *))
 
 ((* block header *))
 %% This file was auto-generated by IPython.
 %% Conversion from the original notebook file:
 %% tests/ipynbref/Gun_Data.orig.ipynb
 %%
 \documentclass[11pt,english]{article}
 
 %% This is the automatic preamble used by IPython.  Note that it does *not*
 %% include a documentclass declaration, that is added at runtime to the overall
 %% document.
 
 \usepackage{amsmath}
 \usepackage{amssymb}
 \usepackage{graphicx}
 \usepackage{ucs}
 \usepackage[utf8x]{inputenc}
 
 % needed for markdown enumerations to work
 \usepackage{enumerate}
 
 % Slightly bigger margins than the latex defaults
 \usepackage{geometry}
 \geometry{verbose,tmargin=3cm,bmargin=3cm,lmargin=2.5cm,rmargin=2.5cm}
 
 % Define a few colors for use in code, links and cell shading
 \usepackage{color}
 \definecolor{orange}{cmyk}{0,0.4,0.8,0.2}
 \definecolor{darkorange}{rgb}{.71,0.21,0.01}
 \definecolor{darkgreen}{rgb}{.12,.54,.11}
 \definecolor{myteal}{rgb}{.26, .44, .56}
 \definecolor{gray}{gray}{0.45}
 \definecolor{lightgray}{gray}{.95}
 \definecolor{mediumgray}{gray}{.8}
 \definecolor{inputbackground}{rgb}{.95, .95, .85}
 \definecolor{outputbackground}{rgb}{.95, .95, .95}
 \definecolor{traceback}{rgb}{1, .95, .95}
 
 % Framed environments for code cells (inputs, outputs, errors, ...).  The
 % various uses of \unskip (or not) at the end were fine-tuned by hand, so don't
 % randomly change them unless you're sure of the effect it will have.
 \usepackage{framed}
 
 % remove extraneous vertical space in boxes
 \setlength\fboxsep{0pt}
 
 % codecell is the whole input+output set of blocks that a Code cell can
 % generate.
 
 % TODO: unfortunately, it seems that using a framed codecell environment breaks
 % the ability of the frames inside of it to be broken across pages.  This
 % causes at least the problem of having lots of empty space at the bottom of
 % pages as new frames are moved to the next page, and if a single frame is too
 % long to fit on a page, will completely stop latex from compiling the
 % document.  So unless we figure out a solution to this, we'll have to instead
 % leave the codecell env. as empty.  I'm keeping the original codecell
 % definition here (a thin vertical bar) for reference, in case we find a
 % solution to the page break issue.
 
 %% \newenvironment{codecell}{%
 %%     \def\FrameCommand{\color{mediumgray} \vrule width 1pt \hspace{5pt}}%
 %%    \MakeFramed{\vspace{-0.5em}}}
 %%  {\unskip\endMakeFramed}
 
 % For now, make this a no-op...
 \newenvironment{codecell}{}
 
  \newenvironment{codeinput}{%
    \def\FrameCommand{\colorbox{inputbackground}}%
    \MakeFramed{\advance\hsize-\width \FrameRestore}}
  {\unskip\endMakeFramed}
 
 \newenvironment{codeoutput}{%
    \def\FrameCommand{\colorbox{outputbackground}}%
    \vspace{-1.4em}
    \MakeFramed{\advance\hsize-\width \FrameRestore}}
  {\unskip\medskip\endMakeFramed}
 
 \newenvironment{traceback}{%
    \def\FrameCommand{\colorbox{traceback}}%
    \MakeFramed{\advance\hsize-\width \FrameRestore}}
  {\endMakeFramed}
 
 % Use and configure listings package for nicely formatted code
 \usepackage{listingsutf8}
 \lstset{
   language=python,
   inputencoding=utf8x,
   extendedchars=\true,
   aboveskip=\smallskipamount,
   belowskip=\smallskipamount,
   xleftmargin=2mm,
   breaklines=true,
   basicstyle=\small \ttfamily,
   showstringspaces=false,
   keywordstyle=\color{blue}\bfseries,
   commentstyle=\color{myteal},
   stringstyle=\color{darkgreen},
   identifierstyle=\color{darkorange},
   columns=fullflexible,  % tighter character kerning, like verb
 }
 
 % The hyperref package gives us a pdf with properly built
 % internal navigation ('pdf bookmarks' for the table of contents,
 % internal cross-reference links, web links for URLs, etc.)
 \usepackage{hyperref}
 \hypersetup{
   breaklinks=true,  % so long urls are correctly broken across lines
   colorlinks=true,
   urlcolor=blue,
   linkcolor=darkorange,
   citecolor=darkgreen,
   }
 
 % hardcode size of all verbatim environments to be a bit smaller
 \makeatletter 
 \g@addto@macro\@verbatim\small\topsep=0.5em\partopsep=0pt
 \makeatother 
 
 % Prevent overflowing lines due to urls and other hard-to-break entities.
 \sloppy
 
 ((* endblock *))

templates/tex/latex_sphinx_base.tplx

@@ -1,60 +1,128 b''
 ((============================================================================
   NBConvert Sphinx-Latex Template
 
   Purpose: Allow export of PDF friendly Latex inspired by Sphinx.  Most of the
            template is derived directly from Sphinx source.
 
   Inheritance: null>display_priority>latex_base 
 
   ==========================================================================))
 
 ((*- extends 'latex_base.tplx' -*))
 
-((============================================================================
-  Header, overrides base
-  ==========================================================================))
+% Header, overrides base
 ((* block header *))
+    
+    % Make sure that the sphinx doc style knows who it inherits from.
+    \def\sphinxdocclass{(((parentdocumentclass)))}
+
+    % Declare the document class
+    \documentclass[letterpaper,10pt,english]{templates/tex/sphinx(((documentclass)))}
+    
+    % Imports    
+    \usepackage[utf8]{inputenc}
+    \DeclareUnicodeCharacter{00A0}{\\nobreakspace} 
+    \usepackage[T1]{fontenc}
+    \usepackage{babel}
+    \usepackage{times}
+    \usepackage{import}
+    \usepackage[Bjarne]{templates/tex/fncychap}
+    \usepackage{longtable}
+    \usepackage{templates/tex/sphinx}
+    \usepackage{multirow}
+
+    % Document level variables
+    \title{((( nb.metadata.name )))} 
+    \date{\today}
+    \release{} 
+    \author{Unknown Author}
+    \newcommand{\sphinxlogo}{}
+    \renewcommand{\releasename}{Release} 
+    \makeindex
+
+    
+    ((* block sphinxheader *))((* endblock sphinxheader *)) 
 
-%\newcommand{\sphinxlogo}{}
-
-%% Generated by Sphinx (not really.)
-\def\sphinxdocclass{((* block documentclass *))sphinxmanual((* endblock documentclass *))}
-\documentclass[letterpaper,10pt,english]{report}
-\usepackage[utf8]{inputenc} %(inputenc)s
-\DeclareUnicodeCharacter{00A0}{\\nobreakspace} %(utf8extra)s
-\usepackage[T1]{fontenc} %(fontenc)s
-\usepackage{babel} %(babel)s
-\usepackage{times} %(fontpkg)s
-\usepackage{import}
-\usepackage[Bjarne]{templates/tex/fncychap}
-%\usepackage[Bjarne]{} %(fncychap)s
-\usepackage{longtable} %(longtable)s
-\usepackage{templates/tex/sphinx}
-\usepackage{multirow}
-
-%"" (preamble)s
-
-\title{((( nb.metadata.name )))} %(title)s}
-\date{} %(date)s}
-\release{} %(release)s}
-\author{} %(author)s}
-\newcommand{\sphinxlogo}{} %(logo)s}
-\renewcommand{\releasename}{Release} %(releasename)s}
-\makeindex %(makeindex)s
-
-((* block sphinxstyle *))((* endblock sphinxstyle *))
 ((* endblock header *))
 
-((* block body *))
-\begin{document}
-%(shorthandoff)s
-\maketitle
-\tableofcontents %(tableofcontents)s
+% Body
+((* block bodyBegin *))
 
-\renewcommand{\indexname}{%(indexname)s}
-\printindex %(printindex)s
-\end{document}
-((* endblock body *))
+    % Start of the document
+    \begin{document}
+        \maketitle
+        \tableofcontents 
+((* endblock bodyBegin *))
+((* block bodyEnd *))
 
+
+        \renewcommand{\indexname}{Index}
+        \printindex
+    \end{document}
+((* endblock bodyEnd *))
+
+% Footer
 ((* block footer *))
 ((* endblock footer *))
+
+((*- block any_cell scoped -*))
+    ((( cell.source)))
+    ((*- if cell.type in ['code'] -*))
+
+        ((*- block codecell scoped -*))
+            ((*- block input_group -*))
+                ((*- block in_prompt -*))((*- endblock in_prompt -*))
+                ((*- block input -*))((*- endblock input -*))
+            ((*- endblock input_group -*))
+                ((*- if cell.outputs -*))
+            ((*- block output_group -*))
+                    ((*- block output_prompt -*))((*- endblock output_prompt -*))
+                    ((*- block outputs -*))
+                        ((*- for output in cell.outputs -*))
+                            ((*- if output.output_type in ['pyout'] -*))
+                                ((*- block pyout scoped -*))((*- endblock pyout -*))
+                            ((*- elif output.output_type in ['stream'] -*))
+                                ((*- block stream scoped -*))
+                                    ((*- if output.stream in ['stdout'] -*))
+                                        ((*- block stream_stdout scoped -*))
+                                        ((*- endblock stream_stdout -*))
+                                    ((*- elif output.stream in ['stderr'] -*))
+                                        ((*- block stream_stderr scoped -*))
+                                        ((*- endblock stream_stderr -*))
+                                    ((*- endif -*))
+                                ((*- endblock stream -*))
+                            ((*- elif output.output_type in ['display_data'] -*))
+                                ((*- block display_data scoped -*))
+                                    ((*- block data_priority scoped -*))
+                                    ((*- endblock data_priority -*))
+                                ((*- endblock display_data -*))
+                            ((*- elif output.output_type in ['pyerr'] -*))
+                                ((*- block pyerr scoped -*))
+                                ((*- for line in output.traceback -*))
+                                    ((*- block traceback_line scoped -*))((*- endblock traceback_line -*))
+                                ((*- endfor -*))
+                                ((*- endblock pyerr -*))
+                            ((*- endif -*))
+                        ((*- endfor -*))
+                    ((*- endblock outputs -*))
+            ((*- endblock output_group -*))
+                ((*- endif -*))
+        ((*- endblock codecell -*))
+    ((*- elif cell.type in ['markdown'] -*))
+        
+        ((*- block markdowncell scoped-*))
+        ((*- endblock markdowncell -*))
+    ((*- elif cell.type in ['heading'] -*))
+        
+        ((*- block headingcell scoped-*))
+        ((*- endblock headingcell -*))
+    ((*- elif cell.type in ['raw'] -*))
+        
+        ((*- block rawcell scoped-*))
+        ((*- endblock rawcell -*))
+    ((*- else -*))
+        
+        ((*- block unknowncell scoped-*))
+        ((*- endblock unknowncell -*))
+    ((*- endif -*))
+((*- endblock any_cell -*))

templates/tex/latex_sphinx_howto.tplx

@@ -1,16 +1,16 b''
 ((============================================================================
   NBConvert Sphinx-Latex HowTo Template
 
   Purpose: Allow export of PDF friendly Latex inspired by Sphinx HowTo 
            document style.  Most of the is derived directly from Sphinx source.
 
   Inheritance: null>display_priority>latex_base->latex_sphinx_base 
 
   ==========================================================================))
 
 ((*- extends 'latex_sphinx_base.tplx' -*))
 
-((* block documentclass *))sphinxhowto((* endblock documentclass *))
-((* block sphinxstyle *))((* include 'sphinxhowto.cls' *))((* endblock sphinxstyle *))
+((* set parentdocumentclass = 'article' *))
+((* set documentclass = 'howto' *))
 
 

templates/tex/latex_sphinx_manual.tplx

@@ -1,14 +1,14 b''
 ((============================================================================
   NBConvert Sphinx-Latex Manual Template
 
   Purpose: Allow export of PDF friendly Latex inspired by Sphinx Manual 
            document style.  Most of the is derived directly from Sphinx source.
 
   Inheritance: null>display_priority>latex_base->latex_sphinx_base 
 
   ==========================================================================))
 
 ((*- extends 'latex_sphinx_base.tplx' -*))
 
-((* block documentclass *))sphinxmanual((* endblock documentclass *))
-((* block sphinxstyle *))((* include 'sphinxmanual.cls' *))((* endblock sphinxstyle *))
+((* set parentdocumentclass = 'report' *))
+((* set documentclass = 'manual' *))

templates/tex/sphinxmanual.cls

@@ -1,133 +1,133 b''
 %
 % sphinxmanual.cls for Sphinx (http://sphinx-doc.org/)
 %
 
 \NeedsTeXFormat{LaTeX2e}[1995/12/01]
 \ProvidesClass{sphinxmanual}[2009/06/02 Document class (Sphinx manual)]
 
 % chapters starting at odd pages (overridden by 'openany' document option)
 \PassOptionsToClass{openright}{\sphinxdocclass}
 
 % 'oneside' option overriding the 'twoside' default
 \newif\if@oneside
 \DeclareOption{oneside}{\@onesidetrue}
 % Pass remaining document options to the parent class.
 \DeclareOption*{\PassOptionsToClass{\CurrentOption}{\sphinxdocclass}}
 \ProcessOptions\relax
 
 % Defaults two-side document
 \if@oneside
 % nothing to do (oneside is the default)
 \else
 \PassOptionsToClass{twoside}{\sphinxdocclass}
 \fi
 
 \LoadClass{\sphinxdocclass}
 
 % Set some sane defaults for section numbering depth and TOC depth.  You can
 % reset these counters in your preamble.
 %
 \setcounter{secnumdepth}{2}
 \setcounter{tocdepth}{1}
 
 % Change the title page to look a bit better, and fit in with the fncychap
 % ``Bjarne'' style a bit better.
 %
 \renewcommand{\maketitle}{%
   \begin{titlepage}%
     \let\footnotesize\small
     \let\footnoterule\relax
     \rule{\textwidth}{1pt}%
     \ifsphinxpdfoutput
       \begingroup
       % These \defs are required to deal with multi-line authors; it
       % changes \\ to ', ' (comma-space), making it pass muster for
       % generating document info in the PDF file.
       \def\\{, }
       \def\and{and }
       \pdfinfo{
         /Author (\@author)
         /Title (\@title)
       }
       \endgroup
     \fi
     \begin{flushright}%
       \sphinxlogo%
       {\rm\Huge\py@HeaderFamily \@title \par}%
       {\em\LARGE\py@HeaderFamily \py@release\releaseinfo \par}
       \vfill
       {\LARGE\py@HeaderFamily
         \begin{tabular}[t]{c}
           \@author
         \end{tabular}
         \par}
       \vfill\vfill
       {\large
        \@date \par
        \vfill
        \py@authoraddress \par
       }%
     \end{flushright}%\par
     \@thanks
   \end{titlepage}%
   \cleardoublepage%
   \setcounter{footnote}{0}%
   \let\thanks\relax\let\maketitle\relax
   %\gdef\@thanks{}\gdef\@author{}\gdef\@title{}
 }
 
 
 % Catch the end of the {abstract} environment, but here make sure the abstract
 % is followed by a blank page if the 'openright' option is used.
-
+%
 \let\py@OldEndAbstract=\endabstract
 \renewcommand{\endabstract}{
   \if@openright
     \ifodd\value{page}
       \typeout{Adding blank page after the abstract.}
       \vfil\pagebreak
     \fi
   \fi
   \py@OldEndAbstract
 }
 
 % This wraps the \tableofcontents macro with all the magic to get the spacing
 % right and have the right number of pages if the 'openright' option has been
 % used.  This eliminates a fair amount of crud in the individual document files.
 %
 \let\py@OldTableofcontents=\tableofcontents
 \renewcommand{\tableofcontents}{%
   \setcounter{page}{1}%
   \pagebreak%
   \pagestyle{plain}%
   {%
     \parskip = 0mm%
     \py@OldTableofcontents%
     \if@openright%
       \ifodd\value{page}%
         \typeout{Adding blank page after the table of contents.}%
         \pagebreak\hspace{0pt}%
       \fi%
     \fi%
     \cleardoublepage%
   }%
   \pagenumbering{arabic}%
   \@ifundefined{fancyhf}{}{\pagestyle{normal}}%
 }
 
 % This is needed to get the width of the section # area wide enough in the
 % library reference.  Doing it here keeps it the same for all the manuals.
-
+%
 \renewcommand*\l@section{\@dottedtocline{1}{1.5em}{2.6em}}
 \renewcommand*\l@subsection{\@dottedtocline{2}{4.1em}{3.5em}}
 
 % Fix the bibliography environment to add an entry to the Table of
 % Contents.
 % For a report document class this environment is a chapter.
 \let\py@OldThebibliography=\thebibliography
 \renewcommand{\thebibliography}[1]{
   \cleardoublepage
   \phantomsection
   \py@OldThebibliography{1}
   \addcontentsline{toc}{chapter}{\bibname}
 }