On 2009-05-02, Georg Brandl wrote:
>>>>> On Fri, Apr 17, 2009 at 4:12 AM, Guenter Milde wrote:
>>>>>> Also, it loads the 'report' standard LaTeX documentclass with the
>>>>>> "openright" option hard-coded
>> ...
>>>>> If anyone knows how to make it pass those settings along only if it
>>>>> gets them, that would be great.
...
While possible (with some LaTeX magic), the most easy and maintable
method will be to provide "openright" and "twoside" as default settings
configurable via config.py [#]_ and call the "report" documentclass
without options.
_[#] either modify the 'classoptions' so that the "special named" class
options are appended to a customizable prefix or provide separate
keys to the latex_elements.
See patch below.
>> * Is manual.cls a part of Sphinx or or Python?
...
> The original was used in 2.5's LaTeX-source documentation, and I adapted it
> (quite a lot over time) for Sphinx. I guess that the first you find there
> is the original 2.5 doc one (which Debian ships).
>> * Who could decide to change the name to be more specific
>> (python-manual.cls, say).
> I'd say changing it to "sphinx-manual.cls" is not a problem.
Please do so, as in the LaTeX world, it is common to rename any modified
versions (in many cases it is even mandated by the License). This prevents
nasty surprises with things not working as expected.
thanks,
Günter
Suggestion for sphinx-manual.cls::
--- /usr/share/sphinx/texinputs/manual.cls 2009-03-24 21:51:15.000000000
+0100
+++ /Test/sphinx-manual.cls 2009-05-06 14:26:46.000000000 +0200
@@ -1,14 +1,14 @@
%
-% manual.cls for Sphinx
+% Default document class for Sphinx (http://sphinx.pocoo.org/)
%
\NeedsTeXFormat{LaTeX2e}[1995/12/01]
-\ProvidesClass{manual}[2008/10/18 Document class (Sphinx manual)]
+\ProvidesClass{sphinx-manual}[2009/05/06 Document class (Sphinx manual)]
% Pass all given class options to the parent class.
\DeclareOption*{\PassOptionsToClass{\CurrentOption}{report}}
\ProcessOptions\relax
-\LoadClass[twoside,openright]{report}
+\LoadClass{report}
% Set some sane defaults for section numbering depth and TOC depth. You can
% reset these counters in your preamble.
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"sphinx-dev" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to
[email protected]
For more options, visit this group at
http://groups.google.com/group/sphinx-dev?hl=en
-~----------~----~----~----~------~----~------~--~---
