OASIS Universal Business Language (UBL) TC

 View Only
Back to discussions
Expand all | Collapse all

[REPOST with important modifications] OASIS document templates for 2025 approved layouts

  • 1.  [REPOST with important modifications] OASIS document templates for 2025 approved layouts

    Posted 01-12-2026 09:57
    Please forgive me, folks, but the message that I sent out 30 minutes is a week-old draft of an unsent message that has been superceded. It never was meant to be sent.

    In fact, I have completed a testable version of the publishing environment.

    What follows is the message that I intended to send today.

    Again, my apologies.

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

    These are the approved OASIS 2025 specification, note, and report templates:

    https://drive.google.com/drive/u/0/folders/13rn2fN-6HQJt0uO3xNVM-VL4Sh8qhSoM

    I'm not very happy with them, so I have retained some of the 2020 layout features that are absent in the 2025 layouts, such as PDF footers.

    But I have changed the front cover as directed by the new templates, including the unfortunate reduction in the point size of the header. Ah, well.

    Anyway, the UBL GitHub ubl-2.5-2025-layout branch is not yet ready to merge into ubl-2.5, but you can see the results so far here:

    https://github.com/oasis-tcs/ubl/actions/runs/20881508830

    Please review the layout properties as they have been applied to our document. Perhaps we can talk about them at Wednesday's meeting.

    Of note:

    - the stylesheets rearrange the cover front matter to the new 2025 ordering without changing any of XML
    - the XML has been changed to merge the "Status" section into the "Notices" section, as implied by the templates
    - the 2025 templates have rearranged the document front matter in a way that I think is incompatible with our need to translate the content to ISO format for submission, so I've left that unchanged for now
    - I have submitted a query to OASIS to ask questions of whomever is in charge of the templates and have not received a response
    - I am not planning to rewrite the OASIS template guidelines in DocBook, but point DocBook template users to the common directory for reference to the detailed instructions that are not layout-related ... I am reshaping the DocBook templates to be focused solely on invocation and markup, not anything on content, so that we don't have to keep updating that when content directives are changed

    The game plan going forward, as I see it, is:

    - I will get our GitHub-server-based publishing up and running with the new 2025 stylesheets based on feedback from the committee and some required server updates I am working on behind the scenes
    - Kees will merge ubl-2.5-2025-layout into ubl-2.5 when he is happy with the results and will be a continuing user of the server
    - I will hand the publishing suite as a new "spec-0.9" package to Erlend, replacing the old "spec-0.8" package we worked with earlier
    - Erlend will reshape "spec-0.9" into the new DocBook Templates GitHub repositories and publish those after testing with my help
    - I will retrofit Erlend's new DocBook Templates GitHub repositories into the GitHub-server-based publishing environment in order to get rid of the "spec-0.9" suite online
    - future server support of the GitHub-server-based publishing will include the DocBook Templates GitHub repository as a submodule behind the scenes so that when the OASIS repository is updated the server repository can readily be updated

    Feedback is most welcome! Thank you!

    . . . . . . Ken

    --
    Contact info, blog, articles, etc. http://www.CraneSoftwrights.com/o/ |
    Check our site for free XML, XSLT, XSL-FO and UBL developer resources |
    Streaming hands-on XSLT/XPath 2 training class @US$50 (5 hours free!) |
    Essays (UBL, XML, etc.) http://www.linkedin.com/today/author/gkholman |


  • 2.  RE: [REPOST with important modifications] OASIS document templates for 2025 approved layouts

    Posted 01-28-2026 06:56
      |   view attached

    All,

    first .. Thx Ken for doing the work on updating the layout. I also do not like the way the new layout looks (especially on the front page) but there is nothing really "broken" by the new layout.

    I have taken the published version for UBL 2.5 csd02 .. and took the last version from Ken his test branch and I have compared them with each other. The total number of pages remains the same, there are slight changes to the chapters  .. but nothing major. The biggest "difference" is in Appendix C but that can be explained by the changes to the model we have done after the cds02 review.

    If you want to see a side by side comparison of the two layouts you can use the linked/(attached?) PDF with the full comparison for each page next to each other.

    I do not see any reason not to merge this work into our main 2.5 branch so we are compliant again with the layout. 

    Lets discuss this afternoon if the rest of the TC also agrees.

    Kees D.



    ------------------------------
    Kees Duvekot
    Kees Duvekot / SiPiCo
    ------------------------------

    Attachment(s)

    pdf
    UBL-2.5-full-comparison.pdf   47.52 MB 1 version
    Original Message


Related Content