From bd7e8dde6b2f08bdfdcc3a4521b96b45c1abca6a Mon Sep 17 00:00:00 2001 From: Lief Erickson Date: Fri, 8 Mar 2024 13:40:32 -0600 Subject: [PATCH] Add DITA-OT Day 2024 videos (#550) Signed-off-by: Lief Erickson --- resources/dita-ot-day-video-keys.ditamap | 1 + .../dita-ot-day-2024-keys.ditamap | 308 ++++++++++++++++++ resources/source-files.ditamap | 1 + topics/dita-ot-day-2024.ditamap | 33 ++ topics/dita-ot-day-videos-intro-2024.dita | 17 + topics/dita-ot-day-videos.ditamap | 1 + 6 files changed, 361 insertions(+) create mode 100644 resources/ditaotdaykeys/dita-ot-day-2024-keys.ditamap create mode 100644 topics/dita-ot-day-2024.ditamap create mode 100644 topics/dita-ot-day-videos-intro-2024.dita diff --git a/resources/dita-ot-day-video-keys.ditamap b/resources/dita-ot-day-video-keys.ditamap index bf1bcbd75..421868d97 100644 --- a/resources/dita-ot-day-video-keys.ditamap +++ b/resources/dita-ot-day-video-keys.ditamap @@ -10,4 +10,5 @@ + diff --git a/resources/ditaotdaykeys/dita-ot-day-2024-keys.ditamap b/resources/ditaotdaykeys/dita-ot-day-2024-keys.ditamap new file mode 100644 index 000000000..1b4377084 --- /dev/null +++ b/resources/ditaotdaykeys/dita-ot-day-2024-keys.ditamap @@ -0,0 +1,308 @@ + + + + + DITA-OT Day 2024 + + + Search, Style and More - Extending DITA Bootstrap + Syntax diagrams belong to the kind of special-purpose documentation that +nobody really wants to deal with, the presenter included. This is a brief overview of +real-world challenges in general and how to represent syntax diagrams in DITA in particular. + + Frank Wegmann + + + + + Lessons Learned: Migrating DITA-OT For an IT Hardware Product +Documentation + Oxygen Content Fusion version 6 started using DITA Open Toolkit project +files to define publications and deliverables and then to publish based on the defined +deliverables using a publishing service. In this small talk I will present the usefulness of +the DITA OT project file when it comes to defining deliverables, publication parameters and +publishing in the Oxygen Content Fusion commercial application. + Radu Coravu + + + + + Syntax Diagrams: If you can't avoid them... + Announcing a freely available software which allows highly efficient cross +referencing in PDF output generated by the DITA-OT. Together with the DITA-OT the presented +(small) software package explores a new dimension for the readability of PDF documentation. + + Helmut Scherzer + + + + + Using DITA Open Toolkit Project to Implement a Publishing Service +in a Commercial Application + "I will demonstrate a plugin, which adds functions to the DITA-OT that are +very useful in particular for industry and reseach. Out of many helpful extensions there are +mechanisms like ""Auto-Bibliography Generation"", ""Auto-Image Sizing"", Page Control (e.g. +""Landscape page in a flow of upright pages"") and many more. All extensions are convertible +into DOCX, HTML and CHM. A full documentation is available for all implemented extensions." + + Helmut Scherzer + + + + + Extended PDF Output - The ezRead Plugin + An update on the features of the PDF5-ML Plugin, including details of the +new automated ability to show Oxygen change tracking and comments in PDF output. + Tony Graham + + + + + DITA-OT "How far can you go" + DeltaXML software were until now focused on comparing two XML documents of +same structure and similar data to identify the changes between them by considering the +structure. However, we recently started to look at the use case where there is a need to +compare XML documents with different structure but similar data. We came across some of +partners and customers who convert their documents from one form of XML to another which needs +a manual process to check if there were any errors or inconsistencies during the document +conversion. DeltaXML's new product, ConversionQA, understands different document formats such +DITA, Microsoft Word, etc and performs a comparison between original and converted document +provide a quality assurance report. ConversionQA makes use of the DITA-OT transformation to +process DITA Maps into a single DITA file for conversion checking process with another single +file format. We have used DITA-OT Java Application Programming Interface in product to process +DITA Maps as a part of overall workflow. The lightning the talk will focus on how we have +integrated DITA-OT in conversion. We will also discuss the issues we faced during DITA OT +integration and how they were resolved. + Tejas Pradip Barhate + + + + + PDF5-ML Plugin Update + In order to support a new DITA <topicmeta> specialization, we added +support for it in Markdown content by leveraging the new schema-provider mechanism to +customize Markdown parsing and transparent DITA conversion. + John Kirkilis + + + + + DITA-OT and ensuring DITA Map conversion + iiRDS, the tekom standard for the standardized exchange and delivery of +technical documentation, has been on the market for a few years. We have demonstrated in the +past why an XML standard like DITA is a good fit. Coming in 2024, tekom is publising an OT +plugin that allows to generate iiRDS packages from standard DITA, based on the metadata that +you already have. After a brief introduction to iiRDS, you will learn how you can make use of +the plugin in your DITA environment. + Marion Knebel + + + + + DITA and Markdown Interoperability using new schema-provider +extension mechanism + We understand the importance of having a clear and concise summary at the +beginning of each work instruction. That's why we've developed a plug-in that automates the +creation of these summaries based on the information in the individual steps of the work +instruction. With our DITA-OT plug-in, content creators can now easily add the tools, +supplies, and spare parts in the individual steps of the work instruction, knowing that the +summary will always reflect the most up-to-date information. No more worrying about +inconsistencies or discrepancies between the summary and the steps! This plug-in not only +saves time for the writer but also ensures that mechanics in the workshops have access to +accurate and reliable information. + Pieterjan Vandenweghe + + + + + Publishing with iiRDS from DITA + For our clients, we support DITA OTs from 1.5.2 to 4.x. More advanced users +can maintain and update their own OTs while others are maintained by Ixiasoft. We will discuss +some of the challenges in in supporting DITA OTs in an enterprise environment. + Eric Sirois + + + + + DITA-OT plug-in for work instructions: Say goodbye to manual +summaries and hello to accuracy and efficiency! + ServiceNow uses cross-deliverable key references to author and publish +links between publications, primarily published through Zoomin (https://docs.servicenow.com). +We implemented this by generating "delivery keydef maps" from our root maps from the peer map +references in each root map. We then use a simple OT extension and XSLT transform to swap the +peer maprefs for references to the delivery keydef maps at build time. The delivery keydef +maps are managed in a dedicated git repository. + Eliot Kimber + + + + + Deploying and Maintaining DITA OTs in an Enterprise +environment + A light-hearted view on learning DITA and DITA Open Toolkit from scratch +while trying to prove to your new employer that yes, structured documentation is the best +solution and it will bring cost savings. + Justyna Hietala + + + + + Cheap and Easy Cross-Deliverable Link Implementation + Embark with me on this exciting journey of big successes and many challenges +in setting up a working environment to write and publish user documentation with DITA and +DITA-OT. + Guillaume Delory + + + + + From zero to DITA-OT hero – a story of a DITA-OT implementation in +a small documentation team + So you just got a new job as a technical writer in a modern, high-tech +company. They want to move away from MS Word documentation to a structured documentation but +have no idea how to do it and guess what – you are the person who will do it from beginning to +the end! The problem is you don’t even know how to start... You have been doing documentation +in Adobe InDesign and MS Word so far. You only heard about this DITA thing and heard it’s +quite cool but haven’t done any work with it. In addition, your teammate is about to retire +and you are soon to learn that the Internet is NOT full of easy-access information about +DITA-OT. + Roger Sheen - Documentation Lead + + + + + IBM Workflow Manager: an automated build environment + In this presentation, I will talk about what IBM has been doing the last 5 +years with DITA, and how we integrated the DITA-OT as the center piece of our automated build +system for technical documentation, called IBM Workflow Manager (WFM). WFM is a cloud based +solution meant to automatically build DITA files stored in GitHub (possibility from multiple +repositories), test Accessibility, and publish the outputs to their final location (either IBM +Documentation website at ibm.com/docs or other channel like Box or sFTP servers). It also +connects to communication channels like Slack to give real-time feedback on any failure that +might happen. Along with edit links based on Oxygen Web Author, it creates a 0 click user +experience where users can edit their documentation from their browser, and see the output +live a few minutes later. + Robert D. Anderson - DITA-OT Project Lead + + + + + Documentation Developments + This talk provides an overview of recent changes to the DITA-OT +documentation and project website, points out open issues, highlights ideas for future +improvements, and closes with room for suggestions from the community and a call for +contributions. + Jarno Elovirta - DITA-OT Main Developer + + + + + Moving an HTML plugin to preprocess2: how scared should you +be? + Our custom HTML plugin includes several extension points that hook into the +old "preprocess" steps -- meaning that when the base code moves to "preprocess2", those +extensions are lost. In this session, I will talk about what was required to adopt the updated +model, what worked and didn't, how we re-integrated the old extensions, and how we went about +testing the changes. + DITA-OT Day Team + + + + + Retrospective - DITA-OT improvements between 3.7 and 4.1 + Taking a look at what features, improvements and bug fixes were added +between DITA OT 3.7 and 4.1. + DITA-OT Day Sponsors + + + diff --git a/resources/source-files.ditamap b/resources/source-files.ditamap index 4b1a61837..cf31aaa1d 100644 --- a/resources/source-files.ditamap +++ b/resources/source-files.ditamap @@ -36,6 +36,7 @@ + diff --git a/topics/dita-ot-day-2024.ditamap b/topics/dita-ot-day-2024.ditamap new file mode 100644 index 000000000..4df73b612 --- /dev/null +++ b/topics/dita-ot-day-2024.ditamap @@ -0,0 +1,33 @@ + + + + + DITA-OT Day 2024 + + + 2024 Helsinki + Helsinki 2024 + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/topics/dita-ot-day-videos-intro-2024.dita b/topics/dita-ot-day-videos-intro-2024.dita new file mode 100644 index 000000000..c56fa86a5 --- /dev/null +++ b/topics/dita-ot-day-videos-intro-2024.dita @@ -0,0 +1,17 @@ + + + + + DITA-OT Day Conference – Helsinki 2024 + February 11, 2024 in Helsinki, Finland. DITA-OT Day was not held in 2023. + + + + DITA-OT Day 2024 videos + + + + +

+ + diff --git a/topics/dita-ot-day-videos.ditamap b/topics/dita-ot-day-videos.ditamap index 798114721..0d9ee3d07 100644 --- a/topics/dita-ot-day-videos.ditamap +++ b/topics/dita-ot-day-videos.ditamap @@ -5,6 +5,7 @@ DITA-OT Day Videos +