While converting Docutils over to use support files in the
docutils/writers/support directory, I noticed that the latex2e writer
has both stylesheet & stylesheet_path settings. There, stylesheet
seems to be the equivalent of an embedded stylesheet_path. The
newlatex2e writer has the same semantics on its settings, but adds
user_stylesheet and user_stylesheet_path. The semantics for the
settings in the html4css1 writer are quite different; stylesheet is
for URLs and stylesheet_path is for local files.
This is very confusing. These settings should be rationalized and
unified. It seems to me that the LaTeX writers should only have one
stylesheet setting (per stylesheet type; newlatex2e needs two), plus
an embed_stylesheet setting.
(I don't recall noticing this before. But seeing how I don't actually
use LaTeX, it's not surprising :-). That may be changing though.)
David Goodger <http://python.net/~goodger>
From: Felix Wiemann <Felix.W<iemann@gm...> - 2005-09-26 18:34:12
David Goodger wrote:
> While converting Docutils over to use support files in the
> docutils/writers/support directory, I noticed that the latex2e writer
> has both stylesheet & stylesheet_path settings. There, stylesheet
> seems to be the equivalent of an embedded stylesheet_path. The
> newlatex2e writer has the same semantics on its settings, but adds
> user_stylesheet and user_stylesheet_path.
Regarding the newlatex2e writer, what's now the "stylesheet[-path]"
setting will be removed in the future because there is no need to change
the link to base.tex; anything can be overridden in a user stylesheet.
"--user-stylesheet" (without "-path") will be removed as well because
it's effectively useless (I assume). --user-stylesheet-path will be
renamed to --stylesheet-path.
For the latex2e writer, we *could* remove --stylesheet, but that would
break existing configurations. Since I expect to replace the old with
the new writer sooner or later, I suggest we leave it as is for now.
> These settings should be rationalized and unified.
+1 in general, -0 on doing it now. I suggest we wait until the new
LaTeX writer is finished (in about two or three months) so that we keep
the amount of work low.
For private mail please ensure that the header contains 'Felix Wiemann'.
"the number of contributors [...] is strongly and inversely correlated with the
number of hoops each project makes a contributing user go through." -- ESR