home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / BKRDR110.ZIP / SYSOP.DOC < prev   
Encoding:
Text File  |  1995-11-18  |  7.5 KB  |  178 lines
  1.                             Books On-Line
  2.                          BookReader Version 1.10
  3.  
  4. Documented by Matt Littel and Rajib K. Mitra
  5.  
  6.  
  7. Thank you for trying Books On-Line! Books On-Line will let you and your users
  8. read a wide variety of books quickly and easily while online. You can use any
  9. text file. There are hundreds of public domain books available as text files
  10. free of charge. Many of these books are avaiable via internet FTP.
  11.  
  12.  FTP: ftp.books.com          - cd /eBooks
  13.  FTP: uiarchive.cso.uiuc.edu - cd /pub/etext/gutenberg
  14.  
  15.  
  16.                            ...
  17.  
  18.  
  19. Installing BookReader
  20.  
  21. If you did not unzip BookReader with pkunzip -d, run the install.bat file to
  22. ensure that all files are in their appropriate directories.
  23. BookReader can run on any BBS capable of supplying a DORINFOx.DEF or DOOR.SYS
  24. drop file. If your BBS doesn't generate one, use a converter like DoorMaster.
  25. Execute BOOKRDR.EXE with the name of the drop file on the command line.
  26.  
  27.         For example:    BOOKRDR C:\BBS\DORINFO1.DEF
  28.  
  29. -----------------------------------
  30. Sample batch file for BBS execution
  31. -----------------------------------
  32. @ECHO OFF
  33. CD\BBS\BOOKRDR
  34. BOOKRDR \BBS\DORINFO1.DEF
  35. CD\BBS
  36. -------------------------------------
  37. Sample batch file for BBS errorlevels
  38. -------------------------------------
  39. @ECHO OFF
  40. :START
  41. CD\BBS
  42. RUNBBS
  43. if errorlevel 12 goto books
  44. if errorlevel 3 goto quit
  45. goto START
  46. :books
  47. cd BOOKRDR
  48. BOOKRDR ..\DOOR.SYS
  49. goto START
  50. :quit
  51. -------------------------------------
  52.  
  53.  
  54. To try BookReader locally type BOOKRDR with no parameters.
  55.  
  56. Most BBSes do not use nonstandard or multiport COM ports, but if you are sure
  57. that yours does, you will need to specify the port address and IRQ in the file
  58. BOOKRDR.IRQ. If you have more than 8 ports that you need to configure, you will
  59. need to have more than one copy of BookReader. The format of the BOOKRDR.IRQ
  60. file is:
  61.      Port 1 Base Address (hex)
  62.      Port 1 IRQ (decimal)
  63.      Port 2 Base Address (hex)
  64.      Port 2 IRQ (decimal)
  65. etc... up to 8 ports. I am assuming that it would be impractical to run
  66. BookReader more than 8 times on one computer. If your multi user BBS uses
  67. seperate computers you probably won't have to use nonstandard COM ports.
  68. MajorBBS and WorldGroup sysops, look for BookReader for MajorBBS coming soon.
  69.  
  70.  
  71. Adding Books
  72.  
  73. To add books to BookReader, place the text file in the TEXT\ directory and run
  74. BOOKADD.EXE. Specify that you want interactive mode and enter file descriptions
  75. when you are prompted.
  76. Text Formats:   BookReader is very picky about text formats. A properly
  77.               formatted text must have no more than 79 collumns and contain
  78.               both linefeeds and carriage returns. If a book is not formatted
  79.               correctly, BookAdd will try to format it. Please make sure that
  80.               the author's intent is not hindered by reformatting.
  81.                 BookReader has two methods of formatting text. Paragraph
  82.               reformatting will keep all information but it will lose track of
  83.               where lines begin and end, which can lead to reading difficulty.
  84.               Truncation will cut off any line greater than 79 collumns. It is
  85.               useful for 80 collumn formatted lists which go slightly over. Do
  86.               not use truncation on text formatted for more than 80 collumns or
  87.               you will lose information.
  88. Display formats:
  89.                 For ANSI mode, BookReader requires an 80x24 text mode (which
  90.               most terminal programs accomplish by using 80x25 mode with a
  91.               status bar.)
  92.  
  93. After you add a few books you might decide to change descriptions. To do this,
  94. run BOOKADD /E for the book editor.
  95.  
  96.  
  97. Maintainance
  98.  
  99. BookReader requires no regular maintainance, but we recommend that you run
  100. BOOKADD.EXE occasionally to keep files organized and make popular book lists.
  101. The command line for maintianance is:
  102.         BOOKADD [ /I | /A ]
  103. For interactive mode, type BOOKADD/I. For automatic mode, type BOOKADD/A. You
  104. can also just type BOOKADD and it will wait a few seconds to prompt a user but
  105. continue on if no one responds.
  106.  
  107.  
  108. Registration
  109.  
  110. BookReader will limit you to the first 100 lines of books unless you register
  111. it. We believe that BookReader will greatly improve your BBS's offerings and we
  112. think registration is worth the price. See REGISTER.TXT for details.
  113.  
  114.  
  115. Files in this archive:
  116.         BOOKRDR.EXE               BookReader executable
  117.         BOOKADD.EXE               Maintainance program
  118.         SYSOP.DOC                 This
  119.         REGISTER.TXT              Registration form
  120.         *.ANS, *.ASC, *.RIP       Various screens
  121.  
  122.  
  123. Legal Stuff:
  124.              BookReader is Copyright 1995 by Rajib K. Mitra. This program
  125. is protected by federal and international copyright laws. Rights to this
  126. program are as follows:
  127.    Registration is not required by this copyright aggreement, however the
  128. copyright owner may at any time alter someone's rights to an unregistered 
  129. copy, provided that notification is given.
  130.  
  131. "this package" refers to the shareware BookReader distribution, of which this
  132. file is a part, including, but not limited to, files named BOOKRDR.EXE and
  133. BOOKADD.EXE.
  134.  
  135. "this program" refers to computer-readable instructions within this package
  136. including, but not limited to, those in the files named BOOKRDR.EXE and
  137. BOOKADD.EXE.
  138.  
  139. The following is a description of the distribution and reproduction of files
  140. included within this package:
  141.  
  142.            This package may be reproduced and distributed but it must remain
  143. in the original condition. The only acceptable modifications are for reasons
  144. of compression or encryption, however, when it is decompressed or decrypted, it
  145. must return to its original form. If this package is archived or compiled,
  146. the product must not contain any other information, with the exception of a
  147. small comment that will be removed upon extraction. For example, a ZIP
  148. comment is allowed, however a file contained within the ZIP is forbidden,
  149. even if the file is an advertisment automatically added. No fee may be
  150. charged for this package in any form, with the exception of membership fees
  151. of the supplier. This program may be uploaded to a commercial BBS and it may
  152. be sold as part of a CD-ROM collection, but may not be sold by a shareware
  153. dealer on magnetic media without permission.
  154.  
  155. All rights reserved. The current owner of the copyright may at any time alter
  156. the copyright agreement or grant specific rights at any time. If he feels that
  157. you are inproperly using this program, he may withdraw your rights to this
  158. program.
  159.  
  160. Use at your own risk.      BookReader was in no way intended to cause damage
  161. of any form to anyone, however due to the varied computer systems available,
  162. it is nearly impossible for any program to guarantee correct operation on all
  163. systems. For that reason, I take no responsibility for any damage or
  164. wrongdoing caused by this program. Also I take no responsibility for illegal
  165. usage of this program. Any program can be abused.
  166.  
  167. If any of the agreement within this package is a violation of local, state,
  168. or federal laws, it is to be altered in a way which the intent of the author is
  169. still conveyed. If that is not possible, it is to be stricken from the
  170. aggreement, with notification given to the owner of the copyright.
  171.  
  172. Information given in this documentation is presented in the opinion of the
  173. author. Neither author nor distributor is not responsible for typographical
  174. errors.
  175.  
  176. Neither BOOKRDR.EXE nor BOOKADD.EXE may be altered under any circumstances
  177. without the payment of fees.
  178.