logo
 
  HOME--------FEATURES--------FAQs--------DOWNLOADS---------CONTACT INFO
PATHAGORAS Users' Guide, Part 5
Books: Glossaries & Folders

  Section A.
General Information
Additional instruction on the creation and modification of glossaries can be found 
in the DemoDocs files that shipped with Pathagoras.

For a comparison of Pathagoras' Glossary module to Word's AutoCorrect features, see this link.

Summary:
     Books are Pathagoras' storage places for clauses. Clauses typically are the building blocks for what will become larger documents. However, clauses can also be a frequently used addresses, terms or other bits and pieces of text.  A user would typically have multiple books, each one containing the clauses for a specific kind of document. A user should also consider creating a "SuperBook" (either a SuperGlossary or a SuperFolder." This SuperBook might contain a collection of general terms (addresses, signature blocks, etc.) that are used (or at least needed) in general correspondence and are univeral across users. Because of the way it is registered by Pathagoras, you always have instant access to terms in your SuperBook.

    A typical document assembly session goes like this: (a) the user presses a button to
display of the various available glossaries and folders of clauses and selects the desired book from the list. (b) Pathagoras generates a 'Clause Selection Screen' displaying all of the clauses in the selected book. (c) the user selects the clauses needed to create the specific document, moving the selection from the left ('what's available') panel to the right ('this is what I want') panel. When done,  the user presses the <Next> button and the document is assembled practically instantly.

    Documents can be built, and clauses can be pulled from a book, in a variety of methods other than the checkbox form described above.
  • Standard documents can be 'pre-built' using clause-sets.
  • Clauses can be inserted into an existing document one at a time. This is accomplished directly from the editing screen. The user types the term's name onto the editing screen at the point where the full text is to go. Then the user presses <Alt-G>. Pathagoras quickly locates the term and inserts it where desired.
  • The user can hand type a list of clause 'suffixes'. At the end of the list, type the prefix and press <Alt-G>. Pathagoras will pair the prefix and suffixes and build the desired document instantly.


 

Definitions:
      "Library" A collection of up to 10 books. While each book will encompass a collection of clause on a specific topic, a library is much broader in scope. (Like any library, it can be topically focused -- science, history, philosophy -- and the books therein containing much more specific content.

      "Book" Continuing the metaphor, a book is a sub-part of a library. A book contains the specific clauses which are use to build specific kinds of documents. 'Clauses' are stored in one of two types of books: (1) a 'glossary' or (2) a folder of clauses.

     "Glossary." A 'glossary' is a collection of boilerplate clauses, sentences, paragraphs, signature blocks, frequently used text, addresses, pictures, or anything else, all contained within a single document.  The document is a standard Word document.  It is organized or labeled in such a way that PATHAGORAS can directly access its individual components, but in every regard it is still just a Word document, fully readable and fully usable even if PATHAGORAS were removed from the system.

     "Folder of clauses" Another kind of book. It too can contain boilerplate clauses, sentences, paragraphs, signature blocks, etc. The folder is a standard Word folder, and each file in the folder is simply a standard document representing a single clause of a potential document.
      "Clause"  A 'clause' is the smallest component of an ultimate document (other than a single letter) that contributes significantly to the document's content. Typically, it is a sentence or a paragraph, but it can be (contrary to the dictionary definition) many paragraphs, many pages, pictures, charts, combinations of pictures and words, or a single letter . . . in other words, anything.  

 


Glossaries vs. Folder of Clauses
Whether you use a Glossary or a Folder of Clauses

    Glossaries do have a few advantages if document assembly using glossaries over a folder of clauses and you should consider using glossaries whereever possible.  Here are some of the advantages:

  • Portability.  It is much easier to move a single glossary containing 150 clauses than moving 150 documents, each containing one clause.
  • View-ability.  It is much easier to open a single document and globally scan 150 clauses within the document than to open 150 separate documents.
  • Editi-ability. Same as above. Block moving, copying etc., is much more easily done within a single document than among many documents.
  • Print-ability. If the user wishes to print the clauses (perhaps to place in a notebook; take home to edit, etc.) it is much easier to print a single document than hundreds. Further, a single document can be formatted and paginated to the user's desires. Separate documents will necessarily print on separate pages, and may require separate Page Setup manipulations.
  • See this link for a comparison of Pathagoras' Glossaries to Words AutoCorrect function.

 

     Since a folder of clauses could not be more self-exp;anatory, the rest of this page will focus on the concept of Glossaries.


Types of Glossaries
     PATHAGORAS recognize two glossary 'types'. Each type serves different needs. Both can exist simultaneously on a computer, but the glossary clause types cannot be mixed within the same glossary.
  • 'Bookmarked' glossaries.  The more common and more 'powerful' of the glossary types. Here, each clause is surrounded by Word bookmarks (done automatically by Pathagoras) and given a user supplied name. There is no limit to the number of clauses in such a glossary, or the amount of text each entry can contain.  When displayed during a document assembly session, the Pathagoras CheckBox Form displays the names assigned to each entry.

  • 'Simple list' glossaries. These are collections of single words or single lines of text. A carriage return indicates the end of one term and the beginning of the next.  When displayed during a document assembly session, the Pathagoras CheckBox Form displays the actual text that will be inserted into the document. There is no limit to the number of clauses that this kind of glossary can contain, but there is a practical limit as to the length of each clause. If you will be using clauses longer than one line's worth of text, consider a bookmarked glossary.  
  •      More details on how to create and edit both types of glossaries is presented in other sections of this guide.  Just click on the titles above.

         Regardless of the type of glossary (bookmarked or simple), they essentially work the same way. The user selects a glossary which contains the desired clauses. Pathagoras quickly displays the available clauses onto a CheckBox Form from which the user selects the desired clauses. The user chooses <Assemble> to create a new document or <Insert> if the clauses are to be placed in the current document. The user then presses <Next>.  Almost instantly, the selected clauses are assembled into a single, easily editable, document.

         Here is a simple example of the CheckBox form displaying the contents of a simple list glossary, playing on one's imagination how Abraham Lincoln might have used Pathagoras, were it available in his day:

    Figure 15. Abraham Lincoln's completed checkbox choices (from a 'simple glossary') preceding his famous speech.

         The glossaries, simple or bookmarked, are powerful tools that will be the core of most document assembly systems. However, a glossary is a remarkably simple thing. It is nothing more than a plain Word document.  It is created, stored, edited, moved, copied, deleted, etc., just like any other Word document. This powerful simplicity is what sets Pathagoras apart from the major document assembly programs on the market.

    The Position #1 Glossary (The "General Glossary")
        As you build your document assembly system, over time you will have several (perhaps many) subject oriented glossaries from which you can build documents. However, you will find that you will also be collecting/creating a substantial number of  generic terms and clauses that are important to retain but which are not directly associated with a particular subject. For example, the address to the Clerk of the Court (or client, or agency, etc.) does not 'belong' to the Contracts glossary more than it belongs to the Wills or Proposals glossaries. So, you need a glossary that is more 'general' in nature, one that can house those frequently used addresses, signature blocks, and other often called for 'boilerplate' or 'must have at my fingertips' clauses and terms. This describes what Pathagoras refers to as a 'general' glossary, and everybody needs one. The general glossary can be called anything, but we suggest you call it "General Glossary."  (Regardless of what name you choose, we will call the general glossary by that name.)

        Because of its generic nature, and because it contains terms that you frequently need throughout the day, the General Glossary should be in every library. Further, it should reside in the number one position in each of those libraries.  Why?  Because Pathagoras will look for a term sought via an <Alt-G> call in the following order: (1) from the glossary that matches the prefix (if a prefix is detected by Pathagoras); if not found then (2) from the book sitting on the first shelf of the active library.

        If you did not originally place the General Glossary on the first shelf, it is easy to place it there. Use the <Switch> button on the Document Assembly "Settings" screen to either switch the General Glossary with another glossary currently occupying that shelf, or to open up the slot for a 'direct shelving' of the glossary.


         See Part 5b of this Users' Guide for an in-depth discussion on creating & adding terms to Bookmarked Glossary.

          See Part 5c of this Users' Guide for an in-depth discussion on creating & adding terms to a Simple List glossary.

         Once you begin to use glossaries and appreciate their power, you will want to add new clauses, duplicate others, rename or reposition others. Pathagoras helps you at each step.

    Part 5b of discusses creating & adding terms to Glossaries
    Part 5c discusses Simple List glossaries.
    Part 5d  provides detailed regarding the Glossary Functions screen.

    Part 5e discusses how to create an "Instant Glossary".
    Part 5f teaches how to "Bulk Add" clauses into a glossary.


    View Introduction (Part 1).
    View Part 2 of Users' Guide (PathSmart module)
    View Part 3 of Users' Guide (SaveSmart module).
    Return to Part 4 of Users' Guide (Document Assembly module).
    View Part 6 of Users' Guide (Database Linking module)
    Continue with Part 7 of Users' Guide (Other Features).