home *** CD-ROM | disk | FTP | other *** search
/ PC go! 1995 September / Image.iso / pcgo / programm / online / internet / disk2 / faq / english / wwwfaq2.txt < prev    next >
Encoding:
Text File  |  1995-03-09  |  44.0 KB  |  934 lines

  1.    
  2.                 5.1: HOW CAN I PROVIDE INFORMATION TO THE WEB?
  3.                                        
  4.    
  5.    
  6.    Information providers run programs that the browsers can obtain
  7.    hypertext from. These programs can either be WWW servers that
  8.    understand the HyperText Transfer Protocol HTTP (best if you are
  9.    creating your information database from scratch), "gateway" programs
  10.    that convert an existing information format to hypertext, or a
  11.    non-HTTP server that WWW browsers can access -- anonymous FTP or
  12.    gopher, for example.
  13.    
  14.    To learn more about World Wide Web servers, you can consult a www
  15.    server primer by Nathan Torkington, available at the URL
  16.    http://www.vuw.ac.nz/who/Nathan.Torkington/ideas/www-servers.html .
  17.    
  18.    If you only want to provide information to local users, placing your
  19.    information in local files is also an option. This means, however,
  20.    that there can be no off-machine access.
  21.    
  22. 5.2: Obtaining Servers
  23.  
  24.    Servers are available for Unix, Macintosh, MS Windows, Windows NT,
  25.    OS/2, and VMS systems. If you know of a server for another operating
  26.    system, please contact me.
  27.    
  28.    See http://info.cern.ch/hypertext/WWW/Daemon/Overview.html for more
  29.    information on writing servers and gateways in general.
  30.    
  31.   5.2.1: UNIX SERVERS
  32.   
  33.    NCSA httpd
  34.           NCSA has released a server, known as the NCSA httpd; it is
  35.           available at the URL ftp://ftp.ncsa.uiuc.edu/Web/ncsa_httpd .
  36.           
  37.    EIT httpd
  38.           EIT has created the Webmaster's Starter Kit, which installs
  39.           their WWW server on your system via the web through a painless
  40.           forms interface. Recommended for those unfamiliar with server
  41.           installation. You can learn more about the starter kit and the
  42.           EIT httpd at the starter kit site (URL is
  43.           http://wsk.eit.com/wsk/doc/ ).
  44.           
  45.    CERN httpd
  46.           CERN's server is available for anonymous FTP from info.cern.ch
  47.           (URL is http://info.cern.ch/hypertext/WWW/Daemon/Status.html )
  48.           and many other places. Use your local copy of archie to search
  49.           for "www" in order to find a nearby site.
  50.           
  51.    GN Gopher/HTTP server
  52.           The GN server is unique in that it can serve both WWW and
  53.           Gopher clients (in their native modes). This is a good server
  54.           for those migrating from Gopher to WWW, although it does not
  55.           have the server-side-script capabilities of the NCSA and CERN
  56.           servers. See the URL http://hopf.math.nwu.edu/ .
  57.           
  58.    Perl server
  59.           There is also a server written in the Perl scripting language,
  60.           called Plexus, for which documentation is available at the URL
  61.           http://bsdi.com/server/doc/plexus.html .
  62.           
  63.    WN Server
  64.           The WN Server, available at the URL
  65.           http://hopf.math.nwu.edu/docs/manual.html , is designed with an
  66.           emphasis on security and flexibility, and takes a different
  67.           approach from the NCSA and CERN servers. It provides text
  68.           searching facilities as a standard feature.
  69.           
  70.   5.2.2: MACINTOSH SERVERS
  71.   
  72.    There is a server for the Macintosh, MacHTTP, available at the URL
  73.    http://www.uth.tmc.edu/mac_info/machttp_info.html .
  74.    
  75.   5.2.3: MS WINDOWS, IBM OS/2 AND MS WINDOWS NT SERVERS
  76.   
  77.    HTTPS (Windows NT)
  78.           HTTPS is a server for Windows NT systems, both Intel and Alpha
  79.           -- based. It is available via anonymous FTP from emwac.ed.ac.uk
  80.           in the directory pub/https (URL is
  81.           ftp://emwac.ed.ac.uk/pub/https). (Be sure to download the
  82.           version appropriate to your processor.) You can read a detailed
  83.           announcement at the FTP site, or by using the URL
  84.           ftp://emwac.ed.ac.uk/pub/https/https.txt.
  85.           
  86.           A professional version is also available (URL is
  87.           http://emwac.ed.ac.uk/html/internet_toolchest/https/prof.htm ).
  88.           
  89.    NCSA httpd for Windows
  90.           The NCSA httpd for Windows has most of the features of the Unix
  91.           version, including scripts (which generate pages on the fly
  92.           based on user input). It is available by anonymous FTP from the
  93.           ftp site ftp.alisa.com in the directory pub/win-httpd, and
  94.           documentation can be found at the URL
  95.           http://www.alisa.com/win-httpd/index.html .
  96.           
  97.    SerWeb
  98.           A simple, effective server for Windows writtten by Gustavo
  99.           Estrella. Available by anonymous ftp from
  100.           winftp.cica.indiana.edu (or one of its mirror sites, such as
  101.           nic.switch.ch), as the file serweb03.zip, in the directory
  102.           /pub/pc/win3/winsock.
  103.           
  104.           There is also a Windows NT version of SerWeb, available by
  105.           anonymous FTP from emwac.ed.ac.uk as /pub/serweb/serweb_i.zip.
  106.           
  107.    WEB4HAM
  108.           Another Windows-based server, available by anonymous FTP from
  109.           ftp.informatik.uni-hamburg.de as /pub/net/winsock/web4ham.zip.
  110.           
  111.    OS2HTTPD
  112.           An OS/2 server, written by Frankie Fan. See the home page (URL
  113.           is ftp://ftp.netcom.com/pub/kf/kfan/overview.html ) for
  114.           details, or fetch the package by anonymous FTP from
  115.           ftp.netcom.com in the directory pub/kf/kfan.
  116.           
  117.   5.2.4: MSDOS AND NOVELL NETWARE SERVERS
  118.   
  119.    KA9Q   KA9Q NOS (nos11c.exe) is a internet server package for DOS that
  120.           includes HTTP and Gopher servers. It can be obtained via
  121.           anonymous FTP from one of the following sites:
  122.           
  123.  
  124. inorganic5.chem.ufl.edu
  125. biochemistry.cwru.edu
  126.  
  127.    GLACI-HTTPD
  128.           GLACI-HTTPD is a Netware Loadable Module which allows a Novell
  129.           NetWare server to become a World Wide Web server (URL is
  130.           http://www.glaci.com/info/glaci-httpd.html ).
  131.           
  132.    
  133.    
  134.   5.2.5: VMS SERVERS
  135.   
  136.    CERN HTTP for VMS
  137.           A port of the CERN server to VMS. Available at the URL
  138.           http://delonline.cern.ch/disk$user/duns/doc/vms/distribution.html .
  139.           
  140.    Region 6 Threaded HTTP Server
  141.           A native VMS server which uses DECthreads(tm). This is a
  142.           potentially major performance advantage because VMS has a high
  143.           overhead for each process, which is a problem for the
  144.           frequently-forking NCSA and CERN servers that began life under
  145.           Unix. A multithreaded server avoids this overhead. Available at
  146.           the URL http://kcgl1.eng.ohio-state.edu/www/doc/serverinfo.html .
  147.           
  148.    
  149.    
  150.   5.2.6: AMIGA SERVERS
  151.   
  152.    NCSA's Unix server has been ported to the Amiga, and is bundled with
  153.    the AMosaic browser. See the URL
  154.    http://insti.physics.sunysb.edu/AMosaic/home.html for details.
  155.    
  156.   5.2.7: VM/CMS SERVERS
  157.   
  158.    A VM/CMS web server is available; see the URL
  159.    http://ua1vm.ua.edu/~troth/rickvmsw/rickvmsw.html for more
  160.    information. If you don't yet have a web browser to try this URL with,
  161.    check out the VM/CMS Browsers section.
  162.    
  163.   5.2.8: YEAH, BUT WHICH IS BEST?
  164.   
  165.    
  166.    
  167.    To find out which server is best for your needs, you will want to
  168.    consult Paul Hoffman's Server Comparison Chart (URL is
  169.    http://sunsite.unc.edu/boutell/faq/chart.html ). That document is also
  170.    available by anonymous FTP from ftp.netcom.com in the directory
  171.    pub/bo/boutell/faq.
  172.    
  173. 5.3: Producing HTML documents
  174.  
  175.    HTML is the simple markup system used to create hypertext documents.
  176.    There are three ways to produce HTML documents: writing them yourself,
  177.    which is not a very difficult skill to acquire, using an HTML editor,
  178.    which assists in doing the above, and converting documents in other
  179.    formats to HTML. The following three sections cover these
  180.    possibilities in sequence.
  181.    
  182.   5.3.1: WRITING HTML DOCUMENTS YOURSELF
  183.   
  184.    You can write an HTML document with any text editor. Try the "source"
  185.    button of your browser (or "save as" HTML) to look at the HTML for a
  186.    page you find particularly interesting. The odds are that it will be a
  187.    great deal simpler than you would expect. If you're used to marking up
  188.    text in any way (even red-pencilling it), HTML should be rather
  189.    intuitive.
  190.    
  191.    A beginner's guide to HTML is available at the URL
  192.    http://www.ncsa.uiuc.edu/General/Internet/WWW/HTMLPrimer.html . You
  193.    can also find a plain text version (at the URL
  194.    ftp://ftp.ncsa.uiuc.edu/ncsapubs/WWW/HTMLPrimer.txt) and a compressed
  195.    Postscript version (at the URL
  196.    ftp://ftp.ncsa.uiuc.edu/ncsapubs/WWW/HTMLPrimer.ps.Z). (Since the
  197.    latter two are FTP URLs, you can fetch them by hand using FTP if you
  198.    do not yet have a web browser.)
  199.    
  200.    There is also an HTML primer by Nathan Torkington at the URL
  201.    http://www.vuw.ac.nz/who/Nathan.Torkington/ideas/www-html.html .
  202.    
  203.   5.3.2: HTML EDITORS
  204.   
  205.    Of course, most folks would still prefer to use a friendlier,
  206.    graphical editor. Some editors are WYSIWYG (What You See Is What You
  207.    Get), or close to it; others simply assist you in writing HTML by
  208.    plugging in the desired markup tags for you from a menu.
  209.    
  210.    Fans of the EMACS editor can use EMACS and html-helper-mode , an EMACS
  211.    "mode" for HTML editing (URL is http://www.reed.edu/~nelson/tools/ ).
  212.    
  213.    There is also another Emacs HTML mode, html-mode.el (URL is
  214.    ftp://ftp.ncsa.uiuc.edu/Web/html/elisp/html-mode.el ).
  215.    
  216.    For Microsoft Windows users, there is an editor called HTML Assistant
  217.    with features to assist in the creation of HTML documents. It can be
  218.    had by anonymous FTP from ftp.cs.dal.ca in the directory /htmlasst/.
  219.    Read the README.1ST file in this directory for information on which
  220.    files to download.
  221.    
  222.    ANT_HTML.DOT is a Word for Windows 6.0 template designed to convert
  223.    Word documents into HTML documents in a WYSIWYG environment. It
  224.    includes a demo version of the ANT_PLUS utility, which converts HTML
  225.    files to WYSIWYG. ANT_PLUS also converts HTML files to ASCII, RTF, or
  226.    any other format possible in Word 6.0. Contact jswift@freenet.fsu.edu
  227.    if you need more information.
  228.    
  229.    A WYSIWYG editor for the Web, SoftQuad HoTMetaL, is available for
  230.    downloading at NCSA and numerous other sites. Many mirror sites exist;
  231.    if you can't get through to one, try another, don't give up! That's
  232.    what mirror sites are for. (Also be sure to use the copy closest to
  233.    you geographically if possible.) Hotmetal is available for both Sun
  234.    Sparc systems and Windows systems; note that Windows users need at
  235.    least 6 megabytes of free memory. (A 2-megabyte swap file should just
  236.    barely do the trick on a 4MB machine.)
  237.    
  238.    Known mirrors:
  239.      * ftp://ftp.ncsa.uiuc.edu/Web/html/hotmetal/
  240.      * ftp://ftp.ifi.uio.no/pub/SGML/HoTMetaL
  241.      * ftp://sgml1.ex.ac.uk/SoftQuad
  242.      * ftp://src.doc.ic.ac.uk/packages/WWW/ncsa/html/hotmetal/
  243.      *
  244.        ftp://askhp.ask.uni-karlsruhe.de/pub/infosystems/mosaic/contrib/Sof
  245.        tQuad
  246.      * ftp://ftp.cs.concordia.ca/pub/www
  247.      *
  248.        
  249.    You need a Sun SPARC or Microsoft Windows system and 6MB of disk (6MB
  250.    of RAM minimum for MS Windows; swap files count). Other Unix systems
  251.    may be supported by the time you read this; have a look on one of the
  252.    sites above.
  253.    
  254.    Because it is context-sensitive, HoTMetaL guides users in creating new
  255.    HTML documents and in cleaning up old ones. A Publish command changes
  256.    appropriate SRC and HREF attributes from local paths to http
  257.    locations. For more information, FTP the README file from the same
  258.    directory, or send email to hotmetal@sq.com. A HoTMetaL Pro
  259.    commercially supported version is available for purchase from SoftQuad
  260.    and its resellers.
  261.    
  262.    Also see Gabriel White's reviews of MS Windows HTML editors (URL is
  263.    http://werple.mira.net.au/%7Egabriel/web/html/editors/ ). Another
  264.    option, if you have an SGML editor, is to use it with the HTML DTD
  265.    (URL is http://info.cern.ch/hypertext/WWW/MarkUp/DTDHeading.html ).
  266.    
  267.    An editor for all X users: TkWWW (listed above under X browsers)
  268.    supports WYSIWYG HTML editing; and since it's a browser, you can try
  269.    out links immediately after creating them.
  270.    
  271.    Another editor for X users: Phoenix (URL is
  272.    http://www.bsd.uchicago.edu/ftp/pub/phoenix/README.html ) is a fully
  273.    WYSIWYG HTML editor which insulates the user from direct control of
  274.    the HTML tags. Available by anonymous FTP from www.bsd.uchicago.edu in
  275.    the pub/phoenix subdirectory.
  276.    
  277.    Also for X users, there is a package called htmltext which supports
  278.    WYSIWYG HTML editing. More information is available at the URL
  279.    http://web.cs.city.ac.uk/homes/njw/htmltext/htmltext.html .
  280.    
  281.    For Macintosh users, there is a near-WYSIWYG package called HTML
  282.    Editor (URL is http://dragon.acadiau.ca:1667/~giles/HTML_Editor).
  283.    
  284.    ANT_HTML is a Word for the Macintosh template designed to convert Word
  285.    documents into HTML documents in a WYSIWYG environment. It includes a
  286.    demo version of the ANT_PLUS utility, which converts HTML files to
  287.    WYSIWYG. ANT_PLUS also converts HTML files to ASCII, RTF, or any other
  288.    format possible in Word. At the time of this writing it was scheduled
  289.    to have been released on the Macintosh (it has long been available for
  290.    Windows). Contact jswift@freenet.fsu.edu for more information. Also
  291.    for Macintosh users, the BBEdit HTML extensions allow the BBEdit and
  292.    BBEdit Lite text editors for the Macintosh to conveniently edit HTML
  293.    documents. (URL is http://www.uji.es/bbedit-html-extensions.html .)
  294.    You can also obtain the extensions package by anonymous ftp from
  295.    sumex-aim.stanford.edu as info-mac/bbedit-html-ext-b3.hqx.
  296.    
  297.    There is an alternative BBEdit extension package available as well
  298.    (URL is http://www.york.ac.uk/~ld11/BBEditTools.html ). it is
  299.    available by FTP from ftp.york.ac.uk in the directory
  300.    /pub/users/ld11/BBEdit_HTML_Tools.sea.hqx.
  301.    
  302.    NCSA's List of Filters and Editors, for which the URL is
  303.    http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/Docs/faq-software.html#ed
  304.    itors, mentions several editors, including two for MS Windows. In some
  305.    cases, the "editor" amounts to a set of macros for an existing word
  306.    processor, which can provide a near-WYSIWYG environment.
  307.    
  308.    Note that this URL contains uppercase and lowercase letters; certain
  309.    operating systems won't allow mixed case on the command line, or will
  310.    only allow it if it is quoted (VMS), so if you are launching Lynx or
  311.    another client and specifying a URL at the command line, try quoting
  312.    the URL in double-quotes ("URL").
  313.    
  314.   5.3.3: CONVERTING OTHER FORMATS TO HTML
  315.   
  316.    There is a collection of filters for converting your existing
  317.    documents (in TeX and other non-HTML formats) into HTML automatically,
  318.    including filters that can allow more or less WYSIWYG editing using
  319.    various word processors:
  320.    
  321.    Rich Brandwein and Mike Sendall's List at CERN (URL is
  322.    http://info.cern.ch/hypertext/WWW/Tools/Filters.html ).
  323.    
  324.    (Note that this URL contains uppercase and lowercase letters; certain
  325.    operating systems such as VMS require you to quote mixed-case URLs
  326.    when launching a borwser from the command line. This is NOT a bug in
  327.    the browser.)
  328.    
  329.    There is also a Word for Windows template for writing HTML documents,
  330.    available at the URL http://www.gatech.edu/word_html/release.htm .
  331.    
  332.   5.3.4: CHECKING YOUR HTML FOR ERRORS
  333.   
  334.    Tools to validate your HTML documents (check them for errors) are
  335.    available. There is a form at the URL
  336.    http://www.hal.com/%7Econnolly/html-test/service/validation-form.html
  337.    which will check HTML documents for errors according to the latest
  338.    specification; note that you are encouraged to set up the program on
  339.    your own system if you make heavy use of the form. There is also a
  340.    tool which will check the links in your documents for links to
  341.    nonexistent resources, such as pages that have moved (URL is
  342.    http://wsk.eit.com/wsk/dist/doc/admin/webtest/verify_links.html ).
  343.    
  344.    Also try weblint (URL is
  345.    http://www.khoros.unm.edu/staff/neilb/weblint.html ), a Perl script
  346.    that checks your HTML for errors; you can even try it out over the web
  347.    through an HTML form. The script is available by anonymous FTP from
  348.    ftp.khoros.unm.edu in the directory pub/perl/www.
  349.    
  350.    Another such tool is htmlchek (URL is:
  351.    http://uts.cc.utexas.edu/~churchh/htmlchek.html ), which checks HTML
  352.    documents for errors, creates a cross-reference, automatically expands
  353.    entities (such as European characters) to their proper HTML form, and
  354.    performs other useful services. htmlchek is available by anonymous FTP
  355.    from ftp.cs.buffalo.edu in the directory pub/htmlchek.
  356.    
  357. 5.4: How do I publicize my work?
  358.  
  359.    There are several things you can do to publicize your new HTML server
  360.    or other offering:
  361.      * Post to comp.infosystems.www.announce. PLEASE READ THE CHARTER
  362.        POSTING FIRST. In general, always read a newsgroup first to
  363.        familiarize yourself before posting to it.
  364.      * Submit it to the NCSA What's New Page at the URL
  365.        http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/Docs/whats-new.html
  366.        (see the page for details on how to submit your listing!).
  367.      * Post it to the newsgroup comp.infosystems.announce. Please read
  368.        the group first to get a feel for the contents. You should not
  369.        post to comp.infosystems.www.users,.misc,.providers, etc., but if
  370.        you feel compelled to do so, please choose .misc as announcements
  371.        are of interest to both providers and users (and those who wear
  372.        both hats).
  373.      * Submit it to the maintainers of various catalogs, such as the WWW
  374.        Virtual Library (at the URL
  375.        http://info.cern.ch/hypertext/DataSources/bySubject/Overview.html
  376.        ) and the ALIWEB index (at the URL
  377.        http://web.nexor.co.uk/aliweb/doc/aliweb.html ).
  378.      * Read Gareth Rees' guide to publishing on the World Wide Web. (URL
  379.        is http://www.cl.cam.ac.uk/users/gdr11/publish.html ).
  380.        
  381. 5.5: Can I buy space on an existing server?
  382.  
  383.    Yes, you can. A list of sites offering WWW space for lease is
  384.    available (at the URL http://union.ncsa.uiuc.edu/www/leasing.shtml ).
  385.    
  386. 5.6: How fast does my net connection need to be?
  387.  
  388.    The following response to this very-frequently-asked-question was
  389.    provided by Mike Meyer (mwm@contessa.phone.net).
  390.    
  391.      The answer is "It depends." What it depends on is what kind of
  392.      things you want to provide on your server. Here are some rules of
  393.      thumb to use when deciding what kind of connection you need for your
  394.      server.
  395.      
  396.      The first rule of thumb is:
  397.      
  398.      Don't worry about simultaneous access.
  399.      
  400.      Unless you have a very large site, simultaneous access is not a
  401.      problem. If you have a very large site, you need as much bandwidth
  402.      as you can afford. There is a bit more about this below.
  403.      
  404.      The second rule of thumb is:
  405.      
  406.      It should take at most 5 seconds to send a page.
  407.      
  408.      The five second rule dates from command line days, when that was
  409.      about how long people would wait before getting impatient with the
  410.      system. It seems like a reasonable number to use now.
  411.      
  412.      Since external images/audio/etc. are somewhat exceptional, allow
  413.      more time for them. If you think they should have the same
  414.      restrictions as above, buy the bandwidth your site will need to do
  415.      so. However, the rule of thumb for external images/audio/etc is:
  416.      
  417.      It should take at most 30 seconds to send an external file.
  418.      
  419.      Given these rules, it's pretty straightforward to work out how large
  420.      an HTML page and external files can be. At least, it's easy after
  421.      you simplify things by ignoring IP overhead on the line, compression
  422.      on modem lines, and anything that's less than 10% of the total (or
  423.      even a little bit more than 10%).
  424.      
  425.      The one simplification not to ignore is the multiple packet
  426.      round-trips it takes to get data flowing through an HTTP channel.
  427.      For modem lines, this is nearly a second for each HTTP connection,
  428.      which is significant. For leased lines, it's more like .1 or .2
  429.      seconds, which is not significant.
  430.      
  431.      On a 14.4 line assumed to be sending 1.4K bytes of data/second, with
  432.      a 1 second startup, you get 4 * 1.4 or 5.6K of HTML. If you want to
  433.      include a single inline image, that's 2 seconds of startup, so
  434.      you're down to 3 * 1.4 or 4.2K of HTML + image. This means smallish
  435.      HTML pages, and simple inline images. For external files, you get 29
  436.      * 1.4 or 40K, which is still a small image. If you have a 28.8 line,
  437.      you get to double those figures; for a 9600 line, figure 2/3rds of
  438.      that size.
  439.      
  440.      On a 56K leased line assumed to be sending 5K/second, you get 25K of
  441.      HTML, or mixed HTML/data. For external images, it's 150K. That
  442.      should cover any reasonable HTML document, and small to medium
  443.      external files. An MPEG movie might be a bit much.
  444.      
  445.      With a T1 line assumed to be sending 150K/second, you get 750K of
  446.      HTML, or 4.5 megabytes in an external file. Barring very large
  447.      animations, this should be sufficient for anything you want to
  448.      serve. More would be faster, but it also gets drastically more
  449.      expensive.
  450.      
  451.      Given the above guidelines, let's look at simultaneous access again.
  452.      Under the worst case conditions, you're using all of your line for
  453.      HTML pages, each of which takes 5 seconds to send, so your server is
  454.      sending 12 pages a minute, or 720 pages an hour, or 17,000 pages a
  455.      day (pages, not accesses; each inline image in a page generates an
  456.      access, unless the client cached it). This makes you one of the
  457.      busier sites on the web. While you'll have contention problems
  458.      before you get to this point, anything but a modem connection will
  459.      be sending most pages in a small fraction of five seconds, which
  460.      should leave plenty of bandwidth with no contention. If you have
  461.      this kind of access rates on a modem line, you should seriously
  462.      consider upgrading your connection.
  463.      
  464.      The bottom line on simultaneous access is that the WWW server is
  465.      more likely to have contention with other uses of the line than with
  466.      itself. Since I don't know what else you use your line for, I can't
  467.      factor it in. You'll have to consider that issue yourself.
  468.      
  469.    
  470.    
  471.   5.7.1: HOW DO I SET UP A CLICKABLE IMAGE MAP?
  472.   
  473.    
  474.    
  475.    There are really two issues here: how to indicate in HTML that you
  476.    want an image to be clickable, and how to configure your server to do
  477.    something with the clicks returned by Mosaic, Chimera, and other
  478.    clients capable of delivering them.
  479.    
  480.    You can read about image maps and the NCSA server at the URL
  481.    http://hoohoo.ncsa.uiuc.edu/docs/setup/admin/Imagemap.html .
  482.    
  483.    Using imagemaps requires that you create a map file; you can do this
  484.    by hand or with a WYSIWYG tool.
  485.    
  486.    VERY IMPORTANT: Creating imagemaps requires a real web server (not
  487.    an FTP server) and a cooperative web server administrator. It is not
  488.    usually as simple as wrapping a link around an IMG SRC tag and adding
  489.    the ISMAP directive; the server must also be told about the map file,
  490.    and the way to accomplish this varies from server to server. So read
  491.    your server documentation, and don't waste time making maps before
  492.    making sure you have the necessary tools to deliver them.
  493.    
  494.    Mapedit
  495.           Mapedit (URL is:
  496.           http://sunsite.unc.edu/boutell/mapedit/mapedit.html ) is a
  497.           WYSIWYG imagemap editing tool for Microsoft Windows and the X
  498.           Window System.
  499.           
  500.    MapMaker
  501.           For users of John Bradley's xv image display software for the
  502.           X Window System, Mapmaker can turn the miniature images created
  503.           by xv's Visual Schnauzer into an imagemap. This is useful if
  504.           you would like to make an entire directory of images available
  505.           (but note that you should also make textual links to allow
  506.           those with text- based browsers to download the images for
  507.           external viewing). (URL is:
  508.           http://icg.stwing.upenn.edu:80/~mengwong/mapmaker.html )
  509.           
  510.    WebMap
  511.           On the Macintosh, you may want to use WebMap (URL is
  512.           ftp://ftp.uwtc.washington.edu/pub/Mac/Network/WWW ). . It
  513.           produces both NCSA and CERN-compatible maps, which can also be
  514.           used with MacImagemap and a Macintosh-based server (MacImagemap
  515.           is found in the same directory). Alternatively, you may want to
  516.           use MacMapMaker, also available from
  517.           ftp://ftp.uwtc.washington.edu/pub/Mac/Network/WWW (the same
  518.           directory).
  519.           
  520.    Tkmapedit
  521.           For Unix systems and other systems on which the Tk/Tcl language
  522.           toolkit has been installed, Tkmapedit provides a WYSIWYG
  523.           imagemap editor which is capable of directly testing links if
  524.           the tkWWW web browser is available. Available by anonymous FTP
  525.           from the TCL archive on ftp.aud.alcatel.com.
  526.           
  527.    
  528.    
  529.   5.7.2: HOW DO I MAKE A "LINK" THAT DOESN'T LOAD A NEW PAGE?
  530.   
  531.    
  532.    
  533.    Such links are useful when a form is intended to perform some action
  534.    on the server machine without sending new information to the client,
  535.    or when a user has clicked in an undefined area in an image map; these
  536.    are just two possibilities.
  537.    
  538.    Rob McCool of NCSA provided the following wisdom on the subject:
  539.  
  540. Yechezkal-Shimon Gutfreund (sg04@gte.com) wrote:
  541. : Ok, here is another bizzare request from me:
  542.  
  543. : I am currently running scripts which I "DO NOT" want to return
  544. : any visible result. That is, not text/plain, not text/HTML, not
  545. : image/gif. The entire results are the side effects of the
  546. : script and nothing should be returned to the viewer.
  547.  
  548. : It would be nice to have an internally supported null viewer
  549. : so that I could do this, more "cleanly" (ok, ok, I hear your groans).
  550.  
  551.    
  552.    
  553.    HTTP now supports a response code of 204, which is no operation. Some
  554.    browsers such as Mosaic/X 2.* support it. To use it, make your script
  555.    a nph script and output an HTTP/1.0 204 header. Something like:
  556.    
  557.    HTTP/1.0 204 No response Server: Myscript/NCSA httpd 1.1
  558.    
  559.    (You can learn more about nph scripts from the NCSA server
  560.    documentation at the URL http://hoohoo.ncsa.uiuc.edu/docs .)
  561.    Essentially they are scripts that handle their own HTTP response
  562.    codes.
  563.    
  564.   5.7.3: WHERE CAN I LEARN HOW TO CREATE FILL-OUT FORMS?
  565.   
  566.    Writing an HTML form is easy, but the form doesn't accomplish anything
  567.    until you write a CGI program to interpret the results on the server
  568.    side! For more information, see section 5.7.14.
  569.    
  570.    See the section on email forms for a simple solution to the most
  571.    commonly desired form.
  572.    
  573.     5.7.3.1: How can I create hidden fields in forms (keeping state)?
  574.     
  575.    Use INPUT TYPE=hidden. An example:
  576.  
  577. <INPUT TYPE=hidden NAME=state VALUE="hidden info to be returned with form">
  578.  
  579.    By now, most browsers can handle the hidden type, but understand that
  580.    some browsers will fail to hide the field (and probably confuse the
  581.    user). Note that "hidden" doesn't mean "secret"; the user can always
  582.    click on "view source".
  583.    
  584.     5.7.3.2: How can users send me email through their browsers?
  585.     
  586.    There are two ways:
  587.    
  588.    Using a mailto: URL
  589.           You can simply create a link which looks like this:
  590.           
  591.           <A HREF="mailto:me@my.address">Send Me Mail</A>
  592.           
  593.           This works great for browsers that support the mailto: URL.
  594.           Perhaps 80% of web users will be able to use such a link. But
  595.           not all browsers support it.
  596.           
  597.    Installing an email form
  598.           If you have access to the server's configuration files, or if
  599.           your server administrator permits users to create their own CGI
  600.           scripts, you can create a form which sends mail to you from any
  601.           browser that supports forms. I've written a simple email forms
  602.           package (URL is: http://siva.cshl.org/email/index.html ), which
  603.           does it in ANSI C. There is also a package written in Perl,
  604.           known as the WWW Mailto Gateway (URL is
  605.           http://www.mps.ohio-state.edu/mailto/mailto_info.html ).
  606.           GetComments (URL is:
  607.           http://everest.cs.ucdavis.edu/~hoagland/getcomments.html) is a
  608.           more general package, also written in Perl, which can handle
  609.           many different types of comment forms.
  610.           
  611.           If you want to learn how these forms actually work, see section
  612.           5.7.14.
  613.           
  614.    
  615.    
  616.   5.7.4: HOW DO I COMMENT AN HTML DOCUMENT?
  617.   
  618.    
  619.    
  620.    Use the <!-- tag at the beginning of EACH line commented out; close
  621.    this for EACH line with the --> tag. Note that comments do not nest,
  622.    and the sequence "--" may not appear inside a comment except as part
  623.    of the closing --> tag. (It's officially allowed, but some browsers
  624.    won't handle it properly.)
  625.    
  626.    You should not try to use this to "comment out" HTML that would
  627.    otherwise be shown to the user, since some browsers (notably Mosaic)
  628.    will still pay attention to tags inside the comment and close it
  629.    prematurely.
  630.    
  631.    Thanks to Joe English for clearing up this issue.
  632.    
  633.   5.7.5: HOW CAN I CREATE DECENT-LOOKING TABLES AND STOP USING <PRE>... </PRE>?
  634.   
  635.    Tables are a standard feature in HTML Level 3, a new version of HTML.
  636.    Unfortunately, they are at present implemented only by the latest NCSA
  637.    Mosaic versions and the Viola and Emacs-W3 browsers, to my knowledge.
  638.    In addition, most implementations are incomplete. In some
  639.    implementations, at the time of this writing, text in tables cannot be
  640.    selected and/or cannot be a link.
  641.    
  642.    However, there is a way to use HTML Level 3 tables now and convert
  643.    them automatically to HTML, allowing you to design proper tables and
  644.    install those pages directly when table support arrives in the
  645.    majority of clients. You can do this using the html+tables package, by
  646.    Brooks Cutter (bcutter@paradyne.com), which is available for anonymous
  647.    ftp from sunsite.unc.edu in the directory
  648.    pub/packages/infosystems/WWW/tools/html+tables.shar. This package
  649.    requires the shell language Perl, which is primarily used on Unix
  650.    systems but is also available for other systems (such as MSDOS
  651.    machines). html+tables accepts HTML Level 3 and outputs html using the
  652.    <PRE>...</PRE> construct to represent tables, allowing you to write
  653.    HTML Level 3 now, knowing that it will look better when clients are
  654.    ready for it.
  655.    
  656.   5.7.6: WHAT IS HTML LEVEL 3 AND WHERE CAN I LEARN MORE ABOUT IT?
  657.   
  658.    HTML Level 3, also known as HTML+, is an enhanced version of HTML
  659.    designed to address some of the limitations of HTML. HTML Level 3
  660.    supports true tables, right-justified text, centered text, line breaks
  661.    that do not double space, and many other desired features.
  662.    
  663.    However, most clients support only a handful of HTML Level 3 features
  664.    (such as the partial implementation of tables in Mosaic) at the time
  665.    of this writing. If you have access to a Unix system with the X Window
  666.    System installed, you can try out many features of HTML Level 3 using
  667.    the experimental Arena browser.
  668.    
  669.    You can access information about new developments in HTML at the CERN
  670.    server (at the URL
  671.    http://info.cern.ch/hypertext/WWW/MarkUp/MarkUp.html ).
  672.    
  673.    (HTML Level 1 is the original version. HTML Level 2 is essentially the
  674.    same, but with the addition of forms.)
  675.    
  676.   5.7.7: HOW CAN I MAKE TRANSPARENT AND INTERLACED GIFS? AND WHAT ARE THEY?
  677.   
  678.    Transparent GIFs are useful because they appear to blend in smoothly
  679.    with the user's display, even if the user has set a background color
  680.    that differs from that the developer expected. They do this by
  681.    assigning one color to be transparent -- if the web browser supports
  682.    transparency, that color will be replaced by the browser's background
  683.    color, whatever it may be.
  684.    
  685.    Interlaced GIFs appear first with poor resolution and then improve in
  686.    resolution until the entire image has arrived, as opposed to arriving
  687.    linearly from the top row to the bottom row. This is great to get a
  688.    quick idea of what the entire image will look like while waiting for
  689.    the rest. This doesn't do much for you if your web browser doesn't
  690.    support progressive display as the image is downloaded, but
  691.    non-progressive-display web browsers will still display interlaced
  692.    GIFs once they have arrived in their entirety.
  693.    
  694.    To create transparent and interlaced GIFs, check out David Koblas'
  695.    giftool, a program which can manipulate those options and many more
  696.    aspects of your GIF file.
  697.    
  698.    In addition, there is a document explaining transparent GIFs available
  699.    at the URL http://melmac.corp.harris.com/transparent_images.html . You
  700.    can fetch the program giftrans by anonymous ftp from
  701.    ftp.rz.uni-karlsruhe.de at the path /pub/net/www/tools/giftrans.c.
  702.    
  703.    There is also a Perl Script (URL is:
  704.    http://www.omron.co.jp:80/~jfriedl/perl/ ) which makes transparent
  705.    GIFs.
  706.    
  707.    There is also a utility for the Macintosh, Transparency (URL is:
  708.    http://www.med.cornell.edu/~giles/projects.html#transparency).
  709.    
  710.   5.7.8: HOW COME MAILTO: URLS DON'T WORK?
  711.   
  712.    The mailto: URL is a feature found in Lynx, Netscape, Spry Mosaic, the
  713.    latest NCSA Mosaics, Emacs w3 mode and many other browsers. In
  714.    general, about 80% of web browsers support mailto: at the time of this
  715.    writing. However, it is not in numerous older browsers. In the
  716.    meantime, you can set up forms which send mail to you; see Section
  717.    5.7.3.2.
  718.    
  719.   5.7.9: HOW CAN I RESTRICT AND CONTROL ACCESS TO MY SERVER?
  720.   
  721.    All major servers have features that allow you to limit access to
  722.    particular sites, and many clients have authentication features that
  723.    allow you to identify specific users. There is a tutorial on security
  724.    and user authentication with the NCSA server and Mosaic available,
  725.    written by Marc Andreessen (URL is
  726.    http://wintermute.ncsa.uiuc.edu:8080/auth-tutorial/tutorial.html ).
  727.    See your server documentation for further information.
  728.    
  729.   5.7.10: WHICH FORMAT IS BETTER FOR WWW IMAGE PURPOSES, JPEG OR GIF?
  730.   
  731.    
  732.    
  733.    JPEG does a better job with realistic images such as scanned
  734.    photographs. Most browsers cannot handle inline JPEGs, however, so you
  735.    must link to them as external images (using a regular <A HREF...>
  736.    instead of <IMG SRC...>).
  737.    
  738.    GIF does a better job with crisp, sharp images, such as those
  739.    typically used to construct buttons, graphs and the like. All browsers
  740.    that can display graphics at all can display GIFs inline.
  741.    
  742.   5.7.11: HOW CAN I MIRROR PART OF ANOTHER SERVER?
  743.   
  744.    Scripts are available to do this, but at this time they are not very
  745.    friendly to the server you are attempting to mirror; their behavior
  746.    resembles that of the more poorly written WWW robots. If you are
  747.    trying to improve access times to a distant server, you will likely
  748.    find the "proxy" capabilities of CERN's WWW server to be a more
  749.    effective and general solution to your problem.
  750.    
  751.   5.7.12: HOW CAN I KEEP ROBOTS OFF MY SERVER?
  752.   
  753.    Programs that automatically traverse the web can be quite useful, but
  754.    have the potential to make a serious mess of things. Every so often
  755.    someone will write a "depth-first" searching robot that brings servers
  756.    to their knees. See the section on writing robots (4.10) for details.
  757.    
  758.    Fortunately, most robots on the web follow a simple protocol by which
  759.    you can keep them off your server if you wish, or keep them out of
  760.    portions of your server which are robot traps (ie, they contain an
  761.    infinite number of possible links). Read the document World Wide Web
  762.    Robots, Wanderers and Spiders (URL is:
  763.    http://web.nexor.co.uk/mak/doc/robots/robots.html ) and learn about
  764.    the emerging standards for exclusion of robots from areas in which
  765.    they are not wanted. You can also read about existing robots there,
  766.    including useful cataloging robots you probably do not want to keep
  767.    off your server.
  768.    
  769.   5.7.13: HOW CAN I KEEP STATISTICS ABOUT MY WEB SERVER?
  770.   
  771.    There are several tools which can generate statistics about your web
  772.    server:
  773.    
  774.    getstats
  775.           getstats is a versatile log analyzer, also written in C, which
  776.           provides reports for various time periods with a high degree of
  777.           flexibility. Add-on packages have been written to generate
  778.           reports in HTML and also to generate graphs. You can access the
  779.           getstats home page for more information (URL is
  780.           http://www.eit.com/software/getstats/getstats.html ), or obtain
  781.           the package by anonymous FTP from ftp.eit.com in the directory
  782.           /pub/web.software/getstats.
  783.           
  784.    WebStat
  785.           WebStat is a package written in the language Python which
  786.           supplies statistics on usage by domain, country, etc., with
  787.           daily, weekly, monthly and annual reports available. You will
  788.           need Python in order to use it. See the WebStat home page (URL
  789.           is
  790.           http://www.pegasus.esprit.ec.org/people/sijben/statistics/advertisment.html
  791.           ) for details, or obtain Python from ftp.cwi.nl in
  792.           the directory /pub/python and WebStat from
  793.           ftp.pegasus.esprit.ec.org in the directory /pub/misc.
  794.           
  795.    Wusage
  796.           Wusage, which I wrote, is a C program which generates simple
  797.           weekly reports in HTML, with inline image graphs displaying
  798.           server growth and the distribution of accesses by continent.
  799.           You can also exclude irrelevant accesses (inline images, local
  800.           machines, etc.) from the results. Read the Wusage home page
  801.           (URL is http://siva.cshl.org/wusage.html ) for more
  802.           information, or obtain Wusage by anonymous FTP from
  803.           isis.cshl.org in the directory pub/wusage.
  804.           
  805.    wwwstat
  806.           wwwstat is a full-featured log analyzer written in the language
  807.           Perl. (See the newsgroup comp.lang.perl for more information
  808.           about the language.) See the wwwstat home page (URL is
  809.           http://www.ics.uci.edu/WebSoft/wwwstat/ ) for more information,
  810.           or obtain the package by anonymous FTP from liege.ics.uci.edu
  811.           in the directory /pub/arcadia/wwwstat. See also gwstat (URL is
  812.           http://dis.cs.umass.edu/stats/gwstat.html ), a package which
  813.           produces GIF graphs from the output of wwwstat.
  814.           
  815.    
  816.    
  817.   5.7.14: I WANT TO GENERATE WEB PAGES FROM A PROGRAM. DO I HAVE TO WRITE A
  818.   CUSTOM SERVER?
  819.   
  820.    No, you will not need to write a custom server. Most web servers
  821.    support one variation or another of a standard for adding your own
  822.    programs to the web server. The standard is called CGI (Common Gateway
  823.    Interface).
  824.    
  825.    Marc Hedlund has written a FAQ on CGI programming (URL is:
  826.    http://www.halcyon.com/hedlund/cgi-faq/ ) which makes a good
  827.    introduction to the subject. The standard itself can be found at NCSA
  828.    (URL is: http://hoohoo.ncsa.uiuc.edu/ ).
  829.    
  830.     5.7.14.1: How can I generate GIFs on the fly from my CGI scripts?
  831.     
  832.    If you want to generate GIF images on the fly as part of your
  833.    application, examine the gd library (URL is:
  834.    http://siva.cshl.org/gd/gd.html ). Hint: your HTML page and your
  835.    inline images are separate documents with separate URLs. Generate them
  836.    in response to separate requests! (Yes, there are tricks to speed this
  837.    up, but be careful not to break inline images on HTML pages you didn't
  838.    write that refer to your gd-generated image.)
  839.    
  840.    It's also possible to use gnuplot and the pbmplus utilities. This is
  841.    slower, but can require less programming if gnuplot is sufficient for
  842.    your purposes. (See archie for both tools.)
  843.    
  844.                   6: WHERE CAN I DISCUSS THE WORLD WIDE WEB?
  845.                                        
  846. 6.1: What newsgroups discuss the Web?
  847.  
  848.    You can find discussion of World Wide Web topics in three newsgroups,
  849.    and one newsgroup which will soon be removed:
  850.    
  851.    comp.infosystems.www.users
  852.           A forum for the discussion of WWW client software and its use
  853.           in contacting various Internet information sources. New user
  854.           questions, client setup questions, client bug reports,
  855.           resource-discovery questions on how to locate information on
  856.           the web that can't be found by the means detailed in the FAQ
  857.           and comparison between various client packages are among the
  858.           acceptable topics for this group. Please specify what browser
  859.           and what system type (Windows, Mac, Unix, etc.) your post is
  860.           about if you are asking questions about a specific program.
  861.           
  862.    comp.infosystems.www.providers
  863.           A forum for the discussion of WWW server software and the use
  864.           of said software to present information to users. General
  865.           server design, setup questions, server bug reports, security
  866.           issues, HTML page design and other concerns of information
  867.           providers are among the likely topics for this group.
  868.           
  869.    comp.infosystems.www.misc
  870.           A forum for general discussion of WWW (World Wide Web)- related
  871.           topics that are NOT covered by the other newsgroups in the
  872.           hierarchy. This will likely include discussions of the Web's
  873.           future, politicking regarding changes in the structure and
  874.           protocols of the web that affect both clients and servers, et
  875.           cetera.
  876.           
  877.    comp.infosystems.www.announce
  878.           A moderated forum for the announcement of new and updated World
  879.           Wide Web resources and software.
  880.           
  881.    comp.infosystems.www (DEFUNCT)
  882.           The old catch-all newsgroup, which may still exist on your
  883.           system but was officially removed on September 7th, 1994,
  884.           according to David Lawrence, moderator of
  885.           news.announce.newgroups. If your system still carries this
  886.           group, ask your administrator to remove it.
  887.           
  888.    
  889.    
  890. 6.2: What mailing lists discuss the Web?
  891.  
  892.    www-talk@info.cern.ch
  893.           Address: www-talk@info.cern.ch for CONTRIBUTIONS ONLY.
  894.           Administration: listserv@info.cern.ch (robot)
  895.           www-talk-request@info.cern.ch (human). Description: Technical
  896.           discussion, W3 related. Experts to experts. General questions
  897.           to the newsgroups, please. Archive: Not currently served, but
  898.           kept.
  899.           
  900.    www-announce@info.cern.ch
  901.           Address: www-announce@info.cern.ch. NOT FOR GENERAL USE -
  902.           serious low-volume announcements only. Administration:
  903.           listserv@info.cern.ch (robot),
  904.           www-announce-request@info.cern.ch (human). Description: Low
  905.           volume summary announcemements of product releases, etc.
  906.           Archive: Not currently public.
  907.           
  908.    
  909.    
  910.                             7: I WANT TO KNOW MORE
  911.                                        
  912.    
  913.    
  914.    To find out more, use the web. This FAQ hopefully provides enough
  915.    information for you to locate and install a browser on your system. If
  916.    you have system specific questions regarding FTP, networking and the
  917.    like, please consult newsgroups relevant to your particular hardware
  918.    and operating system!
  919.    
  920.    Once you're up and running, you may wish to consult the World Wide Web
  921.    Primer by Nathan Torkington. It is available at the URL
  922.    http://www.vuw.ac.nz/who/Nathan.Torkington/ideas/www-primer.html .
  923.    
  924.    Later you may return to this FAQ for answers to some of the more
  925.    advanced questions. I encourage you to check out the changes listed
  926.    early in the document each time the FAQ appears.
  927.    
  928.                                   8: CREDITS
  929.                                        
  930.    Maintainer (11/93 to present): Thomas Boutell, boutell@netcom.com
  931.    
  932.    Former Maintainer (until 11/93): Nathan Torkington,
  933.    Nathan.Torkington@vuw.ac.nz
  934.