docs/manual, Meson config: Check if xmllint can be used

kjellahl · kjellahl · commit b49f738e8c97 · 2021-09-27T10:45:32.000+02:00
diff --git a/Makefile.am b/Makefile.am
@@ -30,6 +30,7 @@ EXTRA_DIST = \
   meson_options.txt \
   libxml++config.h.meson \
   MSVC_NMake/libxml++/meson.build \
+  docs/manual/can_use_xmllint.xml \
   docs/manual/insert_example_code.py \
   docs/manual/meson.build \
   docs/reference/meson.build \
diff --git a/docs/manual/can_use_xmllint.xml b/docs/manual/can_use_xmllint.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<book xmlns="http://docbook.org/ns/docbook"
+      version="5.0" xml:id="index" xml:lang="en">
+
+<title>xmllint test</title>
+
+<chapter xml:id="chapter-introduction">
+<title>Introduction</title>
+  <para>
+  This is a short DocBook V5.0 document. It can be used for testing if the installed
+  version of xmllint or a similar program can validate a DocBook V5.0 document.
+  </para>
+</chapter>
+
+</book>
diff --git a/docs/manual/meson.build b/docs/manual/meson.build
@@ -25,6 +25,24 @@ if not build_documentation
   subdir_done()
 endif
 
+# Check if xmllint can be used.
+if xmllint.found()
+  can_parse_and_validate = run_command(
+    python3, tutorial_custom_cmd_py, 'xmllint',
+    validate,
+    meson.current_source_dir() / 'can_use_xmllint.xml',
+    meson.current_build_dir() / 'can_use_xmllint.stamp',
+  ).returncode() == 0
+  if not can_parse_and_validate
+    # The DocBook V5.0 package is called docbook5-xml in Ubuntu,
+    # docbook5-schemas in Fedora. It may have other names in other distros.
+    warning('Can\'t validate XML file.\n' +
+      'xmllint does not support Relax NG schemas and DocBook V5.0.\n' +
+      'DocBook V5.0 support may require docbook5-xml, docbook5-schemas or a similar package.'
+    )
+  endif
+endif
+
 doc_dist_dir = 'untracked' / 'docs' / 'manual' # Relative to MESON_DIST_ROOT
 
 # Create a DocBook XML file with the examples' source code included.
diff --git a/meson.build b/meson.build
@@ -365,7 +365,7 @@ endif
 validate = get_option('validation') and can_parse_and_validate
 explain_val = ''
 if get_option('validation') and not validate
-  explain_val = ' (requires xmllint)'
+  explain_val = ' (requires xmllint with Relax NG and DocBook V5.0 support)'
 endif
 
 build_pdf = build_pdf_by_default and can_build_pdf
diff --git a/tools/build_scripts/tutorial-custom-cmd.py b/tools/build_scripts/tutorial-custom-cmd.py
@@ -75,6 +75,13 @@ def xmllint():
   stamp_file_path = sys.argv[4]
 
   relax_ng_schema = 'http://docbook.org/xml/5.0/rng/docbook.rng'
+  # schematron_schema = 'http://docbook.org/xml/5.0/sch/docbook.sch'
+
+  # Validation against the Schematron schema does not work on Ubuntu 21.04:
+  # file:///usr/share/xml/docbook/schema/schematron/5.0/docbook.sch:6: element rule:
+  #   Schemas parser error : Failed to compile context expression db:firstterm[@linkend]
+  # .....
+  # Schematron schema http://docbook.org/xml/5.0/sch/docbook.sch failed to compile
 
   cmd = [
     'xmllint',
@@ -83,7 +90,10 @@ def xmllint():
     '--xinclude',
   ]
   if validate == 'true':
-    cmd += ['--relaxng', relax_ng_schema]
+    cmd += [
+      '--relaxng', relax_ng_schema,
+      #'--schematron', schematron_schema,
+    ]
   cmd += [input_xml_file]
   result = subprocess.run(cmd)
   if result.returncode:
