|
|
|
|
|
This script calls 55_nav_gen.b or 55_nav_cp.b for all projects in the HTML system.
All directories that are to be included in the system should have a line in this script so that they can be appropriately processed.
There is no requirement that 55_nav_gen.b be called with the same master file for each directory.
A valid argument can be made that the navigation and/or copyright could be different from directory to directory. However, when the same master file is used for all directories, changes can be made in one place and propagated throughout the system.
A more useful variation of this in quickly re-purposing the system is to have multiple 50_ scripts. The 50_ scripts are identical in terms of directories but reference different master files for different purposes. For example, 50_nav_update_internal.b could specify master_internal.html in the 55_nav_gen.b calls for all directories, while 50_nav_update_external.b specifies master_external.html. In this manner, copyright and navigation could be changed in a matter of seconds between internal and external usage.
Note: When only a portion of your system has changed, it came sometimes be more efficient to view this file first to learn what commands it issues. And then instead of calling 50_nav_update.b from the command line, you would issue the appropriate 55_nav_gen.b command (followed by the 56_ scripts). This technique is only appropriate for larger systems that were previously generated and when changes are localized.
Note: When you add cref_ projects for API source code or book_ directories for FrameMaker manuals, this is one of the files that you will manually have to update accordingly.
My environment has a techpubs/perl directory that is parallel to the techpubs/tp_tools directory. References from the shell scripts to a Perl program use a relative path ../perl/<program>. For the purposes of simplicity in creating the ZIP file and clarity in bringing everything together, all scripts have been updated to reflect this new path techpubs/tp_tools/src_perl/, which is simply src_perl/ from the scripts.
|
|
|
Open-Source tools compliments of Voyant Technologies, Inc. and Glenn C. Maxey.
01/13/2003
TP Tools v2-00-0a
# tpt-hug-02