Skip to content

GeekoDoc v2.0.0
Compare
Choose a tag to compare
@tomschr tomschr released this 27 Aug 10:22
· 51 commits to main since this release
v2.0.0
28ce05c

Contains a first distinction between GeekoDoc v1 and GeekoDoc v2.

Structures

  • Move files to the new directory
  • Rename geekodoc5 -> geekodoc-v1
  • Adapt .gitignore
  • Update ChangeLog
  • Create build.sh script for Geekodoc
    Features:
    • Use build directory
    • Use DocBook schemas from externals dir now and not from system
      This may help with CI and Ubuntu builds where they don't have
      the latest DocBook schemas
    • Store result in dist directory
    • Supports -h/--help
    • Colorful logging with -v/-vv/-vvv
    • Converts geekodoc-v?.rnc -> geekodoc-v?-flat.rnc
      (needs several steps for that)
    • Check for scripts instead of packages to avoid OS dependent code with rpm
    • Source /etc/os-release to get some OS-specific variables
    • Remove Makefile
  • Switch from Travis to GitHub action
  • Cleanup and rework catalog entries
    • Remove obsolete non-flat URIs (we only use the flat versions)
    • Sort it: first old, then new URIs
  • Remove flat RNC schemas

GeekoDoc

  • Base GeekoDoc V2 on dbitsxi.rnc (DocBook 5.2b10a5)

    • Identify GeekoDoc as "5.2-subset GeekoDoc-2"
    • Disable db.keycombo.action.attrib to be empty
    • Work on db.keycombo.action.attrib
    • Make it behave the same as previous version 1.0.2.1
    • Amend db.common.base.attributes with:
      • Add db.common.transclusion.attributes
      • Replace its-attribute.translate with expression (its-local.attributes & its-attribute.version?)

  • Apply ID check (#73) to GeekoDoc v2, but not v1 to stay compatible

  • Sync comments between GeekoDoc v1/v2

  • Adapt GeekoDoc XML catalog
    As we support two versions now (1 and 2), we need to distinguish them.

    Old URIs, but still accessible. General syntax:

    urn:x-suse:rng:FILE

    • urn:x-suse:rng:geekodoc5-flat.rnc
    • urn:x-suse:rng:geekodoc5-flat.rng

    New URIs, with distinguish between GeekoDoc version. General syntax:

     urn:x-suse:FORMAT:VERSION:SCHEMA

    FORMAT: can be "rnc" or "rng"
    VERSION: can be "v1" or "v2"
    SCHEMA: "geekodoc-flat"

    • urn:x-suse:rnc:v1:geekodoc-flat
    • urn:x-suse:rng:v1:geekodoc-flat
Assets 2
Loading