Tweet Roundup: DITA Styling in Arbortext Webinar

Live tweet stream from the webinar == “DITA Style in Arbortext. It’s Easy!” — rounded up in one post.

Earlier today, Liz Fraley, from Single-Sourcing Solutions, showed some best practices for doing DITA stylesheets in Arbortext Styler. She talked about understanding fall-back processing, using read-only stylesheets, and doing modular stylesheet development. All of these things contribute to a successful DITA implementation and a productive environment.

In case you missed it, you can view the recording or, because the event had a live Twitter stream, you can read through the highlights below. Enjoy!

#Arbortext #DITA Webinar L.Fraley: Get your Arbortext resources here:
Arbortext Resources from Single-Sourcing Solutions

Arbortext Resources from Single-Sourcing Solutions, qualified value added reseller for PTC dynamic publishing products – Arbortext Mathcad Windchill
#Arbortext #DITA Webinar L.Fraley: A giant chart of resources available to the arbortext community and this is just a small slice!
#Arbortext #DITA Webinar L.Fraley: Please don’t ever, ever, ever, style concept, task or reference. Rely on fall-back processing!
#Arbortext #DITA Webinar L.Fraley: Icon indicators, color, weight, hints to give you what you need to develop stylesheets right in the UI
#Arbortext #DITA Webinar L.Fraley: RDS is a separate stand-alone file that does not affect your source content
#Arbortext #DITA Webinar L.Fraley: Use the Resolved Document for Styling to see your content after it’s gone through publishing pipeline
#Arbortext #DITA Webinar L.Fraley: Use a test document that contains many of the different contexts you need to style
#Arbortext #DITA Webinar L.Fraley: Added APP code by adding a module and changing rendering engine to APP. Voila! Cool.
#Arbortext #DITA Webinar L.Fraley: Source edit support–source edits are mechanism for going above and beyond, like including APP code!
#Arbortext #DITA Webinar L.Fraley: Styler is a very powerful tool; people enjoy using it. It does a nice job of simplifying the view
#Arbortext #DITA Webinar L.Fraley: easy to see that style applies only to one format or to all. Red to indicate you’re changing a subset/one
#Arbortext #DITA Webinar L.Fraley: Styler can have multiple output formats from one stylesheet–true multi-channel stylesheeting
#Arbortext #DITA Webinar L.Fraley: easy to move rules into/between modules and see precedence of modules
#Arbortext #DITA Webinar L.Fraley: lots of customers using pageset modules
#Arbortext #DITA Webinar L.Fraley: Sort by module–it’s a nice way to organize your work, and you can reuse modules in other stylesheets
#Arbortext #DITA Webinar L.Fraley: You can sort by module, and work on all TASK-related parts at once, see everything together.
#Arbortext #DITA Webinar L.Fraley: Styler validates modules on import to make sure you don’t have garbage in your stylesheet
#Arbortext #DITA Webinar L.Fraley: Use a modular architecture to do your work, deploy flattened stylesheet to field–faster in production
#Arbortext #DITA Webinar L.Fraley: Arbortext provides 31 modules OOB, easy to drop domains you don’t use
#Arbortext #DITA Webinar L.Fraley: Use the flattened base or the modules provided OOB to start your stylesheet work
#Arbortext #DITA Webinar L.Fraley: Styler is a tool that just anyone can pick up and use
#Arbortext #DITA Webinar L.Fraley: Styler is a tool that can be used by the non-programmer; easy to understand, with info/hints right there
#Arbortext #DITA Webinar L.Fraley: OTK–a great tool, but takes programming skills, really need to understand the DTD to dig around in it
#Arbortext #DITA Webinar L.Fraley: Make sure w/specializations, you’re not going to break anything. Just think it through
#Arbortext #DITA Webinar L.Fraley: There’s a notion of fall-back processing and you want to take advantage of it: no unnecessary styling
#Arbortext #DITA Webinar L.Fraley: Styler has all of these little tips that provide you w/what you need to know as a stylesheet developer
#Arbortext #DITA Webinar L.Fraley: Comment feature added in 5.4, you can see/add comments easily, right in UI
#Arbortext #DITA Webinar L.Fraley: Can sort by element and can quickly jump to rules, elements, and contexts
#Arbortext #DITA Webinar L.Fraley: Styler provides hints–“this elt is a specialization of…”–stylesheet devs need this info at hand
#Arbortext #DITA Webinar L.Fraley: Lots of elements in OOB stylesheets are “unstyled by design”
#Arbortext #DITA Webinar L.Fraley: With DITA, take advantage of fall-back processing. Styler makes this easy to see.
#Arbortext #DITA Webinar L.Fraley: For folks who used Styler in the past, it looks a lot different; lots of new things to talk about
#Arbortext #DITA Webinar L.Fraley: Styler provides a very robust, obvious, powerful way to make modifications to meet org needs
#Arbortext #DITA Webinar L.Fraley: Can sort on column to see active vs overridden rules.
#Arbortext #DITA Webinar L.Fraley: bold=active rule; gray/italic=overridden rule. Easy to see.
#Arbortext #DITA Webinar L.Fraley: Icon shows precedence and priority status of rules in stylesheet.
#Arbortext #DITA Webinar L.Fraley: Knowing specialization history is important for stylesheet writers, pop up hint in Styler is handy view
#Arbortext #DITA Webinar L.Fraley: Hover over element and you can see where it comes from (file, module) and what it’s specialized from
#Arbortext #DITA Webinar L.Fraley: by importing a read-only copy, you can leverage future updates provided by Arbortext
#Arbortext #DITA Webinar L.Fraley: ATX provides a very extensive stylesheet that supports all of the DITA elements and attributes OOB
#Arbortext #DITA Webinar L.Fraley: Start with an empty shell (driver) stylesheet and import read-only copy of OOB stylesheet
#Arbortext #DITA Webinar L.Fraley: also an RDE – resolved document for editing – to see total — editiable– content in one view
#Arbortext #DITA Webinar L.Fraley: RDS good for troubleshooting link problems, it’s what’s gone through the publishing pipeline
#Arbortext #DITA Webinar L.Fraley: Styler has a “Resolved Document for Styling” (RDS) that contains all the info from map & topics
#Arbortext #DITA Webinar L.Fraley: Style against a sample document that represents the vast majority of constructs you would see in output
#Arbortext #DITA Webinar L.Fraley: Stylesheet creates the rules for how elements appear in the various contexts in the output
#Arbortext #DITA Webinar L.Fraley: a single Styler stylesheet can create output for multiple output formats
#Arbortext #DITA Webinar L.Fraley: Best practices for using Styler with the OOB DITA modular stylesheets
#Arbortext #DITA Webinar L.Fraley: Talking about Styler – a UI to make non-programmers capable of maintaining/creating stylesheets
#Arbortext #DITA Webinar L.Fraley: PTC pushing for interoperability, cooperation between applications — based on customer feedback
#Arbortext #DITA Webinar L.Fraley: Arbortext is the only OOB end-to-end solution with integrated products that all play nicely w/each other
#Arbortext #DITA Webinar L.Fraley: Arbortext was Editor IBM was using when they developed DITA; Arbortext part of OASIS DITA TC from start
#Arbortext #DITA Webinar L.Fraley: Arbortext has a long history with SGML, XML, and DITA. Around since 1990
#Arbortext #DITA Webinar: about to get started…
#Arbortext #DITA Webinar: We’ll be live-tweeting the webinar. Fair warning: we’re going into high-volume for the next hour.

Get useful tips and valuable resources every month

Join the thousands who know just how much we share.

Powered by ConvertKit

Author: Liz Fraley

Liz Fraley has founded two companies, sits on the boards of three non-profits, and is constantly coming up with new ways to share knowledge in the technical communications and content industries.