On Thu, Nov 21, 2013 at 7:28 PM, Clifford Yapp <[email protected]> wrote:
> On Thu, Nov 21, 2013 at 6:39 PM, Tom Browder <[email protected]> wrote:
>
>> I first tried the usual xi:include but that doesn't validate with
>> refsection and I haven't seen any help on a web search.
>
> To be sure I understand - you're doing a DocBook version of the HTML
> page for the website,
Almost--the first step is just to have the same tables defining the
attributes so I want the tables generated for both html (for the web
site) and the man page (xml).
> you want to xinclude the tables from that page
> to the man page, and it's not working? Is the validation failing
> because of the refsection or because generated tables don't exist yet?
Apparently because of the DocBook schema for the refsection.
>> I'm going to ask about the problem on the the DocBook lists,
I've done that--no response yet.
>> but in he meantime I'm
>> assuming there's not much hope (man page DocBook xml is sparsely
>> documented, and I have Bob Stayon's book which is pretty much the word
>> for such things).
>
> You're probably right, but could you paste the error you're seeing and
> the set of files you're trying to make work?
Okay, but first here are two snippets (both children of a
<refsection>) I've tried with no success:
1.
<para>
<xi:include
</para
Error:
[ 66%] Validating DocBook source with xmllint:
./attributes-standard-table.xml:1: element table: Schemas validity
error : Element 'table': This element is not expected. Expected is one
of ( {http://docbook.org/ns/docbook}info,
{http://docbook.org/ns/docbook}inlinemediaobject,
{http://docbook.org/ns/docbook}remark,
{http://docbook.org/ns/docbook}superscript,
{http://docbook.org/ns/docbook}subscript,
{http://docbook.org/ns/docbook}xref,
{http://docbook.org/ns/docbook}link,
{http://docbook.org/ns/docbook}olink,
{http://docbook.org/ns/docbook}anchor,
{http://docbook.org/ns/docbook}biblioref ).
/usr/local/src2/brlcad-svn-trunk/doc/docbook/system/man5/en/attributes.xml
fails to validate
CMake Error at attributes_validate.cmake:39 (message):
xmllint failure: 3
2.
<para>
...
</para
<xi:include
Error:
[ 66%] Validating DocBook source with xmllint:
./attributes-standard-table.xml:1: element table: Schemas validity
error : Element 'table': This element is not expected. Expected is (
{http://docbook.org/ns/docbook}refsection ).
/usr/local/src2/brlcad-svn-trunk/doc/docbook/system/man5/en/attributes.xml
fails to validate
CMake Error at attributes_validate.cmake:39 (message):
xmllint failure: 3
>> So, what is the best way to cobble the attributes file together via
>> CMake? I can see the simplest as separating the current
>> attributes.xml file into manual and auto-generated pieces:
...
>> and let Cliff's magic CMake concatenate the files into attributes.xml
>> before doing DocBook transformation.
>
> Heh - that sounds like a brand for some weird cooking ingredient.
And I've found the recipe in the CMake book..
> To be sure I understand the sequence Tom, are the tables you want to
> include in both the web HTML and the man page autogenerated as part of
> the build, or do they exist as static files? If it's the latter,
> there is a simple approach - if it's the former things get trickier.
> (Not impossible, just a little more work to get right.)
It's the former, and I think I see the path forward and I'm working on it now.
Best regards,
-Tom
------------------------------------------------------------------------------
Shape the Mobile Experience: Free Subscription
Software experts and developers: Be at the forefront of tech innovation.
Intel(R) Software Adrenaline delivers strategic insight and game-changing
conversations that shape the rapidly evolving mobile landscape. Sign up now.
http://pubads.g.doubleclick.net/gampad/clk?id=63431311&iu=/4140/ostg.clktrk
_______________________________________________
BRL-CAD Developer mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/brlcad-devel
