Guidelines on Using the Publishing System

Files Directories
Overview
OPublishing Files
  1. What Publishing Method do I Use?
  2. Publishing Files Using Mail to Web
  3. Publishing Files Using Netscape or an Alternative Application
 OCreate a New Publishing Area (directory)

OCreate Directory and Subdirectories
OHave a Standard Look for my Files
  1. What is the Default Layout?
  2. What Can I Change?
  3. How do I Alter/Remove the Mail Header?
  4. How do I add my own Header?
  5. How do I add my own Footer?
  6. My Index is Long and I Want the Command Bar at the Top and Bottom of the Page
  7. I Want a Banner/Toolbar Down the Side of the Page
  8. How Do I Change the Area Background?
 OChange the Appearance of an Area
  1. What are the parameters?
  2. How do I change the parameters?
  3. What is the Default Layout?
  4. How do I add my own Header?
  5. How do I add my own Footer?
  6. My Index is Long and I Want the Command Bar at the Top and Bottom of the Page
  7. I Want a Banner/Toolbar Down the Side of the Page
  8. How do I change the Way a File or Directory Index Appears on the Page?
  9. How Do I Change the File Background?
OEdit My Files When they Have Been Published

OArchive or Delete My Files and Directories		 0Set Up Areas to Inherit Parent Characteristics
  1. What is Inheritance?
  2. Matching Area Types
  3. Rules for Inheritance
  4. Prevented Parameters from Being Inherited

Overview

 With the current system you can:
  1. Publish files
  2. Generate an Index of Files or Directories in the Area Automatically.
  3. Edit or delete published files
  4. Create new directories (areas)
  5. Change the way an area looks
  6. Add special banners or logos to files when published in an area.

  1. Publishing files

    2. The present publishing system is based upon an email client. Any email message, or email with file attachments can be published on the web using the "webmail" system. The webmail system processes each email to have a standard header and footer which tr ansforms it to html format so that it can be viewed by the web browser. Documents created with special applications such as word, excell, or powerpoint remain as attachments which can be downloaded from the web and viewed with the application with which t hey were made.

  2. Generate an Index of Files or Directories in the Area Automatically.

    3. An auto-matic indexing system is used to provide a list of files or directories in each area. The webmail publishing system calls this procedure so that new files arriving in the area are included in the area's index.

  3. Editing and Deleting Files

    4. Files can be edited or deleted from the web server using the "ParamEdit" tool which is accessible from the command bar on every web page. Care must be taken to select the correct file to be edited or deleted.

  4. Create new directories (areas)

    5. Four types of directories can be found on the current system, each with a particlular function.
    1. List Area- these are set up specifically for webmail publishing
    2. Image Area - these contain the webmail attachments such as word, excell documents. Users do not normally need to access this area.
    3. Private Area - this provides users with a free-format area. This is the only area which currently allows Netscape Publishing.
    4. Node Areas - these are found above the list, private and image areas, and act like a menu page providing a list of the areas one level below.


    The diagram below illustrates these areas.

    You can create a new "list area" for webmail publishing, or create a new "node area" under which further "node" areas, or "list" areas can be created. One vital rule is that all "list areas" which contain files are found at the end of the directory tree - i.e. you cannot have an area below a list area - only files.

  5. Change the way an area looks

    6. The webpage which displays the index for every list or node area is defined by parameters which can be customised according to requirements. These parameters can be changed through a web interface using the "paramedit" system.

    Parameters which control a node area are suffixed with "list" and parameters which control a list area are prefixed with "list". In this way the layout for a node area can be different to that of a list area below.

    As an example, the parameters which define the default layout for a node area are defined below.

    Layout for a Node Area (Contains Subdirectories)

    Parameter NodeBanner - for heading and logo, and any information above the index.



    Parameter NodeElementBanner -for an Index of Subdirectories- each entry is a single table -

    Subdirectory 1SubtitleMailkey
    Subdirectory 2SubtitleMailkey
    Subdirectory 3SubtitleMailkey


    Parameter NodeTail - for any information below the directory index.

    Node Command Bar o o o o o

    Node Self Ref
    $http://$servername$listurl
    Parameter NodeFooter - for address information, logo.

Publishing Files
  1. What Publishing Method do I Use?
  2. Publishing Files Using Mail to Web
  3. Publishing Files Using Netscape or an Alternative Application

  1. What Publishing Method do I Use?

    2. Files can be published using the Mail to Web system or a commercial application such as Netscape Composer. (The latter is not yet fully functional, and requires the user to maintain the area.)

    All files when published on the server must meet the standard requirements for headers, footers and keywords. All files published by the mail to web method are processed automatically to meet these standards. This is the recommended publishing method w hich is supported by the Corporate Web Group. This type of publishing is supported in list areas, in which an index of all files in the area is generated automatically.

    In contrast, publishing using Netscape is currently supported in private areas only, which must be maintained by the user. These areas provide the user with free-formatting capabilities, but require that the area's index is updated manually every time a file is published in order for the file to be listed. Imminent developments of this system will be to allow users to publish to list areas using Netscape, but with enforced file formatting. This will allow the auto-indexing and editing systems to mainta in control of these areas.

  2. Publishing Files Using Mail to Web

    3. The Mail to Web system allows users to publish files via an email client to any list area (an area defined to display only files). Any file (text, image, html, word document, excel chart or spreadsheet etc.) can be sent to an area as an email attachmen t. Alternatively the email message itself can contain the main file contents (for more tips on formatting email messages see Help On Mail to Web Format Tricks). The resulting html file includes a stan dard header and footer (defined for each area) which is added by the mail_to_web system. In addition, keywords (defined in the area's indexformat.html control file) are added for search capabilities.

    1. How Do I Publish to an Area?
    2. How Do I Alter the Mail Headers?
    3. How do I Change the Headers and Footers Being Added to my Files?

      4. The latter two are found in the section "Have a Standard Look for My Files".

  1. How Do I Publish to an Area?

    2. Directly from Your Browser

    Each file can be published by sending it as an email attachment to the appropriate publishing area. You can do this by going to the publishing area, and clicking on the "Post New Message on the Command bar. o o o -> o

    A link to your email client with the address of that area will be opened. You can then enter the text of your file as the main email message, or send your file as an attachment. An advantage of this method is that that your file will be guaranteed to g o to the correct Webmail address.

    The subject heading for your email should be the same as your heading for the article you wish to publish. This will appear in the auto-generated index for the area when published.

    Using Your Email Without Opening the Web Browser

    Alternatively you can obtain the mailkey for the area, which will be displayed in the area above. You can then send your file to mailkey@www.choral.org. An advantage is that you do not need to open your web browser to send messag es to the web using this method. However it cannot be guaranteed that you will not make an error defining the mailkey. Should the mailkey not be recognized you will receive an email message notifying you.

    Additional Note

    The existing Mail_to_Web System cuts filenames at roughly 62 characters. Also characters a_z,0_9 are supported. This ensures the combination of filename and directory is less than the 128 limit beyond which some utilities choke. Meaningful filenames be low this length are therefore recommended.

    More help on using Mail to Web can be found at: http://www.choral.org/admi/util/help/help_on_using_mail_to_web.html.

  2. Publishing Files Using Netscape or Another Publishing Application

    3. The Mail to Web system automatically adds the required standard format to all files published on the server. However when using Netscape or another publishing system, the users themselves must ensure each file conforms to the required standards. As th is cannot be guaranteed, publishing by this manner is currently only be permitted to private areas, that the user is responsible for maintaining. (The auto-indexing, editing and searching capabilities will not be supported for these areas.)

    Future developments (which are imminent) will allow the user to publish using Netscape (or a similar commercial application) to a List area in which auto-indexing, editing and search capabilities are supported. The standard requirements for headers, fo oters etc. will be satisfied automatically. Until that time, users must publish to private areas using these applications.

    1. Standard Requirements

      2. Header and Footer

      The standard header and footer required by Corporate on all servers is not automatically added when a file is published outside of the Mail to Web system. The user must therefore add the standard header and footer manually.

      The file headers and footers can only be replaced using a html editor or a simple text editor, using cut and paste. (Netscape Composer does not allow you to alter the headers and footers.) The file can then be published in the appropriate area using Ne tscape Publisher.

      The standard header is:

      <html>
      <head>
      <title>filetitle </title>
      <meta name="longname" content="filename">
      <meta name="keywords" content="keywords">
      <meta name="ofid" content="unique id"> </head>
      <body bgcolor="ffffff">


      • filetitle must include a meaningful title, and the date and time of the file creation.

        • The date must be written as day first_three_letters_of_the_month 1998
        The time must be written as hr:min:sec
        e.g. My Webpage 20 Oct 1998 12:02:57
      • filename must correspond with the name of the file.
        eg. my_webpage.html
      • keywords must be keywords which best represent the context of your file.
      • ofidThis is a unique number used to identify your file for searching and indexing purposes.
        This is omne1998monthdaytime_of_creation_any_five_other_digits
        e.g. omne199810191053568410 for a file created on 19th October at 10:53 and 56 seconds.">

      The standard footer is

      <address>addressvalue</address>
      </body>
      </html>
      • addressvalue must be something which identifies you as the owner of the file. This can be:
        Your email address e.g. fetterley@houston.sns.slb.com
        Your name e.g. Susy Grilli
        A mailto link to you:
        e.g. <a href="mailto:fetterley@houston.sns.slb.com">Susy Grilli</a>

      These must be included because...

      Maintext

      Once published, you may edit your file using the Param Edit Option on the command bar in the publishing area. However only data within your file which is marked b y parameters will be editable by this system.

      The simplest approach to ensure your whole file is editable is to include the main section of your file between the delimiters

      <param name="maintext">
      <param name="/maintext">
      <param name="maintextOption" value="!textarea"> must also be added so that this parameter can be viewed and edited within a text box in the paramedit page.


      Your file should therefore read:

      Standard header
      <param name="maintext">
      Your main file data
      <param name="/maintext">
      <param name="maintextOption" value="!textarea">
      Standard Footer

      Additional Parameters

      It is recommended that all files also contain thefileselfref and filecmdbar parameters. These can be cut and pasted into your file:

      Fileselfref provides the URL for the area in which the file is published. This is a useful reference if the file contents are to be printed.
      $http://$servername$listurl


      Filecmdbar provides the navigational options to go up to the parent directory, to move between files in that area, to publish another file, and to go to a help area.

      o o o -> -> o o

      Additional headers, banners and logo's.

      When using Netscape or an alternative publishing system, any headers, banners or icons which would have been added automatically to your page by the Mail to Web system will have to be added manually before publishing.

      You may include these in the maintext parameter so that they are editable when published.

      Alternatively you may wish to follow the parameter scheme which is applied to all files published by the Mail to Web system. For example if you have a banner or logo across the top of your page which is the same as that added to existing files in the a rea when published by Mail to Web, you may wish to add the parameter name within your file. This will ensure that all files in the area will have the banner defined under the same parameter, thereby providing some uniformity for editing. Typically the ban ner, logo or title for a file will be defined by the parameter FileHeader

      <param name="fileheader">
      Enter the code for the banner
      <param name="/fileheader">
      <param name="fileheaderoption" value="!textarea">

      Note:Sections of your file can be defined by any parameter contained in that area's indexformat file.

    2. Publishing Steps

    1. Ensure your file meets the standard header and footer requirements.
    2. Ensure your main contents are contained within maintext or other recognizable parameter tags, so that the file can be edited when published.
    3. Select publish from the Netscape Composer menu.
    4. For the Page Title box enter the title for the file (this must include the date and filetime as described above). (Note although you entered this in the standard header information, Netscape overwrites this information with the Page Title when publishing).
    5. Enter the filename (this must be the same as the longname value included in your standard header.
    6. Enter the https location to which the page will be published. Make sure this is a list area and does not have directories below it. Also publishing will only be permitted under the authenticated system - you must therefore ensure you have ente red https and not http.
    7. Enter your username and password for the PH/LDAP system. You must have the correct authentication to be able to publish in the area.
    8. For files associated with this page Select None
    9. Check all details are correct and select OK. Netscape Composer will follow with a message regarding successful or unsuccessful publishing.


    Return to Contents

Create a New Publishing Area

Determine the area type

If you require a new area to publish files to, you must decided whether these files will be published using Netscape or Mail to Web. At present publishing using Netscape is not supported in list areas.

Note:Private areas are intended to provide the user with a free-format area in which the standard formatting requirements do not have to be satisfied. However as a result the indexing and editing systems are not be supported. The ar ea title (areatitle) will be recognized so that it may be included in the parent directories' index. Also, authentication parameters are still recognized, and a basic index of all files present in the area will be provided. However, no other options for d efining the area layout will be available. Therefore it is advisable once the area is created to publish an index.html file which will control the area's index and layout.


In order to create a new area you must be in a node area, designated to be the parent area of subdirectories. This can be identified by:
  1. The automatic index generated shows the names of directories in that area.
  2. The command bar in the area does not display an option to publish files:
    o is not included and the command bar is: o o o o

Creating a List Area

  1. Click on the param edit option from the command bar in that area:
    o o o o
  2. When the edit options appear enter the password for the area (normally aaaa) if required.
  3. From the list of editing options check the box Create Area. (If this option is not shown you are not in a node area.)
  4. Enter a name for the new directory. This must be a minimum of two and a maximum of four characters in length.
  5. Click on
  6. You will be provided feedback regarding the creation of the directory.
  7. If a directory with that name already exists your new directory name will be altered - the last character will be replaced with one which follows in the alphabet (e.g. if mail already exists then maim will be created).
  8. If successful the area configuration editor (Param Edit) will be loaded.

Next create an indexformat file for your new area
  1. The default indexformat parameter values will be loaded.
  2. You will need to alter some parameters in order for your area to be customized:

    areatitle. This will be the main title for your area, and will appear in the index of the parent directory.

    areaSubtitle. This will appear in the index of the parent directory.

    Mailkey. This will be needed if you wish to publish via Mail to Web.

    Keywords. This will be needed for searching and will be added (by default) to all files published in the area.

    AreaType. This will be needed if you wish to specify the area to be private for Netscape publishing. Otherwise the default type (List) will be defined.

  3. Click on
    for each parameter which you change (you must submit their values one by one or the change will not be made.)
  4. When all changes have been made click on to take you to the new area.

Finally register the changes to the indexformat in your new area and in the parent area
  1. Click on the update index option from the command bar in that area to update the directory:
    o o o o o

  2. Then update the parent directory so that the new area is presented in the automatic index. Select parent on the command bar
    o o o o o

    and then select the update directory option again.

Creating a Private Area (for free formatting)

  1. Go to the node area in which you wish to add the new directory.
  2. Click on the param edit option from the command bar in that area:
    o o o o
  3. When the edit options appear enter the password for the area (normally aaaa) if required.
  4. From the list of editing options check the box Create Area. (If this option is not shown you are not in a node area.)
  5. Enter a name for the new directory. This must be a minimum of two and a maximum of four characters in length.
  6. Click on
  7. You will be provided feedback regarding the creation of the directory.
  8. If a directory with that name already exists your new directory name will be altered - the last character will be replaced with one which follows in the alphabet (e.g. if mail already exists then maim will be created).
  9. If successful the area configuration editor (Param Edit) will be loaded.
  10. The default indexformat parameter values will be loaded.

  • In order for your area to be recognized in the parent directory's index, you will need to provide a title for the area (areatitle).
    1. You may also add a areaSubtitle which will appear in the index of the parent directory.
    2. A Mailkey will be needed if files are to be published using Mail to Web.
    3. Keywords will be needed for searching.
    4. AreaType will be needed on order to specify the area to be private.

    5. Click on
      for each parameter which you change (you must submit their values one by one or the change will not be made.)
    6. When all changes have been select which will take you to the new area.

    Finally register the changes to the indexformat in your new area and in the parent area
    1. Click on the update index option from the command bar in that area to update the directory:
      o o o o o

    2. Then update the parent directory so that the new area is presented in the automatic index. Select parent on the command bar
      o o o o o

      and then select the update directory option again.

    Note:With a private area, the area title (areatitle) will be recognized so that it may be included in the parent directories' index. Also a basic index of all files present in the area will be provided. However, no other options for de fining the area layout will be available. Therefore it is advisable once the area is created to publish an index.html file which will control the area's index and layout. (go to Netscape publishing steps)



    Return to Contents

    Create a Directory and Subdirectories

    Define the Area Types

    If you wish to add to the directory structure, creating new areas beneath each other, you must define the correct area type for each.

    It is advisable to have a sketch of your directory structure before attempting to create the areas. e.g.


    These areas must be created in a top-down order, so that node areas area created before their subdirectories.

    Creating a Node Area (for creating subdirectories)

    1. Go to the area in which you wish to add the new directory. (The area must be of type node in order to have a directory added.)
    2. Click on the param edit option from the command bar in that area:
      o o o o
    3. When the edit options appear enter the password for the area (normally aaaa) if required.
    4. From the list of editing options check the box Create Area. (If this option is not shown you are not in a node area.)
    5. Enter a name for the new directory. This must be a minimum of two and a maximum of four characters in length.
    6. Click on
    7. You will be provided feedback regarding the creation of the directory.
    8. If a directory with that name already exists your new directory name will be altered - the last character will be replaced with one which follows in the alphabet (e.g. if mail already exists then maim will be created).
    9. If successful, the area configuration editor (Param Edit) will be loaded.

    Next create an indexformat file for your new area
    1. The default indexformat parameter values will be loaded.
    2. You will need to alter some parameters in order for your area to be customized.

      areatitle and areaSubtitle which will appear in the index of the parent directory.
      Keywords - add keyowrds to enable search capabilities
      AreaType - specify the area to be a node.

      Note:Mailkey will not be needed as files cannot be published in a node area.

    3. Click on
      for each parameter which you change (you must submit their values one by one or the change will not be made.)
    4. When all changes have been made select which will take you to the new area.

    Finally register the changes to the indexformat in your new area and in the parent area
    1. Click on the update index option from the command bar in that area to update the directory:
      o o o o o

    2. Then update the parent directory so that the new area is presented in the automatic index. Select parent on the command bar
      o o o o o

      and then select the update directory option again.
    You may change additional parameters to customise the way your newly created area looks. You may now create further directories below this one.

    Creating a List Area (for publishing files)

    1. Go to the node area in which you wish to add the new directory.
    2. Click on the param edit option from the command bar in that area:
      o o o o
    3. When the edit options appear enter the password for the area (normally aaaa) if required.
    4. From the list of editing options check the box Create Area. (If this option is not shown you are not in a node area.)
    5. Enter a name for the new directory. This must be a minimum of two and a maximum of four characters in length.
    6. Click on
    7. You will be provided feedback regarding the creation of the directory.
    8. If a directory with that name already exists your new directory name will be altered - the last character will be replaced with one which follows in the alphabet (e.g. if mail already exists then maim will be created).
    9. If successful the area configuration editor (Param Edit) will be loaded.

    Next create an indexformat file for your new area
    1. The default indexformat parameter values will be loaded.
    2. You will need to alter some parameters in order for your area to be customized:

      areatitle and areaSubtitle which will appear in the index of the parent directory.
      Mailkey will be needed if files are to be published using Mail to Web.
      Keywords will be needed for searching.
      Note:AreaType will use the default List value.

    3. Click on
      for each parameter which you change (you must submit their values one by one or the change will not be made.)
    4. When all changes have been made select the button o to take you to the new area.

    Finally register the changes to the indexformat in your new area and in the parent area
    1. Click on the update index option from the command bar in that area to update the directory:
      o o o o o

    2. Then update the parent directory so that the new area is presented in the automatic index. Select parent on the command bar
      o o o o o

      and then select the update directory option again.
    You may change additional parameters to customise the way your newly created area looks. You may now publish to this area using the webmail system.

    Creating a Private Area (for free formatting)

    1. Go to the newly create node area in which you wish to add the new directory.
    2. Click on the param edit option from the command bar in that area:
      o o o o
    3. When the edit options appear enter the password for the area (normally aaaa) if required.
    4. From the list of editing options check the box Create Area. (If this option is not shown you are not in a node area.)
    5. Enter a name for the new directory. This must be a minimum of two and a maximum of four characters in length.
    6. Click on
    7. You will be provided feedback regarding the creation of the directory.
    8. If a directory with that name already exists your new directory name will be altered - the last character will be replaced with one which follows in the alphabet (e.g. if mail already exists then maim will be created).
    9. If successful the area configuration editor (Param Edit) will be loaded.
    10. The default indexformat parameter values will be loaded.

  • In order for your area to be recognized in the parent directory's index, you will need to provide a title for the area (areatitle).
    1. You may also add a areaSubtitle which will appear in the index of the parent directory.
    2. A Mailkey will be needed if files are to be published using Mail to Web.
    3. Keywords will be needed for searching.
    4. AreaType will be needed on order to specify the area to be private.

    5. Click on
      for each parameter which you change (you must submit their values one by one or the change will not be made.)
    6. When all changes have been made go to the bottom of the file and select the hyperlink "just exit with no save". This will take you to the new area.

    Finally register the changes to the indexformat in your new area and in the parent area
    1. Click on the update directory option from the command bar in that area to update the directory:
      o

    2. Then update the parent directory so that the new area is presented in the automatic index. Select parent on the command bar
      o
      and then select the update directory option again.

    Note:With a private area, the area title (areatitle) will be recognized so that it may be included in the parent directories' index. Also a basic index of all files present in the area will be provided. However, no oth er options for defining the area layout will be available. Therefore it is advisable once the area is created to publish an index.html file which will control the area's index and layout.



    Return to Contents

    Change the Appearance of an Area

    The appearance and properties of an area are controlled by a number of parameters in the area's control file (indexformat.html). To change the way an area looks, who may access the area, or how long the files are displayed requires alteration of the ap propriate parameters.

    1. What are the parameters?
    2. How do I change the parameters?
    3. What is the Default Layout?
    4. How do I add my own Header?
    5. How do I add my own Footer?
    6. My Index is Long and I Want the Command Bar at the Top and Bottom of the Page
    7. I Want a Banner/Toolbar Down the Side of the Page
    8. How do I change the Way a File or Directory Index Appears on the Page?
    9. How Do I Change the Area Background?

    1. What are the parameters?

      2. The following table is a summary for quick reference. A brief description of each is provided below, while greater detail can be found at: http://www.choral.org/admi /util/help/help_on_indexformat.html.

      Authentication
      Allowread
      Allowwrite
      		 Auto-Indexing
      ListElementBanner
      NodeElementBanner
      ImageElementBanner
      GroupBanner
      GroupTrigger       		Headers and Footers
      NodeHeader
      ListHeader
      FileHeader
      ImageHeader

      NodeFooter
      ListFooter
      FileFooter
      ImageFooter

      NodeSelfRef
      ListSelfRef
      FileSelfRef
      ImageSelfRef
      		 Custom Features
      areatitle
      areaSubtitle
      Responsibility

      NodeBanner
      ListBanner
      FileBanner
      ImageBanner

      NodeTail
      ListTail
      FileTail
      ImageTail
      		 Mail Properties
      Mailkey
      Emailcopy
      Mailquery
      MaxCount
      MaxAge
      FileMailBanner
      		 Add Comment
      InsertComment
      InsertIcon       		Advanced
      htmlformat
      PictureURL
      NewsSummary

      1. Authentication

        2. Allowread-Controls who may access the area.
        Allowwrite-Controls who may publish in the area using Netscape, or who may alter parameter controls.
        Password-required for using Param Edit to alter parameter controls.

      2. Auto-Index

        3. ListElementBanner - controls the presentation of the index of files in a list area
        NodeElementBanner-controls the presentation of the index of directories in a node area
        ImageElementBanner-controls the presentation of the index of images in an image area

        GroupBanner-controls the grouping of files, directories or images in each area.
        GroupTrigger-determines whether grouping will be on or off.


        Note:
        • A node area is set aside to display only subdirectories in that area.
        • A list area is set aside to display only files in that area.
        • An image area is set aside specifically to display image files.

      3. Headers and Footers

        4. NodeHeader -A standard header containing information regarding keywords, author, a unique id, and the filename required for indexing and search capabilities will be added to the top of the node area.
        ListHeader -A standard header containing information regarding keywords, author, a unique id, and the filename required for indexing and search capabilities will be added to the top of the list area.
        FileHeader-A header containing standard information regarding keywords, author, a unique id, and the filename required for indexing and search capabilities will be added to the top of all files posted in the list area.
        ImageHeader-A header containing standard information regarding keywords, author, a unique id, and the filename required for indexing and search capabilities will be added to the top of all files posted in an image area.
        NodeFooter-A standard footer containing standard address information will be added to the top of the node area.
        ListFooter-A standard footer containing standard address information will be added to the top of the list area.
        FileFooter-A standard footer containing standard address information will be added to the end of all files posted in the list area.
        ImageFooter-A standard footer containing standard address information will be added to the end of all files posted in the image area.
        NodeSelfRef-The URL of the node area will be displayed.
        ListSelfRef-The URL of the list area will be displayed.
        FileSelfRef-All files posted in the area will display their URL.
        ImageSelfRef-The URL of the image area will be displayed.

      4. Custom Features

        5. areatitle-The title of the node or list area to be displayed
        areaSubtitle-The subtitle of the node or list area- will be displayed in the index of the node area above if specified.
        Responsibility-
        NodeBanner-Additional headings, text or images can be added above the auto- generated index for a node area.
        ListBanner-Additional headings, text or images can be added above the auto- generated index for a list area.
        FileBanner-Additional text or images can be added above the main contents of every file posted in a list area.
        ImageBanner-Additional headings, text or images can be added above the auto- generated index for an image area.
        NodeTail-Additional text or images can be added below the auto-generated index for a node area.
        ListTail-Additional text or images can be added below the auto-generated index for a list area.
        FileTail-Additional text or images can be added below the main contents of every file posted in a list area.
        ImageTail-Additional text or images can be added below the auto-generated index for an image area.

      5. Mail Properties

        6. Mailkey-Specify the keyword used in the Webmail address for publishing to that list area.
        EmailCopy-Determines if files posted to this area are to be forwarded to other email addresses.
        MailQuery-Specifies the email addresses to which email copy will refer.
        MaxCount-The maximum number of files which will be displayed in a list area.
        MaxAge-The maximum number of days a file will be displayed in a list area.
        FileMailBanner-Defines the components included in the mailheader added to a file.

      6. Add Comment

        7. InsertComment-Determines if comments are to be added to files published in a list area.
        InsertIcon-Specifies the icons indicating where comments can be added to a file.

    2. How do I change the parameters?

      3. First go to the area you wish to alter parameters for. The parameters can be changed using the Param Edit system accessed by selecting the Param Edit button on the command bar in the area:

      o o o o

      You will be required to enter a password for the area (normally aaaa) unless you are using an authenticated server in which case your identify will have been verified with PH/LDAP, and you must make sure the box is checked for "Change Directory Control s". Then click on

      and you will be taken to the "Area Configuration Editor".

      A list of editable parameters is provided at the top of the editor page in alphabetical order. Selecting one of these will take you to the parameter's location within the page. The current value for each parameter will be displayed. You may change thes e value, but must select

      for every parameter that is changed.

      When you have finished changing parameters, you can leave the editor by selecting the . This will take you to the area you have made changes for.

      To register the changes you have made you must update the directory by selecting the button on the command bar for that area.

      Any changes to parameters defining File characteristics will only be made to new files arriving in the area. Therefore to see these effects you must publish a new file.


    3. What is the default layout?

      4. List Area

      List of Files in area arranged in groups by date and time of publishing (most recent at top), with author displayed
      Omnes
      SLB
      C&W
      Home
      News
      Search
      Contact
      Tacacs
      Calendar
      Directory
      People 
      PersSite
      SLB Page
      BBoards
      Help Files
      Web Projects
      O 29-Oct-1998
      14:12:50 Filename1 Susy Grilli
      13:59:04 Filename2 Susy Grilli
      13:57:47 Filename3 Susy Grilli
      O 28-Oct-1998
      13:56:50 Filename4 Susy Grilli
      13:54:52 Filename5 Susy Grilli
      Command Bar below the FileList
      o o o o o

      http://www.choral.org/admi/util/help/indexauto.html

      Node Area

      Index of Directories Displaying the Title, Subtitle and Mailkey for Each
                    ;   Omnes
      SLB
      C&W
      Home
      News
      Search
      Contact
      Tacacs
      Calendar
      Directory
      People 
      PersSite
      SLB Page
      BBoards
      Help Files
      Web Projects
      O Directory 1 Title Directory 1 Subtitle directory1_mailkey
      O Directory 2 Title Directory 2 Subtitle directory2_mailkey
      O Directory 3 Title Directory 3 Subtitle directory3_mailkey
      O Directory 4 Title Directory 4 Subtitle directory4_mailkey

      Command Bar for Node Area
      o o o o

      http://www.choral.org/admi/util/help/indexauto.html

    4. How do I add my own Header?

      5. The parameters ListBanner and NodeBanner defined the information added above the index in List and Node areas respectively. e.g.

      $areatitle e.g. Oilfield Services Finance

      This is in tabular format, with two columns in vertical alignment in a single row. One column contains the image, and one contains the parameter $areatitle, the value of which will be filled in when the auto-index for the area is generated.

      Steps to Follow

      1. Go to the area you wish to customize.
      2. Click on the paramedit option on the command bar.
        3. o o o -> o
      3. Enter password for the area (normally aaaa) if required.
      4. Select the Change Directory Controls checkbox
      5. Then select


      6. A list of parameters for the area will be displayed in alphabetical order.
      7. Select the link NodeBanner (if you are altering a node area) or ListBanner(if you are altering a list area) which will take you to the parameter definition.
    5. Any information defined for this parameter by the parent area will automatically be loaded into the parameter text area. Alternatively if this is not defined the default value will be displayed. You may replace or add to this information.
    6. For the above example a table with two columns is used. One column contains the Schlumberger logo, and one contains the parameter areatitle, the value of which is determined when the page is automatically generated.
      7. Add the html code:

      <table align=center><
      tr align=top><td><img src="http:/image/slb_logo.gif"></td>
      <td><font size ="+2">$areatitle e.g. Oilfield Services Finance</font></td>
      </tr>
      </table>

    7. After changing this parameter you must select
    8. When you have finished changing parameters, you can leave the editor by selecting the . This will take you to the area you have made changes for.
    9. To register the changes you have made you must update the directory by selecting the button on the command bar for that area.

  • How do I add my own Footer?

    • The parameters ListFooter (if you are in a listarea) and nodefooter (if you are in a node area) defined the information added to the bottom of an area. e.g.


     

    or

    		Any Questions, Comments or Problems, please email:
    Susy Grilli

    For the latter example because an email address is specified (actually enclosed within <address></address> tags) thus replacing the author's address entry automatically added at the bottom of the file.

    Steps to Follow

    1. Go to the area you wish to customize.
    2. Click on the paramedit option on the command bar.
      3. o o o -> o
    3. Enter password for the area (normally aaaa) if required.
    4. Select the Change Directory Controls checkbox
    5. Then select


    6. A list of parameters for the area will be displayed in alphabetical order.
    7. Select the link ListFooter (for a list area) or NodeFooter (for a node area) which will take you to the parameter definition.
    8. The standard footer information required for all files on the server is already provided:

      <address><a href="mailto:$emaildef?Subject=$enctitle">
      $emaildef</a></address>
      </body>
      </html>

      This standard information must come at the end. You may add your own information above this. For the latter example a table with two columns is used. The first column contains the image reference, and the second column contains the "mailto" link. The c ontents of the second column are enclosed in the address tags: <address> and </address>. Add the html code:
      <table align=center>
      <tr valign="middle">
      <td><br clear=all><img src="/image/slb_logo.gif"></td>(image URL)
      <td> Any Questions, Comments or Problems, please email: <address><a href="mailto:fetterley@houston.sns.slb.com">Susy Grilli</a>(address "mailto" link) </address></td>
      </tr>
      </table>
      After changing this parameter you must select

    9. When you have finished changing parameters, you can leave the editor by selecting the . This will take you to the area you have made changes for.
    10. To register the changes you have made you must update the directory by selecting the button on the command bar for that area.

  • My Index is Long and I Want the Command Bar at the Top and Bottom of the Page

    • The parameters ListDefinition (for a list area) and NodeDefinition (for a node area) define the order in which parameters appear in the area's display. To show the Command Bar (parameters ListCmdBar and NodeCmdBar) at the to p of the area aswell as the bottom requires two entries in theListDefinition or NodeDefinition parameter.

    Steps to Follow

    1. Go to the area you wish to customize.
    2. Click on the paramedit option on the command bar.
      3. o o o -> o
    3. Enter password for the area (normally aaaa) if required.
    4. Select the Change Directory Controls checkbox
    5. Then select


    6. A list of parameters for the area will be displayed in alphabetical order.
    7. Select the link ListDefinition (if you are altering a list area) or NodeDefinition (if you are editing a node area) which will take you to the parameter definition.
    8. The default values are:
      $ListHeader
      <param name="maintext">
      $ListBanner
      $FileList
      $ListTail
      <param name="/maintext">
      <param name="maintextoption" value=\"!textarea\">
      $ListSelfRef
      $ListCmdBar
      $ListFooter
      		$NodeHeader
      <param name="maintext">
      $NodeBanner
      $DirList
      $NodeTail
      <param name="/maintext">
      <param name="maintextoption" value=\"!textarea\">
      $NodeSelfRef
      $NodeCmdBar
      $NodeFooter
    9. For a Node area Add $NodeCmdBar to the definition above the line $DirList (this will display the node command bar above the directory index.)
    10. For a List area Add $ListCmdBar to the definition above the line $FileList (this will display the list command bar above the file index.)
    11. After changing this parameter you must select
    12. To see the changes go back to the area (the o key will take you there).

  • I Want a Banner/Toolbar Down the Side of the Page

    • The parameters ListBanner (for a list area) and NodeBanner (for a node area) are normally used to add information to an area above the main file contents (but below ListHeader or Node Header). It can also be used to position a toolbar dow n the side of the page.

    Likewise the parameters NodeTail, ListTail, and FileTail are normally reserved for adding additional text or images to a file below the file or directory list, or below the main contents of a file.

    For example, the command bar could be created as a table aligned to the left of the page. e.g.


                    Omnes
    SLB
    C&W
    Home
    News
    Search
    Contact
    Tacacs
    Calendar
    Directory
    People 
    PersSite

    Main File or Directory Index

    File or SubDirectory 1

    File or SubDirectory 2

    File or SubDirectory 3

    File or SubDirectory 4

    File or SubDirectory 5

    File or SubDirectory 6

    File or SubDirectory 7

    End of File or Directory Index

    Steps to Follow

    1. Go to the area you wish to customize.
    2. Click on the paramedit option on the command bar.
      3. o o o -> o
    3. Enter password for the area (normally aaaa) if required.
    4. Select the Change Directory Controls checkbox
    5. Then select


    6. A list of parameters for the area will be displayed in alphabetical order.
    7. Select the link ListBanner (if you are editing a list area) or NodeBanner (if you are editing a node area) which will take you to the parameter definition.
    8. Add the html code for your toolbar, logo etc. To ensure it appears down the side of the file contents make sure it is aligned to the right or left. e.g. for the above example add the html code:

      <table border=0 align=right bgcolor="#7fbfef" background="/image/omnesbg.gif">
      <tr><td align=right>
      <font size="+2" style="color:#0000ff"> <a style="color:#0F6FFF" href="http://www.slb.com">SLB</a><br>
      <a style="color:#0F6FFF" href="http://www.choral.org">C&W</a><br>
      <a style="color:#0F6FCF" href="/index.html">Home</a><br>
      <a style="color:#0F6FCF" href="/news/">News</a><br>
      <a style="color:#0F6FCF" href="/gen/general_search_page.html">Search</a><br>
      <a style="color:#0F6FCF" href="mailto:fetterley@houston.sns.slb.com? Subject=Omnes%20Home%20Page%20Contact">Contact</a><br>
      <a style="color:#0F6F9F" href="/serv/schl/taca/">Tacacs</a><br>
      <a style="color:#0F6F9F" href="/cgi-bin/webcal/WebCal2">Calendar</a><br>
      <a style="color:#0F6F9F" href="http://directory.slb.com/">Directory</a><br>
      <a style="color:#0F6F9F" href="/pers/peop/gall/">People </a><br>
      <a style="color:#0F6F9F" href="/pers/empl/web/">PersSite</a><br>
      <a style="color:#4F5FAF" href="/gen/shared_schlumberger_home_page.html">SLB Page</a><br>
      <a style="color:#4F4F8F" href="/bb">BBoards</a><br>
      <a style="color:#3F3F7F" href="/admi/util/help">Help Files</a><br>
      <a style="color:#2F3F7F" href="/web/proj/">Web Projects</a><br>
      </td></tr></table>

    9. After changing this parameter you must select
    10. When you have finished changing parameters, you can leave the editor by selecting the . This will take you to the area you have made changes for.
    11. To register the changes you have made you must update the directory by selecting the button on the command bar for that area.

  • How do I change the Way a File or Directory Index Appears on the Page?

    • The default autoindex displays a number of parameters defining file or area properties in an orderly tabular format. A different background color for each entry provides some variation. Several variations, using different background or font color, disp laying different parameters, and using different tabular positioning are available.

    The layout of a node, list or image area can be controlled in this way.

    1. Automatically Generated Index for a Node Area

      2. The parameter NodeElementBanner defines the listing for directories in a node area. The default value displays the title ($areatitle), subtitle ($areaSubtitle) and mailkey ($ListMailkey) for each area. The values for these a re obtained from the indexformat file of each area. A link between the displayed title and the area ($ListDir), and the mailkey and an email box to that area ($ListEmail) are also included. The elementbanner parameter defines one single tabl e for each directory listing.

      The following is an example of the default. A single table is generated for each directory listing with parameter values for that directory filled in.


      O <a href="$dirlink">$areatitle $areasubtitle $listmailkey
      O <a href="$listdir">$areatitle $areasubtitle $listmailkey
      (separate table)
      (separate table)

      Steps for Changing the Node Index

      1. Go to the node area you wish to customize.
      2. Click on the paramedit option on the command bar.
        3. o o o ->
      3. Enter password for the area (normally aaaa) if required.
      4. Select the Change Directory Controls checkbox
      5. Then select


      6. A list of parameters for the area will be displayed in alphabetical order.
      7. Select the link NodeElementBanner which will take you to the parameter definition.
      8. For the above example, remove the subtitle and mailkey so that you end up with the parameter value: <table border=1 cellspacing=0>
        <tr>
        <td bgcolor="#bfffff">
        <img src="/image/dkblu_marble.gif" alt="O" align="left" border=0></td>
        <td align=center width=250 bgcolor="#efffff">
        <a href="$dirlink">$areatitle</a></td>
        <td bgcolor="#bfffff">
        <img src="/image/dkblu_marble.gif" alt="O" align="left" border=0></td>
        </tr>
        </table>

      9. After changing this parameter you must select
      10. When you have finished changing parameters, you can leave the editor by selecting the . This will take you to the area you have made changes for.
      11. To register the changes you have made you must update the directory by selecting the button on the command bar for that area.

    2. Automatically Generated Index for a List Area

      3. The parameter ListElementBanner defines the listing for files in a list area. The default value displays the time the file was published (FileTime), the title for the file (FileTitle) with a link to the file (FileLink), and an email link to the author of the file ($author, $enctitle, $emaildef). Again the ElementBanner parameter defines one single table for each file entry.

      $filetime <a href="$filelink"> $filetitle $emaildef
      (separate table)
      $filetime <a href="$filelink"> $filetitle $emaildef
      (separate table)
      $filetime <a href="$filelink"> $filetitle $emaildef
      (separate table)

      The file listings can be arranged by group according to a common value (e.g.
      date, title, author) defined by the parameter GroupElement. For the groupings to be made, the parameter GroupTrigger must be set to on.

      O $date
      $filetime <a href="$filelink"> $filetitle $emaildef
      $filetime <a href="$filelink"> $filetitle $emaildef
      O $date
      $filetime <a href="$filelink"> $filetitle $emaildef

      The order of the files is defined by the parameter ListOrder. By default this is date, with the most recent at the top. Alternatives can be author or title in alphabetical order (with "a" at the top), or reverse (which reverses the order by date ).

      Steps for Changing the List Index

      1. Go to the list area you wish to customize.
      2. Click on the paramedit option on the command bar.
        3. o o o -> ->
      3. Enter password for the area (normally aaaa) if required.
      4. Select the Change Directory Controls checkbox
      5. Then select


      6. A list of parameters for the area will be displayed in alphabetical order.
      7. Select the link ListElementBanner which will take you to the parameter definition.
      8. To remove the $filetime (time of file publishing) and $emaildef (email link to author) comment out or remove these values from the table:
        <table border=0 cellspacing=0><tr>
        <td width="$threadwidth" bgcolor="#ffffff">
        <!-- <font size="-1">
        $filetime</font></td> -->
        <td width=400><a href="$filelink">
        $filetitle</a></td>
        <!-- <td width=250>
        <a href="mailto:$author?Subject=$enctitle">
        $emaildef</a></td> -->
        </tr></table>

      9. After changing a parameter you must select
      10. To group by an alternative parameter (e.g. title instead of date) find the parameter GroupBanner and set the value to $author.
      11. To remove the grouping find the parameter GroupTrigger and set the value to off.
      12. When you have finished changing parameters, you can leave the editor by selecting the . This will take you to the area you have made changes for.
      13. To register the changes you have made you must update the directory by selecting the button on the command bar for that area.

  • How Do I Change the Area Background?

    • The background color for a page is defined by the parameter BodyTags. By default this is a white background. This can be altered to show a background image, or a specific color.

    Steps to Follow

    1. Go to the area you wish to change the background for.
    2. Click on the paramedit option on the command bar.
      3. o o o -> o
    3. Enter password for the area (normally aaaa) if required.
    4. Select the Change Directory Controls checkbox
    5. Then select


    6. A list of parameters for the area will be displayed in alphabetical order.
    7. Select the link ListBodyTags (if you are editing a list area) or NodeBodyTags (if you are editing a node area) which will take you to the parameter definition.
    8. The default value will be loaded:
      <body bgcolor="#ffffff">
    9. To define another color enter your hexadecimal code: e.g.
      <body bgcolor="#fcc542"> will give an orange background.
    10. To define a background image enter a background image reference:
      <body background="/image/slb_logo.gif"> will give the Schlumberger logo repeated in the background.
    11. After changing this parameter you must select
    12. When you have finished changing parameters, you can leave the editor by selecting the . This will take you to the area you have made changes for.
    13. To register the changes you have made you must update the directory by selecting the button on the command bar for that area.


    Return to Contents

    Have a Standard Look for my Files

    Certain parameters in an area's control file (indexformat.html) can be set to define a standard layout for all files published in that area using the mail_to_web system.

    1. What is the Default Layout?
    2. What Can I Change?
    3. How do I Alter/Remove the Mail Header?
    4. How do I add my own Header?
    5. How do I add my own Footer?
    6. My Index is Long and I Want the Command Bar at the Top and Bottom of the Page
    7. I Want a Banner/Toolbar Down the Side of the Page
    8. How Do I Change the Area Background?

    1. What is the Default Layout

      2. The default layout displays the email Subject Heading as the main File Title. Below this is the main file contents published using the Mail to Web system, followed by the URL, the command bar, and finally the name and email link to the author. e.g.

      Web - testing mailkey and updates


      Date: Fri, 30 Oct 1998 13:43:46 -0600
      To: slbp_news_testing@www.choral.org
      From: Susy Grilli <fetterley@houston.sns.slb.com>
      Organization: Subject: Web - testing mailkey and updates

      This is the main body of the file.



      http://www.choral.org/web/proj/slbp/news/test/ox8au_web_testing_mailkey_and_updates.html
      o o o -> -> o o
      Susy Grilli

    2. What Can I Change?

      3. Customization of the layout can include:

    3. How Do I Alter/Remove the Mail Header?

      4. By default, the Mail to Web system will add a mail header to your file, displaying:

      By default, the Mail to Web system will add a mail header to your file, displaying:

      The mail headers can be altered by editing the parameter FileMailBanner in the area's control file (indexformat.html). The minimum requirements are that the header includes a "date" and "from" value, so that the age and origin of every file on t he system can easily be determined.

      1. Go to the area for which you wish change the Mail header.
      2. Select the Param Edit button from the command bar.

        3. o o o o o.

      3. You will be required to enter a password for the area (normally aaaa) unless you are using an authenticated server in which case your identify will have been verified with PH/LDAP, and you must make sure the box is checked for "Change Directory Contro ls". Then click on
        and you will be taken to the "Area Configuration Editor".
      4. A list of editable parameters is provided at the top of the editor page in alphabetical order. Select FileMailHeader and you will be taken to the parameter's location within the page. This defines which parameters are used to make up the file l ayout.
      5. The default value for this parameter will be loaded. Comment out the entries you do not require (if "date" and "from" are missing the system will overwrite them to satisfy the minimum header requirements explained above).

        Date: $maildate
        To: $mailto
        From: $emaildef
        Organization: $mailorganization
        Subject: $mailsubject
      6. Once you have changed this parameter select

      7. Use the button to go back to the area.
      8. To register the changes you have made you must update the directory by selecting the button on the command bar for that area.
      9. Only files posted in the area after this change will be affected. To view the changes you will have to publish a new file. Select the "Post New Message" button .
      10. Allow a few moments for the Webmail to arrive. The reload/refresh the page.Select the link to the newly published file when it appears in the index. The mail headers will not be displayed.

        11. Altering the Mail Header

        The actual mail header is defined by a series of parameters which you can choose to display. These are:

        Date: $maildate
        To: $mailto
        From: $emaildef
        Organization: $mailorganization
        Subject: $mailsubject

        1. Go to the area in which you wish to turn of the Mail header.
        2. Select the Param Edit button from the command bar.

          3. o o o o o.

        3. You will be required to enter a password for the area (normally aaaa) unless you are using an authenticated server in which case your identify will have been verified with PH/LDAP, and you must make sure the box is checked for "Change Directory Contro ls". Then click on
          and you will be taken to the "Area Configuration Editor".
        4. A list of editable parameters is provided at the top of the editor page in alphabetical order. Select FileMailBanner and you will be taken to the parameter's location within the page.
        5. The default value for this parameter will be loaded. Comment out the entries you do not require. e.g. remove "To" from the mail header:
          Date: $maildate
          <!-- To: $mailto -->
          From: <a href="mailto:$email?Subject=$enctitle">$emaildef</a>
          Organization: $mailorganization Subject: $mailsubject

        6. Once you have changed this parameter select

        7. Use the button to go back to the area.
        8. To register the changes you have made you must update the directory by selecting the button on the command bar for that area.
        9. Only files posted in the area after this change will be affected. To view the changes you will have to publish a new file. Select the "Post New Message" button .
        10. Allow a few moments for the Webmail to arrive. The reload/refresh the page.Select the link to the newly published file when it appears in the index. The mail headers will not be displayed.

      11. How Do I Add my Own Header?

        12. The parameter FileBanner defines the information added to the top of every file in the area. e.g.


        $filetitle e.g. News and Events
         


        Steps to Follow

        1. Go to the area containing the files you which to customize.
        2. Click on the paramedit option on the command bar.

          3. o o o -> o
        3. Enter password for the area (normally aaaa) if required.
        4. Select the Change Directory Controls checkbox


        5. A list of parameters for the area will be displayed in alphabetical order.
        6. Select the link FileBanner which will take you to the parameter definition.
        7. Any definition for filebanner from the parent area will automatically be loaded into the parameter text box. You may replace or add to this information.
        8. For the above example the File title is displayed with a size "+3" font. Below this is a table with width 100%, with one row and column, and an orange background color. The entry for the column is a single space.

          Add the html code: <font size="+3" color="000000"><i>$filetitle e.g. News and Events</i></font>
          <table width=100%>
          <tr>
          <td bgcolor="#fcc542" width=100>  </td>
          </tr>
          </table>
          After changing this parameter you must select
        9. Use the button to go back to the area.
        10. To register the changes you have made you must update the directory by selecting the button on the command bar for that area.
        11. Only files posted in the area after this change will be affected. To view the changes you will have to publish a new file. Select the "Post New Message" button .
        12. Allow a few moments for the Webmail to arrive. The reload/refresh your browser. The new file will appear in the area's index.
        13. Select the link to the file, and view the new header which has been added.

      12. How Do I Add my Own Footer?

        13. The parameter FileFooter defines the information added to the bottom of every file in the area. e.g.


           

        or

        		Any Questions, Comments or Problems, please email:
        Susy Grilli

        For the latter example because an email address is specified (actually enclosed within <address></address> tags) this replaces the author's address entry normally added at the bottom of the file.

        Steps to Follow

        1. Go to the area containing the files you which to customize.
        2. Click on the paramedit option on the command bar.
          3. o o o -> o
        3. Enter password for the area (normally aaaa) if required.
        4. Select the Change Directory Controls checkbox
        5. Then select


        6. A list of parameters for the area will be displayed in alphabetical order.
        7. Select the link FileFooter which will take you to the parameter definition.
        8. The standard footer information required for all files on the server is already provided:

          <address><a href="mailto:$emaildef?Subject=$enctitle">
          $emaildef</a></address>
          </body>
          </html>

          Above this (this standard information must come at the end) you may add your own information. For the latter example a table with two columns is used. The first column contains the image reference, and the second column contains the "mailto" link. The contents of the second column are enclosed in the address tags: <address> and </address>. Provided the email details are entered in an <address> field, this will replace that in the standard footer.

          Add the html code:
          <table align=center>
          <tr valign="middle">
          <td><br clear=all><img src="/image/slb_logo.gif"></td>
          <td> Any Questions, Comments or Problems, please email: <address><a href="mailto:fetterley@houston.sns.slb.com">Susy Grilli</a> </address></td>
          </tr>
          </table>
          After changing this parameter you must select
        9. To register the changes you have made you must update the directory by selecting the button on the command bar for that area.
        10. Only files posted in the area after this change will be affected. To view the changes you will have to publish a new file. Select the "Post New Message" button .
        11. Allow a few moments for the Webmail to arrive. The reload/refresh your browser. The new file will appear in the area's index.
        12. Select the link to the file, and view the new file footer which has been added.

      13. My Files are Long and I Want the Command Bar at the Top and Bottom of the Page

        14. The parameter FileDefinition defines the order in which parameters appear in the file display. To show the File Command Bar (parameter FileCmdBar) at the top of the file aswell as the bottom requires two entries in the FileDefinition parameter.

        Steps to Follow

        1. Go to the area containing the files you which to customize.
        2. Click on the paramedit option on the command bar.
          3. o o o -> o
        3. Enter password for the area (normally aaaa) if required.
        4. Select the Change Directory Controls checkbox
        5. Then select


        6. A list of parameters for the area will be displayed in alphabetical order.
        7. Select the link FileDefinition which will take you to the parameter definition. This defines which parameters are used to make up the file layout.
        8. The default value is: $FileHeader
          <param name="maintext">
          $FileBanner
          $FileMailBanner
          $FileBody
          $FileTail
          <param name="/maintext">
          <param name="maintextoption" value=\"!textarea\">
          $FileSelfRef
          $FileCmdBar
          $FileFooter
        9. Add $FileCmdBar to the definition above the line $FileBody (this will display the file command bar above the main contents of the file).
        10. After changing this parameter you must select
        11. To register the changes you have made you must update the directory by selecting the button on the command bar for that area.
        12. Only files posted in the area after this change will be affected. To view the changes you will have to publish a new file. Select the "Post New Message" button .
        13. Allow a few moments for the Webmail to arrive. The reload/refresh your browser. The new file will appear in the area's index.
        14. Select the link to the file, and view the additional file command bar which has been added above the main file contents.

      14. I Want a Banner/Toolbar Down the Side of the Page

        15. FileBanner is normally used to add information to an area above the main file contents (but below FileHeader). It can also be used to position a toolbar down the side of the page. For example, the command bar could be created as a table aligned to the left of the page. e.g.


                        Omnes
        SLB
        C&W
        Home
        News
        Search
        Contact
        Tacacs
        Calendar
        Directory
        People 
        PersSite

        Main file contents

        ----------------------

        ----------------------

        ----------------------

        ----------------------

        ----------------------

        ----------------------

        ----------------------

        End of Main File Contents



        Steps to Follow

        1. Go to the area containing the files you which to customize.
        2. Click on the paramedit option on the command bar.
          3. o o o -> o
        3. Enter password for the area (normally aaaa) if required.
        4. Select the Change Directory Controls checkbox
        5. Then select


        6. A list of parameters for the area will be displayed in alphabetical order.
        7. Select the link FileBanner which will take you to the parameter definition.
        8. Add the html code for your toolbar, logo etc. To ensure it appears down the side of the file contents make sure it is aligned to the right or left. e.g. for the above example add the html code:

          <table border=0 align=right bgcolor="#7fbfef" background="/image/omnesbg.gif">
          <tr><td align=right>
          <font size="+2" style="color:#0000ff"> <a style="color:#0F6FFF" href="http://www.slb.com">SLB</a><br>
          <a style="color:#0F6FFF" href="http://www.choral.org">C&W</a><br>
          <a style="color:#0F6FCF" href="/index.html">Home</a><br>
          <a style="color:#0F6FCF" href="/news/">News</a><br>
          <a style="color:#0F6FCF" href="/gen/general_search_page.html">Search</a><br>
          <a style="color:#0F6FCF" href="mailto:fetterley@houston.sns.slb.com? Subject=Omnes%20Home%20Page%20Contact">Contact</a><br>
          <a style="color:#0F6F9F" href="/serv/schl/taca/">Tacacs</a><br>
          <a style="color:#0F6F9F" href="/cgi-bin/webcal/WebCal2">Calendar</a><br>
          <a style="color:#0F6F9F" href="http://directory.slb.com/">Directory</a><br>
          <a style="color:#0F6F9F" href="/pers/peop/gall/">People </a><br>
          <a style="color:#0F6F9F" href="/pers/empl/web/">PersSite</a><br>
          <a style="color:#4F5FAF" href="/gen/shared_schlumberger_home_page.html">SLB Page</a><br>
          <a style="color:#4F4F8F" href="/bb">BBoards</a><br>
          <a style="color:#3F3F7F" href="/admi/util/help">Help Files</a><br>
          <a style="color:#2F3F7F" href="/web/proj/">Web Projects</a><br>
          </td></tr></table>

        9. After changing this parameter you must select
        10. To register the changes you have made you must update the directory by selecting the button on the command bar for that area.
        11. Only files posted in the area after this change will be affected. To view the changes you will have to publish a new file. Select the "Post New Message" button .
        12. Allow a few moments for the Webmail to arrive. The reload/refresh your browser. The new file will appear in the area's index.
        13. Select the link to the file, and view the additional toolbar which has been added above the main file contents.

      15. How Do I Change the File Background?

        16. The background color for a file is defined by the parameter FileBodyTags.By default this is a white background. This can be altered to show a background image, or a specific color.

        Steps to Follow

        1. Go to the area you wish to change the background for.
        2. Click on the paramedit option on the command bar.
          3. o o o -> o
        3. Enter password for the area (normally aaaa) if required.
        4. Select the Change Directory Controls checkbox
        5. Then select


        6. A list of parameters for the area will be displayed in alphabetical order.
        7. Select the link FileBodyTags will take you to the parameter definition.
        8. The default value will be loaded:
          <body bgcolor="#ffffff">
        9. To define another color enter your hexadecimal code: e.g.
          <body bgcolor="#fcc542"> will give an orange background.
        10. To define a background image enter a background image reference:
          <body background="/image/slb_logo.gif"> will give the Schlumberger logo repeated in the background.
        11. After changing this parameter you must select
        12. To register the changes you have made you must update the directory by selecting the button on the command bar for that area.
        13. Only files posted in the area after this change will be affected. To view the changes you will have to publish a new file. Select the "Post New Message" button .
        14. Allow a few moments for the Webmail to arrive. The reload/refresh your browser. The new file will appear in the area's index.
        15. Select the link to the file, and view the new file header which has been added.


    Return to Contents

    Edit My Files When they Have Been Published

    Any file can be edited using the Param Edit option provided the data is enclosed within maintext parameter (or other parameters defined in the indexformat file for that area) before publishing. Any file published using the mail_to_web< /b> system automatically satisfies this condition. When publishing using Netscape, this parameter must be defined manually. For more information on format before publishing using Netscape see the section on publishing files using Netsc ape.

    To edit a file:

    1. Go to the area in which the file has been published.
    2. Click on the Param Edit option on the command bar.
      3. o o o -> o
    3. Select the file to be edited.
    4. Enter password for the area (normally aaaa) if required.
    5. Select the edit file checkbox
    6. Then select
    7. Make changes to the parameters you wish to alter.
    8. For each parameter which you change you must select
    9. To see the changes go back to the area (the o key will take you there). Click on the link to the file you have just edited and reload/refresh the page in your browser.


    Return to Contents

    Archive or Delete My Files and Directories When they Have Been Published

    Delete a File

    Any file can be 'deleted' using the Param Edit option. The actual procedure moves the file to the directory "back.d" which is not included in the auto-generated index. This provides an option to restore the file at a later time if required.

    1. Go to the area containing the file you wish to delete.
    2. Click on the paramedit option on the command bar o o o -> o
    3. Select the file to be deleted.
    4. Enter password for the area (normally aaaa) if required.
    5. Select the delete file checkbox
    6. Then select
    7. Your file will be moved to the directory back.d
    8. To see the changes select the hyperlink to your area - the automatic index will have been updated and your filename removed from the list.
    9. Note that all links to this file referenced by other files will now be broken.

    Delete a Directory

    Any directory can be 'deleted' using the Param Edit option. The actual procedure renames the directory to directory.d which is not included in the auto- generated index. This provides an option to restore the directory at a later time if required. If the directory contains files these files can now be found under directory.d (their filenames are unaltered).

    1. Go to the area above (parent area) the area you wish to delete.
    2. Click on the Param Edit option on the command bar o o o -> o
    3. At "Select File", select the area (directory name) to be deleted.
    4. Enter password for the area (normally aaaa) if required.
    5. Select the delete file checkbox
    6. Then select
    7. Your directory will be moved to directory.d
    8. To see the changes select the hyperlink to your area - the automatic index will have been updated and your directory name removed from the list.
    9. Note that all links to this directory, and the files it contains, referenced by other files will now be broken.

      10. Note that although this directory is still stored on the server (for backup purposes) its contents are not searchable using the normal web search engine installed on this server.

    Archive File

    Any file can be 'archived' using the param edit option. The actual procedure moves the file to the directory "arch.d" which is not included in the auto- generated index. This allows files to be kept on the server for future reference.

    1. Go to the area containing the file you wish to archive.
    2. Click on the paramedit option on the command bar o o o -> o
    3. Select the file to be archived.
    4. Enter password for the area (normally aaaa) if required.
    5. Select the archive file checkbox
    6. Then select
    7. Your file will be moved to the directory arch.d
    8. To see the changes select the hyperlink to your area - the automatic index will have been updated and your filename removed from the list.
    9. Note that all links to this file referenced by other files will now be broken.

    Note that any file in the archive area is not searched using the normal web search engine installed on this server. If implemented, there may be a special search engine possible that only searches the archives to assist in maintenance of these archive s.

    Archive Directory

    Any directory can be 'archived' using the param edit option. The actual procedure moves the directory to arch.d which is not included in the auto- generated index. This provides an option to restore the directory at a later time if requir ed.

    1. Go to the area above (parent area) the area you wish to archive.
    2. Click on the paramedit option on the command bar o o o ->
    3. At "Select File", select the area (directory name) to be archived.
    4. Enter password for the area (normally aaaa) if required.
    5. Select the archive file checkbox
    6. Then select
    7. Your directory will be moved into the directory arch.d
    8. To see the changes select the hyperlink to your area - the automatic index will have been updated and your directory name removed from the list.
    9. Note that all links to this directory, and the files it contains, referenced by other files will now be broken.

      10. Note that although this directory is still stored on the server (for backup purposes) its contents are not searchable using the normal web search engine installed on this server. If implemented, there may be a special search engine possible that only searches the archives to assist in maintenance of these archives.

    Set Up Areas to Inherit Parent Characteristics

    1. What is Inheritance?
    2. Matching Area Types
    3. Rules for Inheritance
    4. Prevented Parameters from Being Inherited

    1. What is Inheritance?

      2. Parameter values can be defined in a parent directory, and inherited by all subdirectories. This allows subdirectories (and also files) to inherit certain characteristics such as access permissions, headers and footers, toolbars and defined layouts for the indexing, thereby providing a standard look and feel without having to redefine these characteristics for each area.

    2. Matching Area Types

      3. The parameters used to define the layout of an area are associated with specific area types. Those used to define a node area are prefix by "node". e.g. NodeElementBanner. Similarly ListElementBanner and ImageElementBanner refer to list and image areas respectively. Also parameters prefixed with "file" define the layout for files in an area. Using this scheme allows different area definitions for each area type.

      Note that because private areas are not supported by the system, they will not inherit the parent directories' characteristics.

      To ensure parameters are inherited you must ensure the parameters are defined for the subdirectory area types. For example the parent directory is of type node, and all parameters with the prefix node will define its properties. If the subdirectory is also a node, these parameters can be inheritied. However if the subdirectory is a list area the parameters with "list" prefix must be defined in the parent area in order for them to be inherited. Otherwise the default values will be used.

    3. Rules for Inheritance