Skip to main content
1-Visitor
November 14, 2015
Solved

How do I create a procedure in Arbortext?

  • November 14, 2015
  • 1 reply
  • 2766 views

I need to create a procedure in Arbortext but I don't know where to start. I'm starting from scratch with a blank template and would like to know what (DITA) tags I should use.

Any help would be hugely appreciated.

Best answer by kpritchard

Starting from scratch from a blank template would not be recommended as you lose the benefits of structured authoring, and it will have style sheet implications for processing/publishing as well.

Recommend that you use the Template for the DITA Document Type that you are creating.  These should be available when you create a New Document in Arbortext Editor.  Note the options for Template and Sample.

ArbortextNewDocument.jpg

If you don't see this or similar, your Arbortext Editor implementation may not have been done correctly.

1 reply

1-Visitor
November 14, 2015

Starting from scratch from a blank template would not be recommended as you lose the benefits of structured authoring, and it will have style sheet implications for processing/publishing as well.

Recommend that you use the Template for the DITA Document Type that you are creating.  These should be available when you create a New Document in Arbortext Editor.  Note the options for Template and Sample.

ArbortextNewDocument.jpg

If you don't see this or similar, your Arbortext Editor implementation may not have been done correctly.

jka1-VisitorAuthor
1-Visitor
November 15, 2015

Many thanks for your help.

So, when I go to create a new document, I will see the list on the left and the DITA technical content menu will offer a Dita Task option.

Do you have a screenshot of the template/tags that this generates?

1-Visitor
November 15, 2015

no screenshot... If you want an example of Tags and their usage suggest creating a Sample.  For full detail suggest referring to the OASIS specification which outlines the applicable schema (what Tags can be used where) for each DITA Type.  The Template will enforce the schema through the dtd behind the scenes.

It sounds like you could benefit from some mentoring.  Suggest getting in touch with Liz Fraley‌ at Single-Sourcing Solutions who provide support services not only in use of Arbortext Editor but in authoring techniques/philosophy in moving from "Book-Brain" to DITA.