home *** CD-ROM | disk | FTP | other *** search
/ BURKS 2 / BURKS_AUG97.ISO / BURKS / LINUX / HOWTO / mini / browser.txt < prev    next >
Text File  |  1997-07-07  |  8KB  |  218 lines
  1. The Linux Public Web Browser Mini-HOWTO
  2.   Donald B. Marti Jr. <dmarti@agdia.com> 
  3.   v0.01, 2 February 1997
  4.   
  5. 0. Copyright and Disclaimer
  6.  
  7.    Copyright 1997 Donald B. Marti Jr. This document may be redistributed
  8.    under the terms of the Linux Documentation Project license.
  9.    
  10.    _This is a draft version of this document. It may contain errors.
  11.    Apply these instructions at your own risk. _
  12.    
  13.    This document currently contains information for Netscape Navigator
  14.    only, but I plan to add notes for other browsers too as I get the
  15.    necessary information. If you try this with a different browser,
  16.    please let me know.
  17.    
  18. 1. Introduction
  19.  
  20.    The basic idea here is to give web access to people who wander by,
  21.    while limiting their ability to mess anything up.
  22.    
  23.    This setup was originally intended for trade shows, but it might be
  24.    applicable other places you want to have a web browser going without
  25.    having to babysit a computer.
  26.    
  27.    Following these instructions does not make your system bulletproof or
  28.    idiot-proof.
  29.    
  30. 2. Before you begin
  31.  
  32.   2.1. You need a graphical browser
  33.   
  34.    This document assumes that you already have a running graphical web
  35.    browser, such as Netscape Navigator, on your system. You should have
  36.    permission to use your graphical web browser. If you want to use
  37.    Netscape Navigator in a commercial setting, the only way that I know
  38.    of to get a license is to buy the Caldera distribution "Open Linux
  39.    Base."
  40.    
  41.   2.2. You need to be able to add an account
  42.   
  43.    If you don't have the right to be root, get the system administrator
  44.    to add the "guest" account and give you ownership of guest's home
  45.    directory. Skip to the "Create or edit the following files" step when
  46.    he or she is done.
  47.    
  48.   2.3. You need httpd for a stand-alone web browsing station
  49.   
  50.    If you are setting up a web browsing station to run stand-alone,
  51.    without a network connection, you should have httpd working and the
  52.    web documents installed. To tell if this is the case, enter:
  53.    
  54.      lynx -dump http://localhost
  55.      
  56.    You should get the text of the home page on your system.
  57.    
  58. 3. Add the guest account
  59.  
  60.    As root, run adduser to add a user named guest.
  61.    
  62.    Then enter
  63.    
  64.      passwd guest
  65.      
  66.    to set the password for the guest account. This should be something
  67.    easy to remember, like "guest". You will be telling people this
  68.    password. Don't make it the same as your own password.
  69.    
  70.    Then make guest's home directory owned by you. Enter
  71.    
  72.      chown me.mygroup /home/guest
  73.      
  74.    Replace "me" with your regular username and "mygroup" with your group
  75.    name. (On Red Hat Linux, these will be the same, since every user has
  76.    his or her own group.)
  77.    
  78.    You should now exit and do the rest of the steps as yourself, not
  79.    root.
  80.    
  81. 4. Create or edit the following files in /home/guest:
  82.  
  83.   4.1. File name: .bash_login
  84.   
  85.      _________________________________________________________________
  86.                                       
  87. exec startx
  88.  
  89.      _________________________________________________________________
  90.                                       
  91.    This means that when guest logs in, the login shell will start up the
  92.    X Window System right away.
  93.    
  94.   4.2. File name: .Xclients
  95.   
  96.      _________________________________________________________________
  97.                                       
  98. netscape
  99.  
  100.      _________________________________________________________________
  101.                                       
  102.    This means that when X starts, guest just gets the web browser, no
  103.    window manager. If you prefer another web browser, do something else.
  104.    
  105.    The file .Xclients should be executable by guest. Enter
  106.    
  107.      chmod 755 /home/guest/.Xclients
  108.      
  109.      to make it so.
  110.      
  111.   4.3. File name: .xsession
  112.   
  113.        ______________________________________________________________
  114.                                       
  115. #!/bin/sh
  116. netscape
  117.  
  118.        ______________________________________________________________
  119.                                       
  120.      If you use xdm(1) to log people in, this file should make guest get
  121.      the web browser as if he or she had logged in normally. The file
  122.      .xsession should be executable by guest. Enter
  123.      
  124.      chmod 755 /home/guest/.xsession
  125.      
  126.      to make it so.
  127.      
  128.   4.4. File name: .Xdefaults
  129.   
  130.        ______________________________________________________________
  131.                                       
  132. ! Disable drag-to-select.
  133. *hysteresis:                            3000
  134.  
  135. ! Make visited and unvisited links the same color by default
  136. *linkForeground:                        #0000EE
  137. *vlinkForeground:                       #0000EE
  138.  
  139. Netscape.Navigator.geometry: =NETSCAPE_GEOMETRY
  140.  
  141. ! Disable some of the keyboard commands.
  142. *globalTranslations:
  143.  
  144. ! Mouse bindings: make all mouse buttons do the same thing.
  145. *drawingArea.translations:              #replace                        \
  146.         <Btn1Down>:                     ArmLink()                       \n\
  147.         <Btn2Down>:                     ArmLink()                       \n\
  148.         <Btn3Down>:                     ArmLink()                       \n\
  149.         ~Shift<Btn1Up>:                 ActivateLink()                  \
  150.                                         DisarmLink()                    \n\
  151.         ~Shift<Btn2Up>:                 ActivateLink()                  \
  152.                                         DisarmLink()                    \n\
  153.         ~Shift<Btn3Up>:                 ActivateLink()                  \
  154.                                         DisarmLink()                    \n\
  155.         Shift<Btn1Up>:                  ActivateLink()                  \
  156.                                         DisarmLink()                    \n\
  157.         Shift<Btn2Up>:                  ActivateLink()                  \
  158.                                         DisarmLink()                    \n\
  159.         Shift<Btn3Up>:                  ActivateLink()                  \
  160.                                         DisarmLink()                    \n\
  161.         <Btn1Motion>:                   DisarmLinkIfMoved()             \n\
  162.         <Btn2Motion>:                   DisarmLinkIfMoved()             \n\
  163.         <Btn3Motion>:                   DisarmLinkIfMoved()             \n\
  164.         <Motion>:                       DescribeLink()                  \n\
  165.  
  166.        ______________________________________________________________
  167.                                       
  168.      This file disables blink tags, drag-to-select, and some of the
  169.      keyboard commands. It also makes all mouse buttons do the same
  170.      thing, hides the menu bar, and makes visited and unvisited links
  171.      the same color, so each visitor gets nice clean blue links, not
  172.      ones that other people have been thumbing through and staining
  173.      purple.
  174.      
  175.      You should replace the NETSCAPE_GEOMETRY in this file with an X
  176.      geometry that looks like this: XxY+0-0, where X is the width of
  177.      your screen and Y is the height of your screen + 32. This will
  178.      position the Netscape menu bar off the top of the screen, so the
  179.      user won't be distracted. For example, if your screen is 800x600,
  180.      the geometry should be 800x632+0-0.
  181.      
  182. 5. Make a .netscape directory for guest
  183.  
  184.      Enter
  185.      
  186.      mkdir /home/guest/.netscape
  187.      
  188.      Then
  189.      
  190.      chmod 777 /home/guest/.netscape
  191.      
  192.      to copy the configuration files to guest's .netscape directory and
  193.      make it world-writable.
  194.      
  195. 6. Try it
  196.  
  197.      Log out, then log in as guest.
  198.      
  199. 7. Changing preferences
  200.  
  201.      Since you won't be able to use the menu bar as guest, you should
  202.      edit guest's preferences manually if you need to change them, or
  203.      change your own preferences to what you want guest's to be and copy
  204.      the preferences file.
  205.      
  206. 8. Bonus Perl script
  207.  
  208.      The HTML version of this Mini-HOWTO is also a Perl script that does
  209.      all of the steps for you except "Add the guest account" which needs
  210.      to be run as root. Run the script with perl -x.
  211.      
  212. 9. To do
  213.  
  214.      This document needs setup information for other graphical browsers,
  215.      a non-graphical section for Lynx, and how to