Hi All,<br><br><div class="gmail_quote">On Wed, Jun 16, 2010 at 7:22 AM, Daniel Holbach <span dir="ltr"><<a href="mailto:daniel.holbach@ubuntu.com" target="_blank">daniel.holbach@ubuntu.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">




<div>On 07.06.2010 16:36, Jim Campbell wrote:<br>
> I agree with much of what Milo has written, and just wanted to add a few<br>
> things.  With regards to writing in Mallard, there is a GSoC student<br>
> working on an online Mallard editor this summer.  This could simplify<br>
> the Mallard authoring process even further, but we'll have to see how<br>
> things turn out on that project.<br>
><br>
> As for PDF output, Milo mentioned that there is no PDF option for<br>
> Mallard at the present time, but even if there were . . . FOP only<br>
> provides for relatively basic PDF formatting.   This affects DocBook PDF<br>
> output, too.  LaTeX provides for excellent PDF output, but it suffers<br>
> with regards to ease of translation.  AFAIK, there are no automated<br>
> tools in place to process LaTeX docs, as they are not XML-based.<br>
><br>
> Mallard docs can reasonably be put into a format resembling a book.  You<br>
> can see an initial draft example of this at the Gitorious page for the<br>
> Snake Wrangling for Kids book.  <a href="http://gitorious.org/swfk" target="_blank">http://gitorious.org/swfk</a><br>
<br>
</div>Thanks a lot for all these comments. If there's any more comments, let<br>
me know.<br>
<div><div></div><div><br>
Have a great day,<br>
 Daniel<br>
</div></div></blockquote></div><br>Daniel, did you get a chance to look at the Snake Wrangling for Kids draft book?  If not, please clone that gitorious repo and take a look at chapter 1.  <br><br>The content and style/appearance of that chapter is a bit rough, but it would give you an idea of the Mallard-based output.  Also keep in mind that (as Milo said) this is kind of a funny way of using Mallard.  SWFK is using Mallard to write a book, while Mallard is more built to be more topic-focused.<br>


<br>One of your original criteria was to have PDF output available, and for that reason I'm leaning toward DocBook for the project.  When dealing with packaging tasks and concepts, I think it would be helpful for folks to at least have an option to output to PDF, and DocBook provides this.<br>


<br>I'm not a packager, and am interested in packaging, so I think I would be a good person to work on these docs.  I've been sketching out some ideas, which you can grab from Launchpad: bzr branch <span class="branch-url">lp:~jwcampbell/+junk/packaging-guide  <br>

<br>These are just notes, but I think you can see the general direction that I think the project could go - Laying out some big-picture information about packaging for Ubuntu, identifying some prerequisites, and then letting the person choose from a list of specific packaging tasks.  <br>

<br>I think that converting the packaging docs would be a worthwhile effort, but I'd need some help.  Who would be interested in assisting on this project?<br><br>Please also feel free to share any feedback on what I've written above.  Does DocBook sound pretty reasonable to folks for now?  <br>

<br>Jim<br></span>