Pathagoras Help System

Semi-Manual Markup

Semi-Manual Markup

Previous topic Next topic  

Semi-Manual Markup

Previous topic Next topic  

   Manual markup (discussed above) requires you to hand-type '<&' and '&>' at the begin and end points of each clause. Semi-manual markup performs this for you after just a minimum of setup effort.

   Semi-manual markup presumes that if you mark just the beginning of a particular clause, that will of necessity  indicate the end of the previous one. Therefore, only one marker is needed. (Of course, this is not always the case. If the end of '1' does not suggest the beginning of '2', you must use 'Manual Markup'.)

   Here are the steps.

1.Place a unique break-point character set at the beginning of each desired clause. We recommend the "(*)" character set, but you can use anything you wish.
2.Immediately after each break-point, type the name that you want to assign to the clause. (See the information inset below for clause naming rules that must be followed.)
3.If you intend to adopt the Prefix/Suffix naming convention for naming the clauses in the disassembled document, you need only provide a name (in proper 'prefix/suffix' style). Pathagoras will detect your intentions and will, when you take the next step, name all of your subsequent clauses appropriately.
4.Once you have pre-marked the document in accord with the above, run the 'Semi-Manual' routine from the Document Disassembly menu. Access the menu is via the Pathagoras dropdown features menu:

 
Click to enlarge.

When 'Document 'Dis'-assembly' is clicked the below menu appears:

Click to enlarge.

Click the third button to reveal the Bulk Add Preparation options.

Click to enlarge.

Click the 'Semi-Manual' button

5.Pathagoras will replace the (*) with the appropriate '<&' and '&>' markers at the begin and end of each clause and present a fully completed master document.
If prefix/suffix naming has been detected, Pathagoras will appropriately name and increment the clauses. You should still add subjects between the "//" that appear right after the name.
If no name has been provided, Pathagoras will insert two slashes at the 'head' of each clause. You will need to provide a name (and optional subject).
5.Study the resulting document. If any clause has not been pre-named, you should type the clause's name before moving on. Type the name before the first slash. Type a 'subject' between any double slashes you see.

 

Structure:

   The structure of a properly marked clause is:

<&(Name of clause)/(Subject of clause)/(Body Text of clause)&>

The red text shows the begin and end markers and the slashes between the
name, subject and body of the clause.

The blue text shows the clauses name and its (optional) subject.
If the subject is not provided,  the second slash will be immediately adjacent to the first.

Note: colors are for emphasis and illustration purposes only. They are absolutely not required.

   For a document to be 'properly marked,' the name of the clause must begin immediately after the ‘begin’ mark and must end with a forward slash (‘/’). The optional subject of the clause must begin immediately after the slash following the name. A closing forward slash (‘/’) completes the name and subject section. (Note: While a subject is optional, the slash is not. If a subject is not used, the name will be followed by two slashes. See second example below.) An 'end mark' must be placed at the end of the desired clause.


Example:

<&Preamble/Opening Paragraph/This Contract dated [Date of Contract] is made between [Buyer Name] and [Seller Name].&>

 

<&Fixed Price//This is a fixed price contract, not subject to market or other considerations.&>

 

information NAMING RULES:

   If you are breaking up this master document up into separate documents, keep in mind that normal document naming rules apply.

   If you  intend to disassemble the document into a glossary (as opposed to a folder of clauses), bookmark naming rules will apply. (This merely means that the glossary term name must begin with a letter, and contain only letters and numbers (and no spaces). The name may contain an underline (‘_’) character. )

   A 'Subject' for each clause is optional, but strongly recommended. It can be anything (to 'make up for', as it were, the ‘naming’ rules which are limiting).  The 'subject' should be relatively short (no more than 45 characters), but can, in fact, be of any length. As with all aspects of Pathagoras, don't spend too much time worrying about the subject. Changing it, if you find the need, is a very simple process.)

lightbulbsmallHint: Once you have decided on the break-point marker, and have typed it once, you should copy it into your clipboard. Then you can easily paste it at each location you want a new clause to start. That will save time and avoid typos.

redarrowIf a paragraph contains auto-numbering fields such that you cannot move the cursor in 'front' of the number, the marker should be placed adjacent to the first character to the RIGHT of that number.