Resources
Looking for some light bedtime reading? Our resources section offers white papers, webcasts, a style guide, and more.
- Content strategy. Our content strategy section has information about knowledge integration, how XML workflows affect authoring, research on structured authoring implementation, and much more.
- Tools. In the tool section, you’ll find webcasts with information about specific software, including XMetaL, FrameMaker, DITA-FMx, oXygen, Flare, and FOP.
- XML and DITA. We devoted an entire section to white papers and webcasts on XML and DITA because we have so many of them. Here, you’ll find a webcast on specialization, discussions of how to customize PDF output from the DITA Open Toolkit, and more.
- Online style guide. Our style guide provides a concise list of recommendations for technical docmentation.
- FrameMaker wiki. The wiki offers contains free tutorials for FrameMaker. We encourage you to use them and make updates as appropriate.
Learning DITA
May 17th, 2012 by Holly Mabry
I started this internship at Scriptorium with very little knowledge of DITA other than the basic definition of it. One of the major goals of this internship is to learn DITA since it plays such a major role in tech comm.
I have been working on a training exercise that involves on using DITA in oXygen. The exercise started with the top level, bare bones aspects of DITA. All I had to do was create topics and add them to the DITA Map.
From there I have worked my way into more specific tags and menu functions. Learning DITA never stops. You can always go deeper. I have spent a lot of time asking questions and searching the Help files.
One thing I highly recommend doing before learning DITA is to learn HTML. DITA uses a lot of the basic HTML element tags such as <p>, <ul>, <li>, etc. Knowing HTML gave me a foundation to work with so that the prospect of learning a new language didn’t seem as daunting.
I also recommend familiarizing yourself with XML and its structure. Again, knowledge of HTML comes in handy here because XML uses element tags. The difference between XML and HTML is that element tags are defined by the developer rather than predefined.
I am still trying to grasp the lingo and understand what each function is. Misunderstanding the terms for various aspects of DITA such as elements or attributes can make it challenging to ask questions about them. oXygen is helpful though because it shows when certain element tags are not allowed. I think once I actually see the final output, it will make more sense to me.
The only major frustration I have using oXygen is using the Help section. My search terms didn’t seem to bring up relevant results. I also was not pleased that I couldn’t enlarge the font. The font size can easily be adjusted in the main interface.
I worked around the search result and font enlargement problem by going to the user manual on the oXygen website. On the website I can choose HTML or PDF format, and can enlarge the font as big as I need it.
The “learn as I go” approach has been effective for me. I am a visual learner. I have to interact with the content in order to fully understand it.
Any thoughts or recommendations on the best ways to learn and understand DITA?
Tags: dita, oxygen
Category: DITA, theory, Opinion
Permalink | 5 Comments »

Vendor webcast: An overview of authoring DITA with oXygen
May 15th, 2012 by ScriptoriumTech
In this webcast recording, George Bina shows you how to create DITA content from zero to a full deliverable using oXygen. The full deliverable leads to multiple publishing formats.
Category: Webinars, XML and DITA
Permalink | No Comments »

Webcast: Collaboration: A hands-on demo using Confluence wiki
April 27th, 2012 by ScriptoriumTech
In this video recording, guest presenter Sarah Maddox explains why collaboration is a good thing, why a wiki is a good solution for it, and how to do it on Confluence.
Category: Tools, Webinars
Permalink | 3 Comments »

Webcast: Transition to XML
April 17th, 2012 by Simon Bate
Simon Bate provides a planning framework for implementing an XML-based structured authoring environment.
Category: Webinars, XML
Permalink | No Comments »

Vendor webcast: Collaborative content development with easyDITA
April 4th, 2012 by ScriptoriumTech
Paul Wlodarczyk shows how cloud-based tools like easyDITA can change the way you approach collaboration, and in turn speed your time to publish and simplify your work process.
Category: DITA, applied, Webinars
Permalink | No Comments »

Vendor Webcast: Bring your DITA content to the next level with IXIASOFT
March 1st, 2012 by ScriptoriumTech
Have you ever wondered how to effectively manage your DITA content as it continues to grow? Jean-François Ameye shows how IXIASOFT’s full featured DITA CMS solution handles your entire technical documentation process from authoring and searching to reviewing and publishing.
Category: Resources, Webinars
Permalink | No Comments »

Webcast: HTML5 and its impact on technical communication
February 16th, 2012 by ScriptoriumTech
In this webcast recording, guest presenter Peter Lubbers gives a fast-paced overview of HTML5 with a focus on how it affects the tech comm field. He covers what exactly HTML5 is, why you should care, and how you can develop with HTML5. The session covers which browsers support which features, and how you can make the new features work in older browsers so you can start using HTML5 today.
Category: Events, Resources, Tools, Webinars
Permalink | 2 Comments »

Webcast: The Changing Role of the Professional Technical Communicator: What’s Next?
February 15th, 2012 by Sarah O'Keefe
In this webcast recording, Scott Abel, The Content Wrangler, and Val Swisher, CEO of Content Rules, host a lively discussion with technical communication industry professionals Jack Molisani and Sarah O’Keefe. The four discuss the impact of globalization, outsourcing, off-shoring, technological advances, and mobile devices on the technical communication landscape.
Category: Content strategy, applied, Resources, Webinars
Permalink | No Comments »

Webcast: Trends in technical communication, 2012
February 1st, 2012 by Sarah O'Keefe
In this webcast recording, Sarah O’Keefe and guest presenter Char James-Tanny discuss tech comm trends for the upcoming year and beyond. Topics include use of the cloud, help authoring tool innovation, business value, adoption of standards, shift to mobile, and more.
Category: Content strategy, applied, Resources, Webinars
Permalink | 2 Comments »

Webcast: Content strategy in technical communication
January 20th, 2012 by Sarah O'Keefe
In this webcast recording, Sarah O’Keefe explores how to develop a content strategy specifically for technical content. That means stepping back from the temptation to focus on tools and instead taking a hard look at what the users need and how best to deliver it.
Category: Content strategy, theory, Resources, Webinars
Permalink | 4 Comments »
