• Global community
    • Language:
      • Deutsch
      • English
      • Español
      • Français
      • Português
  • 日本語コミュニティ
    Dedicated community for Japanese speakers
  • 한국 커뮤니티
    Dedicated community for Korean speakers
Exit
0

troubleshooting topic validation error after saved as book with FM component

Explorer ,
Nov 12, 2024 Nov 12, 2024

Copy link to clipboard

Copied

The troubleshooting topic alone passed validation check, but it fails after I saved it as a book. Is there something I can do to fix this? 

 

Moreover, the [title] of [cause] tag gets the proper subheading format, but after saved as a book that [title] would be formatted as title.0 instead.

 

Are these two problems related somehow?

Andy38108926n5yf_0-1731398323236.png

 

FM 17 on Windows 11.

 

TOPICS
Structured

Views

357

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
community guidelines
Community Expert ,
Nov 19, 2024 Nov 19, 2024

Copy link to clipboard

Copied

I believe troubleshooting is a DITA 2.0 topic type.

What version of DITA are set up to use right now?

 

-Matt Sullivan
FrameMaker Course Creator, Author, Trainer, Consultant

Votes

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
community guidelines
Explorer ,
Nov 19, 2024 Nov 19, 2024

Copy link to clipboard

Copied

Hi Matt,

 

thank you for the response.

 

I was very excited when I resumed to work with FrameMaker, mostly because of DITA 1.3 and the new troubleshooting topic.

 

I am currently composing and migrating the documentation into XML DITA 1.3, FM 17.

The console error mentioned something about missing ID, even though the topic has been assigned a random unique ID.

 

As for DITA 2.0, from what I read it's still quite a while before we could work with it.

Getting Out of Trouble: DITA 1.3 Troubleshooting – DITA Writer

Votes

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
community guidelines
Community Expert ,
Nov 19, 2024 Nov 19, 2024

Copy link to clipboard

Copied

Ah, I didn't recall the troubleshooting being DITA 1.3.

Check your setup...I'm betting you are using DITA 1.2.

Set it to DITA 1.3 and you should be in business. If that doesn't work, reach out to Adobe directly at tcssup@adobe.com

 

-Matt Sullivan
FrameMaker Course Creator, Author, Trainer, Consultant

Votes

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
community guidelines
Explorer ,
Nov 19, 2024 Nov 19, 2024

Copy link to clipboard

Copied

Thank you, Matt. 
Let me re-confirm which DITA I'm currently use and get back to you asap.

 

edit:

Andy38108926n5yf_0-1732081958255.png

Structure > DITA Options says I'm on DITA 1.3.

 

Andy38108926n5yf_1-1732082016912.png

Task topic also says 1.3.

 

Andy38108926n5yf_2-1732082078981.png

Book components, all points to 1.3.

Votes

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
community guidelines
Community Expert ,
Nov 21, 2024 Nov 21, 2024

Copy link to clipboard

Copied

It sounds like the bookmap EDD isn't supporting something that the ditamap EDD is supporting.

Please reach out to Adobe at tcssup@adobe.com to evaluate.

 

-Matt Sullivan
FrameMaker Course Creator, Author, Trainer, Consultant

Votes

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
community guidelines
Explorer ,
Nov 21, 2024 Nov 21, 2024

Copy link to clipboard

Copied

Good morning, Matt.

 

I'm pretty sure I have re-installed a clean FM 17 environment after my initial experiment with EDD. In the earlier attempt, I experimented to duplicate the EDD of every DITA 1.3 topic, mostly for layout purposes. But now I have managed those within DITA output templates, I reinstalled FM 17 and use the defaults EDD.

 

I've sent the support yesterday, and yet to get their response.

 

Thank you,

Andy

 

Votes

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
community guidelines
Community Expert ,
Nov 21, 2024 Nov 21, 2024

Copy link to clipboard

Copied

Andy, do you have time for a quick web meeting? I can suggest a solution. Please contact me offlist: rick at frameexpert dot com

Votes

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
community guidelines
Explorer ,
Nov 21, 2024 Nov 21, 2024

Copy link to clipboard

Copied

Good morning, Rick.

 

Thank you for responding to my thread. It's currently working hour for me, so let me email your asap for that web call.

 

Regards,

Andy

Votes

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
community guidelines
Community Expert ,
Nov 21, 2024 Nov 21, 2024

Copy link to clipboard

Copied

Here is an unedited video that explains a solution. Note that in the video, I open the wrong output template instead of ditabase.template.fm, but the results would be the same.

https://youtu.be/Z5yDU0Ib5tY

Votes

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
community guidelines
Explorer ,
Nov 21, 2024 Nov 21, 2024

Copy link to clipboard

Copied

The video is most welcome, Rick. 

 

edit: come to think of it, I should've supplied my problematic XML files - I never thought you'd go ahead and actually did an experiment recreating my issue. Thank you for the trouble.

Votes

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
community guidelines
Explorer ,
Nov 21, 2024 Nov 21, 2024

Copy link to clipboard

Copied

I've checked out your recording. Thank you again.

 

1. Looks like the simplest way to fix my problem is to remove the ditabase1.3 reference, and point it to ditabase instead.

CompositeDocTemplate_1.2=ditabase.template.fm
CompositeDocTemplate_1.3=ditabase.template.fm

 

2. If I follow your direction and modify the template directory, I lose all of my customized layout for the DITA output.

 

3. The result looks good now, but the main book still has red NONAME element.

BjJKg1ZrAV.png

 

fixed troubleshooting structure view

aKqUoRFMxC.png

main book structure view

kdeXOBUh46.png

 

4. I will continue to publish solely on ditabase template now, and will report back if I found any issues after I ditch ditabase1.3 template.

Regards,

Andy

Votes

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
community guidelines
Community Expert ,
Nov 22, 2024 Nov 22, 2024

Copy link to clipboard

Copied

Yes, awesome recording from Rick!

He chose one of two paths to get your validation issue resolved, and likely chose the "swap output template method" because most folks haven't customized their default output template.

If you've already customized the output template, instead you might want to update the EDD in your modified template. 

Save a copy of your modified template file and import your element definitions from your valid Troubleshooting file to test.

Sorry I can't record a bright shiny video for you this morning to demonstrate!  🙂

I'm sure Rick will chime in soon as well.

 

-Matt Sullivan
FrameMaker Course Creator, Author, Trainer, Consultant

Votes

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
community guidelines
Explorer ,
Nov 22, 2024 Nov 22, 2024

Copy link to clipboard

Copied

Good morning, Matt. 

 

Thank you for the follow-up explanation and suggestion. 

 

I am still confused about EDD, how to properly read and write them, or how to incorporate them into my customized templates and FM's default EDD. It would be very much appreciated if you could offer a brief explanation of it.

 

Currently, I only customized the master pages of the DITA output template for the layout's visual.

 

Regards,

Andy

 

 

Votes

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
community guidelines
Community Expert ,
Nov 23, 2024 Nov 23, 2024

Copy link to clipboard

Copied

LATEST

Take a look at Adobe's documentation or my EDD workbook for details on modifying your structure environment.

However, it sounds like your template mods are minor, and that you could follow Rick's suggestion to get your DITA to validate, and then import the master pages (or otherwise modify the "new" template) to get the output you need.

Rick or I are available to help you if you need to go beyond what we can write up here.

 

-Matt Sullivan
FrameMaker Course Creator, Author, Trainer, Consultant

Votes

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
community guidelines