Open Stack

On Fri, Jul 25, 2014 at 1:00 PM, Laurel Michaels <lmichaels at tesora.com>
wrote:

>  Anne, I opened the section_cinder-controller file (without using the
> validation button) and I seem to get the same error as you do -- see
> attached screenshot, laurels_error_msg.png.
>
> It looks like Oxygen wants to use a the docbookxi.rng file located in this
> dir on my system:
>
> C:\Program Files (x86)\Oxygen XML Author 16\frameworks\docbook\5.0\rng
>
> So maybe replace the contents of that docbookxi.rng with the contents of
> the rackbook.rng file, so Oxygen uses whatever we have in rackbook.rng?
>
>
Yes. That file copy must have happened so early on my system that I forgot
about that step. Is there a place on the wiki to help others with this?

Know that the error you see is "known" and that Oxygen only checks the
xml:ids in the file itself, not in the built deliverable, so it's fine to
have these errors.




>   ------------------------------
> *From:* annegentle at justwriteclick.com <annegentle at justwriteclick.com> on
> behalf of Anne Gentle <anne at openstack.org>
> *Sent:* Friday, July 25, 2014 8:52 AM
> *To:* Andreas Jaeger
> *Cc:* Laurel Michaels; openstack-docs at lists.openstack.org
> *Subject:* Re: [Openstack-docs] How to tell Oxygen to use rackbook.rng?
>
>
>
>
> On Fri, Jul 25, 2014 at 1:37 AM, Andreas Jaeger <aj at suse.com> wrote:
>
>> On 07/24/2014 11:43 PM, Anne Gentle wrote:
>> > Hi all,
>> > I've been trying to help Laurel with the problem for a while now. The
>> > root need here is that we can all use a common .ent file for entity
>> > references like — -- which is a great goal -- without having to
>> > add any references in headers (since we've standardized nicely on
>> > headers that don't refer to an RNG file).
>> >
>> > In my environment, I've never had to reference the RNG file at all. When
>> > I use Oxygen on my Mac to refer to the rackbook.rng that's maintained in
>> > the doc tools repo, validation errors occur.
>> >
>> > One of my working theories is that the latest change to rackbook.rng for
>> > the tooling actually broke authoring for
>> > some. https://review.openstack.org/#/c/104085/
>>
>>
>>  This patch to openstack-doc-tools is the same as we always had setup
>> rackbook.rng inside openstack-doc-tools - my previous import just forgot
>> to make this local change. This change is essential for working of the
>> toolchain. This was essential our last ".1" urgent release where
>> everything was broken without it.
>>
>> to check your theory:
>> The rackbook.rng comes from clouddocs-maven-plugin, could you point it
>> locally there? Does that help?
>>
>
>  On my machine, if I do what Laurel's doing, by validating with a button
> in the toolbar, I see errors.
>
>  If I just open a file, and look at any validation errors, I see that
> it's point to a local rackbook.rng file. See attached.
>
>  So I think she shouldn't validate the way she is, and there's something
> we have to set up with Oxygen to use the rackbook.rng file locally. I'll
> keep digging into Oxygen's help files for more.
>
>  Laurel, see the attached screenshot and try to get a shot of your system
> so we can compare. I got it by clicking on the "known" validation 'error'
> for an xml:id that doesn't exist in the file itself but is in the larger
> book. Try opening
>   doc/install-guide/section_cinder-controller.xml
> <http://Users/annegentle/src/openstack-manuals/doc/install-guide/section_cinder-controller.xml>
>  and let us know what you see.
>
>
>>
>> Andreas
>> --
>>  Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
>>   SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
>>    GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)
>>     GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126
>>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20140725/19f9408a/attachment.html>