home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 November / PCO1197.ISO / FilesBBS / WIN95 / AOLP2032.EXE / DATA.Z / README.txt < prev    next >
Encoding:
Text File  |  1997-03-21  |  15.7 KB  |  300 lines

  1.                            
  2.               AOLpress 2.0 32-bit version for Windows: Readme
  3.          ---------------------------------------------------------
  4.  
  5. AOLpress is an integrated browsing and WYSIWYG authoring tool for the World
  6. Wide Web. AOLpress was designed both to make WWW authoring more accessible
  7. to beginners and to save valuable time and effort for professional Web
  8. publishers.
  9.  
  10. ---------------------------------------------------------------------------
  11.  
  12. 1.  System Requirements
  13.  
  14.         * RAM: 8 megabytes or more recommended
  15.         * Display: 256 colors or more
  16.         * Processor: 386 minimum
  17.         * System: Windows NT or Windows 95
  18.         * Disk Space Free: 8 megabytes
  19.  
  20. ---------------------------------------------------------------------------
  21.  
  22. 2.  Networking Requirements
  23.  
  24.      If you plan to use AOLpress as a browser and/or remote authoring
  25.      tool, you will need the following:
  26.  
  27.         * Internet service provider
  28.         * Modem
  29.         * Connection software (Trumpet winsock, Chameleon, etc.) If
  30.           you do not already have a WINSOCK.DLL, one will be installed
  31.           that allows you to operate AOLpress locally.
  32.  
  33.      AOLpress can also be installed locally. If you later decide to
  34.      install AOLpress with a network connection you will need to
  35.      delete the winsock.dll in the AOLpress directory for AOLpress to
  36.      use the network.
  37.  
  38. ---------------------------------------------------------------------------
  39.  
  40. 3.  Installation and Configuration
  41.  
  42.        1. Download the aolp20_32.exe self-extracting executable.
  43.        2. Double click on this self-extracting executable to extract
  44.           its contents to a temp directory and it will automatically
  45.           run setup.exe to install AOLpress.
  46.        3. Setup.exe will prompt you for a directory in which to
  47.           install AOLpress.
  48.        4. Launch AOLpress by double-clicking on its icon.
  49.  
  50.      AOLpress does not insist that you set a proxy server and a name
  51.      server but when using an ISP it is highly recommended that you
  52.      set them using Tools => Preferences => Network.
  53.      When using AOL as your service provider, you do not need to set
  54.      these.
  55.  
  56.      Known Problems with Installation and Download:
  57.  
  58.      1)  Extract=-9
  59.      If you receive an Extract=-9 when installing AOLpress it means
  60.      that the installer was damaged during the download.
  61.  
  62.      Workaround: The solution here is to download the file again.
  63.  
  64. ---------------------------------------------------------------------------
  65.  
  66. 4.  Known Bugs
  67.  
  68.         * AOLpress may crash when attempting to display certain
  69.           images. If you find that AOLpress crashes when attempting to
  70.           display a certain page, try changing the Image Display
  71.           Method in Tools->Preferences->General.
  72.         * AOLpress may crash when a page window is closed while in the
  73.           middle of submitting a Form or e-mail. It is best to stop
  74.           communication with the stop button before closing a page
  75.           window.
  76.         * AOLpress may crash when recursively webizing large directory
  77.           structures. This is because AOLpress is running out of
  78.           memory.  If you have this problem you can work around it by
  79.           webizing smaller pieces of the directory (use the Options
  80.           button in the Webize dialog).
  81.         * When several page windows are closed rapidly so that no page
  82.           windows are open, the menu bar in the AOLpress application
  83.           window may become inaccessible.  If this occurs you may exit
  84.           the app by clicking the close (X) button in the upper right
  85.           corner, or you may open a new page (and restore the proper
  86.           menus) by hitting Ctrl+N.
  87.         * After using Edit->Make Icon from a MiniWeb view, there is no
  88.           way to revert back to the default icon.
  89.         * Currently, there is no direct way to remove a page as being
  90.           the Stationery page for a MiniWeb. The workaround is to
  91.           create a  blank page then use Edit->Set Stationery to set it
  92.           as the stationery page.
  93.         * When editing an Image Map, you can not Undo changes if you
  94.           clear a shape or Clear All shapes.
  95.     * Displaying ART images: áThe default MIME type for the .art 
  96.       extension is incorrect. The result is that when attempting to 
  97.       display ART images from a local drive, AOLpress will display 
  98.       the broken image icon. 
  99.       To correct this, change the MIME type for .art extensions to 
  100.       image/art in the Prefs: Extensions/MIME dialog (Tools -> 
  101.       Prefereneces -> Extensions/MIME...).
  102.  
  103. ---------------------------------------------------------------------------
  104.  
  105. 5.  Notes and Hints
  106.  
  107.      General Authoring
  108.  
  109.         * AOLpress is rather strict about enforcing legal HTML. When
  110.           using AOLpress to edit pages which were created outside of
  111.           AOLpress, it may change HTML which does not comply to the
  112.           HTML 3.2 standard and specifications when saving it.  To
  113.           view a raw HTML file (before AOLpress has modified it)
  114.           choose Tools -> Show HTML and File -> Reload from the Show
  115.           HTML window. To save a raw HTML file (without being parsed
  116.           by AOLpress) choose File -> Save As from the Show HTML
  117.           window.
  118.         * Editing pages with Server Side Includes (SSI):  Editing
  119.           pages with Sever Side Includes is particular tricky in a
  120.           WYSIWYG environment. Generally if a SSI page is saved back
  121.           to the server, the server parsed content is incorrectly
  122.           saved in the HTML of the page.   There are two ways to edit
  123.           SSI pages when they are residing on an AOLserver.
  124.           Checking Server Side Include: Never Load in the
  125.           Tools->Preferences->Geveral dialog will cause AOLpress to
  126.           display the HTML of SSI pages without the server parsed
  127.           content.
  128.           Another way to obtain a SSI page without the server parsed
  129.           content is by choosing Tools -> Show HTML and File -> Reload
  130.           without SSI from the Show HTML window.  You can then make
  131.            changes in the HTML window, or parse and close the HTML
  132.           window and make the changes in the browser/editor window and
  133.           save it back to the server.
  134.           Either way, be careful when editing SSI pages from the
  135.           browser/editor window, because deleting a selection that
  136.           includes an SSI directive comment (which isn't displayed in
  137.           the browser window) will delete the comment.
  138.         * Selecting text and formatting: In HTML the formatting
  139.           information for a paragraph is located before the paragraph,
  140.           unlike word processors where the formatting information is
  141.           located at the end of the paragraph. Thus when selecting
  142.           text to replace formatting, copy/paste, or drag/drop it is
  143.           necessary to include the carriage return before the
  144.           paragraph if you want the formatting to be included.
  145.         * Netscape vs HTML 3.2. AOLpress gives you the choice of
  146.           whether the display attempts to conform to the HTML 3.2 spec
  147.           or to Netscape's interpretation of HTML. (There are fewer
  148.           differences than existed between HTML 3.0 and Netscape's
  149.           interpretation). In some cases this affects the actual HTML
  150.           AOLpress generates and saves:
  151.                                
  152.                         Tools->Preferences->General         Tools->Preferences->General
  153.                                Set to: Netscape                    Set to: HTML 3.2
  154.                         ---------------------------         ---------------------------
  155.    Multiple Title tags:      allowed                         not allowed (removed when
  156.                                                               saved)
  157.  
  158.    Multiple Body tags:       allowed                         not allowed (removed when
  159.                                                                saved)
  160.  
  161.    <Script>...<Script>:      allows <Script> in          forces <Script> to reside
  162.                              the BODY                          in HEAD
  163.         
  164.         * ">" within quoted strings: When viewing pages with the
  165.           preferences (Tools -> Preferences -> General) set to conform
  166.           to  Netscape, a greater than sign within a quoted string
  167.           (e.g. ...VALUE=">="... ) often terminates the tag even
  168.           though it should not. It usually displays the rest on the
  169.           tag in the page. To make the page viewable in both HTML 3.2
  170.           and Netscape mode (and generally acceptable by more
  171.           browsers) the "> "should be converted to ">". This can be
  172.           done by loading the page with prefs set to conform to HTML
  173.           3.2 and then saving it back or by manually making the change
  174.           in the Show HTML window.
  175.         * Authoring <Script>: When preferences
  176.           (Tools->Preferences->General) are set to conform to HTML
  177.           3.2, AOLpress places all <Script> tags in the HEAD of the
  178.           HTML document as specified in HTML 3.2. Setting the
  179.           Preferences to conform to Netscape will allow you to place
  180.           <Scripts> in the BODY but it is NOT recommended. Netscape's
  181.           guide for authoring Java Script  (their documentation may
  182.           require Netscape for proper viewing) strongly suggests
  183.           defining all script functions in the HEAD of the document
  184.           and using event handlers embedded within tags within the
  185.           BODY to call those functions.
  186.         * Deleting Files from a MiniWeb: Using the MiniWeb view
  187.           AOLpress allows the user to Edit=>Cut or backspace/delete an
  188.           icon (subsequently deleting the object) without the presence
  189.           of a confirmation dialog box.
  190.         * Concurrent Editing: AOLpress when used with a AOLserver
  191.           version 2.1 offers the ability to "lock" a page on a server
  192.           from other editors. If "locking" is not being used and
  193.           concurrent editing of the same page is occurring, changes
  194.           may be overwritten. This usually happens because someone
  195.           edits a cached version of a page and saves it. Be careful
  196.           and use reload often if multiple people are editing the same
  197.           page concurrently, especially when not using AOLserver.
  198.         * Authentication and saving to a server.  When saving a page
  199.           to a server AOLpress saves all of the page elements as well.
  200.            If you choose to cancel the authentication of a page you
  201.           will still be prompted for authentication of the page
  202.           elements that AOLpress is attempting to save.
  203.         * To edit text or images which are links without following the
  204.           link hold down the Control (Ctrl) key and click with the
  205.           mouse.
  206.         * To create a MiniWeb out of a directory, or to regenerate a
  207.           MiniWeb that isn't showing all of the files that it should
  208.           (after moving files outside of AOLpress) use the Webize
  209.           dialog by pressing Ctrl-Shift-W (or choose Tools=>Webize
  210.           from the MiniWeb view).
  211.         * Double-click on a link to display the linked page in a new
  212.           window.
  213.  
  214.      Tables
  215.  
  216.         * Selecting (highlighting) a table in the page view requires
  217.           that the paragraph before and after the table be selected.
  218.           Dragging the mouse across or double clicking on a table will
  219.           not highlight it but dragging the pointer from the paragraph
  220.           above to the paragraph beneath (or vice versa) will select
  221.           the table.
  222.         * Selecting tables within tables and tables at the end of the
  223.           page:  When a table is the first or last item in a table
  224.           cell the table is not selectable with the mouse. This is
  225.           because the selection of a table requires the selection of a
  226.           paragraph before and after the table. It is easy to avoid
  227.           this problem once you are aware of it. When creating tables
  228.           nested within tables insert paragraphs into the table cell
  229.           (by hitting Return) and place the cursor between these
  230.           paragraphs when choosing Create Table.  Extra paragraphs can
  231.           be easily deleted later.
  232.  
  233.           If you find yourself in this state, the workaround is to add
  234.           a <P> tag at each end of the table you are trying to select:
  235.              o Highlight some of the table content (as a reference
  236.                point) and choose Tools=>Show HTML.
  237.              o The highlighted selection should be highlighted in the
  238.                Show HTML window.
  239.                Insert <P> before the beginning table tag (<TABLE
  240.                BORDER .....>) to insert a paragraph before the table.
  241.              o Insert a <P> tag immediately after the closing table
  242.                tag (</TABLE>) to insert a paragraph after the table
  243.              o Select Parse and Close from the file menu in the Show
  244.                HTML window.
  245.         * Typing in tables: Resizing tables on the fly as text is
  246.           inserted is a lot of work and the typing speed in tables can
  247.           be slower as a result. The more cells there are in the
  248.           table, the slower the typing will be.
  249.  
  250.      Lists
  251.  
  252.         * More than one list element on the same line occurs when
  253.           there are lists nested inside a list without a paragraph tag
  254.           between the list tags.  This happens when Edit Complex lists
  255.           is checked in the General Preferences dialog. It is
  256.           impossible to insert text between two such list elements
  257.           from the page view. The workaround is to manually add <P>
  258.           tags after the <LI> tag in the Show HTML window.
  259.         * Exiting from nested lists: AOLpress only allows one level at
  260.           a time to be exited. If you wish to exit multiple nested
  261.           levels, choose Format=>Exit List Format multiple times and
  262.           delete the unwanted list elements when finished.
  263.  
  264.      MiniWebs
  265.  
  266.         * If MiniWebs don't correctly show the contents of the
  267.           directory, Webize the directory.
  268.           AOLpress can't tell if a MiniWeb filename has been changed
  269.           outside of AOLpress. If files or links in a MiniWeb are
  270.           modified outside of AOLpress, or if you ever notice that the
  271.           MiniWeb view is not reflecting the true status of the
  272.           directory, be sure to webize/regenerate (Tools->Webize
  273.           Directory) the MiniWeb.
  274.         * Deleting a MiniWeb deletes all of the contents in the
  275.           MiniWeb.
  276.         * Changing a filename in a MiniWeb
  277.              o does not update links in subwebs.
  278.              o does not update links in image maps
  279.              o removes anchor extensions from links it changes
  280.         * When editing long filenames in a MiniWeb using a list view
  281.           (Name, Title, or MIME type) the file name display allows for
  282.           ~27 characters.  After that the text exceeds the filename
  283.           box and is displayed behind the title.  The workaround is to
  284.           use the Web view to rename files longer than 27 characters.
  285.         * Browsing for MiniWeb icons by default shows only files with
  286.           .gif extension. Files of type gif, jpg, and xbm can be used
  287.           for MiniWeb icons.
  288.  
  289.      Miscellaneous
  290.  
  291.         * Opening or editing a page with a large amount of text
  292.           (>100K) is very slow with AOLpress, and AOLpress will crash
  293.           if given a file that is too large.
  294.         * Check Links will indicate "Could not find ..." when there is
  295.           a redirect at the specified URL.
  296.         * The hotlist window does not have a horizontal scroll bar.
  297.            To read long URLs the window may be resized larger.
  298.  
  299.                  Copyright ⌐ 1995-97 America Online, Inc.
  300.