Word is great when you have content that is managed by SharePoint, or based on standard and highly-enforced templates, or you have a team of developers to support your team of writers. However, there are too many ways for too many people to cause too many problems. Style overrides, manual formats, or just incorrect use of a template can haunt good content. You spend time and effort to make content great; now put a little bit more time into getting to know a tool that isn’t created for everyone. It’s created for those of us who work in technical communication. It’s time for Adobe FrameMaker.
In this session, you will learn how to
» Evaluate a Word document for content quality
» Rework content for a topic-based model
» Import a Word file to Adobe FrameMaker
» Create a structured workflow
» Migrate legacy content to a structured format
» Move your content to a CCMS
» Publish single sourced content to multiple channels, formats & devices
Whether you are writing an article, research paper, essay, blog, and dissertation or PhD thesis, it is important to choose an appropriate writing software tool for your work. The choice of writing software comes down to your personal taste.
Joint presentation at STC Conference 2004 (Baltimore) by Rhonda Bracey and Char James-Tanny; other supporting material available from here: http://www.cybertext.com.au/9453.htm
XML for Humans: Non-geek Discussion of a Geek-chic TopicPublishing Smarter
This session, presented at the Editors Conference in Toronto, on June 8, 2014, introduces you to the basics of XML, explaining what it is, how it is used, and why it benefits people who write and edit.
While THEY may love to work with code, the goal was to put as much of this into plain language for US as possible. I think it succeeded.
Participants could learn how clear and concise content can be created (and managed) in an XML workflow. At the end of the session they had enough knowledge to speak about XML with confidence.
During the session detailed slides were presented and discussed. A packed room attended and participated (the session featured a lot of great questions and answers) over the span of an hour.
Whether you are writing an article, research paper, essay, blog, and dissertation or PhD thesis, it is important to choose an appropriate writing software tool for your work. The choice of writing software comes down to your personal taste.
Joint presentation at STC Conference 2004 (Baltimore) by Rhonda Bracey and Char James-Tanny; other supporting material available from here: http://www.cybertext.com.au/9453.htm
XML for Humans: Non-geek Discussion of a Geek-chic TopicPublishing Smarter
This session, presented at the Editors Conference in Toronto, on June 8, 2014, introduces you to the basics of XML, explaining what it is, how it is used, and why it benefits people who write and edit.
While THEY may love to work with code, the goal was to put as much of this into plain language for US as possible. I think it succeeded.
Participants could learn how clear and concise content can be created (and managed) in an XML workflow. At the end of the session they had enough knowledge to speak about XML with confidence.
During the session detailed slides were presented and discussed. A packed room attended and participated (the session featured a lot of great questions and answers) over the span of an hour.
SharePointFest Konferenz 2016 - Alternative Approaches to Solution Developmen...Marc D Anderson
We regularly hear about the importance of building Apps or Add-Ins from the Microsoft folks. But in many cases, that approach is overkill. Even in enterprises, all solutions aren’t enterprise scale. It’s always been possible to build solid solutions or solution components using the trusty Content Editor Web Part to hold some HTML, JavaScript, and CSS, and that’s still a viable approach. With a few other more modern tricks, we can even build solutions that span many pages using a common code base.
Join Marc D Anderson as he kicks around the plusses and minuses of sanctioned development versus smaller, lighter-touch approaches.
Content creation, reuse, and publishing to everyone on every device (WritersUA)Publishing Smarter
Timing is everything. It's crucial to quickly create content for multiple audiences, manage reuse effectively, and publish to an audience that needs: the right information, at the right time, in the right format. You can follow up and in a hands-on way you: create content for multiple audiences, in seconds generate dynamic HTML5 content, do so at the click of a button
PDF Generation in Rails with Prawn and Prawn-to: John McCaffreyJohn McCaffrey
breakdown of the most commonly used pdf libraries in rails projects,and an in depth review of prawn
example pdfs and code can be seen at prawn.heroku.com
More info at www.RailsPerformance.com
Content creation, reuse, and publishing to everyone on every devicePublishing Smarter
Use Adobe FrameMaker and its conditional text settings to create content unique to your audience and allow them to choose exactly what they read. Step-by-step instructions make it easy to get started, and explore powerful ideas.
Cherryleaf’s Ellis Pratt will be speaking at Lavacon’s first European conference. This will be held on 5-8 June, at the Trinity College Conference Centre, Dublin. Ellis’ presentation will be on the 7th June 2016
Advantages to authoring in a topic based environment
*. More efficient
*. Structure helps produce better content
*. Takes advantage of new technologies for delivering content
I plan to share the best way to
*. Assess your current situation
*. Plan for your future and
*. Execute to the plan
After the presentation, you will:
*. Understand what topic–based writing is and its advantages
*. Follow best–practices for organizing new material into topic–based content
*. Understand the place of XML and DITA and how they may relate to your needs
Presented by Neil Perlin at Documentation and Training West, May 6-9, 2008 in Vancouver, BC.
With two releases of RoboHelp in 2007, Adobe is working to restore its place in the help authoring world after several uncertain years. If you’’re a RoboHelp X5 user who’s been waiting to see where RoboHelp was going, come to this workshop. Version 7 offers the most significant interface changes in years, and some significant new features. Plus you can use it with Captivate and Acrobat to build multi-modal help. This workshop offers a hands-on overview where you’’ll use RoboHelp 7 to create a simple help system and look at its integration with the rest of the Adobe Technical Communication Suite.
Today there are multiple CSS frameworks, pre-processors, grids and naming strategies that can be used to organize your codebase. The question is, how do you sort through all the noise and figure out which of theses new CSS coding strategies and tools are best for your specific project and how do you combine them in order to create the best environment for styling? (Created for a Workshop)
By now, you have heard how important structured content is. But, maybe you poked around with something like DITA and were baffled by the complexity. Or, maybe you still aren’t sure what XSLT stands for. This workshop will take participants back to the basics, to provide a foundation for higher-level concepts that have taken hold of our industry. Topics will include:
- What XML looks like, what it does, and how to create it.
- How to define a structure model, including whether to use a - DTD, Schema, etc.
- What XSLT looks like, what it does, and how to make it work.
- What DITA and DocBook really are and whether one is right for you.
Russell Ward is an experienced technical writer and structured technologies developer. He has spent many years working with structured content to maximize efficiency in the techcomm environment, both as an employee and as an independent consultant. He is also an experienced trainer and speaks periodically at conferences and other peer events.
Develop key components of a content strategy
Connect the implementation of the strategy with
Improved workflows for creating, managing, and publishing content
Reduction of risk in lack of compliance, inconsistency, missing information
Generation of revenue through effective multi-channel content delivery
Ask (and answer) questions related to tool selection
Hands-on with FrameMaker and DITA to create topics
Publish PDF and HTML5 formats
Implement an Adobe Experience Manager-based solution to ingest, manage, and publish content
Automating DITA Publishing: How Gulfstream Publishes Style-rich, Interactive ...Publishing Smarter
If you have watched a TV show or movie in which characters travel the world in a Gulfstream, you have seen a company that elevates aviation to an art form. Sleek lines, luxurious cabins, and an ongoing pursuit of excellence are what we see onscreen.
Behind the scenes, there is DITA. Flight manuals, operators manuals, handbooks, and other content is sourced from one set of DITA materials. Gulfstream then publishes it in a system to PDF that is as functional, professional, and sharp looking as the airplanes they support.
How Gulfstream is doing this, though, is another story. It includes highs and lows of discovery, challenge, and success from open communications between partners. The experience of delivering the best looking and the best functioning documentation in the industry means months of effort to create a push-button approach to convert a DITA map to a finished digital PDF that provides a complete solution to online documentation for the cockpit.
This story is a continuing exploration of the boundaries of automation, compliance, design, and a desire to enhance the usability (and the re-usability) of content from creation to the final delivery. See how it works and what DITA can do to change the way we fly.
SharePointFest Konferenz 2016 - Alternative Approaches to Solution Developmen...Marc D Anderson
We regularly hear about the importance of building Apps or Add-Ins from the Microsoft folks. But in many cases, that approach is overkill. Even in enterprises, all solutions aren’t enterprise scale. It’s always been possible to build solid solutions or solution components using the trusty Content Editor Web Part to hold some HTML, JavaScript, and CSS, and that’s still a viable approach. With a few other more modern tricks, we can even build solutions that span many pages using a common code base.
Join Marc D Anderson as he kicks around the plusses and minuses of sanctioned development versus smaller, lighter-touch approaches.
Content creation, reuse, and publishing to everyone on every device (WritersUA)Publishing Smarter
Timing is everything. It's crucial to quickly create content for multiple audiences, manage reuse effectively, and publish to an audience that needs: the right information, at the right time, in the right format. You can follow up and in a hands-on way you: create content for multiple audiences, in seconds generate dynamic HTML5 content, do so at the click of a button
PDF Generation in Rails with Prawn and Prawn-to: John McCaffreyJohn McCaffrey
breakdown of the most commonly used pdf libraries in rails projects,and an in depth review of prawn
example pdfs and code can be seen at prawn.heroku.com
More info at www.RailsPerformance.com
Content creation, reuse, and publishing to everyone on every devicePublishing Smarter
Use Adobe FrameMaker and its conditional text settings to create content unique to your audience and allow them to choose exactly what they read. Step-by-step instructions make it easy to get started, and explore powerful ideas.
Cherryleaf’s Ellis Pratt will be speaking at Lavacon’s first European conference. This will be held on 5-8 June, at the Trinity College Conference Centre, Dublin. Ellis’ presentation will be on the 7th June 2016
Advantages to authoring in a topic based environment
*. More efficient
*. Structure helps produce better content
*. Takes advantage of new technologies for delivering content
I plan to share the best way to
*. Assess your current situation
*. Plan for your future and
*. Execute to the plan
After the presentation, you will:
*. Understand what topic–based writing is and its advantages
*. Follow best–practices for organizing new material into topic–based content
*. Understand the place of XML and DITA and how they may relate to your needs
Presented by Neil Perlin at Documentation and Training West, May 6-9, 2008 in Vancouver, BC.
With two releases of RoboHelp in 2007, Adobe is working to restore its place in the help authoring world after several uncertain years. If you’’re a RoboHelp X5 user who’s been waiting to see where RoboHelp was going, come to this workshop. Version 7 offers the most significant interface changes in years, and some significant new features. Plus you can use it with Captivate and Acrobat to build multi-modal help. This workshop offers a hands-on overview where you’’ll use RoboHelp 7 to create a simple help system and look at its integration with the rest of the Adobe Technical Communication Suite.
Today there are multiple CSS frameworks, pre-processors, grids and naming strategies that can be used to organize your codebase. The question is, how do you sort through all the noise and figure out which of theses new CSS coding strategies and tools are best for your specific project and how do you combine them in order to create the best environment for styling? (Created for a Workshop)
By now, you have heard how important structured content is. But, maybe you poked around with something like DITA and were baffled by the complexity. Or, maybe you still aren’t sure what XSLT stands for. This workshop will take participants back to the basics, to provide a foundation for higher-level concepts that have taken hold of our industry. Topics will include:
- What XML looks like, what it does, and how to create it.
- How to define a structure model, including whether to use a - DTD, Schema, etc.
- What XSLT looks like, what it does, and how to make it work.
- What DITA and DocBook really are and whether one is right for you.
Russell Ward is an experienced technical writer and structured technologies developer. He has spent many years working with structured content to maximize efficiency in the techcomm environment, both as an employee and as an independent consultant. He is also an experienced trainer and speaks periodically at conferences and other peer events.
Develop key components of a content strategy
Connect the implementation of the strategy with
Improved workflows for creating, managing, and publishing content
Reduction of risk in lack of compliance, inconsistency, missing information
Generation of revenue through effective multi-channel content delivery
Ask (and answer) questions related to tool selection
Hands-on with FrameMaker and DITA to create topics
Publish PDF and HTML5 formats
Implement an Adobe Experience Manager-based solution to ingest, manage, and publish content
Automating DITA Publishing: How Gulfstream Publishes Style-rich, Interactive ...Publishing Smarter
If you have watched a TV show or movie in which characters travel the world in a Gulfstream, you have seen a company that elevates aviation to an art form. Sleek lines, luxurious cabins, and an ongoing pursuit of excellence are what we see onscreen.
Behind the scenes, there is DITA. Flight manuals, operators manuals, handbooks, and other content is sourced from one set of DITA materials. Gulfstream then publishes it in a system to PDF that is as functional, professional, and sharp looking as the airplanes they support.
How Gulfstream is doing this, though, is another story. It includes highs and lows of discovery, challenge, and success from open communications between partners. The experience of delivering the best looking and the best functioning documentation in the industry means months of effort to create a push-button approach to convert a DITA map to a finished digital PDF that provides a complete solution to online documentation for the cockpit.
This story is a continuing exploration of the boundaries of automation, compliance, design, and a desire to enhance the usability (and the re-usability) of content from creation to the final delivery. See how it works and what DITA can do to change the way we fly.
Convince Management to Invest in a CCMS (Lessons learned)Publishing Smarter
You are keenly aware of the benefits of a Component Content Management System (CCMS). Next steps; develop a business case to present to management. Answering their questions about an important investment decision means prepping for their key questions. This webinar presents you with questions management may ask, information on researching answers, and guidance on how to make your case. Learn through stories of companies and people who have a CCMS. Hear what they did to convince their management teams to make the long term investments that pay dividends for years to come.
DITA: From “Do I?” to “Done It!”: An Automotive Case Study that can apply to ...Publishing Smarter
This session showcases how documentation for one of the biggest auto manufacturers in the world was to migrated to DITA allowing for publishing of hundreds of manuals in over a dozen languages.
Vehicle documentation (owner’s manuals, user guides, quick reference guides, etc) are as crucial to a car as the brakes, engine, or chassis. Without these a car is not finished, and cannot be shipped and sold. Documentation failure can cost over $100,000 per MINUTE if it results in a line being shut down.
Learn about the journey and discovery of concerns, project scope definition and change, trials and tribulations of getting tools to do what was needed, and the net results. Along the way a component content management system, author tools, review processes, and much more had to be planned, tested, implemented, and supported.
Darwin Information Typing Architecture (DITA) is the accepted industry standard for creating structured content. A Unified Content Strategy is the methodical and purposeful management of your information assets across all divisions of your enterprise, in a way that breaks down silos and makes information easy to find and use.
Brakes, engine, or chassis is mission-critical for a car. Equally important is all the documentation (owner’s manuals, user guides, quick reference guides, etc). Without these, a car is not finished, and cannot be shipped or sold. When supporting one of the biggest auto manufacturers in the world meant migrating to DITA, a solution that supported publishing had to work right. It had to work the first time, and every time.
Learn about the journey and discovery of concerns, project scope definition and change, trials and tribulations of getting tools to do what was needed, and the net results. Along the way, a component content management system, authoring tools, review processes, and much more had to be planned, tested, implemented, and supported.
Takeaways:
• Attendees should be able to clearly see what worked, what didn’t, learn why, and avoid similar pitfalls in their path to structured content.
• Identify how a tight time frame, expectations vs reality, last minute changes, and many late nights culminated into results that showcase the best and worst of tech comm and related tools and processes.
• Discover an automated publishing solution, where one source of content is transformed to multiple channels and uploaded to a CCMS.
Give in to the power of the Dark Side: Tech Comm and Marketing are ConvergingPublishing Smarter
Video: https://youtu.be/AXPG_d-XiZk
We’ve come to think of it like this: content is content. Marketing and technical communications are generated for the same end users at different points in the product adoption life-cycle. The distinction between marketing communications and technical communications is far less pronounced than it once was. Managers sometimes see little difference in skill-sets and often put content creators together in one role or department – and maybe they’re right. During our careers we’re often dealing with a lot of technical content but also creating marketing communications; we’re in a good position to see how very little difference there might be between them. They’re both an always-on dialogue with the user, just at different points in the product adoption life-cycle. We’ll explore the audiences who consume content, ideas related to a seamless content experience, how both training and support factor into this, and talk about implementation ideas.
Make It All About Your Audience (Deliver What They Want, How They Want, When ...Publishing Smarter
It’s all about the audience and we hear that all the time. Know your audience. Articles and discussions abound about the informed consumer, audience metrics, and personas. How do you actually organize and create content geared to multiple audiences?
Learn tips and techniques for planning, writing, and publishing which help you deliver the right information, to the right audience, in the right format, at the right time, and let them make the right decisions.
DITA can help both marketing and technical communications teams connect with customers. In a non-technical way, this slide deck (and the associated presentation) shows how and why it matters to connect with your customer using all the tools at your command.
Text-rich, illustration-heavy, table-filled, overly-hyphenated manuals and docs sit on the shelf and never get read.
Today, we read information in the format we want, on whatever device we want, and with just enough information to support what we need to do.
Learn more about topic-based writing, what it is and what it can do for your approach to documentation.
Any device, any time, any format.
Information on business models in Canada, and some background on considerations when starting a business in Alberta. Focus is on general ideas, but details about one tech comm business addressed specifically in the session.
When creating technical documentation it's good to know how long it will take. This presentation (delivered to the STC in Calgary Alberta) explores estimating such projects as well as an overview of the estimating process.
Metrics that matter Making the business case that documentation has valuePublishing Smarter
Tell the story around content as a business asset. We agree there is value in documentation but have been challenged at times to “prove it”. Present to groups including sales, support, service, IT, engineering, QA/testing, manufacturing, HR, training, finance, marketing, and every other business unit in your organization. Demonstrate how documentation drives sales and generates corporate revenue to managers and executives helping them see how important documentation is to them
Metrics that matter: Making the business case that documentation has valuePublishing Smarter
Presented at STC16 Summit in Anaheim, follow a case study in which a product launch was positively impacted by good planning around documentation early in the project.
Metrics that matter: Making the business case that documentation has value (r...Publishing Smarter
Tell the story around content as a business asset. We agree there is value in documentation but have been challenged at times to “prove it”. Present to groups including sales, support, service, IT, engineering, QA/testing, manufacturing, HR, training, finance, marketing, and every other business unit in your organization. Demonstrate how documentation drives sales and generates corporate revenue to managers and executives helping them see how important documentation is to them.
Metrics that matter: Making the business case that documentation has valuePublishing Smarter
Presented at CMS/DITA North America 2016 to help people tell the story around content as a business asset. We agree there is value in documentation but have been challenged at times to “prove it”. Demo of how to present to groups including sales, support, service, IT, engineering, QA/testing, manufacturing, HR, training, finance, marketing, and every other business unit in your organization. Discussion on how documentation drives sales and generates corporate revenue to managers and executives helping them see how important documentation is to them.
Accelerate your Kubernetes clusters with Varnish CachingThijs Feryn
A presentation about the usage and availability of Varnish on Kubernetes. This talk explores the capabilities of Varnish caching and shows how to use the Varnish Helm chart to deploy it to Kubernetes.
This presentation was delivered at K8SUG Singapore. See https://feryn.eu/presentations/accelerate-your-kubernetes-clusters-with-varnish-caching-k8sug-singapore-28-2024 for more details.
GDG Cloud Southlake #33: Boule & Rebala: Effective AppSec in SDLC using Deplo...James Anderson
Effective Application Security in Software Delivery lifecycle using Deployment Firewall and DBOM
The modern software delivery process (or the CI/CD process) includes many tools, distributed teams, open-source code, and cloud platforms. Constant focus on speed to release software to market, along with the traditional slow and manual security checks has caused gaps in continuous security as an important piece in the software supply chain. Today organizations feel more susceptible to external and internal cyber threats due to the vast attack surface in their applications supply chain and the lack of end-to-end governance and risk management.
The software team must secure its software delivery process to avoid vulnerability and security breaches. This needs to be achieved with existing tool chains and without extensive rework of the delivery processes. This talk will present strategies and techniques for providing visibility into the true risk of the existing vulnerabilities, preventing the introduction of security issues in the software, resolving vulnerabilities in production environments quickly, and capturing the deployment bill of materials (DBOM).
Speakers:
Bob Boule
Robert Boule is a technology enthusiast with PASSION for technology and making things work along with a knack for helping others understand how things work. He comes with around 20 years of solution engineering experience in application security, software continuous delivery, and SaaS platforms. He is known for his dynamic presentations in CI/CD and application security integrated in software delivery lifecycle.
Gopinath Rebala
Gopinath Rebala is the CTO of OpsMx, where he has overall responsibility for the machine learning and data processing architectures for Secure Software Delivery. Gopi also has a strong connection with our customers, leading design and architecture for strategic implementations. Gopi is a frequent speaker and well-known leader in continuous delivery and integrating security into software delivery.
GraphRAG is All You need? LLM & Knowledge GraphGuy Korland
Guy Korland, CEO and Co-founder of FalkorDB, will review two articles on the integration of language models with knowledge graphs.
1. Unifying Large Language Models and Knowledge Graphs: A Roadmap.
https://arxiv.org/abs/2306.08302
2. Microsoft Research's GraphRAG paper and a review paper on various uses of knowledge graphs:
https://www.microsoft.com/en-us/research/blog/graphrag-unlocking-llm-discovery-on-narrative-private-data/
Kubernetes & AI - Beauty and the Beast !?! @KCD Istanbul 2024Tobias Schneck
As AI technology is pushing into IT I was wondering myself, as an “infrastructure container kubernetes guy”, how get this fancy AI technology get managed from an infrastructure operational view? Is it possible to apply our lovely cloud native principals as well? What benefit’s both technologies could bring to each other?
Let me take this questions and provide you a short journey through existing deployment models and use cases for AI software. On practical examples, we discuss what cloud/on-premise strategy we may need for applying it to our own infrastructure to get it to work from an enterprise perspective. I want to give an overview about infrastructure requirements and technologies, what could be beneficial or limiting your AI use cases in an enterprise environment. An interactive Demo will give you some insides, what approaches I got already working for real.
Connector Corner: Automate dynamic content and events by pushing a buttonDianaGray10
Here is something new! In our next Connector Corner webinar, we will demonstrate how you can use a single workflow to:
Create a campaign using Mailchimp with merge tags/fields
Send an interactive Slack channel message (using buttons)
Have the message received by managers and peers along with a test email for review
But there’s more:
In a second workflow supporting the same use case, you’ll see:
Your campaign sent to target colleagues for approval
If the “Approve” button is clicked, a Jira/Zendesk ticket is created for the marketing design team
But—if the “Reject” button is pushed, colleagues will be alerted via Slack message
Join us to learn more about this new, human-in-the-loop capability, brought to you by Integration Service connectors.
And...
Speakers:
Akshay Agnihotri, Product Manager
Charlie Greenberg, Host
Slack (or Teams) Automation for Bonterra Impact Management (fka Social Soluti...Jeffrey Haguewood
Sidekick Solutions uses Bonterra Impact Management (fka Social Solutions Apricot) and automation solutions to integrate data for business workflows.
We believe integration and automation are essential to user experience and the promise of efficient work through technology. Automation is the critical ingredient to realizing that full vision. We develop integration products and services for Bonterra Case Management software to support the deployment of automations for a variety of use cases.
This video focuses on the notifications, alerts, and approval requests using Slack for Bonterra Impact Management. The solutions covered in this webinar can also be deployed for Microsoft Teams.
Interested in deploying notification automations for Bonterra Impact Management? Contact us at sales@sidekicksolutionsllc.com to discuss next steps.
State of ICS and IoT Cyber Threat Landscape Report 2024 previewPrayukth K V
The IoT and OT threat landscape report has been prepared by the Threat Research Team at Sectrio using data from Sectrio, cyber threat intelligence farming facilities spread across over 85 cities around the world. In addition, Sectrio also runs AI-based advanced threat and payload engagement facilities that serve as sinks to attract and engage sophisticated threat actors, and newer malware including new variants and latent threats that are at an earlier stage of development.
The latest edition of the OT/ICS and IoT security Threat Landscape Report 2024 also covers:
State of global ICS asset and network exposure
Sectoral targets and attacks as well as the cost of ransom
Global APT activity, AI usage, actor and tactic profiles, and implications
Rise in volumes of AI-powered cyberattacks
Major cyber events in 2024
Malware and malicious payload trends
Cyberattack types and targets
Vulnerability exploit attempts on CVEs
Attacks on counties – USA
Expansion of bot farms – how, where, and why
In-depth analysis of the cyber threat landscape across North America, South America, Europe, APAC, and the Middle East
Why are attacks on smart factories rising?
Cyber risk predictions
Axis of attacks – Europe
Systemic attacks in the Middle East
Download the full report from here:
https://sectrio.com/resources/ot-threat-landscape-reports/sectrio-releases-ot-ics-and-iot-security-threat-landscape-report-2024/
Securing your Kubernetes cluster_ a step-by-step guide to success !KatiaHIMEUR1
Today, after several years of existence, an extremely active community and an ultra-dynamic ecosystem, Kubernetes has established itself as the de facto standard in container orchestration. Thanks to a wide range of managed services, it has never been so easy to set up a ready-to-use Kubernetes cluster.
However, this ease of use means that the subject of security in Kubernetes is often left for later, or even neglected. This exposes companies to significant risks.
In this talk, I'll show you step-by-step how to secure your Kubernetes cluster for greater peace of mind and reliability.
Generating a custom Ruby SDK for your web service or Rails API using Smithyg2nightmarescribd
Have you ever wanted a Ruby client API to communicate with your web service? Smithy is a protocol-agnostic language for defining services and SDKs. Smithy Ruby is an implementation of Smithy that generates a Ruby SDK using a Smithy model. In this talk, we will explore Smithy and Smithy Ruby to learn how to generate custom feature-rich SDKs that can communicate with any web service, such as a Rails JSON API.
Builder.ai Founder Sachin Dev Duggal's Strategic Approach to Create an Innova...Ramesh Iyer
In today's fast-changing business world, Companies that adapt and embrace new ideas often need help to keep up with the competition. However, fostering a culture of innovation takes much work. It takes vision, leadership and willingness to take risks in the right proportion. Sachin Dev Duggal, co-founder of Builder.ai, has perfected the art of this balance, creating a company culture where creativity and growth are nurtured at each stage.
Neuro-symbolic is not enough, we need neuro-*semantic*Frank van Harmelen
Neuro-symbolic (NeSy) AI is on the rise. However, simply machine learning on just any symbolic structure is not sufficient to really harvest the gains of NeSy. These will only be gained when the symbolic structures have an actual semantics. I give an operational definition of semantics as “predictable inference”.
All of this illustrated with link prediction over knowledge graphs, but the argument is general.
Transcript: Selling digital books in 2024: Insights from industry leaders - T...BookNet Canada
The publishing industry has been selling digital audiobooks and ebooks for over a decade and has found its groove. What’s changed? What has stayed the same? Where do we go from here? Join a group of leading sales peers from across the industry for a conversation about the lessons learned since the popularization of digital books, best practices, digital book supply chain management, and more.
Link to video recording: https://bnctechforum.ca/sessions/selling-digital-books-in-2024-insights-from-industry-leaders/
Presented by BookNet Canada on May 28, 2024, with support from the Department of Canadian Heritage.
Essentials of Automations: Optimizing FME Workflows with ParametersSafe Software
Are you looking to streamline your workflows and boost your projects’ efficiency? Do you find yourself searching for ways to add flexibility and control over your FME workflows? If so, you’re in the right place.
Join us for an insightful dive into the world of FME parameters, a critical element in optimizing workflow efficiency. This webinar marks the beginning of our three-part “Essentials of Automation” series. This first webinar is designed to equip you with the knowledge and skills to utilize parameters effectively: enhancing the flexibility, maintainability, and user control of your FME projects.
Here’s what you’ll gain:
- Essentials of FME Parameters: Understand the pivotal role of parameters, including Reader/Writer, Transformer, User, and FME Flow categories. Discover how they are the key to unlocking automation and optimization within your workflows.
- Practical Applications in FME Form: Delve into key user parameter types including choice, connections, and file URLs. Allow users to control how a workflow runs, making your workflows more reusable. Learn to import values and deliver the best user experience for your workflows while enhancing accuracy.
- Optimization Strategies in FME Flow: Explore the creation and strategic deployment of parameters in FME Flow, including the use of deployment and geometry parameters, to maximize workflow efficiency.
- Pro Tips for Success: Gain insights on parameterizing connections and leveraging new features like Conditional Visibility for clarity and simplicity.
We’ll wrap up with a glimpse into future webinars, followed by a Q&A session to address your specific questions surrounding this topic.
Don’t miss this opportunity to elevate your FME expertise and drive your projects to new heights of efficiency.
2. Migrating Word to FrameMaker to Structure
14:04@aschwanden4stc #stc19
2
Word is great when you have content that is managed by
SharePoint, or based on standard and highly-enforced
templates, or you have a team of developers to support
your team of writers. However, there are too many ways
for too many people to cause too many problems. Style
overrides, manual formats, or just incorrect use of a
template can haunt good content. You spend time and
effort to make content great; now put a little bit more time
into getting to know a tool that isn’t created for everyone.
It’s created for those of us who work in technical
communication. It’s time for Adobe FrameMaker.
3. Overall Objectives
14:33@aschwanden4stc #stc19
3
Evaluate a Word document for content quality
Rework content for a topic-based model
Import a Word file to Adobe FrameMaker
Create a structured workflow
Migrate legacy content to a structured format
Move your content to a CCMS
Publish single sourced content to multiple channels,
formats & devices
4. Rule 1: Know your audience
14:33@aschwanden4stc #stc19
4
Why are you here? (A bit of a “show of hands”)
Free certificate that I can use to get a raise at work?
Here because “my boss made me do it”?
Here because migrating to structure is something you
Are just starting to talk about?
Want to do in the next 6 to 12 months?
Love it more than almost anything else on earth and you need it yesterday?
Prerequisite is a basic familiarity with content creation
Who is planning to “play along” as we do the work?
5. Housekeeping and note taking
14:37@aschwanden4stc #stc19
Not all slides or topics are
equally weighted
Use some, discard others
Slides speed varies (reference)
Questions? Ask along the way!
I’d love to claim errors/typos is
on purpose… they isn’t,
weren’t never, and ain’t; I’ll fix
‘em as I can…
Tweet using @AdobeTCS and
@aschwanden4stc
Reference #stc19
5
6. About your speaker
14:37@aschwanden4stc #stc19
Publishing Smarter: President
Content strategist, publishing
technologies expert, author,
and geek-enough
Certified Technical Trainer
FrameMaker
Content management
Topic-based writing
Structured content (includes
DITA)
Society for Technical
Communications
Past President
STC Associate Fellow
6
7. Standard disclaimer
14:38@aschwanden4stc #stc19
In the interest of brevity I
will make some blanket
statements to keep it simple
It’s not all 100% “the truth”,
but I’ll stay close
Purists may complain
And they are wrong!
(except when they are right)
A lot of slides to guide us,
plus hands-on work
7
8. Some stuff you know, some tech you
may not, and some hands on work
Go ahead, launch Word now…
@aschwanden4stc #stc19 14:40
8
Evaluate a Word Document
9. We created 3 documents to quickly demo ideas
14:40@aschwanden4stc #stc19
9
10. Mix and match: Sample 1—Poor styles
14:42@aschwanden4stc #stc19
10
16. Before we go further
14:03@aschwanden4stc #stc19
16
Do you know if your content is well styled? (If so, how?)
Do you think that there may be:
Format overrides (to make that paragraph fit on a line, or the word
stand out, or the content fit on a page)
Empty paragraphs (or even empty spaces that may have style info)
A mix of manual and programmed references (see X on page #)
Manual and automated numbering mixed together
Content copied/pasted from other documents
If so, then content may be a risk for conversion
17. Let’s talk about the *.docx extension
14:03@aschwanden4stc #stc19
It’s actually XML
You can “unzip” DOCX
Creates folders including
the /word folder
document.xml
styles.xml
/media
Each XML has info
The document.xml is info
about the content including
overrides to formats
The styles.xml is the actual
set of default styles that exist
The media folder contains,
amongst other things, images
17
18. The process (defaults in Windows, no magic)
14:03@aschwanden4stc #stc19
1. Create a *.docx file
2. Make a copy of it
3. Rename the copy to *.zip
4. Extract the zip file
5. Review content
We’ll look at the
document.xml file and
discuss the styles.xml
briefly.
18
19. document.xml from a good doc
14:03@aschwanden4stc #stc19
19
<w:p w:rsidR="003754B0" w:rsidRDefault="00391015"
w:rsidP="003754B0">
<w:pPr>
<w:pStyle w:val="Title"/>
</w:pPr>
<w:r>
<w:t>Prepping a Word Document for
Structure</w:t>
</w:r>
</w:p>
20. document.xml from a mixed doc
14:03@aschwanden4stc #stc19
20
<w:p w:rsidR="003754B0" w:rsidRDefault="00615507"
w:rsidP="00A3480A">
<w:pPr>
<w:pStyle w:val="Title"/>
<w:jc w:val="center"/>
</w:pPr>
<w:r>
<w:t>Prepping a Word Document:
Mixed</w:t>
</w:r>
</w:p>
25. What this means for you
14:03@aschwanden4stc #stc19
25
You can create Word files with or without overrides
You can create a zip and extract/analyze the XML
Look for things like:
w:pStyle
w:style w:type="character“
w:style w:type=“table“
w:p (this is the default “Normal” tag)
Reference the Microsoft materials and other content for details
Get Hands On: Let’s create a Word file now
Launch Word and File > New to create a generic file
26. The goal is to build this (Details follow)
14:03@aschwanden4stc #stc19
26
27. Initial content to write (no format, just text)
14:03@aschwanden4stc #stc19
27
Moving to structured content¶
The move to structured content is gaining a lot of traction.¶
There are many reasons, including:¶
Working with large volumes of content¶
Managing complex numbering systems¶
Meeting online or print design and layout requirements¶
Publishing to Responsive HTML5 (plus apps, ebooks, and
PDF), or¶
Other reasons to retire just a word processor and use a
professional communications tool!
28. Next steps (add formats)
14:03@aschwanden4stc #stc19
28
Moving to structured content [Assign Title, +Center Button]
The move to structured content is gaining a lot of traction. There
are many reasons, including: [Make 2 words Emphasis]
Working with large volumes of content
Managing complex numbering systems
Meeting online or print design and
layout requirements
Publishing to Responsive HTML5
(plus apps, ebooks, and PDF), or
Other reasons to retire just a word processor and use a
professional communications tool!
[Make the rest of the
paragraphs bulleted;
select them all, then
click the toolbar icon]
29. Save the file as“MoveToStructure.docx”
14:03@aschwanden4stc #stc19
29
Title paragraph
(+manual center)
“Normal” paragraph
with 2 words in
Emphasis
Collection of bullets
(using the toolbar icon)
30. Behind the scenes (the XML you could extract)
14:03@aschwanden4stc #stc19
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<w:document xmlns:ve="http://schemas.openxmlformats.org/markup-compatibility/2006"
xmlns:o="urn:schemas-microsoft-com:office:office"
xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"
xmlns:m="http://schemas.openxmlformats.org/officeDocument/2006/math"
xmlns:v="urn:schemas-microsoft-com:vml"
xmlns:wp="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing"
xmlns:w10="urn:schemas-microsoft-com:office:word"
xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main"
xmlns:wne="http://schemas.microsoft.com/office/word/2006/wordml">
<w:body>
<w:p w:rsidR="008E34F2" w:rsidRDefault="00AA6835" w:rsidP="00A801F8">
<w:pPr>
<w:pStyle w:val="Title"/>
<w:jc w:val="center"/>
</w:pPr>
<w:r>
<w:t xml:space="preserve">Moving to structured </w:t>
</w:r>
<w:r w:rsidR="00A801F8">
<w:t>content</w:t>
</w:r>
</w:p>
<w:p w:rsidR="00AA6835" w:rsidRDefault="00AA6835" w:rsidP="00AA6835">
<w:r>
<w:t xml:space="preserve">The move to </w:t>
</w:r>
<w:r w:rsidRPr="00AA6835">
<w:rPr>
<w:rStyle w:val="Emphasis"/>
</w:rPr>
<w:t>structured content</w:t>
</w:r>
<w:r>
<w:t xml:space="preserve"> is gaining a lot of traction. There are many reasons, including:</w:t>
</w:r>
</w:p>
<w:p w:rsidR="00AA6835" w:rsidRDefault="00AA6835" w:rsidP="00AA6835">
<w:pPr>
<w:pStyle w:val="ListParagraph"/>
<w:numPr>
<w:ilvl w:val="0"/>
<w:numId w:val="1"/>
</w:numPr>
</w:pPr>
<w:r>
<w:t>Working with large volumes of content</w:t>
</w:r>
</w:p>
<w:p w:rsidR="00AA6835" w:rsidRDefault="00AA6835" w:rsidP="00AA6835">
<w:pPr>
<w:pStyle w:val="ListParagraph"/>
<w:numPr>
<w:ilvl w:val="0"/>
<w:numId w:val="1"/>
</w:numPr>
</w:pPr>
<w:r>
<w:t>Managing complex numbering systems</w:t>
</w:r>
</w:p>
<w:p w:rsidR="00AA6835" w:rsidRDefault="00AA6835" w:rsidP="00AA6835">
<w:pPr>
<w:pStyle w:val="ListParagraph"/>
<w:numPr>
<w:ilvl w:val="0"/>
<w:numId w:val="1"/>
</w:numPr>
</w:pPr>
<w:r>
<w:t>Meeting online or print design and layout requirements</w:t>
</w:r>
</w:p>
<w:p w:rsidR="00AA6835" w:rsidRDefault="00AA6835" w:rsidP="00AA6835">
<w:pPr>
<w:pStyle w:val="ListParagraph"/>
<w:numPr>
<w:ilvl w:val="0"/>
<w:numId w:val="1"/>
</w:numPr>
</w:pPr>
<w:r>
<w:t xml:space="preserve">Publishing to Responsive HTML5 (plus apps, </w:t>
</w:r>
<w:proofErr w:type="spellStart"/>
<w:r>
<w:t>ebooks</w:t>
</w:r>
<w:proofErr w:type="spellEnd"/>
<w:r>
<w:t>, and PDF), or</w:t>
</w:r>
</w:p>
<w:p w:rsidR="00AA6835" w:rsidRPr="00AA6835" w:rsidRDefault="00AA6835" w:rsidP="00AA6835">
<w:pPr>
<w:pStyle w:val="ListParagraph"/>
<w:numPr>
<w:ilvl w:val="0"/>
<w:numId w:val="1"/>
</w:numPr>
</w:pPr>
<w:r>
<w:t>Other reasons to retire just a word processor and use a professional communications tool!</w:t>
</w:r>
</w:p>
<w:sectPr w:rsidR="00AA6835" w:rsidRPr="00AA6835" w:rsidSect="008E34F2">
<w:pgSz w:w="12240" w:h="15840"/>
<w:pgMar w:top="1440" w:right="1440" w:bottom="1440" w:left="1440" w:header="720"
w:footer="720" w:gutter="0"/>
<w:cols w:space="720"/>
<w:docGrid w:linePitch="360"/>
</w:sectPr>
</w:body>
</w:document>
30
31. The details you may care about…
14:04@aschwanden4stc #stc19
<w:body>
<w:p w:rsidR="008E34F2"
w:rsidRDefault="00AA6835" w:rsidP="00A801F8">
<w:pPr>
<w:pStyle w:val="Title"/>
<w:jc w:val="center"/>
</w:pPr>
<w:r>
<w:t xml:space="preserve">Moving to structured
</w:t>
</w:r>
<w:r w:rsidR="00A801F8">
<w:t>content</w:t>
</w:r>
</w:p>
<w:p w:rsidR="00AA6835"
w:rsidRDefault="00AA6835"
w:rsidP="00AA6835">
<w:r>
<w:t xml:space="preserve">The move to </w:t>
</w:r>
<w:r w:rsidRPr="00AA6835">
<w:rPr>
<w:rStyle w:val="Emphasis"/>
</w:rPr>
<w:t>structured content</w:t>
</w:r>
<w:r>
<w:t xml:space="preserve"> is gaining a lot of
traction. There are many reasons, including:</w:t>
</w:r>
</w:p>
<w:p w:rsidR="00AA6835"
w:rsidRDefault="00AA6835" w:rsidP="00AA6835">
<w:pPr>
<w:pStyle w:val="ListParagraph"/>
<w:numPr>
<w:ilvl w:val="0"/>
<w:numId w:val="1"/>
</w:numPr>
</w:pPr>
<w:r>
<w:t>Working with large volumes of
content</w:t>
</w:r>
</w:p>
31
32. Diving deeper
/* Get Word DOCX Statistics
// Prompt for Word files.
// Set up an output file.
// Get the files to process.
// Process all files.
// Write the file statistics
// Append the field list
// Get the number of pages.
// Add tables's style data
// Generate the report
// Format it all for Excel
Remember our 3 Word files?
We decided to go explore them
Using our own tools we converted
each of the three “sources” to XML
We can ID what is in the XML
Consolidate info into a spreadsheet
Can be done file by file
We ended up automating it
32
14:56@aschwanden4stc #stc19
37. The details are scary (but less so in the good)
14:59@aschwanden4stc #stc19
37
38. Content cleanup tips
14:59@aschwanden4stc #stc19
38
We can find very detailed issues
Track them down
Fix them “one-by-one” or ID when it makes sense to do it
programmatically
The tricky part kicks in with larger doc sets
Hundreds, or even 1000s of source Word documents
40. Once you know the volume and types of issues
15:00@aschwanden4stc #stc19
40
41. Legacy content review
15:01@aschwanden4stc #stc19
41
Please feel free to ask me about your own content later on
bernard@publishingsmarter.com
ENSURE YOU CAN ACTUALLY SHARE IT (legal/NDA)
I’m also at the Adobe booth for the conference
Mention the STC conference and the Adobe workshop
42. Making the move to modular topics
may mean rewriting legacy content
@aschwanden4stc #stc19 15:02
42
Rework content for a
topic-based model
43. Modular means:
Pieces of information must
make sense without context
Pieces of information can
be moved around
Context may or may not
bring extra meaning to
individual pieces
15:03
43
@aschwanden4stc #stc19
44. Benefits of topic-based content for users
15:04@aschwanden4stc #stc19
44
Read what you want
Read in the order you want
Common layout makes it fast to scan and find content
(beyond search)
Right information, right format, right time
Information is in topic types, each with a purpose
Task: How to complete a goal
Concept: Why a goal is worth achieving, or what it is
Reference: Quick lookup or guide to technical specs
45. Review your materials for nested content
15:05@aschwanden4stc #stc19
45
Learning’s complex enough
Use titles that relate to the goal of a
user
Don’t nest additional steps or tasks
Rework content into clear topics
Saving
1. Select File > Save As
The Save dialog appears.
2. Select a location
3. If required, create a folder
a) Click New Folder
A new folder is created
b) Type a name for the folder
c) Press Enter
4. Choose a file format
RTF: Rich Text Format
DOC: Microsoft Word document
FM: Adobe FrameMaker file
5. Name the file and click Save.
46. Save a file Create folders to organize files
1. Select File > Save As
2. Select a location
3. Choose a file format
4. Name the file
5. Click Save
1. Click New Folder
2. Type a name for the folder
3. Press Enter
Much better would be
15:06@aschwanden4stc #stc19
46
47. Darwin Information Typing Architecture
DITA is about Topic, Maps, Specializations
Some common topic types include
concept
reference
task
glossary
bookmap and map
15:07@aschwanden4stc #stc19
47
DITA supports topic-based content
DITA Information Types
Topic–Concept–Task–Reference
48. Types of topics
15:07@aschwanden4stc #stc19
48
Tasks: Start with tasks (Users don’t want to
learn about something unless they have to)
What does the user need to do? Identify those and
then write how they do it.
Concepts: Supporting info for a task
In many cases, concepts can provide a clear
conceptual model that is lacking in a task. Used to
orient the users.
References: Quick look up; no procedures,
no conceptual information
49. Work with images: Text heavy, mixed source
15:08@aschwanden4stc #stc19
It has been said a picture is worth
1000 words. If this is true, it
makes sense to use images to
show ideas, visualize things, or to
add life to dry text. You can add
images in supported formats to
web pages.
To insert images first select
where you want in on your web
page. Choose Insert in the Image
menu. There are many image
formats supported (web formats),
and since pictures draw the eye
to a specific location, you may
want to add maps or charts.
If maps or charts are used they
can visually explain ideas that
may take many pages to write
about. They can even make
content feel more alive, so if it
makes sense, add them to reports
to accentuate an idea that
matters.
Once you know the format you
need, select a file location and
click Map or Chart if needed. We
support jpg, gif, png, svg (and we
convert Illustrator or Photoshop
too!). Click on a file, then Insert.
49
50. ID the task / concept / reference?
15:09@aschwanden4stc #stc19
It has been said a picture is worth
1000 words. If this is true, it
makes sense to use images to
show ideas, visualize things, or to
add life to dry text. You can add
images in supported formats to
web pages.
To insert images first select
where you want in on your web
page. Choose Insert in the Image
menu. There are many image
formats supported (web formats),
and since pictures draw the eye
to a specific location, you may
want to add maps or charts.
If maps or charts are used they
can visually explain ideas that
may take many pages to write
about. They can even make
content feel more alive, so if it
makes sense, add them to reports
to accentuate an idea that
matters.
Once you know the format you
need, select a file location and
click Map or Chart if needed. We
support jpg, gif, png, svg (and we
convert Illustrator or Photoshop
too!). Click on a file, then Insert.
50
51. Remember: Tasks come first
15:10@aschwanden4stc #stc19
It has been said a picture is worth
1000 words. If this is true, it
makes sense to use images to
show ideas, visualize things, or to
add life to dry text. You can add
images in supported formats to
web pages.
To insert images first select
where you want in on your web
page. Choose Insert in the Image
menu. There are many image
formats supported (web formats),
and since pictures draw the eye
to a specific location, you may
want to add maps or charts.
If maps or charts are used they
can visually explain ideas that
may take many pages to write
about. They can even make
content feel more alive, so if it
makes sense, add them to reports
to accentuate an idea that
matters.
Once you know the format you
need, select a file location and
click Map or Chart if needed. We
support jpg, gif, png, svg (and we
convert Illustrator or Photoshop
too!). Click on a file, then Insert.
51
52. Repeat for concepts
15:10@aschwanden4stc #stc19
It has been said a picture is worth
1000 words. If this is true, it
makes sense to use images to
show ideas, visualize things, or to
add life to dry text. You can add
images in supported formats to
web pages.
To insert images first select
where you want in on your web
page. Choose Insert in the Image
menu. There are many image
formats supported (web formats),
and since pictures draw the eye
to a specific location, you may
want to add maps or charts.
If maps or charts are used they
can visually explain ideas that
may take many pages to write
about. They can even make
content feel more alive, so if it
makes sense, add them to reports
to accentuate an idea that
matters.
Once you know the format you
need, select a file location and
click Map or Chart if needed. We
support jpg, gif, png, svg (and we
convert Illustrator or Photoshop
too!). Click on a file, then Insert.
52
53. And for references
15:10@aschwanden4stc #stc19
It has been said a picture is worth
1000 words. If this is true, it
makes sense to use images to
show ideas, visualize things, or to
add life to dry text. You can add
images in supported formats to
web pages.
To insert images first select
where you want in on your web
page. Choose Insert in the Image
menu. There are many image
formats supported (web formats),
and since pictures draw the eye
to a specific location, you may
want to add maps or charts.
If maps or charts are used they
can visually explain ideas that
may take many pages to write
about. They can even make
content feel more alive, so if it
makes sense, add them to reports
to accentuate an idea that
matters.
Once you know the format you
need, select a file location and
click Map or Chart if needed. We
support jpg, gif, png, svg (and we
convert Illustrator or Photoshop
too!). Click on a file, then Insert.
53
55. Now, the task title reads: Import pictures
15:11@aschwanden4stc #stc19
55
Images, maps, and charts can be added to web
pages.
Prereq: Ensure graphics are in a supported
web-friendly file format.
1. Select the location to insert an image.
2. Select Image > Insert.
If inserting a Map or Chart, specify this.
3. Select a folder location.
4. Select a file.
5. Click Insert.
6. Configure the image as needed.
56. Concept title: Reasons to use pictures
15:11@aschwanden4stc #stc19
56
It has been said a picture is worth 1000 words;
use images to show ideas, visualize complex
ideas, or to add life to dry text.
Pictures draw the eye to a specific location. If
maps or charts are used they can graphically
explain an idea that may take many pages to
write about. They can even make content feel
more alive, so if it makes sense, add them to
reports to accentuate an idea that matters.
57. Reference title: Supported image formats
15:11@aschwanden4stc #stc19
57
Graphic types, how they are used, and
background information.
Format Function Notes
.jpg Raster based
images displayed
online (web).
Our conversion tools allow
multiple options, test for best
compatibility.
.gif
.png
.svg Vector based
images displayed
online (web)
Our conversion tools allow
multiple options, test for best
compatibility.
.ps Adobe Photoshop Raster based source.
.ai Adobe Illustrator Vector based source.
58. Remember: Styles are your friends
@aschwanden4stc #stc19 15:11
58
Import a Word file to FrameMaker
59. Importing Word to FrameMaker
15:12@aschwanden4stc #stc19
Styles can be mapped
Once mapped, save it
Import one or more *.docx
Results vary
Better results
Better styles in the source
Better use of the styles
Poorer results
Poor use of styles
Misuse of styles
59
63. Importing our Word document
15:14@aschwanden4stc #stc19
1. Launch FrameMaker
2. Select File > New >
Document, then Portrait
3. Select File > Import > File
4. At the bottom, click
Copy Into Document
5. Find/select the Word
source
6. Import the document
7. Confirm message dialogs
63
64. Configure the import
15:15@aschwanden4stc #stc19
64
FrameMaker scans the Word source document
If styles in Word match tags in FrameMaker they are
automatically mapped for you
If they do NOT then you can map them via a visual
interface
Character format and table format conversion can be done
Advanced settings allow for further cleanup
You can even save your settings
Demo: Configure the dialog as seen on the next slide
76. Our imported Word source can be
converted to structured, DITA-ready
content with a bit of setup
@aschwanden4stc #stc19 15:31
76
From Legacy to Structure
77. Big picture for conversion
15:34@aschwanden4stc #stc19
77
Any content in FrameMaker can be converted
The more complex the content, the tougher the setup
We have a basic document
Title paragraph
Body paragraph
Bulleted paragraphs
Emphasis character format
Our conversion table basics are just that… Basics
81. Generate a New Conversion Table
15:37@aschwanden4stc #stc19
81
82. A bit of detail on the columns
15:37@aschwanden4stc #stc19
82
Wrap this object or objects In this element With this qualifier
P:Title Title
P:Body Body
P:Bulleted Bulleted
C:Emphasis Emphasis
When a P (paragraph) or C
(character) with a name is
found...
...take that tagged
content and wrap it
into a named element
84. Update to names DITA likes
15:39@aschwanden4stc #stc19
84
Wrap this object or objects In this element With this qualifier
P:Title title
P:Body p
P:Bulleted li
C:Emphasis i
85. Nest elements
15:39@aschwanden4stc #stc19
85
Wrap this object or objects In this element With this qualifier
P:Title title
P:Body p
P:Bulleted li
C:Emphasis i
E:li+ ul
(E:p | E:ul)+ conbody
E:title, E:conbody concept
86. Apply the Conversion Table
15:40@aschwanden4stc #stc19
1. Go to MoveToStructure
2. Structure > Utilities >
Structure Current Doc
3. Choose the CT file
4. Click Add Structure
5. Click OK
6. Review the structure
86
87. Once converted to structure (and based on DITA)
15:43@aschwanden4stc #stc19
The content could be
copied into a DITA concept
Once there, a bit of minor
cleanup
For example, you may choose
to click View menu and show
or hide boundaries to dive in
deeper, or change attribute
display options
May want to “right-click” the
concept element and assign
an ID
Regardless of additional
changes, the core of the
conversion is complete
The file can quickly be
converted to DITA
If the source has more
paragraphs or bullets
added, re-run the CT
If more objects are added,
the CT needs more dev
87
88. Good Word, when mapped, may import as…
15:45@aschwanden4stc #stc19
88
93. Live? Video? Slides?
15:48@aschwanden4stc #stc19
93
Going to try it live because…
I’m an idiot?
Hotel networks are 100% reliable and fast?
I tested this extensively?
If it WON’T play nice I have a backup in Captivate
Let’s go…
94. PDF, HTML5, and other formats
@aschwanden4stc #stc19 15:48
94
Publishing
101. Summary and next steps
@aschwanden4stc #stc19 15:54
101
Conclusion
102. In about 75 minutes we did this:
15:54@aschwanden4stc #stc19
102
Evaluate a Word document for content quality
Rework content for a topic-based model
Import a Word file to Adobe FrameMaker
Create a structured workflow
Migrate legacy content to a structured format
Move your content to a CCMS
Publish single sourced content to multiple channels,
formats & devices
103. Download the whitepaper Watch the videos
16:48@aschwanden4stc #stc19
103
https://tinyurl.com/PS-YouTube-FM-Structure
https://tinyurl.com/PS-Adobe-Structure-Migration