Highlighted

Removing Context and Result labels in DITA output

Explorer ,
Nov 27, 2018

Copy link to clipboard

Copied

We are using FrameMaker 2019 and are looking to publish our next document. While the publishing is faster and somewhat easier, I'm getting unwanted Dita labels in my output, mainly the Context and Result labels that are associated with Dita tasks. I understand I may need to remove these from my FM template files - is this correct? Can I turn off just Context or Result, or both? And how would I go about removing these labels? Many thanks!

OK, after you've edited the task.eddmod.fm file, open task.edd.fm then click Edit > Update References to pull in the changes. Save task.edd. Then open task.template.fm and click File > Import > EDD and choose task.edd. Save the template.
(Of course backup the files before you change them in case something breaks. Also, you can either run FM as an administrator to be able to save the files directly or save them somewhere else and copy them back into the normal location.)

Now if you click File > New > DITA > task, you'll see that the context label is gone. These changes affect how dita files are displayed within FrameMaker. However they don't affect how anything is published - the next steps fixed the output for me:

Open composite.edd.fm (it's here: C:\Program Files\Adobe\Adobe FrameMaker 2019\Structure\xml\DITA\app\DITA-Composite-FM) find the context and result elements, and delete the prefix rules in the same way that you did in task.eddmod.fm. Save the file.

Open ChapterOutputTpl.fm and ditabase1.3.template.fm (or just ditabase.template.fm if you're using an earlier version of DITA). Use File > Import > EDD to import the composite.edd.fm into these two files. save them into their original locations. Now your published output should be good.

If you only care about the published output and not how things display when you're working with the base DITA files then you only need to change the composite, chapterOutput, and ditabase1.3, but I find it helpful to have things look consistent all the way through the editing process, so I make my changes in both places.

TOPICS
Structured

Views

1.1K

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more

Removing Context and Result labels in DITA output

Explorer ,
Nov 27, 2018

Copy link to clipboard

Copied

We are using FrameMaker 2019 and are looking to publish our next document. While the publishing is faster and somewhat easier, I'm getting unwanted Dita labels in my output, mainly the Context and Result labels that are associated with Dita tasks. I understand I may need to remove these from my FM template files - is this correct? Can I turn off just Context or Result, or both? And how would I go about removing these labels? Many thanks!

OK, after you've edited the task.eddmod.fm file, open task.edd.fm then click Edit > Update References to pull in the changes. Save task.edd. Then open task.template.fm and click File > Import > EDD and choose task.edd. Save the template.
(Of course backup the files before you change them in case something breaks. Also, you can either run FM as an administrator to be able to save the files directly or save them somewhere else and copy them back into the normal location.)

Now if you click File > New > DITA > task, you'll see that the context label is gone. These changes affect how dita files are displayed within FrameMaker. However they don't affect how anything is published - the next steps fixed the output for me:

Open composite.edd.fm (it's here: C:\Program Files\Adobe\Adobe FrameMaker 2019\Structure\xml\DITA\app\DITA-Composite-FM) find the context and result elements, and delete the prefix rules in the same way that you did in task.eddmod.fm. Save the file.

Open ChapterOutputTpl.fm and ditabase1.3.template.fm (or just ditabase.template.fm if you're using an earlier version of DITA). Use File > Import > EDD to import the composite.edd.fm into these two files. save them into their original locations. Now your published output should be good.

If you only care about the published output and not how things display when you're working with the base DITA files then you only need to change the composite, chapterOutput, and ditabase1.3, but I find it helpful to have things look consistent all the way through the editing process, so I make my changes in both places.

TOPICS
Structured

Views

1.1K

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Nov 27, 2018 0
Participant ,
Nov 28, 2018

Copy link to clipboard

Copied

The labels are either defined in the numbering part of the paragraph format which is controlled by the template file, or are defined directly within the EDD.

Context and result are prefix added by task.eddmod.fm. To get rid of them you need to delete this rule under the context element:

Prefix rules

1. In all contexts.

Prefix: Context:

Text range.

Use character format: step.callouts

And under the results element delete:

Prefix rules

1. In all contexts.

Prefix: Result:

Text range.

Use character format: step.callouts

If I remember rightly, once you've done this, you need to refresh the task.edd.fm so it pulls in the updated task.eddmod.fm info, then apply the new task.edd to your task.template.fm file, and then you'll probably want to make the same changes to your output edd and template (in my setup that's ChapterOutputTpl.fm and composite.edd.fm).

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Nov 28, 2018 0
Explorer ,
Nov 28, 2018

Copy link to clipboard

Copied

This is very helpful, thank you. This is the first I've heard of this task.eddmod.fm. Where do I find this file?

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Nov 28, 2018 0
Participant ,
Nov 28, 2018

Copy link to clipboard

Copied

Mine is here:

C:\Program Files\Adobe\Adobe FrameMaker 2019\Structure\xml\DITA_1.3\app\technicalContent\edd\task.eddmod.fm

The path is similar for FM 2017 but under program files (x86).

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Nov 28, 2018 0
Explorer ,
Nov 28, 2018

Copy link to clipboard

Copied

OMG, thanks again. I would have been looking a while. These are some of my frustrations with FrameMaker -  there are support files all over the place that are needed to make things work. I would not say finding one's way around is intuitive.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Nov 28, 2018 0
Participant ,
Nov 28, 2018

Copy link to clipboard

Copied

Agreed. This forum definitely helps though. This is where I came to figure it out. There's still a lot I have to learn!

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Nov 28, 2018 0
Explorer ,
Nov 28, 2018

Copy link to clipboard

Copied

I gather you are working in DITA, did you also have to remove these labels from your Task outputs? We moved from 2017 to 2019 and I have since deleted the 2017 install. Perhaps in our 20170 these EDD files were already customized - but our software developer who spearheaded FrameMaker for us has since moved on.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Nov 28, 2018 0
Participant ,
Nov 28, 2018

Copy link to clipboard

Copied

Yes I did. Our company did a branding update so I had to remake all our templates and no-one knew how, so I've had fun learning... I needed to modify the note prefix too, (which is in the commonelements.eddmod.fm).

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Nov 28, 2018 0
Explorer ,
Nov 28, 2018

Copy link to clipboard

Copied

Just one more thing...yeah right

You mentioned the following:

If I remember rightly, once you've done this, you need to refresh the task.edd.fm so it pulls in the updated task.eddmod.fm info, then apply the new task.edd to your task.template.fm file, and then you'll probably want to make the same changes to your output edd and template (in my setup that's ChapterOutputTpl.fm and composite.edd.fm).

How do I go about "refreshing" the task.edd.fm file? I didn't know there was a tast.template.fm file, I thought the only template I was using was, like you, the ChapterOutputTpl.fm file.

In regards to the output edd, what would I have to to do the composite.edd.fm file?

Sorry, likely asking one too many questions, but this is worth the effort - still better than unwrapping the Context tag. You have been very helpful!

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Nov 28, 2018 0
Participant ,
Nov 29, 2018

Copy link to clipboard

Copied

OK, after you've edited the task.eddmod.fm file, open task.edd.fm then click Edit > Update References to pull in the changes. Save task.edd. Then open task.template.fm and click File > Import > EDD and choose task.edd. Save the template.
(Of course backup the files before you change them in case something breaks. Also, you can either run FM as an administrator to be able to save the files directly or save them somewhere else and copy them back into the normal location.)

Now if you click File > New > DITA > task, you'll see that the context label is gone. These changes affect how dita files are displayed within FrameMaker. However they don't affect how anything is published - the next steps fixed the output for me:

Open composite.edd.fm (it's here: C:\Program Files\Adobe\Adobe FrameMaker 2019\Structure\xml\DITA\app\DITA-Composite-FM) find the context and result elements, and delete the prefix rules in the same way that you did in task.eddmod.fm. Save the file.

Open ChapterOutputTpl.fm and ditabase1.3.template.fm (or just ditabase.template.fm if you're using an earlier version of DITA). Use File > Import > EDD to import the composite.edd.fm into these two files. save them into their original locations. Now your published output should be good.

If you only care about the published output and not how things display when you're working with the base DITA files then you only need to change the composite, chapterOutput, and ditabase1.3, but I find it helpful to have things look consistent all the way through the editing process, so I make my changes in both places.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Nov 29, 2018 0
Explorer ,
Nov 29, 2018

Copy link to clipboard

Copied

Wow, thank you. Have you thought about contacting Adobe and having them put you on the payroll?

I think I have everything I need to give this a try.

Only hangup I've having is my system is not giving me write privileges to the folder containing the task.edd.fm file. This could be an Adobe thing where they wish to leave these files undisturbed. I've had this before with FrameMaker, where some of the deeper nested folders containing template files are "locked".

Thanks again!

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Nov 29, 2018 0
Participant ,
Nov 29, 2018

Copy link to clipboard

Copied

I get round that by choosing save as, saving the file somewhere else, then copying and pasting the file back into the original location.

Alternatively you can right click on FrameMaker in the start menu and choose More > Run as administrator and then you can probably save the files directly.

It's no trouble - I've been figuring this out quite recently and ask my share of questions too.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Nov 29, 2018 0
Explorer ,
Mar 11, 2019

Copy link to clipboard

Copied

I am strongly hoping someone may see this tread.

I finally got around to trying the edits to the various EDD files, but with no luck.

Firstly, I've edited the task.eddmod.fm and updated task.edd.fm. I did this both in the DITA 1.2 and DITA 1.3 folders, but it it didn't take. When I restart FM and open a new task, when I insert the Context Element, I still see the label.

Now as to the composite.edd.fm file, I cannot even see the the Prefix Rules that I need to edit - at least not for the Context element.

Perhaps my 2019 FM root files are not the ones being referenced by my version of FM.

Any suggestions by anyone would be most helpful!

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Mar 11, 2019 0
Participant ,
Mar 11, 2019

Copy link to clipboard

Copied

Did you import the updated EDD into the templates?

For task.edd, you want these changes to apply to the task.template.fm file. So:

Open task.template.fm and task.edd.fm.  Use File > Import > EDD to import the task.edd.fm into the template file. Save the template file into its original location. Now when you open a task you should see the effect of the changes you made.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Mar 11, 2019 0
Explorer ,
Jul 02, 2019

Copy link to clipboard

Copied

I am wondering if anyone else still has this issue. I have tried repeatedly the great instruction from Kat, but no luck.

The latest is when I try to update reference task.edd.fm with the task.eddmod.fm file, I get a text inset error message.

I would like to hear from someone at Adobe who could walk me through this. I have been beating my head for months trying to fix this with no resolution.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Jul 02, 2019 0
Adobe Employee ,
Jul 03, 2019

Copy link to clipboard

Copied

Can you please drop me an email with a sample content and what you would like to be removed from the PDF.

thanks

Amitoj Singh

Email: amisingh@adobe.com

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Jul 03, 2019 0
Explorer ,
Jul 08, 2019

Copy link to clipboard

Copied

Will do! Thanks,

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Jul 08, 2019 0
Explorer ,
Jul 25, 2019

Copy link to clipboard

Copied

Bit of an update. While I haven't had luck getting this to work I finally got around to it. I was getting "text inset" error message when doing an Update Reference of the task.edd.fm file with the task.eddmod.fm file. I finally converted all the linked files in the task.edd.fm to text so I could remove the prefix labels. What a chore! The about of updating and referencing of these EDD files just to get these prefixes removes is mind blowing.

Then to have to do it all over again for the composite.edd.fm and finally update the template files. I count no less than FIVE files that need to be updated in order to make these things go away.

An no information in the manuals on how to do this!

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Jul 25, 2019 0