Both `DIARY-2000' and this doc. file are Copyright. (c) 1995 Dave Freeman. ___________________________ ===================================== HOW TO CUSTOMISE `DIARY - 2000' ===================================== 1. CHANGING THE BATCH FILES (DB.bat, SS.bat, WP.bat, TIME.bat and CALC.bat) TO POINT TO YOUR OWN PROGRAMS: ----------------------------------------------------- This is something that you MUST do if you want to use the facilities to open your system Clock, system Calculator, Address Book, Accounts and Word Processor from `Diary-2000'. First load the DB.bat file into QED (or any ASCII text editor). The current file reads - Stack=8000 ; sets stack size reuired by program CD Work:Superbase ; changes current dir. to Work:Superbase SBp ; start program called `SBp' If your Address Book/Database program needs a stack size to be set, amend the first line to show required stack size. If it does not need a stack, you can delete the first line. Change the second line to read- CD and the path to the directory containing your Address Book program. Change the third line to read- Name of your Address Book program. When you have done that, save the file back to the `Diary-200' program disk under the same name, `DB.bat'. Do the same thing with the files `SS.bat' (pointing to the path and name of your Accounts or Spreadsheet program) and `WP.bat' (pointing to your Word Processor). The file `TIME.bat' points to the Amiga's system clock, but ONLY if you have added a battery-backed clock to your system. If you have a clock installed but clicking on any `Time/Date' box does not display a digital clock on the screen, load the TIME.bat file into QED and check that the `path' is correct for your system. If not, edit the line to read - RUN and the full path to your system clock, then the `tool-types' as shown in the original batch file. (You can also edit the `tool-types' in the batch file to vary the clock display to your personal taste -- see Amiga Manual). The CALC.bat file points to the Amiga's built-in calculator. If this does not display on the screen when you click in any `Calculator' box, check that the `path' shown in the batch file is correct for your system. If not, change the line to read - RUN and the full path to your system calculator tool. After editing, save the altered batch files back onto your program disk under their original name. IMPORTANT NOTE: After you have edited and saved a batch file back to your disk, use the Workbench "Icons - Information" menu to check that the batch files `script' bit is set. It must be set (ticked) or the batch file will not be executed. 2. CHANGING THE SCREEN COLOURS: ------------------------------- One of my pet hates is other people's programs that change my Workbench colours. One of the main reasons why I did NOT make this disk self-booting was so as not to impose MY colours on the user. Having said that, you MAY find that `DIARY-2000' does not display very well with your default Workbench colourscheme. You can easily change the colours by clicking ONCE on the opening screen's `Change Palette Colours' panel (to select a new palette), then on the `Change Pens/Paper Colours' panel to set a new `Amigaguide/Pens' file. THE `CHANGE PALETTE COLOURS' BOX - Clicking once on this box will bring the Amiga's `Palette Editor' to the front screen. (If it does not appear on the screen, first check that you have loaded it from your WB System Disk, then check that the `Diary' script-file (line no. 23) shows the correct path to your Palette Editor; if the path is not correct, amend the script-file as necessary. When the `Palette Editor' appears on the screen, use the slider bars to change the four Workbench colours until you have a scheme that you like. Click the `USE' button at the bottom of the Editor's window to save the colours to the RAM disk's ENV directory. NB: You may get a much improved display by ALSO changing the `Amigaguide/Pens' file --- see below. To see the colours that I have used whilst writing this program set the four palette colours and the Amigaguide/Pens as follows - R. G. B. Screen Colour Amigaguide/Pens (see below) ----------- ------------- -------------- Col.0 15 15 15 White 2101301 Col.1 0 0 0 Black Col.2 7 10 14 Blue Col.3 15 14 7 Yellow On an Amiga running WB2, you can select pre-set WB colours by opening the `Palette Editor', then pressing combinations of the `RightAmiga' key plus any number from 1 to 9 inclusive. This may or may not produce the same colour combinations on other WB versions, but the WB2 pre-set palettes and my recommended `Amigaguide/Pens' settings for each one are as follows - Key combinations Col.No. R. G. B. Scrn. Col. A'guide/Pens ---------------- ------- ----------- ---------- ------------ RightAmiga + 1 0 11 10 9 Brown 31032202 1 0 0 0 Black or 12310022 2 15 15 15 White 3 6 8 11 Dark Blue RightAmiga + 2 0 8 10 12 Blue 01302232 1 0 0 0 Black or 11013222 2 15 15 15 White 3 15 12 9 Light Orange RightAmiga + 3 0 8 10 12 Blue 02302232 1 0 0 0 Black or 11013222 2 15 15 15 White 3 14 9 7 Dark Orange RightAmiga + 4 0 5 11 10 Sea Green 31032202 1 0 0 0 Black or 12310022 2 15 15 15 White 3 5 7 10 Dark Blue RightAmiga + 5 0 9 11 13 Light Blue 02302232 1 0 0 0 Black or 12310022 2 15 15 15 White 3 6 8 11 Dark Blue RightAmiga + 6 0 10 9 8 Brown 01302232 1 0 0 0 Black or 11003303 2 15 15 15 White 3 15 13 11 Buff RightAmiga + 7 0 12 12 11 Grey-Green 31032202 1 0 0 0 Black or 11310222 2 15 15 15 White 3 9 10 11 Slate Blue RightAmiga + 8 0 12 9 9 Pink 31032202 1 0 0 0 Black or 12310022 2 15 15 15 White 3 11 6 7 Dark Red RightAmiga + 9 0 10 9 6 Dark Gold 31032202 1 0 0 0 Black or 12310022 2 15 15 15 White 3 7 7 9 Purple THE `CHANGE PENS/PAPER COLOUR' BOX - When you click in this panel you will open-up a SHELL window. Type the following at the SHELL prompt - SETENV AMIGAGUIDE/PENS (then press ENTER) (where is the string of numbers defining which colours should be used for screen background, boxes and text). e.g. for the first palette shown above (Rt.Am.+1), enter AMIGAGUIDE/PENS 31032202 Defining the `Pens' colours is explained in the `Amigaguide Help File' which is displayed from any `Diary-2000' screen when you press the keyboard's HELP key. After you have entered the Amigaguide/Pens, close the Shell, then QUIT `Diary-2000' and RE-START IT AGAIN. You MUST re-start the program to set the new `pen' colours. Try the suggested pen colours in the above table, but don't be afraid to experiment with your own settings. Finally, if you have clicked on the `USE' button in the `Palette Editor' and used the DOS command `SETENV', the palette and pens will only be stored on the RAM disk; it will be lost when you power-down or re-boot your machine. To store them PERMANENTLY (they will be used for ALL WB screens), click the `SAVE' button in the `Palette Editor' and copy the Amigaguide `Pens' text-file to your `Sys:Prefs/Env-Archive/Amigaguide' directory. 3. DISK CONFIGERATIONS: ----------------------- `Diary-2000' runs best on a hard disk system. It will perform in exactly the same way if you have TWO floppy disk drives, but it runs noticeably more slowly. If you have only a single floppy disk drive, `Diary-2000' will still operate in the same way but instead of saving generated external text files to a separate disk it will save them to the program disk; you will soon face the problem of what to do when the program disk becomes full. To help clarify this, APPENDIX `A' lists all the text files that can be generated from `Diary-2000' and shows whether they are saved specifically to the program disk or to any disk in drive DF0: With two disk drives, you can use a separate disk (in drive df0:) to store most of the text files. IF YOU HAVE ONLY ONE DISK DRIVE (df0:) - Put the program disk into Df0: and start `Diary-2000'. ALL the text files that you generate wilL be saved onto the program disk, so it will probably become full long before the end of the year 2000. You may be able to free some space on the program disk by first checking that you don't already have some of the utilities on your `System' disk, (eg AMIGAGUIDE, QED, PPMORE, PPSHOW and the Amigaguide and PowerPacker libraries). If you already have any of these utilities and PROVIDED THEY ARE IN YOUR SYSTEMS `PATH', you can delete any duplicated files from the `Diary-2000' disk. (To add a program into your system's `path' you must add a line to your `startup-sequence' file --- see you Amiga Operating Manual). To conserve more space, you might want NOT to put any pictures onto the disk (losing the `Picture of the Month' facility). In that case, you can also delete PPSHOW from the program disk. More space can be freed if you copy all the `Docs' files and PPMORE to a separate disk. If you still find that the program disk becomes full, you should copy your old diary page files and mail-log files to an archive disk and then delete them from the `Diary-2000' disk. You can also delete any `Holidays' files at the end of each year and probably the `Memo' files as well. WITH TWO FLOPPY DISK DRIVES (df0: and df1:) - Put the `Diary-2000' program disk into DRIVE DF1: and a blank disk to hold your generated `page' files into drive df0: It is important to put both disks into the correct drive because most text files will be saved to the disk in drive df0:, regardless of its name. (See APPENDIX `A'). The comments in the preceding section (ONE DISK DRIVE) concerning deleting programs you may already have on your system also apply to users with TWO disk drives, but unless your program disk becomes full, you may think that deleting files is not worth the hassle. USING `DIARY-2000' WITH A HARD DISK SYSTEM - If you have a hard disk drive, copy the `Diary-2000' disk to a new drawer on your hard disk. Check for duplicated utilities (see above section- ONE DISK DRIVE). If you don't already have AMIGAGUIDE, QED, etc on your system you might prefer to put these programs into other directories where they can be more easily accessed by other programs (eg Sys:Utilities or Sys:c). If you do this, the directories to which you copy them MUST be in the system's search `PATH'. If they are not, `Diary-2000' will not find them. `Diary-2000' will save (and look for) most of the generated text files on a disk in drive df0:, even if you are running it from a hard disk. This has been done deliberately to avoid cloggging up your hard disk with text files. If you really want to save all your text files onto the hard disk instead of df0: you will have to make extensive changes to the program's script files. (See Section 4. below : also refer to Appendix A). 4. AMENDING THE `DIARY-2000' SCRIPT FILES: ------------------------------------------ There are seven separate script files, one for the `Information' module (filename - `Diary') and one for each year (filenames - `1995',`1996', `1997', `1998', `1999' and `2000'). Together, these files are roughly 2,100 lines in length and many of the lines are more than 320 characters long (some are more than 500 chars.). I strongly recommend that you DO NOT make any changes to these files unless you are an experienced Amigaguide user, WARNING! It is very easy to accidentally destroy the `Diary-2000' page layouts. If you really must change the script files, you can do so with any ASCII text editor, but I recommend that you use QED (distributed on this disk). After you load a script file into QED and BEFORE YOU DO ANTHING ELSE, set the line length to 600 chars. (default is only 75) by adjusting `Right Margin' from QED's `Tools' pull-down menu. You can then use QED's `Search' and `Replace' functions from the `Tools' menu to change the text. These functions are fully explained in the QED doc. file located in this directory. I am not going to explain in detail how to change an Amigaguide script file. If you are an experienced user you will already know and if you are not, please don't try. APPENDIX `B' shows lists of each of the seven script file's `Nodes', together with their line numbers. This is included so you can use QED's `Go To Line No.' facility (bottom of QED's `Cursor' pull-down menu). 5. DISPLAYING ANIMATIONS INSTEAD OF PICTURES: --------------------------------------------- The `Picture of the Month' box can be used to display animations instead of pictures. To do this you will need to change the script file for the month/year in which you want the anim. to be shown. Load the script file for the revelant year, then use QED`s `Search' and `Replace' functions to find the line you want to change (eg `Search' for "PPSHOW PIC12" to change the December picture). Replace the quoted text with "PPANIM PIC12" and save. (For "PPANIM" substitute the name of your anim. display tool and don't forget to include the full PATH to the tool if needed). Rename your anim. as `Pic12'. 6. CHANGING THE ON-SCREEN `BOX/PANEL' NAMES & FUNCTIONS: -------------------------------------------------------- If you change any of the box names as displayed on the `Diary-2000' screens you MUST preserve the same number of character spaces in the area that displays the box title. For example, on each `Calendar' page there is a box named " ? ? ? ". This box is 13 spaces long (between the quotes). If you change the box title, you MUST preserve the same number of spaces. The line that sets the screen display for this box and then displays the Shareware Notice when it is selected reads - @{" ? ? ? " link DIARY/SW} If you want to change this box to display an external text file listing all your BBS and/or E-Mail access numbers/addresses, you could change that line to read something like - @{" BBS/E-Mail " SYSTEM "QED BBS_E-Mail_Access"} `Diary-2000' will then show the new title " BBS/E-Mail " on the screen display. The first time you select the box QED will generate a new file called `BBS_E-Mail_Access' and after you have entered and saved your data will save it to the `Diary-2000' program disk. The next time you click on the box your data will be diplayed from the text file. NOTE THAT THE NEW BOX NAME PRESERVES 13 CHARACTER SPACES BETWEEN THE QUOTATION MARKS BY INCLUDING TRAILING HARD SPACES. If you want the box to open your Comms. program, the line might read - @{" COMMS. " SYSTEM ""} ============================================== If you have any problems with this program, or ideas for future `Amigaguide' projects, or if you're just curious about Thailand, please write to me at the following address. All letters will be answered, even if you don't pay the shareware fee: Dave Freeman | Tel: (6638)-25O3OO or 250311/2 12 Johnathan Court | 146/45-46 Tuppraya Road | ( NOT between 7pm and 2am UK time ) Pattaya City | Cholburi | THAILAND 2O26O | Sorry, I don't have a modem so there is no E-Mail address. ============================================= ___________________________ ________________________ Amigaguide is Copyright QED is Copyright Commodore-Amiga Inc. Darren M. Greenwald ___________________________ ________________________ ============================================== APPENDIX `A' -- LIST OF GENERATED TEXT FILES ============================================== Files saved to the program disk - _________________________________ Anniversaries (up to 12 files, one for each month) CALC.bat DB.bat SS.bat TIME.bat WP.bat all INFO-Personal files (up to 6 files) all INFO-Business files (up to 4 files) all INFO-Hard & Soft files (up to 52 files) all INFO-Travel files (up to 6 files) Mail-In (mail log) Mail-Out (mail log) Files saved to any disk inserted into drive DF0: - __________________________________________________ all Picture/Anim. files (up to 12 files) all Diary `Date Pages' (separate file for each day you write to) Memos (up to 12 files for EACH YEAR) Holidays (up to 12 files for EACH YEAR) ============================================================== APPENDIX `B' -- LIST OF MODULES, NODES & THEIR LINE NUMBERS: ============================================================== 1. THE `DIARY' MODULE: ________________ Node Name Description Line No. _________ ___________ ________ Main Diary Contents page 5 Index The Index page 29 SW Shareware Notice 52 G1 Info - Personal 120 G2 Info - Business 144 G3 Info - Hard & Soft 161 G4 Info - Travel 202 G5 Info - World Times 224 G6 Conversions 248 G61 Conversions-Length 264 G62 Conversions-Surface Area 285 G63 Conversions-Capacity/Vol 307 G64 Conversions-Weight 329 G65 Conversions-Temperature 344 2. THE `1995' MODULE: _____________________ Node Name Description Line No. _________ ___________ ________ Main 1995 Contents page 5 Jul95 July Calendar 28 Aug95 August Calendar 52 Sep95 September Calendar 76 Oct95 October Calendar 100 Nov95 November Calendar 124 Dec95 December Calendar 148 3. THE `1996' MODULE: _____________________ Node Name Description Line No. _________ ___________ ________ Main 1996 Contents page 5 Jan96 January Calendar 25 Feb96 February Calendar 49 Mar96 March Calendar 73 Apr96 April Calendar 98 May96 May Calendar 123 Jun96 June Calendar 147 Jul96 July Calendar 171 Aug96 August Calendar 195 Sep96 September Calendar 220 Oct96 October Calendar 244 Nov96 November Calendar 268 Dec96 December Calendar 292 4. THE `1997' MODULE: _____________________ Node Name Description Line No. _________ ___________ ________ Main 1997 Contents page 5 Jan97 January Calendar 25 Feb97 February Calendar 49 Mar97 March Calendar 73 Apr97 April Calendar 97 May97 May Calendar 121 Jun97 June Calendar 145 Jul97 July Calendar 169 Aug97 August Calendar 193 Sep97 September Calendar 217 Oct97 October Calendar 241 Nov97 November Calendar 265 Dec97 December Calendar 289 5. THE `1998' MODULE: _____________________ Node Name Description Line No. _________ ___________ ________ Main 1998 Contents page 5 Jan98 January Calendar 25 Feb98 February Calendar 49 Mar98 March Calendar 73 Apr98 April Calendar 97 May98 May Calendar 121 Jun98 June Calendar 145 Jul98 July Calendar 169 Aug98 August Calendar 193 Sep98 September Calendar 217 Oct98 October Calendar 241 Nov98 November Calendar 265 Dec98 December Calendar 289 6. THE `1999' MODULE: _____________________ Node Name Description Line No. _________ ___________ ________ Main 1999 Contents page 5 Jan99 January Calendar 25 Feb99 February Calendar 49 Mar99 March Calendar 72 Apr99 April Calendar 96 May99 May Calendar 120 Jun99 June Calendar 144 Jul99 July Calendar 168 Aug99 August Calendar 192 Sep99 September Calendar 216 Oct99 October Calendar 240 Nov99 November Calendar 264 Dec99 December Calendar 288 7. THE `2000' MODULE: _____________________ Node Name Description Line No. _________ ___________ ________ Main 2000 Contents page 5 Jan00 January Calendar 25 Feb00 February Calendar 49 Mar00 March Calendar 73 Apr00 April Calendar 97 May00 May Calendar 121 Jun00 June Calendar 145 Jul00 July Calendar 169 Aug00 August Calendar 193 Sep00 September Calendar 217 Oct00 October Calendar 241 Nov00 November Calendar 265 Dec00 December Calendar 289 ============================================= APPENDIX `C' -- LIST OF FILES ON THIS DISK: ============================================= Filename - Length (approx)- ---------- ---------------- Diary 17,318 1995 18,593 1996 37,491 1997 37,380 1998 37,266 1999 37,252 2000 37,402 Amigaguide 6,752 Help.guide 4,857 QED 50,348 PPMore 10,136 PPShow 5,180 PPAnim 7,360 CLI 2,156 Run 2,568 Amigaguide.library 62,932 PowerPacker.library 5,236 CALC.bat 25 DB.bat 36 SS.bat 56 TIME.bat 60 WP.bat 29 Mail-In 150 Mail-Out 149 Pic1 20,784 (crunched) Pic2 24,204 (crunched) Diary-2000.doc 10,844 (crunched) Customising-Diary-2000.doc 9,788 (crunched) QED.doc 24,768 (crunched)