<div dir="ltr"><div><div>I did a quick proof of concept to see how it would work to migrate it from docbook to rst. The results are on my github [1]. It only took a few minutes to figure out how to migrate the content. I can work on getting the navigation working too if people like this.<br>
<br></div>If decide we want to do RST. I think we should follow the same style as what opsschool [3, 4] did. They use sphinx [2] to manage the conversion to html/pdfs and it looks really good.  <br><br>[1] <a href="https://github.com/blkperl/ubuntu-serverguide">https://github.com/blkperl/ubuntu-serverguide</a><br>
[2] <a href="http://sphinx-doc.org/">http://sphinx-doc.org/</a><br>[3] <a href="https://github.com/opsschool/curriculum">https://github.com/opsschool/curriculum</a><br>[4] <a href="http://www.opsschool.org/en/latest/">http://www.opsschool.org/en/latest/</a><br>
<br></div>~blkperl<br></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Thu, Dec 12, 2013 at 2:15 PM, Peter Matulis <span dir="ltr"><<a href="mailto:peter.matulis@canonical.com" target="_blank">peter.matulis@canonical.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="im">On 12/12/2013 04:03 PM, Jorge O. Castro wrote:<br>
> On Thu, Dec 12, 2013 at 8:57 AM, Peter Matulis<br>
> <<a href="mailto:peter.matulis@canonical.com">peter.matulis@canonical.com</a>> wrote:<br>
>> This is mentioned at every UDS but no one ever steps up to do anything<br>
>> so we remain with XML.<br>
><br>
> What's involved with this?<br>
<br>
</div>1. Ensuring the underlying source can yield HTML and PDF documents.<br>
<br>
2. Convert *all* XML to the new format and then convert *all* of the<br>
latter to HTML *and* PDF and make sure *everything* looks right.<br>
<br>
3. The toolchain needs to be understandable by mortals.<br>
<br>
(a) Will we lose "linkend" attributes?  That is, the ability to do:<br>
<br>
<para><br>
If you are going to use LDAP to store Samba users you will need to<br>
configure the Samba<br>
server to authenticate using LDAP. See <xref linkend="samba-ldap"/> for<br>
details.<br>
</para><br>
<br>
I'm not sure how these kinds of source links will end up after<br>
converting from XML to markdown.<br>
<br>
(b) There may very well be other things we need to think about.  I'm not<br>
an XML expert.<br>
<div class="im"><br>
> Sections 10 through 14 need to be rewritten for Juju usage.<br>
<br>
</div>I don't see why not as long as i) we can achieve the same results in<br>
terms of an actual installation and ii) do not leave people scratching<br>
their heads.  I'm alluding to the fact that performing manual steps is<br>
part of learning the software's architecture and, in turn, is invaluable<br>
in how to maintain/administer the installation.  Since Juju replaces the<br>
manual steps the text would need to replace them with corresponding<br>
explanation.<br>
<br>
~pmatulis<br>
<div class="HOEnZb"><div class="h5"><br>
--<br>
ubuntu-server mailing list<br>
<a href="mailto:ubuntu-server@lists.ubuntu.com">ubuntu-server@lists.ubuntu.com</a><br>
<a href="https://lists.ubuntu.com/mailman/listinfo/ubuntu-server" target="_blank">https://lists.ubuntu.com/mailman/listinfo/ubuntu-server</a><br>
More info: <a href="https://wiki.ubuntu.com/ServerTeam" target="_blank">https://wiki.ubuntu.com/ServerTeam</a><br>
</div></div></blockquote></div><br><br clear="all"><br>-- <br><div>Thanks,</div>William<br>
</div>