manual.cls

   1 %
   2 % manual.cls for Sphinx
   3 %
   4
   5 \NeedsTeXFormat{LaTeX2e}[1995/12/01]
   6 \ProvidesClass{manual}[2008/10/18 Document class (Sphinx manual)]
   7
   8 % Pass all given class options to the parent class.
   9 \DeclareOption*{\PassOptionsToClass{\CurrentOption}{report}}
  10 \ProcessOptions\relax
  11 \LoadClass[twoside,openright]{report}
  12
  13 % Set some sane defaults for section numbering depth and TOC depth.  You can
  14 % reset these counters in your preamble.
  15 %
  16 \setcounter{secnumdepth}{2}
  17 \setcounter{tocdepth}{1}
  18
  19 % Change the title page to look a bit better, and fit in with the fncychap
  20 % ``Bjarne'' style a bit better.
  21 %
  22 \renewcommand{\maketitle}{%
  23   \begin{titlepage}%
  24     \let\footnotesize\small
  25     \let\footnoterule\relax
  26     \ifsphinxpdfoutput
  27       \begingroup
  28       % These \defs are required to deal with multi-line authors; it
  29       % changes \\ to ', ' (comma-space), making it pass muster for
  30       % generating document info in the PDF file.
  31       \def\\{, }
  32       \def\and{and }
  33       \pdfinfo{
  34         /Author (\@author)
  35         /Title (\@title)
  36       }
  37       \endgroup
  38     \fi
  39     \begin{flushright}%
  40       \rule{\textwidth}{1pt} \par
  41       {\rm\Huge\py@HeaderFamily \@title \par}%
  42       \rule{\textwidth}{1pt} \par
  43       {\em\LARGE\py@HeaderFamily Leandro Mat\'ias Lucarella \par}
  44       {\em\normalsize\py@HeaderFamily Direcci\'on Lic. Rosa Wachenchauzer \par}
  45       {\em\small\py@HeaderFamily Padr\'on 77.891 \par}
  46       \vfill
  47       {\LARGE\py@HeaderFamily Tesis de Grado en Ingenier\'ia en Inform\'atica \par}
  48       {\Large\py@HeaderFamily Departamento de Computaci\'on \par}
  49       {\large\py@HeaderFamily Facultad de Ingenier\'ia \par}
  50       {\normalsize\py@HeaderFamily Universidad de Buenos Aires \par}
  51       \vfill
  52       \vfill
  53       {\large
  54        Octubre 2010 \par
  55        \vfill
  56        \py@authoraddress \par
  57       }%
  58     \end{flushright}%\par
  59     \@thanks
  60   \end{titlepage}%
  61   \cleardoublepage%
  62   \setcounter{footnote}{0}%
  63   \let\thanks\relax\let\maketitle\relax
  64   %\gdef\@thanks{}\gdef\@author{}\gdef\@title{}
  65 }
  66
  67
  68 % Catch the end of the {abstract} environment, but here make sure the abstract
  69 % is followed by a blank page if the 'openright' option is used.
  70 %
  71 \let\py@OldEndAbstract=\endabstract
  72 \renewcommand{\endabstract}{
  73   \if@openright
  74     \ifodd\value{page}
  75       \typeout{Adding blank page after the abstract.}
  76       \vfil\pagebreak
  77     \fi
  78   \fi
  79   \py@OldEndAbstract
  80 }
  81
  82 % This wraps the \tableofcontents macro with all the magic to get the spacing
  83 % right and have the right number of pages if the 'openright' option has been
  84 % used.  This eliminates a fair amount of crud in the individual document files.
  85 %
  86 \let\py@OldTableofcontents=\tableofcontents
  87 \renewcommand{\tableofcontents}{%
  88   \setcounter{page}{1}%
  89   \pagebreak%
  90   \pagestyle{plain}%
  91   {%
  92     \parskip = 0mm%
  93     \py@OldTableofcontents%
  94     \if@openright%
  95       \ifodd\value{page}%
  96         \typeout{Adding blank page after the table of contents.}%
  97         \pagebreak\hspace{0pt}%
  98       \fi%
  99     \fi%
 100     \cleardoublepage%
 101   }%
 102   \pagenumbering{arabic}%
 103   \@ifundefined{fancyhf}{}{\pagestyle{normal}}%
 104 }
 105
 106 % This is needed to get the width of the section # area wide enough in the
 107 % library reference.  Doing it here keeps it the same for all the manuals.
 108 %
 109 \renewcommand*\l@section{\@dottedtocline{1}{1.5em}{2.6em}}
 110 \renewcommand*\l@subsection{\@dottedtocline{2}{4.1em}{3.5em}}