Skip to main content

Xml

Content operations Podcast Podcast transcript Tools XML

Balancing CMS and CCMS implementation (podcast, part 1)

In episode 142 of The Content Strategy Experts Podcast, Gretyl Kinsey and Christine Cuellar discuss balancing the implementation of a content management system (CMS), and component content management system (CCMS). This is part one of a two-part podcast.

“When you have two types of content produced by your organization and different groups in charge of that, and maybe they’re in two different systems, that it’s really important to get those groups working together so that they can understand that those priorities don’t need to be competing, they just need to be balanced.”

— Gretyl Kinsey

Christine Cuellar
April 24, 2023
Read More
Content operations DITA Podcast Podcast transcript XML

What is LearningDITA? (podcast)

March 2025 update: We have moved LearningDITA to a new platform. The Introduction to DITA course is still free, and you can sign up for courses at store.scriptorium.com.

In episode 141 of The Content Strategy Experts Podcast, Alan Pringle and Christine Cuellar discuss the story behind LearningDITA, the free DITA training created by the Scriptorium team.

What we are trying to do with this site is give people a resource where they can go and, at their own pace, learn about what DITA is and how it can apply to their content and their content processes. It’s a way to take some of the technical mystique out of it, to bring it down and help you learn what it is and how it works.

– Alan Pringle

Christine Cuellar
April 10, 2023
Read More
Content operations XML

Replatforming structured content

Scriptorium is doing a lot of replatforming projects. We have customers with existing structured content—custom XML, DocBook, and DITA—who need to move their content operations from their existing CCMS to a new system.

These transitions, even DITA to DITA, require a solid business justification. Replatforming structured content is annoying and expensive. Most often, the organization’s needs have changed, and the current platform is no longer a good fit.

Note: This post focuses on transitions into DITA. There are surely DITA to not-DITA projects out there, but they are not in our current portfolio.

Sarah O'Keefe
August 22, 2022
Read More
DITA XML

LearningDITA: four years later

If you had told me in July 2015 that LearningDITA would have 10 courses and be available in three languages, I wouldn’t have believed you. Since the site’s initial launch, it’s grown from a single course to a major resource for those who need to learn to use DITA.

March 2025 update: We have moved LearningDITA to a new platform. The Introduction to DITA course is still free, and you can sign up for courses at store.scriptorium.com.

Gretyl Kinsey
June 17, 2019
Read More
Content strategy White papers XML

Structured authoring and XML

Coauthored by Sarah O’Keefe and Alan Pringle

First published in 2001.

Structured authoring and XML represent a significant paradigm shift in content creation. Implementing structured authoring with XML allows organizations to enforce content organization requirements. The addition of hierarchy and metadata to content improves reuse and content management. These benefits, however, must be weighed against the effort required to implement a structured authoring approach. The business case is compelling for larger writing organizations; they will be the first to adopt structured authoring. Over time, improvements in available tools will reduce the cost of implementing structured authoring and make it affordable for smaller organizations.

Sarah O'Keefe
April 12, 2017
Read More
XML

Before XML, improve DTP

Thinking about migrating unstructured content to XML? Take a hard look at your existing desktop publishing workflow. The maturity of your DTP process will have a big impact on a move to XML.

Following a template-based DTP workflow is not just about implementing best-practice processes. Templates make a potential move to XML less expensive and painful.

Alan Pringle
September 6, 2016
Read More
XML

Managing technical communicators in an XML environment

To understand how XML changes technical communication, we need to step back and look at how the rise of information technology has changed the content development process. Through the 1970s, most technical communication work had separate writing, layout, and production phases. Authors wrote content, typically in longhand or on typewriters. Typesetters would then rekey the information to transfer it into the publishing system. The dedicated typesetting system would produce camera-ready copy, which was then mechanically reproduced on a printing press.
In a desktop publishing environment, authors could type information directly into a page layout program and set up the document design. This eliminated the inefficient process of re-entering information, and it often shifted the responsibility for document design to technical communicators.

Sarah O'Keefe
June 14, 2010
Read More
Content strategy XML

XML: The death of creativity in technical writing?

Originally published in STC Intercom, February 2010.

I spend a lot of time giving presentations on XML, structured authoring, and related technologies. The most common negative reaction, varied only in the level of hostility, is “Why are you stifling my creativity?”

Does XML really mean the Death of Creativity for technical communicators? And does creativity even belong in technical content?

Sarah O'Keefe
February 1, 2010
Read More
XML

Handling XSL:FO’s memory issue with large page counts

Formatting Object (FO) processors (FOP, in particular) often fail with memory errors when processing very large documents for PDF output. Typically in XSL:FO, the body of a document is contained in a single fo:page-sequence element. When FO documents are converted to PDF output, the FO processor holds an entire fo:page-sequence in memory to perform pagination adjustments over the span of the sequence. Very large page counts can result in memory overflows or Java heap space errors.

ScriptoriumTech
December 31, 2009
Read More
XML

Managing implementation of structured authoring


An updated version of this white paper is in Content Strategy 101. Read the entire book free online, or download the free EPUB edition.

Moving a desktop publishing–based workgroup into structured authoring requires authors to master new concepts, such as hierarchical content organization, information chunking with elements, and metadata labeling with attributes. In addition to these technical challenges, the implementation itself presents significant difficulties. This paper describes Scriptorium Publishing’s methodology for implementing structured authoring environments. This document is intended primarily as a roadmap for our clients, but it could be used as a starting point for any implementation.

ScriptoriumTech
December 31, 2009
Read More
Content strategy Localization XML

Building efficient multilingual workflows

STC Intercom, April 2009

A common argument for XML-based workflows is that they automate production and localization tasks. With XML, localization can be reduced to a fraction of its original cost, but how exactly does that happen?

Sarah explores automization in localization and two technology standards used in multilingual workflows: The Extensible Stylesheet Language (XSL) and XML Localization Interchange File Format (XLIFF).

Download the PDF PDF file (125 K)

Sarah O'Keefe
April 30, 2009
Read More
XML

When is XML the wrong answer?

Originally published in STC Intercom, November 2007

XML can benefit a publishing workflow in many ways: improving content reuse, consistency, and potentially automating much of the process. That all sounds wonderful, but XML is not the logical answer for everyone.

Implementing a structured authoring solution requires a significant change from the familiar desktop publishing routine to new tools, technologies, and processes. Switching to XML is going to cost time and money. Depending on your needs, it may not be the most efficient solution.

Sarah O'Keefe
November 19, 2007
Read More