FrameMaker XML Author Toolkit

21:08

Bernard Aschwanden

www.publishingsmarter.com

[email protected]

FrameMaker XML Author 2015

Content Contributors Toolkit1

@publishsmarter

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.


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)

http://www.stc.org/


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)

@publishsmarter 21:08

5

I ’ l l showcase DITA 1.2 support, but…

Swapping DITA Versions

21:08

6

Switch DITA versions

@publishsmarter

21:08

Choose wisely, consider what you need

@publishsmarter

7

21:08

Choose an application mapping

@publishsmarter

8


9

Depending on your instal lation…

Set up the workspace

21:08

FrameMaker, Structured, or XML Author?

@publishsmarter

10

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

21:08

By default you see this (or similar)

@publishsmarter

11

21:08

Change to a structured author mode

@publishsmarter

12 1

2

21:08

Structure View: Hierarchy of content

@publishsmarter

13

21:08

Element Catalog: Contextual list

@publishsmarter

14

21:08

Setup of a custom workspace (one time)

@publishsmarter

15

1

2

21:08

Collapse by double-clicking

@publishsmarter

16

1

21:08

Save your own workspace

@publishsmarter

17 1

23

4

21:08

Remove <related-links>

@publishsmarter

18

1

21:08

Add a title

@publishsmarter

19

1

21:08

Content in doc and in Structure View

@publishsmarter

20

21:08

Inline: View > Element Boundaries (as Tags)

@publishsmarter

21

21:08

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

@publishsmarter

22

21:08

View > Hide Element Boundaries

@publishsmarter

23

21:08

Save the file (anywhere, but make a folder)

@publishsmarter

24


25

Create a map

21:08

To build a New <map> in FrameMaker

@publishsmarter

261

2

21:08

File > Save Ditamap As... (m_DITA_and_FrameMaker)

@publishsmarter

27

21:08

Different views based on preferences/functions

@publishsmarter

28

21:08

Change content in an element

@publishsmarter

29

21:08

When content is selected, just type to edit

@publishsmarter

30

21:08

To add an existing concept to the map

@publishsmarter

31

21:08

Add a <topicref> (a topic reference)

@publishsmarter

32

21:08

Double-click a file that already exists

@publishsmarter

33

12

21:08

So far, pretty simple

@publishsmarter

34

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

21:08

Remove the need to think DITA

@publishsmarter

36

Now, let’s make it simpler


37

Let’s do setup: Edit > Preferences

1

2

3

21:08

Enable Simplified XML

@publishsmarter

38

1

2

3

21:08

Relaunch, then File > New > XML

@publishsmarter

39

12

3

21:08

Change the default interface

@publishsmarter

40

21:08

In FrameMaker XML Author...

@publishsmarter

41

21:08

… you can make DITA editing super simple

@publishsmarter

42

21:08

And if you DO like the code...

@publishsmarter

43

21:08

… Use a full text based XML editor

@publishsmarter

44

21:08

Make the view your own

@publishsmarter

45

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


47

Summing up the discussion,and options to continue it.

Conclusion and contact


48

Services


49

Follow up contact information

905 833 8448 (Eastern Time)

[email protected]

www.linkedin.com/in/bernardaschwanden

@publishsmarter

www.publishingsmarter.com

Business

FrameMaker XML Author Toolkit