Convex Press Web

Structuring Documents with FrameBuilder


Previous Page | Next Page | Contents | Convex Press Home | Help

Process


Viewing your file online

After exporting your file to SGML, you can view it online using PinPoint. However, you first need to set up PinPoint and compile the SGML file.

Setting up PinPoint

In order to use PinPoint to read your files online, you should perform the following steps on icarus:

  1. Make sure /usr/ebt/bin and /usr/local/doctools/bin are in your search path.
  2. Copy /usr/ebt/data/.pprc into your home directory on icarus.
  3. Edit your .pprc to contain the following line:
COLLECTION /rmt/bipod/docs/collections/login.collection=My Collection

where

login
is your user name
My Collection
is any string you want.

Compiling your file for PinPoint

In order to view your file in PinPoint, you will need to "compile" your SGML file with mkbook. To do this, use the following command on icarus:

% mkbook -fa -col /rmt/bipod/docs/collections/login.collection file
where

login
is your user name
file
is the directory name you created in Step 3 of the "Setting up to export" section.
mkbook outputs a lot of information when performing its task--do not be alarmed. Ignore error messages referring to index markers and appendixes.

Using PinPoint

The file can be viewed by performing the following steps:

  1. Start PinPoint (on icarus):
    % pinpoint
  2. Select your collection (as defined in your .pprc file) in the Collections list (left window).
  3. Double-click on file in the Books list (right window).
  4. Read away.
When you make changes to your file and re-export it, overwrite your previous SGML output file and run mkbook on the new file. Do not keep creating new directories each time you change a file.

See "PinPoint customization" section for information on setting PinPoint defaults.


Previous Page | Next Page | Contents | Convex Press Home | Help

Please submit comments and questions about these pages to scox@convex.com