Move gernic doc properties out of sphinx and into base

IPython/nbconvert/templates/latex/latex_base.tplx

@@ -1,195 +1,197 b''
 ((= Latex base template (must inherit)
 This template builds upon the abstract template, adding common latex output
 functions.  Figures, data_text,
 This template does not define a docclass, the inheriting class must define this.=))
 
 ((*- extends 'abstract.tplx' -*))
 
 %===============================================================================
 % Abstract overrides
 %===============================================================================
 
 ((* block packages *))
     \usepackage{graphicx} % Used to insert images
     \usepackage{adjustbox} % Used to constrain images to a maximum size 
     \usepackage{color} % Allow colors to be defined
     \usepackage{enumerate} % Needed for markdown enumerations to work
     \usepackage{fancyvrb} % Needed to support color codes (tex) in verbatim blocks
     \usepackage{geometry} % Used to adjust the document margins
     \usepackage{amsmath} % Equations
     \usepackage{amssymb} % Equations
     \usepackage[utf8]{inputenc} % Allow utf-8 characters in the tex document
     \usepackage{ucs} % Extended unicode (utf-8) support
     \usepackage{alltt} % Verbatim replacement that allows latex
     \usepackage{grffile} % extends the file name processing of package graphics 
                          %to support a larger range 
 
     % 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}
 
     % Pygments definitions
     ((( resources.latex.pygment_definitions )))
 ((* endblock packages *))
 
 ((* block definitions *))
     \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}
 
     % new ansi colors
     \definecolor{brown}{rgb}{0.54,0.27,0.07}
     \definecolor{purple}{rgb}{0.5,0.0,0.5}
     \definecolor{darkgray}{gray}{0.25}
     \definecolor{lightred}{rgb}{1.0,0.39,0.28}
     \definecolor{lightgreen}{rgb}{0.48,0.99,0.0}
     \definecolor{lightblue}{rgb}{0.53,0.81,0.92}
     \definecolor{lightpurple}{rgb}{0.87,0.63,0.87}
     \definecolor{lightcyan}{rgb}{0.5,1.0,0.83}
 
     % Define a nice break command that doesn't care if a line doesn't already
     % exist.
     \def\br{\hspace*{\fill} \\* }
 
     % Define a custom verbatim that allows latex
     \renewenvironment{Verbatim}[1][\unskip]
     {\begin{alltt}}
     {\end{alltt}}
 
-    % Document title
-    \title{((( resources.metadata.name | escape_latex )))}
+    % Document parameters
+    ((* block title *))\title{((( resources.metadata.name | escape_latex )))}((* endblock title *))
+    ((* block date *))((* endblock date *))
+    ((* block author *))((* endblock author *))
 ((* endblock definitions *))
 
 ((* block commands *))
     \sloppy % Prevent overflowing lines due to hard-to-break entities
 
     % Setup hyperref package
     \hypersetup{
       breaklinks=true,  % so long urls are correctly broken across lines
       colorlinks=true,
       urlcolor=blue,
       linkcolor=darkorange,
       citecolor=darkgreen,
       }
     
     % Slightly bigger margins than the latex defaults
     \geometry{verbose,tmargin=3cm,bmargin=3cm,lmargin=2.5cm,rmargin=2.5cm}
 
     % Hardcode size of all verbatim environments to be a bit smaller
     \makeatletter 
     \g@addto@macro\@verbatim\small\topsep=0.5em\partopsep=0pt
     \makeatother 
 ((* endblock commands *))
 
 ((* block predoc *))
     ((* block maketitle *))\maketitle((* endblock maketitle *))
 ((* endblock predoc *))
 
 %===============================================================================
 % Support blocks
 %===============================================================================
 
 % Displaying simple data text
 ((* block data_text *))
     \begin{Verbatim}
 ((( output.text | escape_latex )))
     \end{Verbatim}
 ((* endblock data_text *))
 
 % Display python error text as-is
 ((* block pyerr *))
     \begin{Verbatim}
 ((( super() )))
     \end{Verbatim}
 ((* endblock pyerr *))
 ((* block traceback_line *))
     ((( line | indent | strip_ansi | escape_latex )))
 ((* endblock traceback_line *))
 
 % Display stream ouput with coloring
 ((* block stream *))
     \begin{Verbatim}[commandchars=\\\{\}]
 ((( output.text | ansi2latex )))
     \end{Verbatim}
 ((* endblock stream *))
 
 % Display latex
 ((* block data_latex -*))
     ((*- if output.latex.startswith('$'): -*)) 
         ((= Replace $ symbols with more explicit, equation block. =))
         \begin{equation*}
         ((( output.latex | strip_dollars )))
         \end{equation*}
     ((*- else -*))
         ((( output.latex )))
     ((*- endif *))
 ((* endblock data_latex *))
 
 % Default mechanism for rendering figures
 ((*- block data_png -*))((( draw_figure(output.png_filename) )))((*- endblock -*))
 ((*- block data_jpg -*))((( draw_figure(output.jpeg_filename) )))((*- endblock -*))
 ((*- block data_svg -*))((( draw_figure(output.svg_filename) )))((*- endblock -*))
 ((*- block data_pdf -*))((( draw_figure(output.pdf_filename) )))((*- endblock -*))
 
 % Draw a figure using the graphicx package.
 ((* macro draw_figure(filename) -*))
 ((* set filename = filename | posix_path *))
 ((*- block figure scoped -*))
     \begin{center}
     \adjustimage{max size={0.9\linewidth}{0.9\paperheight}}{((( filename )))}
     \end{center}
     { \hspace*{\fill} \\}
 ((*- endblock figure -*))
 ((*- endmacro *))
 
 % Draw heading cell.  Explicitly map different cell levels.
 ((* block headingcell scoped -*))
     ((*- if cell.level == 1 -*))
         ((* block h1 -*))\section((* endblock h1 -*))
     ((*- elif cell.level == 2 -*))
         ((* block h2 -*))\subsection((* endblock h2 -*))
     ((*- elif cell.level == 3 -*))
         ((* block h3 -*))\subsubsection((* endblock h3 -*))
     ((*- elif cell.level == 4 -*))
         ((* block h4 -*))\paragraph((* endblock h4 -*))
     ((*- elif cell.level == 5 -*))
         ((* block h5 -*))\subparagraph((* endblock h5 -*))
     ((*- elif cell.level == 6 -*))
         ((* block h6 -*))\\*\textit((* endblock h6 -*))
     ((*- endif -*))
     {((( cell.source | escape_latex )))}
 ((*- endblock headingcell *))
 
 % Redirect pyout to display data priority.
 ((* block pyout scoped *))
     ((* block data_priority scoped *))
     ((( super() )))
     ((* endblock *))
 ((* endblock pyout *))
 
 % Render markdown
 ((* block markdowncell scoped *))
     ((( cell.source | markdown2latex )))
 ((* endblock markdowncell *))
 
 % Spit out the contents of raw cells unmodified
 ((* block rawcell scoped *))
     ((( cell.source )))
 ((* endblock rawcell *))
 
 % Don't display unknown types
 ((* block unknowncell scoped *))
 ((* endblock unknowncell *))
 
 % Render code using pygments
 ((* block input scoped *))
     ((( cell.input | highlight2latex )))
 ((* endblock input *))
  No newline at end of file

IPython/nbconvert/templates/latex/latex_sphinx_article.tplx

@@ -1,49 +1,40 b''
 
 %===============================================================================
 % Cell style
 %===============================================================================
 
 % Inherit from the specified cell style.
 ((* extends 'latex_article.tplx' *))
 
-
 %===============================================================================
 % Latex Sphinx Article
 %===============================================================================
 
 ((* block docclass *))
     % Make sure that the sphinx doc style knows who it inherits from.
     \def\sphinxdocclass{article}
 
     % Declare the document class
     \documentclass[letterpaper,10pt,english]{((( resources.sphinx.texinputs | posix_path )))/sphinxhowto}
 ((* endblock docclass *))
 
 ((* block packages *))
     ((* block chstyle *))
     \usepackage[Bjarne]{((( resources.sphinx.texinputs | posix_path )))/fncychap}
     ((* endblock chstyle *))
 
     \usepackage{((( resources.sphinx.texinputs | posix_path )))/sphinx}
 
     ((( super() )))
 ((* endblock packages *))    
 
 ((* block commands *))
     ((( super() )))
 
-    \graphicspath{ {figs/} }
-
-    % Document level variables
-    \date{((( resources.sphinx.date | escape_latex )))}
-    \release{((( resources.sphinx.version | escape_latex )))}
-    \author{((( resources.sphinx.author | escape_latex )))}
-    \renewcommand{\releasename}{((( resources.sphinx.release | escape_latex )))}
-
-    % TODO: Add option for the user to specify a logo for his/her export.
-    \newcommand{\sphinxlogo}{}
+    % Override to specify your own logo
+    ((* block logo *))\newcommand{\sphinxlogo}{}((* endblock logo *))
 
     % Make the index page of the document.
     \makeindex
 
 ((* endblock commands *))