            gg       _,g%+        $$S@g,_      gg
            $$  _gS"`            $$``^"?$@_  $$
            $$%$$2,._            S       `?$L $$
            $$```^^"?'_g@Q$$$$$$$Q@g_      ?$i$$
            $$  srb   j$$`_       _`$$;      $$$$
            ""        $$; :$       $;          `^""
                      $$; :$       $; ,,,
                      `$b._       _.d$'   kALIUM
                        "?S$$$$$$$S?"     CYANIde
                          g,_     _,g       group
                          `?$$$$$?`


                    -=  WORD 2 PANORAMA  =-


[Type::         m$-word to Chris Dragan's Panorama2 convertor
[Title::        word2panorama
[Version::      0.02beta
[Date::         mar2002
[File::         word2panorama.dot,clp2bmp.exe
[Format::       word template+win32 exe
[Requirez::     M$ WORD 2000 (or 97, but not tested)

[------------------------------------------------------------------]

[Creditz::
 [Code::        zZz/KCN

[------------------------------------------------------------------]

[Manual::

0. General info
0.0 Diz
  Word2panorama convertor is an experimental program, that
  converts a word document and saves it to Panorama's
  format.

rem: I've got a russian copy of word, so i don't know exactly
  how menu commands and so on are named in english one.
  Sorry for this - maybe you'll have to look for some
  controls i'll mention.

0.1 Ingridients
  The word2panorama convertor contains two files. One is a Word
  template (word2panorama.dot). And the other is a picture
  convertor.

  The template contains one macro (the convertor itself). Predefined
  styles and a toolbar are also in this template.

  The picture convertor is used to dump bitmaps from clipboard to
  .bmp files.

0.2 What can be converted
  Convertor detects and converts:
  - plain text (of course ;)
  - bold & italic text
  - paragraph justification (left,right,center,width justified)
  - spacing between paragraphs
  - headers, subheaders and other paragraph styles
  - preformated text (code)
  - hyperlinks
  - pictures (including most word in-text objects)

  Convertor features:
  - text title autosearch (by header style)
  - author name autosearch (gets from File->Properties->Author)
  - different schemes (default/columns/columns2) for text layout
  - paragraph spacings are converted to current and next paragraph
    spacings (space before -> current,space after -> next).
    Empty paragraphs are also converted to spacings (without <p>
    tag insertion).
  - font styles for Panorama are defined by word style names.
    If such name includes 'h__', the convertor will automatically
    insert a <font face> tag. The word style name can be made like
    this:
    Heading 1;h__header_def
    Heading 2;h__subheader_def
    h__code.
    The name portion after h__ till next ; or till eol is the name
    that's put to <font face...>
  - Preformated text is detected by font name (!). By default it's
    "Courier New" font. Sequental paragraphs of "Courier New" font
    will be converted to <font face code><pre> sequence.
    The convertor will only detect code if all the (!) paragraph is
    typed in "Corier New".
  - Hyperlinks are converted to <link external...>
  - Pictures are converted to bitmaps and stored in file's
    directory. The output text refers correctly to these pictures.
    A picture is converted via copying to the clipboard and then
    dumping to .bmp (by running clp2bmp.exe). Yet dunno other
    good ways to convert them.
    Also any other word objects, that can be in-text ones
    (like embedded Equation objects and so on) are converted
    to .bmps!
  - Ouputted text is automatically word-wrapped. By default after
    70th char.

1. Setting up
1.0 Installing
   - copy convertor files to your hd. pref. to c:\word2panorama\
     folder (because it's set up to this folder by default)
   - run m$ word
   - goto tools->Templates & Add Ins
   - click Add and browse to word2panorama.dot
     This will add a new global template. A word2panorama
     toolbar will also be available.
1.1 Setup
   - goto File->Open and open word2panorama.dot template
   - goto Tools->Macro->VB Editor
   - edit the word2panorama module. You'll see some customisable
     parametres in the first lines:

     Const WrapAround = 70
       This const sets text wrap-around char.

     Const PreFont = "Courier New"
       This const sets the name of a font which is detected
       as preformated text (code).

     Const ClpPath = "c:\word2panorama\"
       This const sets path to clp2bmp.exe file.
       It's important to set it to correct location (!!!!!) or
       pictures won't be converted!

   - goto Format->Style. Here you can change the default look of
     document

   - save and close the template

2. Preparing documents to conversion
   - open your file or
   - check styles: if the styles are correctly set for
     headings and so on - do the following:
     a) goto Format->Style
     b) rename default styles:
        Heading 1 -> h__header
        Heading 2 -> h__subheader
        Add _def to new style names if you need styles for default
        schema.
        Do not worry if word appends the new name to the old one.
        To make convertor insert a <font face xxxx> tag create
        or rename style to contain h__xxxx in name. (xxxx = anything)

     c) goto Tools->Templates & AddIns
     d) click Attach and attach a word2panorama template
     e) check Auto style refresh

     This will connect your doc to word2panorama template styles.

     Your doc is now almost ready to be converted.

     If the styles are not set correct - start with step c and
     apply h__ styles to text paragraphs.

     You can also apply h__code style. Although you should remember,
     that code paragraphs are detected by font face (default is
     "Courier New") not by style.

   - check pictures and objects: they shold be in-text ones,
     not floating over text.

3. Conversion process
   To start the conversion:
   - click 'Convert' button on word2panorama toolbar
   - a dialog will show up anabling you to edit output file name,
     article headline (title), author and used schema.
   After OK the conversion starts.
   When it finishes - you'll get a converted txt file
   with pictures, all located in your document's folder.


4. Known bugz/issues
  The main issue:
    This convertor was written without having any specifications on
    Panorama's markup format. So, it can produce unpredictable code ;)
    Be warned.

  Known issues:
    - only bmp files as pictures
    - unpredictable results when converting bold or italic or
      link, that's located inside preformated text (code)

