OS/2 Shareware BBS: 5 Edit/05-Edit.zip/infomana.zip/LESSONS.HLP

OS/2 Help File | 1993-02-10 | 78KB | 1,233 lines

ΓòÉΓòÉΓòÉ 1. Main Menu ΓòÉΓòÉΓòÉ


1.   Getting Started
2.   Creating IPF Online Helps and Books
3.   Printing
4.   Advanced Features and Creating Presentations


ΓòÉΓòÉΓòÉ 2. Getting Started - Moving Around ΓòÉΓòÉΓòÉ


To move around the tutorial easily, you'll need to know how to scroll text,
close panels, move them out of the way, and make the panel you want to change
active.  If you already know how to do those things, just scroll down to the
bottom of this panel and doubleclick on the hand to  begin learning about HyperWrite.
Scrolling -- To see the information at the bottom of a panel, you have to
place the mouse pointer on the down arrow  at the bottom of the scrollbar and
press mouse button 1.  Do that now, pressing the mouse button several times.
Notice the bar moving downward.  Some panels also have a scrollbar on the
bottom with arrow keys on the right and left.

As you can guess, to view information at the top of the panel again, just place
the mouse pointer on the up arrow  and press mousebutton 1.

Some panels also have a scrollbar on the bottom with arrow keys on the right
and left.

Moving panels out of the way -- You'll want to know how to move panels out of
the way so you can see what's behind them.  To do that, place the mouse pointer
on the titlebar, press and hold mousebutton 1 while you move right, left, up or
down.

You can try moving the Main Menu panel now.  Place your mouse pointer on the
title "Main Menu" and  press mousebutton 1.  Move right, left,  up and down.

Closing panels, list windows,etc  -- To close panels and windows, go to the
titlebar icon  and doubleclick with mousebutton 1.  There is no titlebar icon
on this panel, but the the main menu has one.  Please don't try to close that
right now.....

Focus on the panel you want to take action on -- To make any changes or to take
action, you have to let HyperWrite know which window or panel to focus on.  To
do that ,  just place your mouse pointer on the panel or window and click once
with mousebutton 1.  The border  becomes yellow and the one you moved from,
becomes gray.  The change is subtle.  Try it on the main menu panel and back to
this panel again.

You've just learned things about OS/2 and windowing.  Let's move on to learn
about HyperWrite - E.  Double click on the hand and your next panel will appear.


ΓòÉΓòÉΓòÉ 3. Getting Started -- Question 1 ΓòÉΓòÉΓòÉ


Q. What are all those things on the HyperWrite-E Screen and what do they mean?
A.  There is a picture of the HyperWrite-E main screen below.  Double click on
the parts you want to learn about.


ΓòÉΓòÉΓòÉ 4. Titlebar Icon ΓòÉΓòÉΓòÉ

This is HyperWrite-E's titlebar icon.  All OS/2 programs have their own
"picture" and have it in the same place.  Just like the closing panel icon  you
read about earlier, the titlebar icon serves as a way to close the program,
close the panel,  or to exit quickly.


ΓòÉΓòÉΓòÉ 5. Titlebar  ΓòÉΓòÉΓòÉ

The titlebar serves to let you know first,  what program you have started up
and then what document you have opened and where it is located on your disk.
Keeping the document name and pathname visible is a convenience.  With OS/2 you
could have several programs started .


ΓòÉΓòÉΓòÉ 6. Min/Max icon ΓòÉΓòÉΓòÉ

The min/max icons are convenient ways to make windows as large as possible or
to make them as small as possible,  Getting  them out of the way until you want
to use them again can be a real convenience.  Please do not try it now, but if
you clicked once on the left icon, HyperWrite-E becomes an icon that looks like
this .  If you click on the right icon, HyperWrite-E is sized to as large a
window as it can be.


ΓòÉΓòÉΓòÉ 7. bird ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 8. Menu Bar ΓòÉΓòÉΓòÉ

HyperWrite-E's action bar gives headings for related function.  Under each
heading is a list of things you can do.  Double click on the action bar
category  you want to understand.

A general thing about action bars ..... we put every function that can be done
with the keyboard in the Menu Bar.  For those of you who are not particularly
fond of using a mouse, you may prefer that.....


ΓòÉΓòÉΓòÉ 9. Document on Action Bar ΓòÉΓòÉΓòÉ

Under the document heading, you will find all the things you can do with entire
file or document.  You can create a new one, open an existing one, save it,
save another copy with a different name, print it,  and finally make your
editing session more like you want it rather than how we think you should want
it.  Oh yes, and you can exit  HyperWrite-E from here.


ΓòÉΓòÉΓòÉ 10. Edit on the Action Bar ΓòÉΓòÉΓòÉ

Under the heading Edit, you will find cut, copy, paste and search. You'll find
the same things in the toolbar in the form of icons.

To cut or copy text, you have to mark it first.  To paste the cut or copied
text, you have to place your cursor and select Paste.


ΓòÉΓòÉΓòÉ 11. Create on the Menu Bar ΓòÉΓòÉΓòÉ

Under the heading Create, you will find that you can create animation
sequences, indexes, tables and grouped elements.  There are other things you
can create also.  You'll have a chance to learn and practice all of those things.


ΓòÉΓòÉΓòÉ 12. Panel  on the Menu Bar ΓòÉΓòÉΓòÉ

 This heading changes if the style you're using is for books or for online
information.  This is the heading for all the things that have "local" meaning
and affect only the panel you're currently "focussed on".

You'll find things here like locking your cursor so it keeps the same color or
font wherever you want to use it again .  You can change the property of an
element (the way it looks) just on that panel .  You can also create a template
of your panel....that's especially helpful if you have a split screen design.


ΓòÉΓòÉΓòÉ 13. Styles on the Menu Bar ΓòÉΓòÉΓòÉ

Different styles make the panels or text have different "looks".  Notice that
the Main Menu panel and text structure look different than the panel style and
text structure here.

We provide an element or text structure style with HyperWrite-E, called
Panel.Sty .

We provide several panel styles.

You'll learn how to create your own panel and text structure or element styles
when you become an advanced user of HyperWrite-E.


ΓòÉΓòÉΓòÉ 14. View on the Menu Bar ΓòÉΓòÉΓòÉ

View gives you a list of lists to display as you edit.  They are font, element,
table of contents, index panel, synonym, etc.

The toolbar has some of the more commonly used lists on it......you'll probably
want to learn about that after seeing the rest of the Menu Bar..


ΓòÉΓòÉΓòÉ 15. Help on the Menu Bar ΓòÉΓòÉΓòÉ

Under the heading Help, you can choose to get a help index, help for keys.
general help and of course, this tutorial.  You can also get help on the action
you're trying to perform by pressing F1 on a  screen menu item or function
under the Menu Bar.

The help index will get you into some of these tutorial panels in addition to
the regular help panels.


ΓòÉΓòÉΓòÉ 16. Toolbar ΓòÉΓòÉΓòÉ


The most commonly used functions are represented  as icons and make up what we
call a tool bar.
Doubleclick on each icon picture.
After you have read about each icon and have completed the tutorial and have
completely forgotten what icon is what, don't worry.  You can place your mouse
pointer on an icon and  the name of it is displayed at the bottom of the
HypeWrite screen in the command line area.


ΓòÉΓòÉΓòÉ 17. New Panel  Icon ΓòÉΓòÉΓòÉ

To get a new panel , you need to click only once on this icon.  To title the
panel , just begin typing.
If you're like most of us, you'll press Enter or place your mouse pointer in
the panel area before titling it and then the name of the panel becomes Unnamed
Panel.  No problem. Place your mouse pointer in the title area, press Alt and
mousebutton 1.


ΓòÉΓòÉΓòÉ 18. Cut Icon ΓòÉΓòÉΓòÉ

Cutting text is a quick way to move it or delete it.  You'll mark the text you
want to move or delete and click once on this cut icon.


ΓòÉΓòÉΓòÉ 19. Copy Icon ΓòÉΓòÉΓòÉ

Copying text is just like cutting it except your information is still in its
original place.  Simply mark the text or area to copy and click once on this
icon.  You'll then place your mouse pointer where you want to paste it.


ΓòÉΓòÉΓòÉ 20. Paste Icon ΓòÉΓòÉΓòÉ

Pasting is what you do after you have cut  or copied  and have placed your
mouse pointer.


ΓòÉΓòÉΓòÉ 21. Search Icon ΓòÉΓòÉΓòÉ

As you edit text, you often have to find and change words.  Click once on the
search icon  and a screen will ask you what word or words you want find.


ΓòÉΓòÉΓòÉ 22. Print Icon ΓòÉΓòÉΓòÉ

Clicking once on this icon brings up a panel that asks what you want to print.

You can get Postscript print if you have a Postscript print driver with OS/2.


ΓòÉΓòÉΓòÉ 23. Graphics Icon ΓòÉΓòÉΓòÉ

HyperWrite-E allows you to insert graphics in your online helps, books or presentations.

Click once on this icon (it's the only colored one) and you will get a list of
picture names that have .bmp or .met extensions.


ΓòÉΓòÉΓòÉ 24. Panel or Page List Icon ΓòÉΓòÉΓòÉ

Your panel  list is your working list.
You may ask why you can't just work with the table of contents.  It's because
your table of contents does not have to list all the panels you created.  In
online information you have some panels (like the one you are reading right
now) that are linked to by another panel and without the information in the
starting panel, isn't complete.  Therefore, we want to "hide"  some titles.
 This is a panel we need  to author but not display in a table of contents.


ΓòÉΓòÉΓòÉ 25. Font Icon ΓòÉΓòÉΓòÉ

One click on the font icon and the text styles that belong to the Panel.Sty or
Page.Sty appear.
There are many, many more that can be created.  When you're an "Advanced User",
you'll want to learn how to create your own.


ΓòÉΓòÉΓòÉ 26. Table of Contents Icon ΓòÉΓòÉΓòÉ

The table of contents icon is a quick way to get to the table of contents.
Once there, you can change the order of it by pressing mousebutton two over a
title and dragging it wherever you want it.


ΓòÉΓòÉΓòÉ 27. Index Icon ΓòÉΓòÉΓòÉ

Click once on the index icon to display the index.

 If you don't have an index  and want one, you have to go to the Menu Bar and
select Create, Index and Add.


ΓòÉΓòÉΓòÉ 28. Element List Icon ΓòÉΓòÉΓòÉ

The element list is used often.  It lists all the text structures that belong
to Panel.Sty.  After you have clicked once on the icon and have your list,  you
just double click on the element you want to use.


ΓòÉΓòÉΓòÉ 29. Table Icon ΓòÉΓòÉΓòÉ

Click once on the table icon and a screen appears asking you to fill in the
number of rows and columns.  The cell height grows automatically as you type
into it.

If you don't want all the table cells to be the same width, you can specify that.

You'll have a chance to create tables and update them later.


ΓòÉΓòÉΓòÉ 30. User Preference Icon ΓòÉΓòÉΓòÉ

Clicking once on the user preference icon gives you the choice to use more
advanced features, choices to see your screen with or without all of
HyperWrite-E's markers and the choice to see your panel list in an icon view or not.

If you have many panels, we recommend that you  turn off the panel icon view.
It's really easier to work with a list then.


ΓòÉΓòÉΓòÉ 31. Colorbar ΓòÉΓòÉΓòÉ

ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
Γöé               Γöé                    Γöé
Γöé               Γöé                    Γöé
Γöé               ΓöéThe colorbar is usedΓöé
Γöé               Γöéfor IPF online      Γöé
Γöé               Γöéinformation or for  Γöé
Γöé               ΓöéHyperWrite-E        Γöé
Γöé               Γöépresentations.      Γöé
Γöé               Γöé                    Γöé
Γöé               ΓöéTo color the        Γöé
Γöé               Γöéforeground text, be Γöé
Γöé               Γöésure the letter at  Γöé
Γöé               Γöéthe bottom of the   Γöé
Γöé               Γöécolorbar is F  (    Γöé
Γöé               Γöédouble click on it  Γöé
Γöé               Γöéif the B is being   Γöé
Γöé               Γöédisplayed.)  Mark   Γöé
Γöé               Γöéthe text by swiping Γöé
Γöé               Γöéit and then         Γöé
Γöé               Γöédoubleclick on the  Γöé
Γöé               Γöécolor of choice.  ToΓöé
Γöé               Γöéchange the          Γöé
Γöé               Γöébackground color    Γöé
Γöé               Γöérepeat the same     Γöé
Γöé               Γöésteps but be sure   Γöé
Γöé               Γöéthe B is displayed  Γöé
Γöé               Γöéat the bottom of theΓöé
Γöé               Γöécolorbar.           Γöé
ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ


ΓòÉΓòÉΓòÉ 32. Current Directory Icon ΓòÉΓòÉΓòÉ

The current directory is displayed under this icon.  Double click on it if you
want to change the directory you want HyperWrite-E to work from.


ΓòÉΓòÉΓòÉ 33. Create New Document Icon ΓòÉΓòÉΓòÉ

This is placed at the bottom of the screen for your convenience.  A doubleclick
on this icon and you can have a new document .

 One of the things to become accustomed to in HyperWrite-E is how documents are
closed.  They are closed only after a new one is created or opened.  Opening or
creating another document  replaces the one currently open.


ΓòÉΓòÉΓòÉ 34. Lock Icon ΓòÉΓòÉΓòÉ

The lock icon is for use with IPF online information or HyperWrite-E presentations.

Locking text means you want a key or password to be the thing that opens it up
for viewing.  That way you can have more than one version of your document in a
single file.


ΓòÉΓòÉΓòÉ 35. Shredder Icon ΓòÉΓòÉΓòÉ

The shredder "eats" the documents or panels or pages you feed it.  You'll just
drag and drop the objects onto the shredder and they will be gone.


ΓòÉΓòÉΓòÉ 36. Toolbar and Element Status Line ΓòÉΓòÉΓòÉ

At the very bottom of HyperWrite-E's main screen you can see the names of the
toolbar icon being pointed to on the left and the names of the elements and
fonts on the right.


ΓòÉΓòÉΓòÉ 37. Getting Started -- Question 2 ΓòÉΓòÉΓòÉ

Q.  How do I learn to use HyperWrite-E quickly?
A.  First, learn how HyperWrite-E's different from other editors you may have used......

How HyperWrite-E's different....

A.  Second, double click on each of the five most common tasks below.

1.   Opening a new or existing document
2.   Opening a new or existing panel
3.   Using the element style list
4.   Creating  tables
5.   Saving Your Work

And finally you're started!  We suggest that the next lesson you take is
Creating Online Helps and Books.  Even if you don't  use it right away, you'll
learn the most about HyperWrite-E from that lesson.

Just double click on the main menu item of your choice.


ΓòÉΓòÉΓòÉ 38. Open an Existing or New Document ΓòÉΓòÉΓòÉ

To open an existing document, you may have to move this tutorial aside...just
point to "HyperWrite-E Help" , hold mousebutton one down and move...

1.   Click on the Demo.wf icon now........ and watch. (You just saw the
     auto-linking function of IPF, authored by HyperWrite - E.)

1.   To open a new  document, double click on the Create New Document icon.
     There's no need to close Demo.wf first.  Opening another document whether
     it's new or existing, replaces the one currently open.

     A "HyperWrite-E- wants- to-ask-you- something" screen appears.  The
     something it wants to ask you is what is the name of the document you want
     to create and the style file you want to associate with it.
2.   Type Lesson1.wf
3.   Press the tab key.
4.   Type Panel.Sty

     (Panel.Sty gets you to IPF helps or HyperWrite-E presentations.  A panel
     and an element style list appear.
5.   Press Enter.

     Your panel has the title Unnamed Panel.  You'll get to change that in the
     next lesson.


ΓòÉΓòÉΓòÉ 39. How HyperWrite's Different ΓòÉΓòÉΓòÉ

HyperWrite-E's different from other editors in many ways.  The first and most
apparent is that a great deal of function is devoted to online information.
One popular IBM program that displays online information is IPF .  IPF comes
with OS/2 and displays both context sensitive help and online books.
HyperWrite-E was first developed to give you an easier way to create IPF information.

(By the way, you can create hardcopy with HyperWrite-E also, but that's not
very different from other editors...)

Color, all types of linking  (jumps you can create within your document), panel
placement and size are just a few of the things that are unique to online
information and HyperWrite-E.

The next most apparent difference is that HyperWrite-E works with structures
that simulate those that IPF use.  HyperWrite-E calls those structures elements
.

Most editors require pressing of the Enter key or Tab key to move to the next
line.  They also require pressing the spacebar to indent.  HyperWrite-E does
all the formatting automatically.  So now you don't have to keep looking to see
where your cursor is while you type.

Now a discussion of styles.....any two paragraphs could look different.  One
could be indented five spaces and use plain text.


   Indented paragraph with plain text...

and one could be flush left with a italic text

Flush left  paragraph and italic text....

and another structure could use a bullet or a number

o    like this....

1.   And like this........

All of those things make up a style.

We provide one with HyperWrite-E,  Panel. Sty and it is "stylized" to look like
standard IPF .


ΓòÉΓòÉΓòÉ 40. Open a New or Existing Panel or Page ΓòÉΓòÉΓòÉ

You were told in the last lesson to press Enter.  If you're like the rest of
us, you will do that alot until you get used to titling your panels first.  The
title of your panel is  "Unnamed Panel" .

1.   Place the mouse pointer in the titlebar, press the Alt key and mousebutton
     1 and you'll get focus back on the titlebar and you can title it .
2.   Type Panel One and press Enter

To open a new panel ,

1.   Click once on the first icon of the toolbar.
     The cursor is placed automatically in the titlebar.
2.   Type the name of the panel  and press Enter.
     If you get Unnamed Panel again, go back to the first set of instructions
     at the top of this panel.


ΓòÉΓòÉΓòÉ 41. Use the Element Style List ΓòÉΓòÉΓòÉ

There are several things that make up a style and several things that make up
an element list.  When you bring up a document (new or existing) and you ask
for the PANEL.STY , one of the first things to appear is the element style list.

The element style list for PANEL.STY looks like this:

When you're ready to begin typing. you'll just doublelick on the element of
your choice and type.  The cursor will automatically place itself .  You don't
have to be concerned about indenting or structuring the text.

To practice using the element list, follow the steps below:

(You may have to move the tutorial screen around again to see what you're
doing, but that would be good practice !)

1.   Highlight Document on the Menu Bar.  Select New.
2.   Type Lesson2.wf on the first line and Panel.Sty on the next line.
      (Ignore the other fields.  HyperWrite-E's asking for translation information.)
     A panel and the element style list appear.
3.   Type the name Introduction in the panel title.
4.   Locate ordered list and doubleclick on it.
     The focus went to the new panel (the border turns yellow from gray) and
     the cursor is placed after the number 1.
5.   Press Enter once or twice and see new numbers appear.
6.   Now find the paragraph element and doubleclick on it.
     The paragraph is part of the ordered list so it is indented several
     spaces.
7.   Type and continue to type until the cursor wraps to the next line.
8.   Press Enter.  Notice that the cursor skips a line and waits for you to
     type again.  Pressing the Enter key in HyperWrite-E means "give me another
     one of those".
9.   Now place the cursor after the bottom structure symbol.
     The cursor gets pretty small....it's always the size of the thing to its
     immediate left.
10.  Double click with mousebutton 1 on definition list.
11.  Type a definition term.  How about the word "Font" ?
12.  Press the tab key and type a definition description.  How about "defines a
     typestyle and size in points " ?
13.  Press the Enter key.
14.  Type another definition term, press the tab key and type another
     definition description.

You have learned to use the element list which is the main text editor function
of HyperWrite-E.  The elements are named the same as they are in  IPF language.
You can play with the other elements.   If you don't know what a certain
element is though, refer to the IPF  guide.

Now for a very important and powerful feature!

You can change the element you first created by just marking it and
doubleclicking on another one.  If you want to change your paragraphs to
ordered list items, just mark them and doubleclick on the ordered list.

Try that with the paragraphs you created.

1.   Mark the paragraphs.
2.   Doubleclick on Ordered List.

That's a real timesaver!!

Now on to the next most common task.


ΓòÉΓòÉΓòÉ 42. Creating Tables ΓòÉΓòÉΓòÉ

For just a bit of practice, create another new panel by clicking once on the
New Panel Icon in the toolbar.

1.   Title the panel Tables.
     To create a table,  begin with a single click on  the table icon  in the toolbar.
2.   Delete the number 2 after "Rows:" and enter 5.
3.   Press the tab key and delete the number 2 after "Columns:"  Then type 4.
4.   Press Enter.
     A table with 5 rows and 4 columns appears.
5.   Type "This is the first cell in my table".
     Notice that the words wrap and the cell height grows automatically.
     Now let's change the number of columns from 4 to 6.
6.   Be sure the cursor is somewhere in the table.  Click on Create on the Menu
     Bar, Table and Update.
7.   Tab to the Columns field.  Delete the number 4 and type 6.
8.   Press Enter.
     The table is automatically updated.
9.   Practice typing text in the table cells.  To move between cells, use the
     Ctrl and arrow keys.  Also note that if you type a line of text with no
     spaces, the text will seem to disappear....you would see it reappear if
     you sized the panel larger.  For this exercise keep the words short so you
     can see the cells expand.
10.  Be sure the cursor is somewhere in the table.  Click on Create on the Menu
     Bar, Table and Update.
11.  Move to the Cell Widths field.  Currently it should have all asterisks.
12.  Replace the first asterisk with the number 15 (be sure that the 15 is
     followed by a comma and there are 5 remaining asterisks separated by
     commas.
13.  Press Enter.
     You now should be able to see that the first cell is wider than the rest.
     The 15 represents 15 characters.  However, you can also use picas (p), or
     pixels (x), if you need to define a cell width more exactly.


ΓòÉΓòÉΓòÉ 43. Saving Your Work ΓòÉΓòÉΓòÉ

To save your work, click on Document in the Menu Bar and Save.

Sometimes you want another copy of the same document.  If so, select Save as...
from the pulldown and type the second name the document will be known by.

 You can save individual panels by clicking on Panel on the Menu Bar and then
Save; however, if you've edited several panels, the fastest way is to save the
whole document.  Don't worry though.  If you forget to save a panel and you
close HyperWrite-E, you will be reminded before HyperWrite-E goes away.

HyperWrite-E also always asks you if you want to save the document that's open
before closing .


ΓòÉΓòÉΓòÉ 44. IPF Menu ΓòÉΓòÉΓòÉ

1.   Planning for online and importing
2.   Creating lists, paragraphs and tables
3.   Creating indexes and synonyms
4.   Graphics and Creating animation sequences
5.   Linking text, graphics and programs
6.   Creating split screen panels
7.   Exporting


ΓòÉΓòÉΓòÉ 45. Planning for Online ΓòÉΓòÉΓòÉ

The first step in planning is to look at all the different times your customer
may need to get information.  You'll probably decide that giving help for each
action that can be taken is a good idea.  However, you could do that in several
different ways because of all of the link capability you have.

For example, you could have a help screen displayed which is nothing more than
a menu or links to other helps, just like the menu you double clicked to get
here.  You could have help screens bring up an online book .

Or you could  have your user start with an online book.  Starting with a table
of contents might be helpful .

Whatever your plan, you will almost assuredly change it.  And the great thing
is, HyperWrite-E is always in build,test and build some more mode.  You can
prototype ideas quickly and 'til your heart's content.

Once you have decided your overall book or help design (you can add design of
your tutorial also.........this tutorial was authored with HyperWrite-E),
you'll then want to design different panel layouts.  Again, just simulate, test
and simulate again.

Finally you're ready to put your outline to computer display.  Assuming you
have written an outline... all good writers do .....you can bring up panels and
title each one.  Don't worry if you change the order later, you can change the
order in the HyperWrite-E table of contents very easily....we'll practice that later.

Importing already existing IPF coded files is easy.  Doubleclick on the word
importing and you can learn about it.

Doubleclick with mouse button 1 on "Creating lists, paragraphs and tables" from
the menu to your left.


ΓòÉΓòÉΓòÉ 46. Creating Lists, Paragraphs and Tables for Online ΓòÉΓòÉΓòÉ

This is almost the same lesson that's in the Getting Started part of this
tutorial.   We've added just three new things to learn.  If you don't think you
want the repeated practice, double click on the index and synonym item from the
online menu to your left.

There are several things that make up a style and several things that make up
an element .  An element can be made up of a structure, a font and a prefix.
(An example of a prefix would be the numbers in an ordered list or the word
WARNING before the warning note.)

 When you bring up a document (new or existing) and you ask for the PANEL.STY ,
one of the first things to appear is the element style list.

The element style list for PANEL.STY looks like this:

When you're ready to begin typing. you'll just doublelick on the element of
your choice and type.  The cursor will automatically place itself where  IPF
style does and the text wraps automatically.  You don't have to be concerned
about indenting or structuring the text.

In HyperWrite-E, pressing the Enter key means "Give me another one of those".

To practice using the element list, follow the steps below:

(You may have to move the tutorial screen around to see what you're doing, but
that's good practice !)

1.   Highlight Document on the Menu Bar.  Select New.
     This is the second way  to create a new document...it's  an easier way if
     the Create New Document icon is covered up.
     Type Lesson2.wf on the first line and Panel.Sty on the next line.
      (Ignore the other fields.  Remember, HyperWrite-E's asking for
     translation information.)
     A panel and the element style list appears.
2.   Type the name Introduction in the panel title.
3.   Locate ordered list and doubleclick on it.
     The focus goes to the new panel (the border turns from gray to yellow) and
     the cursor is placed after the first number 1.
4.   Press Enter once or twice and see the new numbers appear.
5.   Now press Ctrl and N.  The list is now nested,
6.   Now find the paragraph element and doubleclick on it.
     The paragraph is part of the ordered list so it is indented several
     spaces.
7.   Type and continue to type until the cursor wraps to the next line.
8.   Press Enter.  Notice that the cursor skips a line and waits for you to
     type again.  Pressing the Enter key in HyperWrite-E means "give me another
     one of those".
9.   Now place the cursor after the bottom most structure symbol.  The cursor
     will become very small...it always takes on the size of the thing next to it.
10.  Double click with mouse button 1 on definition list.
11.  Type a definition term.  How about the word "Online"?
12.  Press the tab key and type a definition description. How about "computer
     displayed " ?
13.  Press the Enter key.
14.  Type another definition term, press the tab key and type another
     definition description.
15.  Place the cursor to the right of the end structure.
16.  Now press Ctrl and P.  You have just used the key sequence for paragraph
     instead of double clicking on the element.  Almost all of the elements
     have keys assigned.

You have learned to use the element list which is the main text editor function
of HyperWrite-E.  Elements have the same names as they do in IPF.  If the name
we gave an element isn't obvious, the IPF guide will  help you.

Now for a very important and powerful feature!

You can change the element you first created by just marking it and double
clicking on another one.  If you want to change your paragraphs to ordered list
items, just mark them and doubleclick on the ordered list.

That can be a real timesaver!!

Now on to creating tables ...............

To create a table,  begin with a single click on  the table icon  in the toolbar.

1.   Press Enter right away.  You have a 2 column and 2 row table.
2.   Let's delete that table.  Be sure the cursor is on the table, click on
     Create and Delete.  You'll be asked if you are sure.  Click on OK.
3.   Delete the number 2 after "Rows:" and enter 5.
4.   Press the tab key and delete the number 2 after "Columns:"  Then type 4.
5.   Press Enter.
     A table with 5 rows and 4 columns appears.
6.   Type "This is the first cell in my table".
     Notice that the words wrap and the cell height grows automatically.
     Now let's change the number of columns from 4 to 6.
7.   Be sure the cursor is somewhere in the table.  Click on Create on the Menu
     Bar, Table and Update.
8.   Tab to the Columns field.  Delete the number 4 and type 6.
9.   Press Enter.
     The table is automatically updated.
10.  Practice typing text in the table cells.
     To move between cells, use the Ctrl and arrow keys.  Also note that if you
     type a line of text with no spaces, the text will seem to disappear....you
     would see it reappear if you sized the panel larger.  For this exercise
     keep the words short so you can see the cells heighten.
11.  Be sure the cursor is somewhere in the table.  Click on Create on the Menu
     Bar, Table and Update.
12.  Move to the Cell Widths field.
     Currently it should have all asterisks which means that they are all the
     same width.
13.  Replace the first asterisk with the number 15 (be sure that the 15 is
     followed by a comma and there are 5 remaining asterisks separated by
     commas.....practice makes perfect on this task).
14.  Press Enter.
     You now should be able to see that the first cell is wider than the rest.
     The 15 represents 15 characters.  However, you can also use picas (p), or
     pixels (x), if you need to define a cell width more exactly.

On to Creating indexes and synonyms...doubleclick on that choice from the menu
to your left.


ΓòÉΓòÉΓòÉ 47. Creating  Indexes and Synonyms ΓòÉΓòÉΓòÉ

Creating indexes with HyperWrite-E can be fun.  You can highlight a word like
HyperWrite-E, select Create, Index and Add.  The highlighted word becomes the
main index item.

1.   Try it by highlighting any word you have in your Introduction panel, and
     then click on Create, Index and Add.
2.   You're in the subindex window.  Type any word, press Enter and type
     another, press Enter and type another.
3.   Click on the OK pushbutton.
     An index window should have appeared with the word you highlighted as the
     leftmost word and the others should be indented and in in alphabetical order.
4.   Now highlight one of the words you added.
5.   Click on Create, Index, and Add.  You might have thought that Update was
     the obvious choice rather than Add again.  We'll explain Update later.
     You'll notice that the cursor is in the subindex window and your
     highlighted word is grayed.
6.   Type any word, press Enter and type another.
7.   Click on OK .
     You'll notice that the index now has three levels of index.
     If you repeated those steps you could extend the number of index levels to
     as many as you wanted.  However, if you're creating indexes for IPF, use
     only two index levels.
8.   Now, of the index items you created, only the one you took from the panel
     by highlighting word(s) in your panel will actually be "linked" to a
     panel, thereby causing that panel to display when you doubleclick on the
     index item.  To connect the other words to that panel you have to place
     your mouse pointer on the panel, press mouse button 2, drag and drop the
     icon onto the index item.
9.   What should have appeared is an icon that represents your "linked to "
     panel.  Click on your panel and the icon will disappear.
10.  The other fun thing you can do is drag and drop words into your index
     list.  Highlight a word (any word) with mouse button 1.
11.  Press mouse button 2 and hold it while you drag your icon over to the
     index list.  The word or words are placed alphabetically in the level you
     brought them to and under the heading you brought them.

Now that you know how to create index lists, we can try synonyms.  Creating
synonyms is a feature used in IPF or HyperWrite-E presentations.

By the way, we haven't forgotten that you need to know what update does for you
in indexing, but it will make more sense to learn that after you learn about
synonyms.........these are synonyms to index items.

1.   Click on Create, Synonym and Add.
2.   Type the word Create as the root.
3.   Press the tab key
4.   Type develop and press Enter.
5.   Type the word build and press Enter.
6.   Click on OK.
     A synonym list appears.
7.   Add another synonym root and synonyms.
     It really doesn't matter if the words make any sense or even if they are
     words.  Just getting the practice is important.
8.   Now bring up the index list by clicking on View and Index List.
9.   Now click on Create, Index (yes, Index), and Update.
     The synonyms appear and if you have an index item highlighted from the
     index list that would be in the first field.
10.  Highlight the synonym(s) you want to associate with the index item and
     press the spacebar.
11.  Select the pushbutton next to Combine and click on OK.
     If you had many, many panels in this document you would probably have many
     panel icons appear.  You would want to check each one and then if you
     didn't want the index item and the synonym associated with it, you would
     simply close the panel and drag it to the shredder to throw the
     association away.


ΓòÉΓòÉΓòÉ 48. Graphics and Creating Animation Sequences ΓòÉΓòÉΓòÉ

HyperWrite-E displays OS/2 bitmap and metafile graphics.  We have provided
several bitmaps to use during these lessons.  To see a list of them, click on
the graphics icon .

Now, let's put a graphic in a panel.

1.   Open a new panel by clicking on the New Panel Icon .
2.   Title your panel Graphics.
3.   Press Ctrl and P to start a paragraph and type the following:
     In HyperWrite-E, you can place your graphics inline, meaning immediately
     following.  Or you can place your graphic to the right, center or left of
     the panel.  And finally, you can fit the graphic so it takes the entire
     panel space.  In HyperWrite-E, the first thing you do is to click on the
     graphics icon.
4.   Now click on the Runin radio button to tell HyperWrite-E where to place
     your graphic.
5.   Doubleclick on the graphic named graph.bmp.  Look familiar?
     How about another picture...?... but let's place it to the right.
6.   Press Ctrl and P again....gives us a new line too......
7.   Click on the graphics icon.
8.   Fill the Right radiobutton.
9.   Doubleclick on the picture called paste.bmp.  This graphic should look
     familiar too.
     Now we'll fill an entire panel...........
10.  Open a new panel .
11.  Title your panel A bird
12.  Click on the graphics icon.
13.  Fill the Fit radiobutton.
14.  Doubleclick on the picture Owl1.

On to more fun!!

Animation is used in IPF panels or in HyperWrite-E presentations.

You won't be able to see animation if you are running on OS/2 1.3.  This is a
feature available in OS/2 2.0.  You can see the animation created in
HyperWrite-E though.

Press the Escape key to get rid of the flying bird.

1.   To create the flying bird, click on Create, Animation and Create.
2.   Type the word Nature in the first field.
3.   Click on the down arrow  to the right of the word Default.
     You have several selections to associate a panel style with your
     animation.
4.   Highlight Animate. It should replace the word default.
5.   Tab to the frames field and type 9.
6.   Skip the time field.  Tab to the Iterations field and type 10.
7.   Click on OK.
     A panel of 9 filmstrip cells appears.  Next you'll bring up the bitmaps
     that you need to place in the cells.
8.   Click on the graphics icon.  In the first field delete the existing text
     and replace with  fr*.bmp
     All of the frame bitmaps will be listed.
9.   Now click on the View pushbutton.
     The bird bitmaps appear.  You may have to resize the window to see all of
     the filmstrip cells and the bitmaps.
10.  Place your mouse pointer over the first bitmap, press mouse button 2 and
     drag the picture over to the first frame. Let go of mouse button 2.
     The bird appears in the first frame.  Don't worry if you put the wrong
     bird in or the wrong frame is filled.  Just do it again.  The first
     picture can always be replaced by another dropped on top of it.
11.  Now place focus on the filmstrip panel (named Nature) and click on Create,
     Animation and Play.  You should see your bird flapping its wings ten
     times.  If you had not put anything in the iterations field the bird would
     never stop flying.

Linking is next................you have used alot of the linking capability
already that was created with HyperWrite-E.


ΓòÉΓòÉΓòÉ 49. ACVP ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 50. Linking Text, Graphics and Programs ΓòÉΓòÉΓòÉ

Linking used to be so complex and with HyperWrite-E it is so simple.  It can
even be fun!

First, we'll learn how to do what we call a hypertext (emphasize "text") link.
You've used hypertext links when you double clicked on the menu items.  It's
linking text to something else.  The something else can be other text, a
picture, a panel or a program.

1.   Let's link to a panel first.  Bring up the panel list by clicking on the
     panel list icon.  You may want to resize the panel list and move it to the
     right of the screen.
2.   With mouse button 1, mark the first two words of the panel you have been editing.
3.   With mouse button 2, drag and drop (notice the chain link icon) from the
     highlighted text onto a panel title.  Make sure it's not the one you're editing.
4.   Bring focus back to the open panel.
5.   Now test your link by double clicking on the first two words which by now
     are green in color.  Your "linked to" panel should have appeared.
6.   Close the "linked to" panel.

If you wanted to link to a panel that contained only a graphic, you would do it
the same way.

1.   Let's link to the panel you filled with the owl earlier.  Be sure your
     panel list is still visible.
2.   With mouse button 1, mark a different word in the panel you have been editing.
3.   With mouse button 2, drag and drop from the highlighted text onto  panel
     title "A bird".
4.   Bring focus back to the open panel.
5.   Now test your link by double clicking on the word you highlighted earlier.
6.   The owl should appear.  Don't close the owl panel yet.

Now, we're going to link the owl's right eye to the introduction panel.  We
call that a hypergraphics link.

1.   Check to be sure the panel list is still visible.
2.   With mouse button 1 pressed, draw a box around the owl's right eye.
     Because the owl is dark in color, it may be hard to see.
3.   With mouse button 2, drag and drop onto the panel titled "Introduction".
4.   Bring focus back to the owl.
5.   Double click on the right eye and the introduction panel should appear.

You could draw any number of boxes in the owl picture and connect them to other panels.

How about connecting or linking the owl's left eye to the OS/2 E editor?

1.   This time you don't care if the panel list is visible.  With mouse button
     1 pressed, draw a box around the owl's left eye.
2.   Go up to the Menu Bar and select Panel, Link and Program....
3.   A dialog appears that asks for the program name.
4.   Type E.EXE in the first field and click on Link.
5.   Bring focus to the owl.
6.   Double click on the left eye.
7.   The E Editor should appear.
8.   Close the E Editor.


Now for some fancy graphics, linking and animation.  Locate demo.wf, double
click, sit back and watch the show!

You'll learn how to make linked to things appear automatically in "Using
Advanced Features".

Let's go on to create a split screen panel.  Double click on the "Creating
Split Screen Panels" title to your left.


ΓòÉΓòÉΓòÉ 51. Creating Split Screen Panels ΓòÉΓòÉΓòÉ

Split screen panels are useful for viewing a picture while your text scrolls
by, or to view different types of information all related to the same topic.
For this exercise, we will create a scrollable panel of text about the United
States that will appear to the left and a picture of the United States to the
right.

1.   Click on View and Panel style list.  A list of panel styles appears.
2.   Doubleclick with mouse button 1 on the Left35 (shorthand for it sits on
     the left and takes up 35% of the space ) style and title it United States.
3.   Press Ctrl and P and type the following.
4.   Be sure the panel style list is still visible and double click with
     mousebutton 1 on the Right65 (shorthand for it sits on the right and takes
     up 65% of the space) style.
5.   Title the panel USA map
6.   Click on the graphics icon.
7.   Select the center radiobutton and doubleclick on USA.BMP.
     A picture of a very pink USA should appear.
     Now that you have the two content panels, you want to place them inside
     another panel (we call it a main panel) to keep the two together all the time.
8.   Double click with mousebutton 1 on the panel style NONE80 (shorthand for
     no titlebar, scrollbars, etc and it takes up 80% of the space.
     Some part of all 3 panels should be visible.
9.   With mousebutton 2 drag and drop the text panel into the parent panel.  Do
     the same with the USA map panel.  Drag and drop it into the parent panel.



The text panel becomes 35% of the main panel and the picture panel becomes 65%
of that main panel.  Scroll your text panel.
 You can put any number of panels inside other panels with the technique you
just learned.  The source panel becomes your "inside" panel and the target
panel becomes the "main" panel.
Let's go back to the main menu by double clicking on the hand.


ΓòÉΓòÉΓòÉ 52. Importing and Exporting ΓòÉΓòÉΓòÉ

The many things we can bring into HyperWrite-E and export from HyperWrite-E are
things that make it additionally powerful.  You can import ASCII (the kind of
text that you create with an editor like PE or E.EXE) , BookMaster and  IPF.
Because IBM has an RTF (Rich Text Format which is Microsoft's editor format)
to IPF conversion program, we can even get those documents into HyperWrite-E.

What we can export from HyperWrite-E is BookMaster, IPF, ASCII, Inf and Hlp
(which is the "readable" form of IPF), PostScript and .BIF which is the form
that we can make into books readable by BookManager.
All imports and exports (except for PostScript) are done at the command line.
Stay tuned for that to be moved into HyperWrite-E, but for now, we have to do
that work outside.
The convention for importing files is:
BKMIN filename
or
IPFCIN filename
or
ASCIIN filename
After the conversion is done, you get a .wf document.  When you bring up
HyperWrite-E again, the .wf document is displayed.
The convention for exporting files is:
 BKMOUT filename BKMfilename
 or
 IPFCOUT filename IPFCfilename
 or
 BIFOUT filename BIFilename
 or
 ASCIIOUT filename ASCIIfilename
 PostScript will be explained in the "Printing" section of this tutorial.
One of the more useful things about importing and exporting is that you can
take the same HyperWrite-E document  and export it to IPF and to BookMaster and
to ASCII and to the other tagged formats.  Of course, there are many things
that don't have an equivalent so you have to think about what you're trying to
export to what, but with careful planning, it can be pretty easy to use the
same information and get it out into several formats.
Double click on the import or export of interest.


ΓòÉΓòÉΓòÉ 53. BKMIN ΓòÉΓòÉΓòÉ

BookMaster IN can be used to import an entire book or a file at a time.  There
are several things that HyperWrite-E wants, though, whether it's a book or a
file.  That is :userdoc and :body. and :h1. at the beginning of any file and
:euserdoc at the end.  Once exported, these can be removed if they don't make
sense in the formatter you are then moving the file to.
Whether the first words are true text or just comments, HyperWrite-E needs to
get a message that text is coming and it needs to "ready" a panel to capture
it. Userdoc, body and h1 provide just the right language.  Also, because
HyperWrite-E likes things to be very complete and structured, all beginning
tags have to be ended.
If you have lots of errors or messages while importing is taking place, you
should correct the errors and try it again.
The way to create an error file is to type BKMIN filename > BKM.err.
Once you have that, you can read it with the use of an ASCII editor and you'll
see the line numbers that caused the errors.


ΓòÉΓòÉΓòÉ 54. IPFCIN ΓòÉΓòÉΓòÉ

IPFCIN changes the IPF tagged information into a format that HyperWrite-E
understands.  It is called the .wf format.
HyperWrite-E understands all the tags related to the latest version of IPF, so
things like pushbuttons and global indexes are recognized.
There are no restrictions that we are aware of today in the size of the IPF
file you can bring in; all imbedded files are opened when imported. The result
is one big file.
It is assumed that if you are working with a team of folks on one IPF file, you
will be creating your own chapter or information unit, exporting that in IPF
tagged format and at the end of the cycle, importing all the files as one
imbedded file.  That's probably very similar to the way you work today.


ΓòÉΓòÉΓòÉ 55. BKMOUT ΓòÉΓòÉΓòÉ

Once you're ready to go to BookMaster tags , you will bring up the command line
(C:\ ) and type BKMOUT filename BKMfilename.

The first filename will be the .wf document name and the second filename will
be the one you want to store the tagged document in.  Most BookMaster documents
are stored on VM and are called script files.  Once downloaded, because the
disk file system on PC's have a three letter extension, the documents are
shortened to .scr documents.  You may want to continue to use that convention.
If you forget what you were supposed to type, just type BKMOUT at the command
line and the instructions will appear.


ΓòÉΓòÉΓòÉ 56. IPF Exports ΓòÉΓòÉΓòÉ

To export to IPF tagged source, go to the command line,  type IPFCOUT, the
HyperWrite-E document name and the name you want to store the document in.
Most documents are stored with .ipf extensions but it's a choice for you or
your team to make.
You can also export in HLP or INF formats which are the ones used for IPF helps
or online books.  Use HLPOUT from the command line  for exporting to these IPF
readable formats.
From your OS/2 window, if you type HLPOUT.EXE, all of the possible choices you
have are listed.


ΓòÉΓòÉΓòÉ 57. BIFOUT ΓòÉΓòÉΓòÉ

BIFOUT is meant to be used in conjunction with Build/2 which is being developed
in Boulder.  Without the product, we have been unable to test it so far, but
when complete, it will give you the ability to get simple BookMaster structures
into a BookManager format all on the workstation so you can create, compile and
view all on OS/2.  That should save alot of time!!


ΓòÉΓòÉΓòÉ 58. ASCIIIN ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 59. ASCIIOUT ΓòÉΓòÉΓòÉ


ΓòÉΓòÉΓòÉ 60. Creating Pages ΓòÉΓòÉΓòÉ

Creating pages is a shorter way of saying that you will want to get either
BookMaster tagged text or you want to print the HyperWrite-E document directly
from  your workstation or LAN PostScript printer.

There are several differences between creating panels for use in IPF and
creating pages for use in print or BookMaster.  BookMaster understands complex
tables and IPF does not.  BookMaster has book parts like front and backmatter.
BookMaster has several levels of headings that are given to us as elements.
Other than how they appear in the table of contents, headings have no meaning
in IPF.  BookMaster has things like label frames and screens.  IPF does not.

Because of these differences, we have tried to make it easier for you by giving
you menus that contain only the BookMaster or IPF functions.  The only time you
really have to pay attention to the differences is when you are exporting.  If
you want to export a document that was created with pagel.sty into Ipf tagged
source, we map things for you that don't have an exact equivalent or we simply
throw the element out.  The better way to export the same source to several
different places is Ipf to BookMaster.

The following lessons will cover just the differences.  We won't be covering
the basics so you'll need to go to the Getting Started section if you haven't
taken that lesson.


ΓòÉΓòÉΓòÉ 61. Creating Complex Tables ΓòÉΓòÉΓòÉ

Creating complex tables is one of the things that most people stay away from.
The reason is that, until now, it has been very difficult and time-consuming.
Let's create a table that has 5 rows and four columns and then change the last
row so it has only one column.
First we have to create a page.sty document.

1.   Double click on the Create New Document icon.  You'll be asked if you want
     to save the panels and document you were working on.  Remember, that
     opening a new or existing document replaces the one that's currently open.
     You can decide to save your practice document or not.
2.   Type Lesson4.wf
3.   Press the Tab key
4.   Type page.sty
5.
6.
     7.

     A new element list and panel appears.
8.   Type Complex Tables and press Enter.



To create a table,  begin with a single click on  the table icon  in the toolbar.

1.   Delete the number 2 after "Rows:" and enter 5
2.   Press the tab key and delete the number 2 after "Columns:"  Then type 4.
3.   Press Enter.
     A table with 5 rows and 4 columns appears
4.   Click on Create, Table and Create Row Layout.  A dialog asks for a name.
5.   Type Layout1.  Another screen appears.
6.   Click on the down arrow at the beginning of the row (another row appears
     with the same numbers  in each cell).
7.   Click on the up arrow and the numbers in the lower row of cells replace
     the upper row.
8.   Close the screen.
9.   Place the cursor in the last row.
10.  Click on Create, Table and Replace row layout.
11.  Select Layout1.  Easy??
12.  Now, let's change the first row into three columns by combining the first
     two.  Click on Create, Table and Create Row Layout.  A dialog asks for a name.
13.  Type Layout2.  The same first layout appears, numbered 1 through 4.
14.  Go to the second cell, delete the number 2 and type 1.
15.  Close the screen.
16.  Place your cursor in the first row of the table.
17.  Click on Create, Table and Replace row layout.
18.  Select Layout2 .

The principle behind the numbering is that every new cell gets a new number.
That's why the last row, having all the same numbers, was just one continuous
cell.  When you want to combine cells or "continue" a table cell, just continue
the previous number.


ΓòÉΓòÉΓòÉ 62. Creating Label frames and Screens ΓòÉΓòÉΓòÉ

Creating labeled notes and screens is very simple.  The only thing you have to
remember is that HyperWrite-E thinks of labeled notes and screens the same way
it does tables.  HyperWrite-E doesn't want you to put tables or screens or
labeled notes inside labeled notes or screens.

1.   Select Create and Label Frames.
2.   Click on Square


ΓòÉΓòÉΓòÉ 63. Printing ΓòÉΓòÉΓòÉ

Printing the panels you have created is possible through a PostScript printer
or plotter.  Once you learn how to create your own style file, you'll be glad
to have this feature for  presentations or nice looking correspondence with
your boss.
Learning how to create your own style file is under Advanced Features.


ΓòÉΓòÉΓòÉ 64. Advanced Features and Presentations ΓòÉΓòÉΓòÉ

Look at the IPF book that came with this driver to learn about advanced
features.  Once you know how to create your own styles, you can create some
nice