home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.wwiv.com
/
ftp.wwiv.com.zip
/
ftp.wwiv.com
/
pub
/
BBS
/
HM11A.ZIP
/
11111111.111
/
HMQUOTE.DOC
< prev
next >
Wrap
Text File
|
1992-08-16
|
4KB
|
106 lines
Harmony Quoter
HMquote is a small quoting program provided as a companion to Harmony BBS.
Every time HMQuote is executed, an ASCII and ANSI text file will be created
with a random quote. HMQuote is automatically installed with Harmony BBS.
Actually, it is installed in two ways with Harmony.
First, HMquote is set up to run from the batch file LOGFILES.BAT. Remember,
this batch file is run everytime a full logon is executed. HMQuote MUST be
run in the directory that all of it's data files are found. If they are not
there, HMQuote will abort. Therefore, the first thing LOGFILES.BAT must do is
change to the directory that HMquote and the data files are found. Harmony's
install puts these files in the SYSTEM directory.
Second, the quote files that HMquote creates are set up as Logon Text Files,
as explained in the configuration section of this documentation. Since these
files are displayed during a logon, a different quote will be displayed
everytime a user calls the system.
Here are the files that HMQuote MUST have in the current active directory to
work properly. (Please remember that all text files must have the standard
CR/LF at the end of each line) :
QHEADER.HMY : This text file contains the ASCII and ANSI header information
that will be put into the final quote files. For example -
Quote for the day :
-------------------
:Ansi
[0;1;32mQuote For The Day :
[0;33m------------------- [1;37m
The above example Qheader.hmy file will take all lines before the :Ansi line
is encountered, and place them at the head of the ASCII quote file that
HMquote generates. All text lines after the :Ansi line are then placed at the
head of ANSI quote file. This format MUST be followed if you wish to change
the headers for HMquote.
QUOTES.HMY : This is the actual text file of all the available quotes.
Obviously, you don't have to have just quotes in here. For example, you can
put small bits of trivia, or important events in history here also. Again,
Quotes.hmy must follow a strict format.
HMquote will ignore all the beginning lines that start with a semi-colon (;).
This is ONLY at the beginning of the file. No remarks are allowed anywhere
else.
The next line must consist of a number. The actual limit on this number has
not yet been determined. This number is the number of active quotes that are
in your file. HMquote will use this number to randomly pick one out of the
list. You MUST make sure that this number is accurate. If it is too high,
and Hmquote picks a number higher than the actual number of quotes that are
there, no quote file will be generated.
The rest of the file will be the quotes that HMquote will randomly choose
from. Quotes can consist of more than one line. If you wish to extend a
quote past one line, all extra lines MUST begin with a colon. Otherwise,
Hmquote will look at is as the beginning of a new quote.
The last line of Quotes.hmy must be :Done. This lets HMquote know that it is
officially the end of the file. Anything after that line is simply ignored.
Here is a sample Quotes.hmy file :
;Remember these lines will not
;be looked at by Hmquote.
3
This would be the first line of quote #1
:this would be the second line of quote #1
This would be quote #2
This would be the first line of quote #3
:this would be the second line of quote #3
:this would be the third line of quote #3
:this would be the fourth line of quote #3
:Done
As you can see with quote #3, these is no reasonable limit to the size of your
quotes.
If HMquote is run successfully, two output files will be created, they are
QUOTEAS.HMY and QUOTEAN.HMY. Quoteas.hmy is the ASCII text file that is
created, and Quotean.hmy is the ansi text file that is created. Each on of
them consists of their respective headers as defined in Qheader.hmy, and the
quote that HMquote randomly chose.
HMQUOTE, although a separate entity of Harmony BBS, is copyrighted with
Harmony BBS. All applicable copyright laws relevant to Harmony BBS are also
extended onto HMQUOTE.
HMQuote (C)Copyright Concord Software 1992