<br><br><div class="gmail_quote">2009/9/21 Arnaud Quette <span dir="ltr">&lt;<a href="mailto:aquette.dev@gmail.com">aquette.dev@gmail.com</a>&gt;</span><br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
<br><br><div class="gmail_quote">2009/9/21 Charles Lepple <span dir="ltr">&lt;<a href="mailto:clepple@gmail.com" target="_blank">clepple@gmail.com</a>&gt;</span><div class="im"><br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">

<div><div></div><div><br>
On Sep 21, 2009, at 7:28 AM, Charles Lepple wrote:<br>
<br>
<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
On Sep 21, 2009, at 5:52 AM, Arnaud Quette wrote:<br>
<br>
<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
Subject: svn commit r1997 - in branches/AsciiDoc: . docs docs/man docs/website<br>
Author: aquette<br>
Date: Mon Sep 21 09:51:09 2009<br>
New Revision: 1997<br>
<br>
Log:<br>
switch INSTALL to AsciiDoc, and name it as the &quot;Quick Start Instructions&quot;.<br>
Also includes various minor updates to the User Manual and Packager Guide.<br>
</blockquote>
<br>
Arnaud,<br>
<br>
not sure why Buildbot did not send out an email regarding this, but the AsciiDoc build failed for this revision:<br>
<br>
/usr/local/bin/asciidoc --unsafe --backend=xhtml11 \<br>
                --attribute icons \<br>
                --attribute localdate=`TZ=UTC date +%Y-%m-%d` \<br>
                --attribute localtime=`TZ=UTC date +%H:%M:%S` \<br>
                --attribute iconsdir=./icons \<br>
                --attribute=badges \<br>
                -a toc -a numbered -o user-manual.html user-manual.txt<br>
ERROR: cables.txt: line 2: only book doctypes can contain level 0 sections<br>
make[1]: *** [user-manual.html] Error 1<br>
<br>
</blockquote>
<br></div></div></blockquote></div><div><br>yup, sorry. I missed to fix that before commiting...<br> </div><div class="im"><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">

<div><div></div></div>
Looking a little closer, it seems that we have two conflicting goals here:<br>
<br>
 * having standalone web pages with automatic titles (&quot;level 0 sections&quot;)<br>
 * being able to include the same page in a larger document<br>
<br>
Maybe there is a way to set the page title attribute if it has not already been set by an including document?<br>
<br>
Unfortunately, this loses some of the simplicity of AsciiDoc.<br>
</blockquote></div></div><br>I&#39;m looking at that currently, but this was the main reason for not including a level 0 title in docs like features, cables (included both the website and the doc, itself pointed as a whole in the website).<br>

<br>ATM, the lightest solution I have is to conditionaly declare the level 0 title in the doc if we don&#39;t have a &quot;website&quot; attribute. otherwise (ie we&#39;re included in the doc), the title is declared in the includer.<br>

<br>I&#39;m also redefining the levels in user manual with:<br>:titles.underlines: &quot;__&quot;,&quot;==&quot;,&quot;--&quot;,&quot;~~&quot;,&quot;^^&quot;<br><br>The other way is to not define a level 0 title, and force &quot;doctitle=name&quot; in the Makefile.<br>

<br>I&#39;ll finish the test approach #1 to see if it fits all cases...<div><div></div><div class="h5"><br></div></div></blockquote><div class="h5"><br>I&#39;ve commited a first try with r1998<br><br>cheers,<br>Arnaud<br>
-- <br>Linux / Unix Expert R&amp;D - Eaton - <a href="http://www.eaton.com/mgeops" target="_blank">http://www.eaton.com/mgeops</a><br>Network UPS Tools (NUT) Project Leader - <a href="http://www.networkupstools.org/" target="_blank">http://www.networkupstools.org/</a><br>

Debian Developer - <a href="http://www.debian.org" target="_blank">http://www.debian.org</a><br>Free Software Developer - <a href="http://arnaud.quette.free.fr/" target="_blank">http://arnaud.quette.free.fr/</a><br>
</div></div><br>