Top Banner
Bernard Aschwanden www.publishingsmarter.com [email protected] FrameMaker XML Author 2015 Content Contributors Toolkit 12:06 1 @publishsmarter
49

FrameMaker XML Author Toolkit

Jan 15, 2017

Download

Business

Welcome message from author
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
Page 1: FrameMaker XML Author Toolkit

21:08

Bernard Aschwanden

www.publishingsmarter.com

[email protected]

FrameMaker XML Author 2015

Content Contributors Toolkit1

@publishsmarter

Page 2: FrameMaker XML Author Toolkit

21:08@publishsmarter

2

About this session

Adobe FrameMaker XML Author (2015 release) enables both authors and subject matter experts to easily contribute DITA compliant content without knowing XML.

An intuitive UI, multiple views, MathML equation support, and new DITA 1.3 support make it easier than ever before to get all content contributors in an enterprise on board for DITA while keeping the budget low.

Author DITA compliant content as a subject matter expert in several ways with FrameMaker XML Author (2015 release).

Workflows can include pure XML, or working in a guided author environment.

Configure your work environment as an author and create content such as DITA topics (tasks, concepts, references) using a simple to follow workflow.

Page 3: FrameMaker XML Author Toolkit

21:08@publishsmarter

3

About your speaker

Publishing Smarter: President

Content strategist, publishing technologies expert, author, and geek-enough

Certified Technical Trainer DITA Content management Topic-based writing

STC President (www.stc.org)

Page 4: FrameMaker XML Author Toolkit

21:08@publishsmarter

4

Standard disclaimer

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)

Page 5: FrameMaker XML Author Toolkit

@publishsmarter 21:08

5

I ’ l l showcase DITA 1.2 support, but…

Swapping DITA Versions

Page 6: FrameMaker XML Author Toolkit

21:08

6

Switch DITA versions

@publishsmarter

Page 7: FrameMaker XML Author Toolkit

21:08

Choose wisely, consider what you need

@publishsmarter

7

Page 8: FrameMaker XML Author Toolkit

21:08

Choose an application mapping

@publishsmarter

8

Page 9: FrameMaker XML Author Toolkit

@publishsmarter 21:08

9

Depending on your instal lation…

Set up the workspace

Page 10: FrameMaker XML Author Toolkit

21:08

FrameMaker, Structured, or XML Author?

@publishsmarter

10

Three modes are availableSwitch between them if neededOr just get the FrameMaker XML Author tool

Page 11: FrameMaker XML Author Toolkit

21:08

By default you see this (or similar)

@publishsmarter

11

Page 12: FrameMaker XML Author Toolkit

21:08

Change to a structured author mode

@publishsmarter

12 1

2

Page 13: FrameMaker XML Author Toolkit

21:08

Structure View: Hierarchy of content

@publishsmarter

13

Page 14: FrameMaker XML Author Toolkit

21:08

Element Catalog: Contextual list

@publishsmarter

14

Page 15: FrameMaker XML Author Toolkit

21:08

Setup of a custom workspace (one time)

@publishsmarter

15

1

2

Page 16: FrameMaker XML Author Toolkit

21:08

Collapse by double-clicking

@publishsmarter

16

1

Page 17: FrameMaker XML Author Toolkit

21:08

Save your own workspace

@publishsmarter

17 1

23

4

Page 18: FrameMaker XML Author Toolkit

21:08

Remove <related-links>

@publishsmarter

18

1

Page 19: FrameMaker XML Author Toolkit

21:08

Add a title

@publishsmarter

19

1

Page 20: FrameMaker XML Author Toolkit

21:08

Content in doc and in Structure View

@publishsmarter

20

Page 21: FrameMaker XML Author Toolkit

21:08

Inline: View > Element Boundaries (as Tags)

@publishsmarter

21

Page 22: FrameMaker XML Author Toolkit

21:08

Add content in tags, and select/delete related-links

@publishsmarter

22

Page 23: FrameMaker XML Author Toolkit

21:08

View > Hide Element Boundaries

@publishsmarter

23

Page 24: FrameMaker XML Author Toolkit

21:08

Save the file (anywhere, but make a folder)

@publishsmarter

24

Page 25: FrameMaker XML Author Toolkit

21:08@publishsmarter

25

Create a map

Page 26: FrameMaker XML Author Toolkit

21:08

To build a New <map> in FrameMaker

@publishsmarter

261

2

Page 27: FrameMaker XML Author Toolkit

21:08

File > Save Ditamap As... (m_DITA_and_FrameMaker)

@publishsmarter

27

Page 28: FrameMaker XML Author Toolkit

21:08

Different views based on preferences/functions

@publishsmarter

28

Page 29: FrameMaker XML Author Toolkit

21:08

Change content in an element

@publishsmarter

29

Page 30: FrameMaker XML Author Toolkit

21:08

When content is selected, just type to edit

@publishsmarter

30

Page 31: FrameMaker XML Author Toolkit

21:08

To add an existing concept to the map

@publishsmarter

31

Page 32: FrameMaker XML Author Toolkit

21:08

Add a <topicref> (a topic reference)

@publishsmarter

32

Page 33: FrameMaker XML Author Toolkit

21:08

Double-click a file that already exists

@publishsmarter

33

12

Page 34: FrameMaker XML Author Toolkit

21:08

So far, pretty simple

@publishsmarter

34

Page 35: FrameMaker XML Author Toolkit

21:08

To sum up

@publishsmarter

35

Authors create content using FrameMakerContent follows the DITA specificationAuthors need to understand the FrameMaker

interface Structure view Where/when to click

Provides a LOT of control over the content

Page 36: FrameMaker XML Author Toolkit

21:08

Remove the need to think DITA

@publishsmarter

36

Now, let’s make it simpler

Page 37: FrameMaker XML Author Toolkit

21:08@publishsmarter

37

Let’s do setup: Edit > Preferences

1

2

3

Page 38: FrameMaker XML Author Toolkit

21:08

Enable Simplified XML

@publishsmarter

38

1

2

3

Page 39: FrameMaker XML Author Toolkit

21:08

Relaunch, then File > New > XML

@publishsmarter

39

12

3

Page 40: FrameMaker XML Author Toolkit

21:08

Change the default interface

@publishsmarter

40

Page 41: FrameMaker XML Author Toolkit

21:08

In FrameMaker XML Author...

@publishsmarter

41

Page 42: FrameMaker XML Author Toolkit

21:08

… you can make DITA editing super simple

@publishsmarter

42

Page 43: FrameMaker XML Author Toolkit

21:08

And if you DO like the code...

@publishsmarter

43

Page 44: FrameMaker XML Author Toolkit

21:08

… Use a full text based XML editor

@publishsmarter

44

Page 45: FrameMaker XML Author Toolkit

21:08

Make the view your own

@publishsmarter

45

Page 46: FrameMaker XML Author Toolkit

21:08

In closing, for the techies…

@publishsmarter

46

Support files: C:\Program Files (x86)\Adobe\AdobeFrameMaker2015\

Structure\xml\DITA_1.2\app\FrameMaker\simplifiedxmlIncludes:

config files for appearance EDD for allowed structure templates

Page 47: FrameMaker XML Author Toolkit

@publishsmarter 21:08

47

Summing up the discussion,and options to continue it.

Conclusion and contact

Page 48: FrameMaker XML Author Toolkit

21:08@publishsmarter

48

Services

Page 49: FrameMaker XML Author Toolkit

21:08@publishsmarter

49

Follow up contact information

905 833 8448 (Eastern Time)

[email protected]

www.linkedin.com/in/bernardaschwanden

@publishsmarter

www.publishingsmarter.com