Enforce strict Sphinx style on headers and doc. attrib.

Temporarly copy-and-pasted standard latex declares to
	make output work.

templates/tex/latex_sphinx_base.tplx

@@ -1,163 +1,268 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' -*))
 
 ((* block header *))
 
 % Header, overrides base
 
     % Make sure that the sphinx doc style knows who it inherits from.
     \def\sphinxdocclass{(((parentdocumentclass)))}
     
     % Declare the document class
     \documentclass[letterpaper,10pt,english]{((( resources.sphinx_texinputs )))/sphinx(((documentclass)))}
     
     % Imports    
     \usepackage[utf8]{inputenc}
     \DeclareUnicodeCharacter{00A0}{\\nobreakspace} 
     \usepackage[T1]{fontenc}
     \usepackage{babel}
     \usepackage{times}
     \usepackage{import}
     \usepackage[((( resources.sphinx_chapterstyle )))]{((( resources.sphinx_texinputs )))/fncychap}
     \usepackage{longtable}
     \usepackage{((( resources.sphinx_texinputs )))/sphinx}
     \usepackage{multirow}
 
+    \usepackage{amsmath}
+    \usepackage{amssymb}
+    \usepackage{graphicx}
+    \usepackage{ucs}
+    \usepackage{enumerate}
+
+% 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
+
     % Document level variables
-    \title{((( nb.metadata.name )))} 
-    \date{((( nb.metadata.date )))}
-    \release{((( nb.metadata.version )))} 
-    \author{((( nb.metadata.author )))}
+    \title{((( filterOutLatex(nb.metadata.name) )))} 
+    \date{((( filterOutLatex(nb.metadata.date) )))}
+    \release{((( filterOutLatex(nb.metadata.version) )))} 
+    \author{((( filterOutLatex(nb.metadata.author) )))}
     \newcommand{\sphinxlogo}{}
-    \renewcommand{\releasename}{((( nb.metadata.release )))} 
+    \renewcommand{\releasename}{((( filterOutLatex(nb.metadata.release) )))} 
     \makeindex
 
     
     ((* block sphinxheader *))((* endblock sphinxheader *)) 
 
 ((* endblock header *))
 
 ((* block bodyBegin *))
 % Body
 
     % Start of the document
     \begin{document}
         \maketitle
         \tableofcontents 
 
         ((* endblock bodyBegin *))((* block bodyEnd *))
 
         \renewcommand{\indexname}{Index}
         \printindex
 
     % End of document
     \end{document}
 ((* endblock bodyEnd *))
 
 % Footer
 ((* block footer *))
 ((* endblock footer *))
 
 ((* block headingcell -*))
     \
     ((*- if cell.level == 1 -*))
         ((* block h1 -*))part((* endblock h1 -*))
     ((*- elif cell.level == 2 -*))
         ((* block h2 -*))chapter((* endblock h2 -*))
     ((*- elif cell.level == 3 -*))
         ((* block h3 -*))section((* endblock h3 -*))
     ((*- elif cell.level == 4 -*))
         ((* block h4 -*))subsection((* endblock h4 -*))
     ((*- elif cell.level == 5 -*))
         ((* block h5 -*))subsubsection((* endblock h5 -*))
     ((*- elif cell.level == 6 -*))
         ((* block h6 -*))paragraph((* endblock h6 -*))
-    ((*- endif -*)){((( cell.source | markdown2latex )))}
+    ((*- endif -*)){((( filterOutLatex(cell.source) )))} ((= | markdown2latex =))
 ((*- endblock headingcell *))
 
 ((* block unknowncell scoped*))
     
     % Unsupported cell type, no formatting
     ((( filterOutLatex(cell.source) )))
 ((* endblock unknowncell *))
 
 ((*- block markdowncell scoped-*))
     ((( super() )))
 ((*- endblock markdowncell -*))
 
 ((= Raw text cells allow the user to manually inject document code that will
 not get touched by the templating system. =))
 ((*- block rawcell *))
     ((( cell.source )))
 ((* endblock rawcell -*))
 
 ((* macro filterOutLatex(text) -*))
     ((*- set text = text|replace("\\","\\backslash") -*))
+    ((*- set text = text|replace("_","\\_") -*))
     ((*- set text = text|replace("{","\\{") -*))
     ((*- set text = text|replace("}","\\}") -*))
     ((*- set text = text|replace("|","\\vert") -*))
     ((( text )))
 ((*- endmacro *))
 
 % Useful to block TODO: Remove/move this block below
 
     \setbox0\vbox{
     \begin{minipage}{0.95\linewidth}
 
     \end{minipage}}
     \begin{center}\setlength{\fboxsep}{5pt}
     \shadowbox{\box0}\end{center}
 
-
 ((========================================================================
     EVERYTHING BELOW HERE STILL NEEDS TO BE FILLED IN!
   ========================================================================))
-
+((=
 ((*- 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 -*))
+=))
+