On 09/12/2014 06:27 AM, Roger Baran, Owner wrote: > Here is what I put together from our chat yesterday. Could you > please review and tell me if I missed anything or if there is > something you would like to add to it. > > I will be using this as a ready-ref as I get myself > bootstrapped. > > Thank you in advance > > > I'll add one more thing that we didn't get to: xmllint. It will check your document's XML structure, and validate it against the Docbook specification. Sometimes a `publican build` will fail, and publican will complain, but only about the first error it discovers. Like any diagnostic output, it usually will help you find the problem, not point directly to it. There are a lot of options, but most commonly you'd want to suppress all but the complaints, and check that your docbook is valid, like this: xmllint --noout --valid path/to/file.xml -- -- Pete Travis - Fedora Docs Project Leader - 'randomuser' on freenode - immanetize(a)fedoraproject.org

-----BEGIN PGP SIGNATURE----- Version: GnuPG v2 iQEcBAEBAgAGBQJUFE+hAAoJEFGmycyxj9l+pkQH/2Tza4ssY8BwGZLVQOlWW1sc yC90vcLmwSA17Bwc2Yi9z+wNzr13NIOi5O0cfeG1VTVnw717JWVLH5xo2d5O72Q5 RN0tSOcXmF2a9VByqLUPAStsAxe4dij+yGAESGykcr0m80LOZ7UCICuXl/yjeFHc jvWnNNhB0EcHrpGswRHZL8RN8ftsMDBhbtghYrZ0E7mVVm3M3J6GH5TBBt1QsEFe CD3uZGfoL4+mKTr8j0ls6+p3cqlPZRPXCZVyuFWWPdIWbwzWhrA6XGT8UH1jch3V YGKMwbdw6w8faCBUQW/52FEh7gOkTsRoYT0iMYp+NjqKJqqrm1UBDXyD0wPMmrk= =+9ta -----END PGP SIGNATURE-----