Introduction to OpenDoc

OpenDoc uses a plug-in software architecture that allows users to combine several functions into a single application. OpenDoc uses software components called parts that users can drag-and-drop or cut-and-paste into an OpenDoc-aware application. A single OpenDoc document may contain a text editor, spreadsheets, graphics, movies, and/or CPU simulators. The only limitation is that the application creating the original document must be a container application. One example of such a container is Dock'Em.

Each OpenDoc part works like an application. A text editor part will work like Microsoft Word. A spreadsheet part will have functions similar to Microsoft Excel. In addition to being a container, Dock'Em is also a page layout program and you can use it solely for its page layout features. Because it is a container, you can insert other OpenDoc parts like CPU simulators into Dock'Em documents, just like you can place an Excel worksheet in a Word document. If you decide to use Dock Em's container features, OpenDoc's help function will give you the information you need.

An OpenDoc part consists of an editor and one or more stationery files. You create documents by opening stationery files, editing them, and saving them under different names. Each CPU simulator is an OpenDoc part and has its own editor and stationery. Dock'Em also has its own editor and stationery.

Icons for Editors look very different from those for Stationery Pads and Documents. Editor icons look like two or more overlapping squares. Stationery icons look like rectangular pads of paper (stationery pads), with the lower right corner of the top sheet turned up. Document icons resemble a single sheet, with the top right corner turned down. The figures below show the icons for Dock'Em and the simulator LNC 1.

Editors and Stationery Pads

Documents

Editors

The editors for each OpenDoc part must be placed in the Editors folder, which is located within the System Folder.

Do not move either the editors or the Editors folder. Unless an editor is located within the Editors folder AND the Editors folder is itself located within the System Folder, OpenDoc won't be able to find the editor when you try to open associated stationery pads or documents. Likewise, you cannot rename the Editors folder.

To actually open an OpenDoc application, you don't double-click on the Editor file. Instead, you must double-click on a Stationery Pad or document.

Stationery Pads

When you double-click on a stationery pad, you don't open the stationery file itself. Instead, OpenDoc creates a new document that you edit and save. The new document has a different name than the stationery pad (OpenDoc automatically adds a numeral [1, 2, 3, etc.] to the stationery pad name). The icon also looks different (compare the document icons to the stationery icons on the previous page). The stationery pad works like a template from which you can build new documents. It functions in a manner similar to Microsoft Word templates.

Stationery pads do not need to remain in the Stationery folder (located in the main directory of your hard drive). You can move them anywhere that you want to. You can also rename stationery pads as you please. A stationery pad will always "know" the editor that created it no matter what you do to it!

Setting Up OpenDoc

Once you have installed OpenDoc, you need to configure it for the CPU software.

  1. On your Apple Menu, move the cursor down to "Control Panels." A separate submenu listing your computer's control panels will appear to the right. Select "OpenDoc Setup." The OpenDoc Setup control panel will open.
  2. The top panel allows you to set the default document Random Access Memory. It should indicate about 384 K. Using the up arrow, increase the default memory to 2048 K.
  3. The bottom panel asks you when you want to start and stop OpenDoc. As OpenDoc uses a significant chunk of memory, we suggest that you wait to run OpenDoc until you need open your first OpenDoc document. Because you may work on several OpenDoc documents, one after the other, we suggest you keep OpenDoc running until you shut down your system.

     

    • For "Start OpenDoc" choose "When first OpenDoc document is opened"
    • "Stop OpenDoc," choose "At System Shutdown"
  4. If you should choose to shut down OpenDoc before shutting down the system, open OpenDoc Setup and click on the button labeled "Stop."
Making Stationery Pads

Suppose that you have a new editor, but without its Stationery Pad. How do you create new stationery? As a specific example, let us make Stationery for the L&C Sim1 Editor.

  1. Open your Stationery folder (located in the main directory of your hard drive) and remove any L&C Sim1 Stationery Pads that may already be there. Any new stationery that you create will always appear inside the Stationery folder. Once it appears there, you are free to move it anywhere else you want. You can open up the stationery from anywhere in your computer.
  2. In order to make stationery for LNC1, you must be sure that its Editor is inside the Editors Folder (located within the System Folder). If you have received an updated version of the Editor, you must trash the previous version and replace it with the newest version. You cannot have two versions of the same simulator editor in the Editors folder at the same time. So, for our example we will assume that you have the newest version of LNC1 in the Editors folder. Keep the Editors folder open on your desktop.
  3. In your System Folder open the Extensions folder, then open the folder called OpenDoc Libraries.

  4. Inside the OpenDoc Library folder is the application program called OpenDoc.
  5. In order to make stationery, you drag the LNC1 Editor from the Editors folder and drop it on top of the OpenDoc icon. After you let go, your computer will take several seconds to carry out some operations. After the hard drive stops making noise, your Editor will remain at its original place in the Editors Folder, and the new stationery will appear in the Stationery folder. The title of the new stationery will generally be related to the title of the Editor, so you should have no trouble recognizing it.
  6. Once the Stationery is created, you can rename it anything you wish and can place it anywhere in your computer--either on the desktop or anyplace in the hard drive. When you double click on it, the stationery will be able to locate the Editor that created it and will open up.
Editing Stationery Pads

Sometimes you wish to open up the Simulator, create a unique set-up with the apparatus, then save your finished product as its own stationery. This is easy to do. You start by opening up the fresh new stationery (created the way described above).

Add any elements you wish to the set-up, set any properties you wish in the appropriate dialog boxes. When you are finished just save and close the document. Then locate the icon for the document on your computer (either the desktop or in a folder somewhere in your hard drive). The icon will be a normal document icon, with the upper right corner turned down.

Select the document, go to the File Menu, and choose Get Info. Alternatively, you can type I. At the bottom of the Info window for LNC1 Practice, you will see two check boxes. Click on the one labeled Stationery Pad and close the window.

The icon will then change to a stationery icon, with the lower right corner turned up .



The CPU Project - Copyright ©2000