error: element "meta" not allowed anywhere

[KucharczykL]

This error started happening when using the locally installed toolchain (including in OBS ¹), it doesn't happen when building via container, either directly (registry.opensuse.org/documentation/containers/15.6/opensuse-daps-toolchain:latest - hash 34c54e2fe646) or via GitHub Actions.

The error is caused by the inclusion of <meta> tags in docinfo.xml, for example:

release-notes/adoc/sles/release-notes-sles-160-docinfo.xml

Lines 34 to 40 in 1a3a778

	<meta name="series">Release Notes</meta>
	<meta name="maintainer" content="{maintainer}"/>
	<meta name="productname">
	<productname version="{this-version}">{productname}</productname>
	</meta>
	<meta name="description">Latest information about new and deprecated features, improvements, and known-issues</meta>
	<meta name="social-descr">New and deprecated features, improvements, known-issues</meta>

The differences between environments:

local (up-to-date Tumbleweed)

DAPS VERSION: 3.3.2

             DOC_DIR: /home/lukas/work/git/release-notes
           BUILD_DIR: /home/lukas/work/git/release-notes/build
            DAPSROOT: /usr/share/daps
             DOCCONF: /home/lukas/work/git/release-notes/DC-releasenotes_sles_16.0
                BOOK: releasenotes_sles_16.0


     DOCBOOK_VERSION: 5
        DOCBOOK5_RNG: /usr/share/xml/docbook/schema/rng/5.1/docbookxi.rng
        DBSTYLE_VERS: snapshot

           STYLEROOT: /usr/share/xml/docbook/stylesheet/suse2022-ns
      STYLEROOT_VERS: '2.95.29'
  FALLBACK_STYLEROOT: /usr/share/xml/docbook/stylesheet/nwalsh5/current
   FB_STYLEROOT_VERS: Not available
            EPUB_CSS: 
            HTML_CSS: 

       PDF FORMATTER: fop
   FORMATTER VERSION: FOP Version 2.10
   FORMATTER WRAPPER: /usr/share/daps/libexec/daps-fop
    FORMATTER CONFIG: 

            MAKE_CMD: /usr/bin/make -f /usr/share/daps/make/selector.mk -j4 -s html 
       XSLTPROCESSOR: /usr/bin/xsltproc
   XML_CATALOG_FILES: /etc/xml/catalog

---------------

Container

        DAPS VERSION: 4.0.beta12

                BOOK: releasenotes_sles_16.0
                MAIN: /docs/build/.adoc/releasenotes_sles_16.0.xml
           BUILD_DIR: /docs/build
            DAPSROOT: /usr/share/daps
             DOCCONF: /docs/DC-releasenotes_sles_16.0
             PRJ_DIR: /docs
             SRC_DIR: /docs/build/.adoc
         IMG_SRC_DIR: 


     DOCBOOK_VERSION: 5
        DOCBOOK5_RNG: /usr/share/xml/geekodoc/rng/2_5.2/geekodoc-v2-flat.rng
        DBSTYLE_VERS: snapshot

           STYLEROOT: /usr/share/xml/docbook/stylesheet/suse2022-ns
      STYLEROOT_VERS: '2.95.29'
  FALLBACK_STYLEROOT: /usr/share/xml/docbook/stylesheet/nwalsh5/current
   FB_STYLEROOT_VERS: Not available
            EPUB_CSS: 
            HTML_CSS: 

       PDF FORMATTER: fop
   FORMATTER VERSION: FOP Version 2.8
   FORMATTER WRAPPER: /usr/share/daps/libexec/daps-fop
    FORMATTER CONFIG: /etc/daps/fop/fop-daps.xml

            MAKE_CMD: /usr/bin/make -f /usr/share/daps/make/selector.mk -j16 -s --always-make html 
       XSLTPROCESSOR: /usr/bin/xsltproc
   XML_CATALOG_FILES: /etc/xml/catalog

Footnotes

1. https://build.suse.de/package/live_build_log/SUSE:Maintenance:REQUEST:402383/release-notes-sles-for-sap.SUSE_SLE-15-SP7_Update/SUSE_SLE-15-SP7_Update/x86_64 ↩

[tomschr]

This is the problem:

DOCBOOK5_RNG: /usr/share/xml/docbook/schema/rng/5.1/docbookxi.rng

and this in your local Tumbleweed system:

DAPS VERSION: 3.3.2

The DAPS version on Tumbleweed is too old. This needs to be installed from Documentation:Tools repo (although I have to admit, this should go into TW & Leap).

You are using DocBook 5.1, but you need DocBook 5.2. The <meta> tag was introduced in version 5.2. Installing the latest DocBook package should fix that.

[KucharczykL]

@tomschr This also happens when building the packages in OBS. How to fix it there? Even SP7 is impacted.

[tomschr]

This also happens when building the packages in OBS. How to fix it there? Even SP7 is impacted.

@KucharczykL For SP7, direct packages are certainly not available for DAPS, DocBook & Co. However, I enabled SLE15-SP7 in Documentation:Tools under the name SLE_15_SP7. This will build over the weekend and you can try to include that on Monday.

All successful packages are listed here: https://build.opensuse.org/project/monitor/Documentation:Tools?arch_x86_64=1&defaults=0&repo_SLE_15_SP7=1&succeeded=1
In this list, docbook_5 (Version 5.2) and suse-xsl-stylesheets (the SUSE stylesheets) are already available. However, daps is currently not. 😢

To include the D:T repo into your repo, proceed as follows:

1. Browse to your repo.

2. In the tab bar, click the Meta entry. It will show you an XML config.

3. In the editor below, look for the SLE-15SP7 entry. It's important to add the entry in the right position, otherwise it won't work. 😉

   <repository name="SLE_15_SP7">
       <!-- Add these entries: -->
       <path project="Documentation:Tools" repository="SLE_15_SP7"/>
       <path project="Documentation:Tools" repository="15.6"/>
       <!-- Existing path: -->
       <path project="SUSE:SLE-15-SP7:Update" repository="standard"/>
       <arch>x86_64</arch>
       <arch>aarch64</arch>
     </repository>

   As SLE 15SP7 and openSUSE 15.6 is binary compatible, we can add both. That has the advantage that if something in the first <path/> is not found, OBS will search for the second <path/> until it reaches the end of </repository>. Now you know why order is important here. 😉

4. Optionally add a commit message.

5. Click Save.

I think that should work (we use the same approach in D:T repo too).

[KucharczykL]

@tomschr Unfortunately I get an error that the repository doesn't exist:

[tomschr]

@KucharczykL

Unfortunately I get an error that the repository doesn't exist:

The repo exists: https://build.opensuse.org/project/repository_state/Documentation:Tools/SLE_15_SP7. 🙂

But I think it was related to the architecture. I only enabled x86-64, but not the other architectures. I did that now, maybe it will solve that. 🤷‍♂️

However, even if this error goes away, we will run into other problems. The repo for the specific architectures need to be built first. This takes time. And this is were things can horribly fail. I would expect that not all dependencies are available for all archs, they have compilation errors etc.

Fixing all of this would be a huge effort.

The docbook_5 and daps are basically noarch. Not exactly sure why you need all these architectures. You could ask in the Slack channel #discuss-packaging.