Readme - for verse a day utility ================================ Sections ======== 1) Purpose 2) Different Versions 3) How to Install? 4) Options available 5) Example Usage 6) Acknowledgment 7) Advanced User Info 8) Disclaimer 9) Contact info =========================================================== 1) Purpose =========================================================== This utility displays a sloka at a time from the Bhagavad Gita. The utility was developed to enable Bhagavad Gita lovers to keep in touch with the slokas, one sloka at a time, throughout the day. See below for various options available. =========================================================== 2) Versions =========================================================== There are two version available : bgt-r - Translation by Dr. Ramanand Prasad bgt-m - Based on Sri Madhvacharya's commentary [In progress] bgt-r provides the following : ------------------------------ slokas - Slokas extracted from the ITRANS version available on-line. translation - Meanings extracted from the original translation by Dr. Ramanand Prasad word meanings - Extracted from "BhagavadGita As It Is" by Srila Prabhupada of ISKON (Contact information is available at the end of this readme) bgt-m provides the following : ------------------------------ slokas - Extracted from the ITRANS version translation - Follows Sri MadhvAchArya's bhAshya and tAtparya (Currently only 3rd chapter is available) word meanings - Follows Sri MadhvAchArya’s bhAshya/tAtparya =========================================================== 3) Installation =========================================================== Unix ---- 1. Uncompress the accompanying .Z file Type: uncompress *Z 2. Untar the file Type: tar -xvf *.tar 3. Compile the source Type: cc -o vwslk vwslk.c 4. Init the database by running: bgt-r.sh -init or bgt-m.sh -init 5. If you would like to view a sloka at the login time, insert the following in your login script : (Directory_where_vwslk_is_stored)/bgt-r.sh -d (or bgt-m.sh -d) 6. Follow the usage options below DOS --- 1. Unzip the .zip file 2. Init the database by running: type: bgt-r.bat -init (or bgt-m.bat -init) 3. If you would like to view a sloka at bootup time, insert the following in your autoexec.bat file : (Directory_where_bgt_is_stored)\bgt-r -d (or bgt-m -d) 4. Follow the usage options below NOTE: For Win95/Win NT .pif files are included for easier access. =========================================================== 4) Available Options =========================================================== Operations : ------------ -d Display one sloka per day -n Display Next sloka in the database -r Display a randomly chosen sloka -s chapter#.xx Search for a sloka (eg., -s 3.26) Display Modes : --------------- -v Display verse -t Display English translation -w Display word meanings To View in Devanagari Font : ---------------------------- Use one of the following options. Each option writes the output to a file specified by you. 1) [-itxpc filename] : NOTE: This option works ONLY on the IBM compatible PCs. Open the file saved by the utility in the ITranslator package and hit the Convert button. You can download the ITranslator package from the site http://www.geocities.com/Athens/Forum/5105/Itrans.htm 2) [-itxweb filename] : Go to the website http://dworkin.wustl.edu/~hari/itrans.html Copy the contents of the output file generated by the utility in the "The Web Interface to the ITRANS Package" section of the webpage. Hit the Submit button. 3) [-itxm filename] : Email the contents of the resulting file to itrans@yamuna.asd.sgi.com with the subject strictly typed as "itrans convert" without quotes, you will receive a postscript file, over email, which can be viewed/printed using a postscript viewer. For more information on itrans conversions visit : ftp://jaguar.cs.utah.edu/private/sanskrit/volunteer.html Configuration ------------- -init reset current sloka to the beginning [This is useful to restart the -d option print out to start from the beginning] [-fi .ini file] Use the specified .ini file name =========================================================== 5) Example usage : =========================================================== 1. To call from a login script and display verse, translation and word meaning use : bgt-r.sh -d -vtw or bgt-m.sh -d -vtw (use the .bat extension for DOS/Windows) New messages will come up on a daily basis ==========NOTE on .pif files ========= For Win95/Win NT, *.pif files have pre-stored options. Edit the path in the properties of these files and then you can drag these to your desktop for easy access. (Right click the mouse on the .pif file to access its properties and double click on the file to run it) bgt-r.pif/bgt-m.pif - automatically invoke -d option for daily mode usage init-r.pif/init-m.pif - Init the database to start from the beginning ====================================== 2. To display a randomly chosen sloka use : bgt-r.sh -r -vtw or bgt-m.sh -r -vtw 3. To display the next sloka in the database use : bgt-r.sh -n -vtw or bgt-m.sh -n -vtw 4. To search for a specific sloka use : bgt-r.sh -s chapter.xx -vtw or bgt-m.sh -s chapter.xx -vtw Eg., bgt-r.sh -s 3.26 will display 26th sloka from the 3rd chapter 5. Use [itxpc or itxweb or itexm options to convert itrans to devanagari font. See above for details on these options. 6. To initialize the database : bgt-r.sh -init or bgt-m.sh -init =========================================================== 6) Acknowledgment =========================================================== I am immensly greatfull to all my friends on the internet who have reviewed this utility and offered valuable suggestions. Thanks to Dr. Ramanand Prasad for granting permission to use his English translation. For his online version look into: ftp://jaguar.cs.utah.edu/private/sanskrit/bglesson.doc ftp://jaguar.cs.utah.edu/private/sanskrit/bglesson.ps For a printed version contact: American Gita Society, 511 Lowell Place, Fremont, CA 94536-1805 USA Thanks to the Bhaktivedanta Book Trust(BBT) International, for permitting us to use the word meanings from the "Bhagavadgita As It Is" by Srila Prabhupada. You can contact BBT at : Bhaktivedanta Book Trust(BBT) International, Farboret 101, S-242 97 Horby, SWEDEN, http://www.algonet.se/~bbt-intl The book is available on line at : http://www.prabhupada.com/~btg/gita/toc.html. Thanks to Atul, Hari and Sri Omakaranand Ashram for making available the various itrans conversion methods. The words were converted manually in ITRANS format to get devanaagarii display. The formatted files are available from ftp://jaguar.cs.utah.edu/private/sanskrit/sanskrit.html Refer ftp://jaguar.cs.utah.edu/private/sanskrit/sanskrit.html for various Gita and Sanskrit documents. =========================================================== 7) Advanced users =========================================================== Refer details.txt for using this utility to view other documents and document format info. =========================================================== 8) Disclaimer =========================================================== This a public domain distribution. You are free to copy/modify the accompanying source code for public domain use only. The use of this utility is solely at the discretion of the user. The author is not responsible for any damages direct or indirect. This utility may not be used for commercial purpose without the prior permission from the author. =========================================================== 9) Contact =========================================================== Send Suggestions/Comments/Errors to : ------------------------------------- adurg@hotmail.com or adurg@msn.com