Re: [Scons-dev] Documentation in EPUB-Format?

2013-10-06 Thread Dirk Bächle 

On 06.10.2013 01:24, Bill Deegan wrote:

Dirk,

How big are the ePub files? vs pdf..



For the full UserGuide, I currently have:

PDF = 2394kB vs. EPUB = 219kB

, but you have to take into account that the additional graphics for the 
style and the titlepage

eat up a lot of space for the PDF.

I haven't tried yet, but I guess additional images would bloat up both 
formats in about the same way.


Regards,

Dirk


___
Scons-dev mailing list
Scons-dev@scons.org
http://two.pairlist.net/mailman/listinfo/scons-dev

Re: [Scons-dev] Documentation in EPUB-format

2013-10-06 Thread Dirk Bächle 

Andrew,

On 06.10.2013 21:07, Dirk Bächle wrote:

[...]
The DocBook Tool is not (yet) part of the core sources. By keeping 
compatibility to older SCons and Python versions, we don't force 
people to upgrade if they want to use the Tool. So this still makes 
sense, I think.




sorry I have to correct myself...it *is* a core Tool by now. Anyway, 
please publish your changes on your scons_docbook fork and send a short 
note. Then I'll have a look and we can decide how to take it from there.


Dirk

___
Scons-dev mailing list
Scons-dev@scons.org
http://two.pairlist.net/mailman/listinfo/scons-dev

Re: [Scons-dev] Documentation in EPUB-Format?

2013-10-06 Thread Gary Oberbrunner 
I wouldn't use the epub format personally, I almost always use the
searchable HTML.  But anything that allows for wider adoption is fine with
me, especially if it's not much work.


On Fri, Oct 4, 2013 at 8:56 AM, Dirk Bächle tshor...@gmx.de wrote:

 Hi devs,

 since we're now using DocBook as source format for all our documentation,
 it would technically be relatively easy to publish things like the MAN page
 or the UserGuide in EPUB format as well.
 The latest versions of pandoc ( 1.12.x) offer a DocBook reader and do
 a, more or less, good job in rendering the single markups.
 Find a shortened version of the UserGuide attached, as a first example...

 The question now is: Should we go this route? Then I'd try to integrate an
 ebook target into the build and bootstrapping process, such that EPUBs
 get created automatically if pandoc can be found on the current system.

 Note, how this would add a dependency to pandoc for all the
 ReleaseManagers...and this currently means installing the full Haskell
 platform package with approx 400MB. ;)

 Your comments?

 Best regards,

 Dirk


 ___
 Scons-dev mailing list
 Scons-dev@scons.org
 http://two.pairlist.net/mailman/listinfo/scons-dev




-- 
Gary
___
Scons-dev mailing list
Scons-dev@scons.org
http://two.pairlist.net/mailman/listinfo/scons-dev