9 Replies Latest reply: Aug 7, 2013 9:42 AM by max_drawdown RSS

    TOC for hierarchical book using child book TOCs?

    max_drawdown Community Member

      (My first hiearchical book in FM11. Win7x64.)

       

      I've created a book of two child books.

       

      Each child book has:

       

      1. A generated TOC as its first file. Its first paragraph in the primary flow has the paratag dtc-ChapTitle.
      2. Content as its second file, with tags such as h1-Head1, h2-Head2, and other paratags.

       

      (Side note: that child book design implements the idea of a chapter TOC without using a text inset. That's how this adventure started.)

       

      dtc-ChapTitle appears only in the (generated) TOCs of the child books (1's above), not in the content files (2's above).

       

      The parent book has two child books and a generated TOC. The generated TOC of the parent book is to include dtc-ChapTitle, h1-Head1, and other paratags.

       

      The parent TOC does generate with h1-Head1, and other paratags, but not dtc-ChapTitle.

       

      Maybe I don't know how to think about hierarchical books and am clinging to flat-book thinking.

       

      Am I being gently nudged toward using the <$chaptertitlename> variable somehow?  Section "cover pages" ?  But how do I make a "chapter TOC" the first file in the child book -- or otherwise make the chapter TOC appear before the chapter that it describes?

       

      Best regards,

        • 1. Re: TOC for hierarchical book using child book TOCs?
          Arnis Gubins CommunityMVP

          IIRC, you need to manually update/regenerate child books first when working with a hierarchical book. Also, you have to follow standard FM rules where the first file in the parent book needs to contain all of the tags used (that you need in your master TOC) in all of the child books in order to properly build the master TOC.

          • 2. Re: TOC for hierarchical book using child book TOCs?
            max_drawdown Community Member

            @Arnis,

             

            Thanks.

             

            I believe the parent book meets both of those conditions: child books updated first, and the first parent file has all tags.

             

            Moving the first child book to be the first "file" in the parent book does not change the result.

             

            It's as if the parent TOC cannot find a non-TOC paratag in the child TOC.

            • 3. Re: TOC for hierarchical book using child book TOCs?
              Arnis Gubins CommunityMVP

              Have you tried inserting some sort of "cover page" file (containing all of the tags) as the very first file before the child books?

               

              The hierarchical books were designed for structured FM. There are a few blogs on these that might provide some more clues (I haven't needed to use this functionality):

               

              http://blogs.adobe.com/techcomm/2009/05/xml_authoring_projects_using_hierarchical_books.ht ml

              http://blogs.adobe.com/techcomm/2009/06/numbering_in_hierarchical_books.html

              http://blogs.adobe.com/techcomm/2009/09/fm9_hierarchical_books_new_variable.html

              • 4. Re: TOC for hierarchical book using child book TOCs?
                max_drawdown Community Member

                @Arnis,

                 

                Thanks.

                 

                The FrontCover file is the first in the parent book. It precedes the parent-book TOC, and that parent-book TOC immediately precedes the first child book. I've imported paratags from the child-book TOC files and child-book content files into FrontCover and into the parent-book TOC.

                 

                The parent-book TOC correctly includes the paratag for the index title from the parent-book index file. Both of those files are generated, though at the same hierarchical level in the parent book, the top level.

                 

                The parent-book TOC correctly includes the paratag for its own title "Contents"

                 

                The parent-book TOC correctly includes paratags for content from the chapter files of the child books.

                 

                So the remaining anomaly is that the parent-book TOC isn't capturing paratag content from a child-book TOC.

                 

                I'll look at those links that you posted.

                • 5. Re: TOC for hierarchical book using child book TOCs?
                  max_drawdown Community Member

                  Latest news:

                   

                  I switched from using a child book to using the Folder feature.

                   

                  As the "template" file for the folder, I re-used the chapter TOC file that was part of the old child book.

                   

                  So the book looks like this:

                  1. FrontCover
                  2. ParentBookTOC
                  3. Folder
                    1. ChapterFile
                  4. ParentBookIX

                   

                  Results are:

                  • ParentBookTOC now contains the chapter name that was missing from the book-of-books design attempt higher on this thread. The name is flowing in from Folder. Good.
                  • In Folder, <$chaptertitlename> correctly produces the text that I typed in in the folder's Container Properties > Title. Good.
                  • Folder is, in fact, the chapterTOC file from the previous architecture. So when I open ChapterFile and generate a separate TOC file, it appears as content of Folder. Good.
                  • The chapter running header variable in ChapterFile produces a blank result. Not good.
                  • When I attempt to use <$chaptertitlename> in the running header variable in ChapterFile, it produces the file name, even after I regen the book. Not good.

                   

                  Adobe's blog entry leaves a logical gap in its coverage. The important sentence is: " For all other documents which are neither Folder template file nor part of the FM book, variable will reflect the filename of the file in which it is used." (emphasis added)

                   

                  The file in this case is not a Folder template and is part of the book. In this case, the variable is producing the name of the file, not the Title from the Folder's Container Properties, even after I regen the book.

                   

                  Again, I don't have a book-of-books now. I have a single book with a Folder.

                   

                  So how do I type the chapter name in one place, say as the Folder name, and have that available in ChapterFile?

                  • 6. Re: TOC for hierarchical book using child book TOCs?
                    Arnis Gubins CommunityMVP

                    Have you looked at the video on the ChapterTitle variable:

                     

                    http://blogs.adobe.com/techcomm/files/techcomm/FM9books/ChapterTitleName_demo2.swf

                     

                    Personally, I think the implementation is confusing and definitly isn't intuitive.

                    • 7. Re: TOC for hierarchical book using child book TOCs?
                      max_drawdown Community Member

                      @Arnis,

                       

                      Thanks.

                       

                      Yes, I looked at that video.

                       

                      It shows effects on the book TOC and folder files from changing the Title property of folder files, but not the effects (if any) on the "chapter" files such as resourceOne or concernOne.

                       

                      The chapter file is where the behavior is not as I desire.

                      • 8. Re: TOC for hierarchical book using child book TOCs?
                        Arnis Gubins CommunityMVP

                        I tried to get the <$chaptertitlename> variable to progate down to the files contained in the folders and it doesn't seem to have any effect (as you've observed). It's only the template file that is picking up the folder name. Very useless implementation, IMHO.

                         

                        I would be inclined to use MIF snippets to import my own variable definitions for <$chaptertitlename>, but it kind of depends on what you'ree trying to achieve by using the <$chaptertitlename> building block.

                         

                        The MIF snippet is a simple text file (MIF) that you import by copy into a FM file. This allows you to set specific variables without introducing or changing system level variable definitions:

                         

                        <MIFFile 11.0> # Generated by FrameMaker 11.0.1.382

                        <VariableFormats

                        <VariableFormat

                          <VariableName `Chapter Title Name'>

                          <VariableDef `This my Chapter Title'>

                        > # end of VariableFormat

                        > # end of VariableFormats

                        • 9. Re: TOC for hierarchical book using child book TOCs?
                          max_drawdown Community Member

                          @Arnis,

                           

                          Interesting idea!  That might be part of the answer.

                           

                          The more I look at all of this stuff, the more I think structured FM / XML is part of my future.