From owner-freebsd-doc@FreeBSD.ORG Sat Feb 21 19:48:13 2015 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 6482FBA1 for ; Sat, 21 Feb 2015 19:48:13 +0000 (UTC) Received: from mailout12.t-online.de (mailout12.t-online.de [194.25.134.22]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mailout00.t-online.de", Issuer "TeleSec ServerPass DE-1" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id E9FB3E1A for ; Sat, 21 Feb 2015 19:48:12 +0000 (UTC) Received: from fwd08.aul.t-online.de (fwd08.aul.t-online.de [172.20.26.151]) by mailout12.t-online.de (Postfix) with SMTP id D8D924A8482 for ; Sat, 21 Feb 2015 20:48:03 +0100 (CET) Received: from esprimo.local (Gt+e0vZHYhRGNnbDgOf6oWLwrU-t-FoNU9HzfeCf9dw5wLbSE0vC6tuaXRPi-HQQ0n@[217.81.159.113]) by fwd08.t-online.de with (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384 encrypted) esmtp id 1YPG1z-10iWbA0; Sat, 21 Feb 2015 20:48:03 +0100 Received: from esprimo.local (localhost [127.0.0.1]) by esprimo.local (Postfix) with ESMTP id 7A48F45CE81 for ; Sat, 21 Feb 2015 20:48:02 +0100 (CET) Received: (from chris@localhost) by esprimo.local (8.14.9/8.14.9/Submit) id t1LJm26K003089 for freebsd-doc@FreeBSD.org; Sat, 21 Feb 2015 20:48:02 +0100 (CET) (envelope-from chris) Date: Sat, 21 Feb 2015 20:48:02 +0100 From: Christoph Brinkhaus To: freebsd-doc@FreeBSD.org Subject: Re: igor and xmllint Message-ID: <20150221194802.GA923@esprimo.local> References: <20150221165145.GA2107@esprimo.local> <54E8C018.1080202@freebsd.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <54E8C018.1080202@freebsd.org> User-Agent: Mutt/1.5.23 (2014-03-12) X-ID: Gt+e0vZHYhRGNnbDgOf6oWLwrU-t-FoNU9HzfeCf9dw5wLbSE0vC6tuaXRPi-HQQ0n X-TOI-MSGID: 0b18b8cd-b630-435e-95ca-cd6f50f14318 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 21 Feb 2015 19:48:13 -0000 On Sat, Feb 21, 2015 at 12:27:52PM -0500, Allan Jude wrote: > On 2015-02-21 11:51, Christoph Brinkhaus wrote: > > Hello, > > > > I have read the fdp-primer but I am not sure about > > the verification of xml files. > > > > In the quick start section igor is mentioned which > > works well. Unfortunaltely I have overlooked it first > > because it is just mentioned once. > > > > In the other sections the files are checked by xmllint. > > On by system I have problems with xmllint. Even the self > > generated file a.txt can not be checked as below: > > > > xmllint --valid --noout /home/chris/Projekte/a.txt > > > > The response is > > > > /home/chris/Projekte/a.txt:2: validity error : Validation failed: no DTD found ! > > abc > > ^ > > > > > > Does igor included the functions of xmllint or not? > > Is it necessary to verify a document ifirst by xmllint > > and then by igor? Or is the test using igor enough? > > > > I am using FreeBSD for about one year. Therefore I am not > > able to generate big documents which are valuable in terms > > of the content. > > > > I can help in changing docuemnts and by translating to German. > > > > Kind regards, > > > > Christoph > > _______________________________________________ > > freebsd-doc@freebsd.org mailing list > > http://lists.freebsd.org/mailman/listinfo/freebsd-doc > > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" > > > > igor is a perl script written by a FreeBSD Docs developer to catch > common mistakes. It looks to make you followed the conventions like two > spaces after a period, the correct indent level, catches common typos > and incorrect forms of works from the wordlist. > > It is not the same as xmllint, which checks the validity of the xml. > > XML documents require a DTD, which defines which elements are valid for > use in the document. > > A typical article will look something like this: > > > Extension//EN" > "http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd"> >
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" > xml:lang="en"> > > which allows all of the docbook elements to be used. > > -- > Allan Jude > Dear Allan, thank you for the quick answer. I have a problem verifying existing xml files as /usr/doc/en_US.ISO8859-1/books/handbook # xmllint --valid --noout book.xml book.xml:14: warning: failed to load external entity "http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd" ]> ^ book.xml:18: element book: validity error : No declaration for attribute xmlns of element book xml:lang="en"> ^ book.xml:18: element book: validity error : No declaration for attribute xmlns:xlink of element book xml:lang="en"> ^ and so on. From my understanding the catalog files in /usr/doc/share/xml/ should handle that. I will dig the correct command line parameter. Kind regards, Christoph