search

fishworks / deis-accounts

Multiple account management for Deis
10 stars 1 forks source link

XML validation error when building #2

Open mboersma opened 9 years ago

mboersma commented 9 years ago

After doing brew install asciidoc xmlto, I couldn't get make to complete:

$ make 
go build -o bin/deis-accounts github.com/fishworks/deis-accounts
/Applications/Xcode.app/Contents/Developer/usr/bin/make -C docs
asciidoc  -f asciidoc.conf -b docbook -d manpage -o deis-accounts-add.xml deis-accounts-add.txt
xmlto  man deis-accounts-add.xml
xmlto: /Users/matt/Projects/src/github.com/fishworks/deis-accounts/docs/deis-accounts-add.xml does not validate (status 3)
xmlto: Fix document syntax or use --skip-validation option
I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
/Users/matt/Projects/src/github.com/fishworks/deis-accounts/docs/deis-accounts-add.xml:2: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
D DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
                                                                               ^
I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
validity error : Could not load the external subset "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
Document /Users/matt/Projects/src/github.com/fishworks/deis-accounts/docs/deis-accounts-add.xml does not validate
make[1]: *** [deis-accounts-add.1] Error 13
rm deis-accounts-add.xml
make: *** [docs] Error 2
mboersma commented 9 years ago

make worked fine on Ubuntu 14.04. On Mac OS X, xmlto --version returns xmlto version 0.0.26, but on Linux xmlto version 0.0.25. Not sure what else is different.

bacongobbler commented 9 years ago

odd. I'm on 0.0.25 on OSX and it works fine. Maybe the latest version is broken perhaps?

bacongobbler commented 9 years ago

Either that or OSX is missing some core DTD rules which is present in Ubuntu

mboersma commented 9 years ago

I think this is the issue:

$ brew install docbook
Warning: docbook-5.0 already installed
$ brew install docbook-xml45
Error: No available formula for docbook-xml45 
Searching formulae...
Searching taps...

Homebrew is kind of a mess in this area, I'm struggling to find a way to get the older docbook package. But I tried xmlto 0.0.25 and that's not relevant, so this must be the problem.

pvdb commented 4 years ago

FWIW: I had a similar issue in a totally unrelated project, but running brew info docbook suggests:

==> Caveats
To use the DocBook package in your XML toolchain,
you need to add the following to your ~/.bashrc:

export XML_CATALOG_FILES="/usr/local/etc/xml/catalog"

... which is what solved the issue for me; YMMV, but worth a try! :smile: