From: David G. <go...@py...> - 2005-09-25 16:26:20
Attachments:
signature.asc
|
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 W. <Fel...@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 |