Contents 
 Index 
 "TPT User's Guide" 
 < Previous 
 Next > 

Chapter Ordering

Mif2Go has a few mechanisms that I use for getting chapters into the correct order, and for assigning topic names that reflect both its content and its order.

[FileIDs] in the mif2go.ini is used to define a two digit number that separates the contents of each chapter. This prefix is assigned to the all generated HTML and image files. The voyant_nav.pl tool relies on this to sort its input file names and know the order of the chapters. This is very important.

[FileSequence] in the mif2htm.ini is used by Mif2Go in its attempt to provide out-of-the-box topic-browsing over the chapter boundaries. TechPubTools redo that browsing, because Mif2Go still has limitations.

» Okay: The Next topic at the end of the chapter is the first topic of the next chapter as defined by the [FileSequence] in the mif2htm.ini.

» Not Okay: The Previous topic at the beginning of a chapter is the first topic of the previous chapter as defined by the [FileSequence] in the mif2htm.ini. Readers expect the Previous topic to always be the previous topic. At the chapter boundaries, this means that the Previous topic should be the last topic of the previous chapter and not the first topic of the previous chapter.

[HTMLStyles] in the mif2htm.ini is where the topic splits are defined and where a portion of the HTML file name is given. In this case, I use the title as part of the name.

[HTMLStyleFilePrefix] in the mif2htm.ini adds information to the HTML filename that would otherwise be used. In this case, I add the file IDs that were defined in [FileIDs] in the mif2go.ini and a three digit number that indicates the topics position within the chapter.

[HTMLOptions] in the mif2htm.ini defines the parameters for a built-in variable that counts topics in a file. In particular, I like having the first topic be a 10 and to have increments of 5 in the numbers.



 "TPT User's Guide" 
 < Previous 
 Next > 


Open-Source tools compliments of Voyant Technologies, Inc. and Glenn C. Maxey.
01/13/2003

TP Tools v2-00-0a

# tpt-hug-02