RFE: enhancements to Lore for --config book

[twisted-trac]

RFE: enhancements to Lore for --config book

[twisted-trac]

	Automation removed owner

[twisted-trac]

	@glyph set status to closed

I can't figure out what this is talking about any more. Many of the complaints may still be valid, but:

1. they should be filed as individual tickets
2. they should be better described
3. some of them probably shouldn't be bothered with.

[twisted-trac]

	@exarkun commented

#!html
<pre>
Is this still relevant?
</pre>

[twisted-trac]

	spiv commented

#!html
<pre>
More importantly, I want to get rid of the current
duplication of admin/book.tex and doc/howto/index.html.

</pre>

[twisted-trac]

	@radix commented

#!html
<pre>
Tasks:
1) Make lore use --template
2) Make default templates for both lore and latex
3) Implement the catalog: syntax in --template
4) With --config book, Instead of processing every
file, process only book.html, then find the files
mentioned in book and process them.


(capturing a conversation I had with spiv a while back):

Feb 20 16:37:09
&lt;MoonFallen> spiv_work: the idea is to ditch book.tex
in favor
of howto/index.html; if you want to add latex
stylesheets you do them with
a &lt;link rel="stylesheet" type="application/x-latex"
href="my.sty"/>
&lt;MoonFallen> i designed it for my own needs. it works,
but i would like
to know if there's anything else you expect it to do,
that it doesn't do
&lt;spiv> MoonFallen: Yes, I absolutely agree with the
idea of ditching book.tex.
&lt;spiv> I'm hesistant to require latex-specific markup,
though.
&lt;MoonFallen> browsers happily ignore it and it's 100%
xhtml compliant
&lt;spiv> I think I'd prefer a --template argument to lint
-o latex.
&lt;spiv> Which is what the current html output does, and
I think it works well.
&lt;MoonFallen> spiv_work: i can do that
&lt;spiv> MoonFallen: That'd be great. :)
&lt;MoonFallen> spiv: there's another whole direction we
can go there,
though: make different templates available through the
system itself,
instead of requiring the developer to write one every time
&lt;spiv> Hmm.
&lt;spiv> Having default templates is probably good.
&lt;spiv> What did you have in mind?
&lt;MoonFallen> well, the first thing i noticed when i
started using lore
is it only supports letter-sized paper. so there's an
obvious need in my
mind for an a4 template
&lt;itamar> yes
&lt;MoonFallen> other than that, it's all just prettiness.
different colors
in the html, different fonts in the printed version, etc.
&lt;MoonFallen> give people an option for how their
document looks
&lt;spiv> Heh. I use a4, and I never noticed that. I
guess I've never
printed it :)
&lt;MoonFallen> not so much the paper size actually, but
the units are in
inches
&lt;MoonFallen> i think it might print ok
&lt;MoonFallen> 80-column &lt;pre> stuff won't fit though
&lt;spiv> Hmm.
&lt;spiv> I'd like 80-columns of pre to fit on the print
version.
&lt;spiv> But I guess if someone knows what they're doing,
they're welcome to
change their own template.
&lt;MoonFallen> well my train of thought is that you could
make an a4
template (or a4 versions of a series of templates,
depending on how motivated
we are) that just uses a slightly smaller font in \verbatim
&lt;MoonFallen> i could also use this as an opportunity to
start putting in
color, which i think the printed version badly needs.
&lt;MoonFallen> i'm thinking lore --template
catalog:letter-1 -o latex
&lt;MoonFallen> if you want to use your own template you
give the filename,
otherwise you ask for a catalog: entry and it copies
the right one for you

</pre>

[twisted-trac]

	moonfallen commented

#!html
<pre>
Some work has been done on this already, in fact --config
book will work, you give it some equivalent of index.html
(with optional stylesheet as specced above) and it will
produce index.tex.

Spiv has also done some work on this, the details of which I
don't know.

Finally, we want to get rid of the latex stylesheets in the
HTML code.  This can be done with magic latex macros which
have yet to be written.

</pre>

[twisted-trac]

	@thijstriemstra commented

Replying to spiv:

More importantly, I want to get rid of the current
duplication of admin/book.tex and doc/howto/index.html.

Both files are gone, perhaps this ticket can be closed?

[twisted-trac]

	@exarkun commented

book.tex merely moved to doc/core/howto. Likewise, doc/howto/index.html is now doc/core/howto/index.xhtml