structuring topics without structured authoring
TRANSCRIPT
![Page 1: Structuring Topics without Structured Authoring](https://reader035.vdocuments.mx/reader035/viewer/2022062523/58f301ac1a28abf7388b45c7/html5/thumbnails/1.jpg)
Structuring Topics withoutStructured Authoring
Michael McCallister
WritersUA Central
October 21, 2015
![Page 2: Structuring Topics without Structured Authoring](https://reader035.vdocuments.mx/reader035/viewer/2022062523/58f301ac1a28abf7388b45c7/html5/thumbnails/2.jpg)
Ask questions any time!
![Page 3: Structuring Topics without Structured Authoring](https://reader035.vdocuments.mx/reader035/viewer/2022062523/58f301ac1a28abf7388b45c7/html5/thumbnails/3.jpg)
Who am I?
• Senior Document Architect, PKWARE
• Books about openSUSE Linux and WordPress
• Blog: Notes from the Metaverse (metaverse.wordpress com)
• President, Society for Technical Communication, Wisconsin Chapter
• National Writers Union, UAW Local 1981, At Large chapter
![Page 4: Structuring Topics without Structured Authoring](https://reader035.vdocuments.mx/reader035/viewer/2022062523/58f301ac1a28abf7388b45c7/html5/thumbnails/4.jpg)
![Page 5: Structuring Topics without Structured Authoring](https://reader035.vdocuments.mx/reader035/viewer/2022062523/58f301ac1a28abf7388b45c7/html5/thumbnails/5.jpg)
What We’re Covering
● DITA and PKWARE
● Organizing Help Topics in RoboHelp 10
● Preparing Master Pages in RoboHelp
![Page 6: Structuring Topics without Structured Authoring](https://reader035.vdocuments.mx/reader035/viewer/2022062523/58f301ac1a28abf7388b45c7/html5/thumbnails/6.jpg)
Ultimate Goal of Tech Comm
● Right content (and only right content)
● Right context
● Right format
![Page 7: Structuring Topics without Structured Authoring](https://reader035.vdocuments.mx/reader035/viewer/2022062523/58f301ac1a28abf7388b45c7/html5/thumbnails/7.jpg)
Quick Survey:What is DITA?
![Page 8: Structuring Topics without Structured Authoring](https://reader035.vdocuments.mx/reader035/viewer/2022062523/58f301ac1a28abf7388b45c7/html5/thumbnails/8.jpg)
![Page 9: Structuring Topics without Structured Authoring](https://reader035.vdocuments.mx/reader035/viewer/2022062523/58f301ac1a28abf7388b45c7/html5/thumbnails/9.jpg)
What's a Topic?Neil Perlin
Focused on one subject:
● Answers one question
● How do I...?
● What is...?
As self-contained as possible
● All info needed to answer question
● Related info is separate
● Topics link to related topics
![Page 10: Structuring Topics without Structured Authoring](https://reader035.vdocuments.mx/reader035/viewer/2022062523/58f301ac1a28abf7388b45c7/html5/thumbnails/10.jpg)
Project Settings in RoboHelp 10
![Page 11: Structuring Topics without Structured Authoring](https://reader035.vdocuments.mx/reader035/viewer/2022062523/58f301ac1a28abf7388b45c7/html5/thumbnails/11.jpg)
Topic Properties in RoboHelp 10
![Page 12: Structuring Topics without Structured Authoring](https://reader035.vdocuments.mx/reader035/viewer/2022062523/58f301ac1a28abf7388b45c7/html5/thumbnails/12.jpg)
Topic Properties Report
![Page 13: Structuring Topics without Structured Authoring](https://reader035.vdocuments.mx/reader035/viewer/2022062523/58f301ac1a28abf7388b45c7/html5/thumbnails/13.jpg)
Topic Properties Report Options
![Page 14: Structuring Topics without Structured Authoring](https://reader035.vdocuments.mx/reader035/viewer/2022062523/58f301ac1a28abf7388b45c7/html5/thumbnails/14.jpg)
Topic types leading to structure
● Concept: Big Picture
● Task: What the user does
● Reference: All the other stuff user needs to know
![Page 15: Structuring Topics without Structured Authoring](https://reader035.vdocuments.mx/reader035/viewer/2022062523/58f301ac1a28abf7388b45c7/html5/thumbnails/15.jpg)
Another PKWARE Interlude
![Page 16: Structuring Topics without Structured Authoring](https://reader035.vdocuments.mx/reader035/viewer/2022062523/58f301ac1a28abf7388b45c7/html5/thumbnails/16.jpg)
Master pages in RoboHelp
● Imported from FrameMaker
● Page Templates
● Added CSS
![Page 17: Structuring Topics without Structured Authoring](https://reader035.vdocuments.mx/reader035/viewer/2022062523/58f301ac1a28abf7388b45c7/html5/thumbnails/17.jpg)
Master Pages in RoboHelp 2015
● Whirl the Whirls Sample
● Master pages
● CSS Editor
![Page 18: Structuring Topics without Structured Authoring](https://reader035.vdocuments.mx/reader035/viewer/2022062523/58f301ac1a28abf7388b45c7/html5/thumbnails/18.jpg)
Goals for Creating Topic Types
● Help users be more effective
● Better statistics for management
● Ease the transition to structured authoring
![Page 19: Structuring Topics without Structured Authoring](https://reader035.vdocuments.mx/reader035/viewer/2022062523/58f301ac1a28abf7388b45c7/html5/thumbnails/19.jpg)
Connect with Me
• PKWARE Help: help.pkware.com
• Email: [email protected]
• Web: michaelmccallister.com
• Twitter: @workingwriter
• LinkedIn: www.linkedin.com/in/workingwriter
Michael McCallister, Independent Writers of Chicago March 2015
![Page 20: Structuring Topics without Structured Authoring](https://reader035.vdocuments.mx/reader035/viewer/2022062523/58f301ac1a28abf7388b45c7/html5/thumbnails/20.jpg)
Questions?
Michael McCallister, Independent Writers of Chicago March 2015