Skip to main content
Participating Frequently
March 28, 2012
Question

Why aren't my DITA <title> elements nesting?

  • March 28, 2012
  • 2 replies
  • 5177 views

FrameMaker 10 and patched || Windows 7 64-bit

Our company is migrating from unstructured to structured DITA XML.  We had not encountered any "showstoppers" that would keep us from proceeding...until we tried producing FM Book files for our print offerings.  It's my understanding that to take advantage of FrameMaker's numbering and pagination features using DITA source content, one must create a DITA map and save it out as a FM Book file, first.  However, when we do this—and subsequently try to print it like a "normal" book—all of our DITA <title> elements remain at the highest heading level.  In other words, each topic, which lives in a hierarchical structure inside any one of the DITA sub-maps, will always take on the paragraph style of .  My topic titles don't nest; everything is at a "flat" level!   Interestingly enough, they nest correctly if I print directly from a DITA map and not from a hybrid DITA+FM book file.  But if I take that route, I forfeit FrameMaker's ability to create a table of contents, index, etc.—features I can't live without.

I've tried fixing this behavior over the course of an entire week, but I have not had any success.  I cannot find any resources that address this issue, nor can I find anyone with the same issue.  Left to my own devices, I've experimented with re-building the maps numerous times; I've built the maps as plain maps and as bookmaps; I've even tried strange things like conref-ing everything.

What am I missing?  Does anyone know what is going on here?  How can I get my <title> elements to nest?

Some background information:

We place chapters in submaps (one per).

We place those submaps in one, big map.

Any help would be greatly appreciated,

Sean

This topic has been closed for replies.

2 replies

Stephanie.Marris
Participating Frequently
November 13, 2015

Hi, Sean-

What did you end up doing? I am having the same problem with the nesting in my hybrid book with FM TOC and DITA xml topics. The nesting in the TOC works, but not in the PDF bookmarks. Just curious if you had any luck.

Thanks-

Stephanie

ScottPrentice
Inspiring
March 28, 2012

Hi Sean...

I must say that I'm really not all that versed in the options for publishing from FM using default FM-DITA, since my focus is on DITA-FMx .. but I'd expect that this should work. The main problem that I'm aware of is that you get nested FM files instead of one FM file per "chapter". I suppose that could have something to do with the titles all being at the same level, since the EDD on;y knows about the titles in each file .. ??

One, clarification .. you say you have .. "chapters in submaps (one per)" .. does that mean one DITA file per submap? Are you using nested topics or separate topic files arranged into a "chapter" using topicrefs in your submap? If you were using nested topics (in one file), then I'd be very surprised if the titles don't get formatted properly. You could try that, but it's really a bit of a hack, since it's best to have separate topic files.

I believe you contacted me about DITA-FMx 2.0 (support for DITA 1.2) .. so I'm assuming you're using DITA 1.2? Are you really using DITA 1.2 features or have you just been using the DITA 1.2 apps in FM10? If you're not using the 1.2 features, you could use DITA-FMx, and you'd have great control over the formatting in your books. (Just an idea.)

Hopefully someone with more experience with using default FM-DITA to build books can comment on your situation .. I do think it should work though.

Cheers,

...scott

Adobe Employee
March 29, 2012

Sean,

Did you try updating the generated FM-Book?

Regards,

Saurabh

Participating Frequently
March 29, 2012

Did you try updating the generated FM-Book?

Yes, Saurabh, and multiple times during my testing.  It doesn't seem to help.