[Scons-dev] Documentation in EPUB-Format?

[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 <tshortik at 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 at scons.org

> http://two.pairlist.net/mailman/listinfo/scons-dev

>

>



-- 
Gary
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://two.pairlist.net/pipermail/scons-dev/attachments/20131006/96046119/attachment.html>