If you tick the Raw Convertion checkbox the Source File is also converted into an HTML file containing Document Title, Document Headline and Made By as described previously in the Standard Convert section.
Everything else is rewritten in the HTML File as it was in the Source File with the only exception that all ocurences of chr(10) are converted to <P>.
This convertion is good for long raw text documents that you just want to add to your home page without adding too much formatting.
This section describes how the HTML Converter is intended to be used.
1.1 The Idea
The idea behind the HTML Converter is that you should be able to make consistent and nice looking web pages while confronted with as little HTML code as possible.
The aim is to be able to maintain the text of your web pages in simple ascii format without having to see all of the HTML code.
1.2 The Files
Your web files are divided into two categories:
1) The Source Files. These are the ascii text files you will create and maintain (with a minimum of HTML coding).
2) The Destination files. These are the HTML files you will upload to your web server.
These two categories are held in seperate directories making it simpe to distinguish between files that should be uploaded and the Source files.
Each Source file is converted to a destination file in HTML format but you can have more destination files than Source files.
All graphic files, files for download etc are placed together with the destination files.
1.3 Usage
To make a destination HTML file do the following:
1) Make directories for your Source files and your destination files (using the Shift-Ctrl-N on tthe system screen)
2) Start the HTML Converter
3) Setup a HTML Converter Style (see section 2)
4) Open the Convert dialog (Press Enter or click the Conv button)
5) Enter the name of the source file you want to convert in the File Name field
6) Edit the Source file by pressing the Edit button (if the file does not exist it will be created for you0
7) Save the Source File (from the editor, Ctrl-S)
8) Convert the Source File to a HTML file by pressing the Convert button
9) Now, the generated file is automatically launched in the web browser (proviided that you have installed it)
5. Contacting PocketIQ5
6. How to register5
PocketIQ can be contacted in a number of ways, for either support or registering your software.
Internet:
http://www.PocketIQ.com
Telephone / Fax:
+44 (0)1234 353970
Email:
Pythia@PocketIQ.com
support@PocketIQ.com
Post:
44 Harpur Street
Bedford
Bedfordshire
MK40 2QT
England
Registered users of HTML Converter are entitled to receive free upgrades via the internet or on floppy disk, as they become available.
For details on how to get latest version see "Contacting PocketIQ". If you do not have access to the internet send a stamped addressed envelope with a PC formatted floppy disk to the address shown.
Please note that the free upgrades offer excludes postage fees & hardware costs.
The Pocket IQ End User Licence Agreement (EULA) is a legal agreement between you and Pocket IQ Limited. By downloading or installing this SOFTWARE, you agree to be bound by the terms of this Agreement. If you do not agree to the terms of this Agreement, remove this SOFTWARE immediately.
Pocket IQ END USER LICENCE AGREEMENT (EULA)
This licence refers to any product which is distributed by Pocket IQ.
GRANT OF LICENCE
This Pocket IQ Licence Agreement ("Licence") permits you to use one copy of this product, on multiple machines which may include user documentation provided in electronic form ("SOFTWARE"), providing it is for the sole, exclusive use of the registered user. The SOFTWARE is licensed as a single product. Its component parts may not be separated for use on more than one computer or by more than one user at any one time.
COPYRIGHT
The SOFTWARE (including any images and text incorporated into the product) is owned by Pocket IQ and the independent application author, or its suppliers and is protected by English copyright laws and international treaty provisions.
REVERSE TRANSLATION
The SOFTWARE, including all related program files may not be altered in any way. Reverse Translation is expressly forbidden without written permission of the Pocket IQ and the independent application author.
LIMITED WARRANTY
To the maximum extent permitted by applicable law, Pocket IQ and the independent application author disclaims all warranties, either express or implied, including but not limited to warranties of merchantability and fitness for a particular purpose. In no event shall Pocket IQ, the independent application author or its suppliers be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use or inability to use this Pocket IQ product.
The SOFTWARE is supplied 'as is' and no advice or technical support is guaranteed from Pocket IQ or any third party.
0. HTML ConverterE
1999-2000 Marc de Oliveira & PocketIQ
Internet: http://www.PocketIQ.com
E-mail: Pythia@PocketIQ.com
The following section describes how to setup the HTML Converter.
2.1 Document Style
The HTML Converter supports multible setup definitions. If you are managing different home pages with different look and feel you can define a seperate setup for each home page.
The Document Style field is used to distinguish between your setup definitions.
You can either select a setup definition by pressing the Left and Right keys (or Left and Right arrow icons), or you can create a new Document Style from the Style dialog (Shift-Ctrl-S or click the Style button on the toolbar).
You can edit the current Document Style by pressing the Space bar (you can also access the current Document Style by clicking the Curr button on the toolbar or the Edit button on the Style dialog).
2.2 From Dir
This field holds the path to the source files of the current Document Style.
This is where your simple text files are stored.
The From File field is saved as part of the setup for that specific Document Type.
2.3 To Dir
This field holds the path to your destination files.
This is where the converted HTML-files are placed by the program.
The To File field is saved as part of the setup for that specific Document Type.
2.4 Made By
The content of this field will be added to the bottom of each file during convertion followed by the curent date.
This field should include something like:
<I>Last updated by <A HREF="mailto:[YOUR E-MAIL]">[YOUR NAME]</A> on</I>
but you can also include anything else that you want to place at the end of each page.
The Made By field is saved as part of the setup for that specific Document Type.
2.5 Horisontal Ruler
The content of this field is always inserted on the following places on every HTML document:
1) after the Page Heading
2) at the end of the page (just before the contents of the Made By field)
3) everywhere the keyword <HR> is found in the Source Document
The field will usually contain something like:
<CENTER><IMG SRC="hr.gif"></CENTER>
The Horisontal Ruler field is saved as part of the setup for that specific Document Type.
2.6 Init String
The content of this field is inserted at the begining of every HTML document.
Here you can specify the initialization string of the HTML page (background graphic,
The content of this field is inserted at the begining of every HTML document.
The field will usually contain something like:
<IMG SRC="head.gif">
If this field is blank the Document Title will be shown at the top of the HTML document instead of the graphic.
If you do not want any heading (neither title nor graphic) set this field to
<REM>
or something else that will not be shown on the page.
The Head Graphic field is saved as part of the setup for that specific Document Type.
2.9 Defalut File Name
This field holds the name of the file that you will usually want to work with (without path or extention).
The Default File Name is saved as part of the setup for that specific Document Type.
Pocket IQ applications can be registered exclusively through Palmscape, the leading online store for the EPOC platform.
To register this product simply visit the Pocket IQ internet site and follow the registration instructions.
Alternatively you can register directly with Palmscape in any of the following ways:
Online Orders:
Purchase online via Palmscape's secure online service. Simply visit www.palmscape.com, and select the "Buy now" link. Palmscape accept most major credit cards (see below).
Telephone \ Fax orders:
Palmscape accept telephone orders via the United Kingdom office which can be reached on +44 (0)1234 353970.
Postal Orders:
Payment can be made by UK Cheque, Cash or Credit Card direct to the Palmscape office, located at:
44 Harpur Street
Bedford
Bedfordshire
MK40 2QT
England.
Please mark clearly that you wish to purchase this application.
Payment types:
Palmscape accept major Credit cards, Switch, Delta as well as UK Cheque, Eurocheque and Cash. If you are paying in any currency other than GB Pounds please add 10% to cover conversion fees.
To convert a simple text document to an advanced HTML document you must open the Convert File dialog using Shift-Ctrl-C (you can also press Enter or click the Conv toolbar button).
The Convert button on the Convert File dialog will convert the text file to HTML. If the Raw Convertion field is not tagged the convertion will be a Standard Convertion. If the field is tagged the convertion will be a Raw Convertion (the raw convertion is described in the next section).
When the Convert button is pressed the text file
<From Dir>\<File Name>.txt
is converted to the following HTML file:
<To Dir>\<File Name>.htm
if the Default checkbox is checked a file named "default.html" will be generated instead.
You can change the name of the default file from the Preference screen (Ctrl-K).
The convertion follows the following structure:
3.1 Document Title
The first line of the Source File is interpreted as the Document Title.
The Document Title is specified in the heading of the HTML document.
If the Head Graphic field is empty the Docuemnt Title is also added as a Headline (<H1>) with a link to the page "default.html" at the top of the document body.
3.1.2 Document Headline
The second line of the Source File is interpreted as the Docuemnt Headline.
The Document Headline is placed on the top of the HTML body (after the Head Graphic, if there is one).
3.1.3 Other Headlines
You can define headlines in the Source File by adding blank lines.
Blank lines are interpreted in the following way:
1 blank line converts the following line to a bold line (<B>).
2 blank lines converts the following line to a level 3 heading (<H3>)
3 blank lines converts the following line to a level 2 heading (<H2>)
4 blank lines converts the following line to a level 1 heading (<H1>)
This text:
"This is some text.
This is coverted to bold
While this will remain normal text."
will be converted to this:
"This is some text.
This is coverted to bold
While this will remain normal text."
3.1.4 Tables
You can specify simple tables in the Source File by using the keyword <MDOTAB> in the following way:
"<MDOTAB>"
<No Of Rows> <No Of Columns> <Border Width>
<Cell 1>
<Cell 2>
<Cell 3>
...
To make a table containing translations (three rows, to columns) you could do this:
<MDOTAB>
3 2 10
English
Danish
House
Hus
Wine
Vin
The above section will be converted to the following HTML code:
<table width=10>
<tr><td>English</td><td>Danish</td></tr>
<tr><td>House</td><td>Hus</td></tr>
<tr><td>Wine</td><td>Vin</td></tr>
</table>
3.1.5 Lines
Each line in the Source file will be implemented as a paragraph in the converted HTML file (<P>).
As the converter can only read 250 characters of a line, longer paragrahs must be made using the ">" token.
A line beginning with the ">" token is interpreted as the continuation of the previous line (ie there will not be added a <P> keyword to that line).
These two lines
>will be interpreted as one paragraph.
But these two lines
will be interpreted as two paragraphs.
3.1.6 Lists
Lists are specified using indentation.
If you add a space charater at the begining of a line, that line will be converted to a bullet in an unnumbered list (<UL>).
The following lines will be added to that bullet.
All succeeding lines begining with a space character will be added as succeeding bullets to the list.
To make sub lists you just increse the number of space characters in the begining of the lines.
Note 1: You can only change one level at a time (you cannot go from level
3 directly to level 1).
Note 2: To end the list you have to use the </UL> token (must be in upper case) on a seperate line.
If you do not remember this the rest of the text will be inserted under the last bullet point of the list.
RHTML Converter 1.3 for the Psion Series 5 and 5mx (C) Marc de Oliveira & PocketIQ 1999-2000
1) Execute the HTMLConv.sis file on your pc or Psion.
2) Choose C or D drive for the installation (make sure that there is enought disk space).
3) The program will install itself.
Installation from ZIP file:
1) Make sure the \System folder is shown on your Series 5 system screen. If it's not, enable it in the 'Preferences' dialogue.
2) Using PsiWin copy the files PYTHIA.OPO, PIQInfo.OPO, PIQInfo.RSC and PIQInfo.MBM to the folder \system\opl (you might have to create the folder)
3) Go into \System\Apps on C: or D: and make a new folder called "HTMLConv"
4) Using PsiWin, copy the following files to the new \System\Apps\HTMLConv folder:
HTMLConv.app
HTMLConv.aif
HTMLConv.mbm
HTMLConv.hlp
HTMLCrea.opo
4) Copy the files systinfo.opx and sysram1.opx in the folder \system\opx
5) A new icon should appear on your Extras bar
Problems
--------
1. Read only files
Some times files become read only while being installed. None of the files should be read only. If you get any errors like the program is unable to write information to your Psion go through the program files to see if some of them are read only.
In the system-view you can open the file property window by selecting (highlighting) a file and pressing Ctrl-P. In the property window you can see and set/clear the read only checkbox.
2. Copying between C and D
Be very careful when you move or copy applications between the C and D drives. It seems that the Psion is not correctly updated when applicaions are copied from C to D or vice versa.
Always delete the application directory from one drive before reinstalling on the other drive.
3. Low on battery
When starting up this program for the first time a lot of writing is done to the disk. If your machine is low on battery these writes can go wrong and turn the application files bad. This should only be an issue when running the application the first time.
4. Not enough memory
This program needs up to 300 Kb of free memory on the C drive. If you try to run the program with less than 300 Kb of free memory on the C drive it may not behave as expected.
Usage:
------
Press Ctrl+Shift+H to see help file.
Bugs:
-----
- When opening the same HTML file twice with the Web Browser it might be cashed and, hence, not automatically reloaded. To reload the file press Ctrl-R.
Registering:
------------
Registering the program will give you the following benefits:
1) The register window will not pop up on startup
2) You get free support via e-mail (Pythia@PocketIQ.com)
3) Your suggestions to new functionalities will be implemented (as far as resources permits it)
How to register
Go to the PocketIQ home page at:
http://www.PocketIQ.com
Here you can register using credit card or cheque.
After receiving your registering fee I will mail you a Key that you can use to register the program.
Made by:
--------
Marc de Oliveira
for Pythia Information & PocketIQ
Web: http://www.PocketIQ.com
E-mail: Pythia@PocketIQ.com
History:
--------
1999.08.14: Version 1.0
1999.08.29: Version 1.0.1
- Installation bug fixed
1999.09.11: Version 1.1.4
- Source files can now be selected for editing or convertion from a pop-list.
- The name of the default file can now be defined as a preference (Ctrl-K).
- The delay needed when starting up the web browser can be setup in the preference screen (default is 120).
- When opening a HTML document in the web browser a reload is made to prevent a previously cached version to be displayed.
- Bug fix: Last character is duplicated.
- Bug fix: Using a source folder with no .TXT files gave an error.
2000.01.20: Version 1.2
- Released through PocketIQ.
- Graphics are adjusted to the current screen size, so that it should work on any EPOC machine.
- After agreement with Igor Akaev the HTML.S5 help file is shipped with HTML Converter. You can open the file by pressing Shift-Ctrl-I.
2000.04.06: Version 1.2.1
- A new preference lets you set up your default converter (Standard or Raw).
2000.05.01: Version 1.2.2
- The maksimum size of Ascii source files is increased from 2Kb to 10Kb.
2000.07.31: Version 1.3
- "Editor" by Symbian is integrated in HTML Converter as the editor for maintaining text files. This removes the size restriction of text files and adds features like search, zoom etc.
(.txt)