RbST 0.1.2 → 0.1.3

data/README.markdown

@@ -43,6 +43,12 @@ By default, RbST uses the `html_body` part for HTML and the `whole` part for LaT
 
 Available options can be viewed using the `RbST.html_options` and `RbST.latex_options` class methods.
 
+You might run into a situation where you want to specify a custom script for processing one or both of the output formats. If so, just specify the full path to the custom script for the format by passing a hash to the `RbST.executables=` method:
+
+    RbST.executables = {:html => "/some/other/path/2html.py"}
+    RbST.new("something").to_html  # uses custom executable for outputting html
+    RbST.new("something else").to_latex # uses default executable for latex since a custom one wasn't specified
+
 For more information on reStructuredText, see the
 [ReST documentation](http://docutils.sourceforge.net/rst.html).
 

data/RbST.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{RbST}
-  s.version = "0.1.2"
+  s.version = "0.1.3"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["William Melody"]
-  s.date = %q{2010-03-29}
+  s.date = %q{2010-05-12}
   s.description = %q{A simple Ruby wrapper for processing reStructuredText via Python's Docutils}
   s.email = %q{wmelody@gmail.com}
   s.extra_rdoc_files = [

data/VERSION

@@ -1 +1 @@
-0.1.2
+0.1.3

data/lib/rbst.rb

@@ -2,6 +2,12 @@ require 'open3'
 
 class RbST
   
+  @@executable_path = File.expand_path(File.join(File.dirname(__FILE__), "rst2parts"))
+  @@executables = {
+    :html  => File.join(@@executable_path, "rst2html.py"),
+    :latex => File.join(@@executable_path, "rst2latex.py")
+  }
+  
   # Takes a string or file path plus any additional options and converts the input.
   def self.convert(*args)
     new(*args).convert
@@ -17,6 +23,18 @@ class RbST
     new.print_options(:html)
   end
   
+  # Specify custom executables to use instead of the default rst2latex.py and
+  # rst2html.py scripts. Takes a hash with two possible keys, :html and :latex,
+  # which should contain a full path to the alternative executable.
+  def self.executables=(exec_paths = {})
+    if exec_paths.empty? || (exec_paths.keys & [:html, :latex]).empty?
+      raise ArgumentError, "Custom executable format must be :html or :latex"
+    end
+    @@executables = @@executables.merge(exec_paths)
+  end
+  # Return the executable hash.
+  def self.executables; @@executables end
+  
   # Takes a string or file path plus any additional options and creates a new converter object.
   def initialize(*args)
     target = args.shift
@@ -26,7 +44,7 @@ class RbST
 
   def convert # :nodoc:
     @output_format ||= :html
-    execute "python #{RbST.executable(@output_format)}" + convert_options
+    execute "python #{@@executables[@output_format]}" + convert_options
   end
   alias_method :to_s, :convert
   
@@ -46,7 +64,7 @@ class RbST
   
   # Formats and prints the options from the docutils help in the way they'd be specified in RbST: strings, symbols and hashes.
   def print_options(format)
-    help = execute("python #{RbST.executable(format)} --help")
+    help = execute("python #{@@executables[format]} --help")
     # non-hyphenated long options to symbols
     help.gsub!(/(\-\-)([A-Za-z0-9]+)([=|\s])/, ':\2\3')
     # hyphenated long options to quoted strings
@@ -60,11 +78,7 @@ class RbST
     puts help
   end
   
-private
-  
-  def self.executable(writer = :html)
-    File.expand_path(File.join(File.dirname(__FILE__), "rst2parts", "rst2#{writer}.py"))
-  end
+protected
   
   def execute(command)
     output = ''

data/test/files/test.html

@@ -175,7 +175,7 @@ used to separate indentation contexts)</td>
 <div class="section" id="inline-markup">
 <h1>Inline Markup</h1>
 <p><em>emphasis</em>; <strong>strong emphasis</strong>; <cite>interpreted text</cite>; <em>interpreted text
-with role</em>; <tt class="docutils literal"><span class="pre">inline</span> <span class="pre">literal</span> <span class="pre">text</span></tt>; standalone hyperlink,
+with role</em>; <tt class="docutils literal">inline literal text</tt>; standalone hyperlink,
 <a class="reference external" href="http://docutils.sourceforge.net">http://docutils.sourceforge.net</a>; named reference, <a class="reference external" href="http://docutils.sf.net/rst.html">reStructuredText</a>;
 <a class="reference external" href="http://docutils.sf.net/docs/ref/rst/restructuredtext.html">anonymous reference</a>; footnote reference, <a class="footnote-reference" href="#id1" id="id3">[1]</a>; citation reference,
 <a class="citation-reference" href="#cit2002" id="id4">[CIT2002]</a>; like an inline directive; <span class="target" id="inline-internal-target">inline internal target</span>.</p>
@@ -199,25 +199,25 @@ with role</em>; <tt class="docutils literal"><span class="pre">inline</span> <sp
 &quot;error&quot;, &quot;hint&quot;, &quot;important&quot;, &quot;note&quot;, &quot;tip&quot;, &quot;warning&quot;</td>
 </tr>
 <tr><td>admonition</td>
-<td>Generic titled admonition: <tt class="docutils literal"><span class="pre">..</span> <span class="pre">admonition::</span> <span class="pre">By</span> <span class="pre">The</span> <span class="pre">Way</span></tt></td>
+<td>Generic titled admonition: <tt class="docutils literal">.. admonition:: By The Way</tt></td>
 </tr>
 <tr><td>image</td>
-<td><tt class="docutils literal"><span class="pre">..</span> <span class="pre">image::</span> <span class="pre">picture.png</span></tt>; many options possible</td>
+<td><tt class="docutils literal">.. image:: picture.png</tt>; many options possible</td>
 </tr>
 <tr><td>figure</td>
 <td>Like &quot;image&quot;, but with optional caption and legend</td>
 </tr>
 <tr><td>topic</td>
-<td><tt class="docutils literal"><span class="pre">..</span> <span class="pre">topic::</span> <span class="pre">Title</span></tt>; like a mini section</td>
+<td><tt class="docutils literal">.. topic:: Title</tt>; like a mini section</td>
 </tr>
 <tr><td>sidebar</td>
-<td><tt class="docutils literal"><span class="pre">..</span> <span class="pre">sidebar::</span> <span class="pre">Title</span></tt>; like a mini parallel document</td>
+<td><tt class="docutils literal">.. sidebar:: Title</tt>; like a mini parallel document</td>
 </tr>
 <tr><td>parsed-literal</td>
 <td>A literal block with parsed inline markup</td>
 </tr>
 <tr><td>rubric</td>
-<td><tt class="docutils literal"><span class="pre">..</span> <span class="pre">rubric::</span> <span class="pre">Informal</span> <span class="pre">Heading</span></tt></td>
+<td><tt class="docutils literal">.. rubric:: Informal Heading</tt></td>
 </tr>
 <tr><td>epigraph</td>
 <td>Block quote with class=&quot;epigraph&quot;</td>
@@ -306,7 +306,7 @@ with role</em>; <tt class="docutils literal"><span class="pre">inline</span> <sp
 <td>Equivalent to <em>emphasis</em></td>
 </tr>
 <tr><td>literal</td>
-<td>Equivalent to <tt class="docutils literal"><span class="pre">literal</span></tt> but processes backslash escapes</td>
+<td>Equivalent to <tt class="docutils literal">literal</tt> but processes backslash escapes</td>
 </tr>
 <tr><td>PEP</td>
 <td>Reference to a numbered Python Enhancement Proposal</td>

data/test/files/test.latex

@@ -1,124 +1,158 @@
-\documentclass[10pt,a4paper,english]{article}
+% generated by Docutils <http://docutils.sourceforge.net/>
+\documentclass[a4paper,english]{article}
+\usepackage{fixltx2e} % LaTeX patches, \textsubscript
+\usepackage{cmap} % fix search and cut-and-paste in PDF
 \usepackage{babel}
-\usepackage{ae}
-\usepackage{aeguill}
-\usepackage{shortvrb}
-\usepackage{ucs}
-\usepackage[utf8x]{inputenc}
-\usepackage{tabularx}
-\usepackage{longtable}
-\setlength{\extrarowheight}{2pt}
-\usepackage{amsmath}
+\usepackage[T1]{fontenc}
+\usepackage[utf8]{inputenc}
+\usepackage{ifthen}
 \usepackage{graphicx}
-\usepackage{color}
 \usepackage{multirow}
-\usepackage{ifthen}
-\usepackage[DIV12]{typearea}
-% generated by Docutils <http://docutils.sourceforge.net/>
-\newlength{\admonitionwidth}
-\setlength{\admonitionwidth}{0.9\textwidth}
-\newlength{\docinfowidth}
-\setlength{\docinfowidth}{0.9\textwidth}
-\newlength{\locallinewidth}
-\newcommand{\optionlistlabel}[1]{\bf #1 \hfill}
-\newenvironment{optionlist}[1]
-{\begin{list}{}
-  {\setlength{\labelwidth}{#1}
-   \setlength{\rightmargin}{1cm}
-   \setlength{\leftmargin}{\rightmargin}
-   \addtolength{\leftmargin}{\labelwidth}
-   \addtolength{\leftmargin}{\labelsep}
-   \renewcommand{\makelabel}{\optionlistlabel}}
-}{\end{list}}
-\newlength{\lineblockindentation}
-\setlength{\lineblockindentation}{2.5em}
-\newenvironment{lineblock}[1]
-{\begin{list}{}
-  {\setlength{\partopsep}{\parskip}
-   \addtolength{\partopsep}{\baselineskip}
-   \topsep0pt\itemsep0.15\baselineskip\parsep0pt
-   \leftmargin#1}
- \raggedright}
-{\end{list}}
-% begin: floats for footnotes tweaking.
-\setlength{\floatsep}{0.5em}
-\setlength{\textfloatsep}{\fill}
-\addtolength{\textfloatsep}{3em}
-\renewcommand{\textfraction}{0.5}
-\renewcommand{\topfraction}{0.5}
-\renewcommand{\bottomfraction}{0.5}
-\setcounter{totalnumber}{50}
-\setcounter{topnumber}{50}
-\setcounter{bottomnumber}{50}
-% end floats for footnotes
-% some commands, that could be overwritten in the style file.
-\newcommand{\rubric}[1]{\subsection*{~\hfill {\it #1} \hfill ~}}
-\newcommand{\titlereference}[1]{\textsl{#1}}
-% end of "some commands"
+\usepackage{longtable}
+\usepackage{array}
+\setlength{\extrarowheight}{2pt}
+\newlength{\DUtablewidth} % internal use in tables
+\usepackage{tabularx}
+
+%%% User specified packages and stylesheets
+
+%%% Fallback definitions for Docutils-specific commands
+
+% providelength (provide a length variable and set default, if it is new)
+\providecommand*{\DUprovidelength}[2]{
+  \ifthenelse{\isundefined{#1}}{\newlength{#1}\setlength{#1}{#2}}{}
+}
+
+% docinfo (width of docinfo table)
+\DUprovidelength{\DUdocinfowidth}{0.9\textwidth}
+
+% fieldlist environment
+\ifthenelse{\isundefined{\DUfieldlist}}{
+  \newenvironment{DUfieldlist}%
+    {\quote\description}
+    {\enddescription\endquote}
+}{}
+% numeric or symbol footnotes with hyperlinks
+\providecommand*{\DUfootnotemark}[3]{%
+  \raisebox{1em}{\hypertarget{#1}{}}%
+  \hyperlink{#2}{\textsuperscript{#3}}%
+}
+\providecommand{\DUfootnotetext}[4]{%
+  \begingroup%
+  \renewcommand{\thefootnote}{%
+    \protect\raisebox{1em}{\protect\hypertarget{#1}{}}%
+    \protect\hyperlink{#2}{#3}}%
+  \footnotetext{#4}%
+  \endgroup%
+}
+
+% lineblock environment
+\DUprovidelength{\DUlineblockindent}{2.5em}
+\ifthenelse{\isundefined{\DUlineblock}}{
+  \newenvironment{DUlineblock}[1]{%
+    \list{}{\setlength{\partopsep}{\parskip}
+            \addtolength{\partopsep}{\baselineskip}
+            \setlength{\topsep}{0pt}
+            \setlength{\itemsep}{0.15\baselineskip}
+            \setlength{\parsep}{0pt}
+            \setlength{\leftmargin}{#1}}
+    \raggedright
+  }
+  {\endlist}
+}{}
+
+% optionlist environment
+\providecommand*{\DUoptionlistlabel}[1]{\bf #1 \hfill}
+\DUprovidelength{\DUoptionlistindent}{3cm}
+\ifthenelse{\isundefined{\DUoptionlist}}{
+  \newenvironment{DUoptionlist}{%
+    \list{}{\setlength{\labelwidth}{\DUoptionlistindent}
+            \setlength{\rightmargin}{1cm}
+            \setlength{\leftmargin}{\rightmargin}
+            \addtolength{\leftmargin}{\labelwidth}
+            \addtolength{\leftmargin}{\labelsep}
+            \renewcommand{\makelabel}{\DUoptionlistlabel}}
+  }
+  {\endlist}
+}{}
+
+% titlereference role
+\providecommand*{\DUroletitlereference}[1]{\textsl{#1}}
+
+% hyperlinks:
 \ifthenelse{\isundefined{\hypersetup}}{
-\usepackage[colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
+  \usepackage[colorlinks=true,linkcolor=blue,urlcolor=blue]{hyperref}
 }{}
-\title{The reStructuredText Cheat Sheet: Syntax Reminders}
-\author{}
-\date{}
 \hypersetup{
-pdftitle={The reStructuredText Cheat Sheet: Syntax Reminders},
-pdfauthor={David Goodger {\textless}goodger@python.org{\textgreater}}
+  pdftitle={The reStructuredText Cheat Sheet: Syntax Reminders},
+  pdfauthor={David Goodger <goodger@python.org>}
 }
-\raggedbottom
+
+%%% Body
 \begin{document}
+
+% Document title
+\title{The reStructuredText Cheat Sheet: Syntax Reminders%
+  \phantomsection%
+  \label{the-restructuredtext-cheat-sheet-syntax-reminders}}
+\author{}
+\date{}
 \maketitle
-%___________________________________________________________________________
+
+% Docinfo
 \begin{center}
-\begin{tabularx}{\docinfowidth}{lX}
+\begin{tabularx}{\DUdocinfowidth}{lX}
 \textbf{Info}: &
-	See {\textless}http://docutils.sf.net/rst.html{\textgreater} for introductory docs. \\
+See <\href{http://docutils.sf.net/rst.html}{http://docutils.sf.net/rst.html}> for introductory docs.
+\\
 \textbf{Author}: &
-	David Goodger {\textless}\href{mailto:goodger@python.org}{goodger@python.org}{\textgreater} \\
+	David Goodger <\href{mailto:goodger@python.org}{goodger@python.org}> \\
 \textbf{Date}: &
 	2006-01-23 \\
 \textbf{Revision}: &
 	4321 \\
 \textbf{Description}: &
-	This is a ``docinfo block'', or bibliographic field list \\
+This is a ``docinfo block'', or bibliographic field list
+\\
 \end{tabularx}
 \end{center}
 
-\setlength{\locallinewidth}{\linewidth}
-
-
-
 
 %___________________________________________________________________________
 
-\hypertarget{section-structure}{}
-\pdfbookmark[0]{Section Structure}{section-structure}
-\section*{Section Structure}
-\label{section-structure}
+\section*{Section Structure%
+  \phantomsection%
+  \addcontentsline{toc}{section}{Section Structure}%
+  \label{section-structure}%
+}
 
-Section titles are underlined or overlined {\&} underlined.
+Section titles are underlined or overlined \& underlined.
 
 
 %___________________________________________________________________________
 
-\hypertarget{body-elements}{}
-\pdfbookmark[0]{Body Elements}{body-elements}
-\section*{Body Elements}
-\label{body-elements}
+\section*{Body Elements%
+  \phantomsection%
+  \addcontentsline{toc}{section}{Body Elements}%
+  \label{body-elements}%
+}
 
 Grid table:
 
 \leavevmode
-\begin{longtable}[c]{|p{0.389\locallinewidth}|p{0.424\locallinewidth}|}
+\setlength{\DUtablewidth}{\linewidth}
+\begin{longtable}[c]{|p{0.389\DUtablewidth}|p{0.424\DUtablewidth}|}
 \hline
 
 Paragraphs are flush-left,
 separated by blank lines.
+%
 \begin{quote}
 
 Block quotes are indented.
+
 \end{quote}
- & \multirow{2}{0.42\locallinewidth}{
+ & \multirow{2}{0.42\DUtablewidth}{%
 Literal block, preceded by ``::'':
 
 {\ttfamily \raggedright \noindent
@@ -132,19 +166,22 @@ or:
 }
 } \\
 \cline{1-1}
-\begin{verbatim}>>> print 'Doctest block'
-Doctest block\end{verbatim}
+
+{\ttfamily \raggedright \noindent
+>{}>{}>~print~'Doctest~block'\\
+Doctest~block
+}
  &  \\
 \hline
 \multicolumn{2}{|l|}{
-\begin{lineblock}{0em}
-\item[] Line blocks preserve line breaks {\&} indents. {[}new in 0.3.6{]}
-\item[] 
-\begin{lineblock}{\lineblockindentation}
+\begin{DUlineblock}{0em}
+\item[] Line blocks preserve line breaks \& indents. {[}new in 0.3.6{]}
+\item[]
+\begin{DUlineblock}{\DUlineblockindent}
 \item[] Useful for addresses, verse, and adornment-free lists; long
 lines can be wrapped with continuation lines.
-\end{lineblock}
-\end{lineblock}
+\end{DUlineblock}
+\end{DUlineblock}
 } \\
 \hline
 \end{longtable}
@@ -152,20 +189,33 @@ lines can be wrapped with continuation lines.
 Simple tables:
 
 \leavevmode
-\begin{longtable}[c]{|p{0.203\locallinewidth}|p{0.714\locallinewidth}|}
+\setlength{\DUtablewidth}{\linewidth}
+\begin{longtable}[c]{|p{0.203\DUtablewidth}|p{0.714\DUtablewidth}|}
+\hline
+\textbf{%
+List Type
+} & \textbf{%
+Examples
+} \\
+\hline
+\endfirsthead
 \hline
-\textbf{
+\textbf{%
 List Type
-} & \textbf{
+} & \textbf{%
 Examples
 } \\
 \hline
 \endhead
+\multicolumn{2}{c}{\hfill ... continued on next page} \\
+\endfoot
+\endlastfoot
 
 Bullet list
- & \begin{itemize}
-\item {} 
-items begin with ``-'', ``+'', or ``*''
+ & %
+\begin{itemize}
+
+\item items begin with ``-'', ``+'', or ``*''
 
 \end{itemize}
  \\
@@ -178,18 +228,17 @@ Enumerated list
 \usecounter{listcnt0}
 \setlength{\rightmargin}{\leftmargin}
 }
-\item {} 
-items use any variation of ``1.'', ``A)'', and ``(i)''
 
-\item {} 
-also auto-enumerated
+\item items use any variation of ``1.'', ``A)'', and ``(i)''
 
+\item also auto-enumerated
 \end{list}
  \\
 \hline
 
 Definition list
- & \begin{description}
+ & %
+\begin{description}
 \item[{Term is flush-left}] \leavevmode (\textbf{optional classifier})
 
 Definition is indented, no blank line between
@@ -199,54 +248,67 @@ Definition is indented, no blank line between
 \hline
 
 Field list
- & \begin{quote}
-\begin{description}
-\item [field name:]
+ & %
+\begin{DUfieldlist}
+\item[{field name:}]
 field body
 
-
-\end{description}
-\end{quote}
+\end{DUfieldlist}
  \\
 \hline
 
 Option list
- & \begin{optionlist}{3cm}
-\item [-o]  
-at least 2 spaces between option {\&} description
-\end{optionlist}
+ & %
+\begin{DUoptionlist}
+
+\item[-o]  at least 2 spaces between option \& description
+
+\end{DUoptionlist}
  \\
 \hline
 \end{longtable}
 
 \leavevmode
-\begin{longtable}[c]{|p{0.203\locallinewidth}|p{0.714\locallinewidth}|}
+\setlength{\DUtablewidth}{\linewidth}
+\begin{longtable}[c]{|p{0.203\DUtablewidth}|p{0.714\DUtablewidth}|}
+\hline
+\textbf{%
+Explicit Markup
+} & \textbf{%
+Examples (visible in the \href{cheatsheet.txt}{text source})
+} \\
+\hline
+\endfirsthead
 \hline
-\textbf{
+\textbf{%
 Explicit Markup
-} & \textbf{
+} & \textbf{%
 Examples (visible in the \href{cheatsheet.txt}{text source})
 } \\
 \hline
 \endhead
+\multicolumn{2}{c}{\hfill ... continued on next page} \\
+\endfoot
+\endlastfoot
 
 Footnote
- & \begin{figure}[b]\hypertarget{id1}$^{1}$
-Manually numbered or {[}{\#}{]} auto-numbered
-(even {[}{\#}labelled{]}) or {[}*{]} auto-symbol
-\end{figure}
+ & %
+\DUfootnotetext{id1}{id3}{1}{
+Manually numbered or {[}\#{]} auto-numbered
+(even {[}\#labelled{]}) or {[}*{]} auto-symbol
+}
  \\
 \hline
 
 Citation
- & \begin{figure}[b]\hypertarget{cit2002}[CIT2002]
+ & \begin{figure}[b]\raisebox{1em}{\hypertarget{cit2002}{}}[CIT2002]
 A citation.
 \end{figure}
  \\
 \hline
 
 Hyperlink Target
- & \hypertarget{internal-target}{} \\
+ &  \\
 \hline
 
 Anonymous Target
@@ -264,13 +326,14 @@ Substitution Def
 \hline
 
 Comment
- & % is anything else 
+ & 
+% is anything else
  \\
 \hline
 
 Empty Comment
  & 
-(``..'' on a line by itself, with blank lines before {\&} after,
+(``..'' on a line by itself, with blank lines before \& after,
 used to separate indentation contexts)
  \\
 \hline
@@ -279,37 +342,52 @@ used to separate indentation contexts)
 
 %___________________________________________________________________________
 
-\hypertarget{inline-markup}{}
-\pdfbookmark[0]{Inline Markup}{inline-markup}
-\section*{Inline Markup}
-\label{inline-markup}
+\section*{Inline Markup%
+  \phantomsection%
+  \addcontentsline{toc}{section}{Inline Markup}%
+  \label{inline-markup}%
+}
 
-\emph{emphasis}; \textbf{strong emphasis}; \titlereference{interpreted text}; \emph{interpreted text
+\emph{emphasis}; \textbf{strong emphasis}; \DUroletitlereference{interpreted text}; \emph{interpreted text
 with role}; \texttt{inline literal text}; standalone hyperlink,
 \href{http://docutils.sourceforge.net}{http://docutils.sourceforge.net}; named reference, \href{http://docutils.sf.net/rst.html}{reStructuredText};
-\href{http://docutils.sf.net/docs/ref/rst/restructuredtext.html}{anonymous reference}; footnote reference,\raisebox{.5em}[0em]{\scriptsize\hyperlink{id1}{1}}; citation reference,
-[\hyperlink{cit2002}{CIT2002}]; like an inline directive; \hypertarget{inline-internal-target}{inline internal target}.
+\href{http://docutils.sf.net/docs/ref/rst/restructuredtext.html}{anonymous reference}; footnote reference,\DUfootnotemark{id3}{id1}{1}; citation reference,
+[\hyperlink{cit2002}{CIT2002}]; like an inline directive; %
+\phantomsection\label{inline-internal-target}inline internal target.
 
 
 %___________________________________________________________________________
 
-\hypertarget{directive-quick-reference}{}
-\pdfbookmark[0]{Directive Quick Reference}{directive-quick-reference}
-\section*{Directive Quick Reference}
-\label{directive-quick-reference}
+\section*{Directive Quick Reference%
+  \phantomsection%
+  \addcontentsline{toc}{section}{Directive Quick Reference}%
+  \label{directive-quick-reference}%
+}
 
-See {\textless}\href{http://docutils.sf.net/docs/ref/rst/directives.html}{http://docutils.sf.net/docs/ref/rst/directives.html}{\textgreater} for full info.
+See <\href{http://docutils.sf.net/docs/ref/rst/directives.html}{http://docutils.sf.net/docs/ref/rst/directives.html}> for full info.
 
 \leavevmode
-\begin{longtable}[c]{|p{0.203\locallinewidth}|p{0.714\locallinewidth}|}
+\setlength{\DUtablewidth}{\linewidth}
+\begin{longtable}[c]{|p{0.203\DUtablewidth}|p{0.714\DUtablewidth}|}
 \hline
-\textbf{
+\textbf{%
 Directive Name
-} & \textbf{
+} & \textbf{%
+Description (Docutils version added to, in {[}brackets{]})
+} \\
+\hline
+\endfirsthead
+\hline
+\textbf{%
+Directive Name
+} & \textbf{%
 Description (Docutils version added to, in {[}brackets{]})
 } \\
 \hline
 \endhead
+\multicolumn{2}{c}{\hfill ... continued on next page} \\
+\endfoot
+\endlastfoot
 
 attention
  & 
@@ -496,23 +574,36 @@ Set the metadata document title {[}0.3.10{]}
 
 %___________________________________________________________________________
 
-\hypertarget{interpreted-text-role-quick-reference}{}
-\pdfbookmark[0]{Interpreted Text Role Quick Reference}{interpreted-text-role-quick-reference}
-\section*{Interpreted Text Role Quick Reference}
-\label{interpreted-text-role-quick-reference}
+\section*{Interpreted Text Role Quick Reference%
+  \phantomsection%
+  \addcontentsline{toc}{section}{Interpreted Text Role Quick Reference}%
+  \label{interpreted-text-role-quick-reference}%
+}
 
-See {\textless}\href{http://docutils.sf.net/docs/ref/rst/roles.html}{http://docutils.sf.net/docs/ref/rst/roles.html}{\textgreater} for full info.
+See <\href{http://docutils.sf.net/docs/ref/rst/roles.html}{http://docutils.sf.net/docs/ref/rst/roles.html}> for full info.
 
 \leavevmode
-\begin{longtable}[c]{|p{0.203\locallinewidth}|p{0.726\locallinewidth}|}
+\setlength{\DUtablewidth}{\linewidth}
+\begin{longtable}[c]{|p{0.203\DUtablewidth}|p{0.726\DUtablewidth}|}
+\hline
+\textbf{%
+Role Name
+} & \textbf{%
+Description
+} \\
+\hline
+\endfirsthead
 \hline
-\textbf{
+\textbf{%
 Role Name
-} & \textbf{
+} & \textbf{%
 Description
 } \\
 \hline
 \endhead
+\multicolumn{2}{c}{\hfill ... continued on next page} \\
+\endfoot
+\endlastfoot
 
 emphasis
  & 

data/test/test_rbst.rb

@@ -18,6 +18,26 @@ class TestRbST < Test::Unit::TestCase
     assert converter.convert
   end
   
+  should "convert with custom executable" do
+    executables = {:html => "/some/path/2html.py"}
+    default_executables = RbST.executables
+    RbST.executables = executables
+    converter = RbST.new(@file)
+    converter.expects(:execute).with("python #{executables[:html]}").returns(true)
+    assert converter.to_html
+    RbST.executables = default_executables
+  end
+  
+  should "raise error when passed bad executable key" do
+    executables = {:markdown => "/some/path/2markdown.py"}
+    begin
+      RbST.executables = executables
+      flunk
+    rescue ArgumentError
+      assert true
+    end
+  end
+  
   should "convert ReST to html" do
     html = RbST.new(@rst_file).to_html
     assert_equal html, File.read(@html_file)

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 1
-  - 2
-  version: 0.1.2
+  - 3
+  version: 0.1.3
 platform: ruby
 authors: 
 - William Melody
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-03-29 00:00:00 -05:00
+date: 2010-05-12 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency