Configuring web publishing


etscape Enterprise Server 3.x clients can use Netscape Web Publisher to collaborate on projects by directly accessing, editing, and managing file on remote servers. Web Publisher provides sophisticated features for server clients, such as file management, editing and publishing, document version control, search, agent services, access control, and link management.

As the server administrator, you can set many options that define how web publishing works for your server clients and how your server's web publishing data is maintained:

When you have configured web publishing for your server, you and your users can access the Web Publisher home page, by typing in this URL: This displays the home page, which provides a link for downloading the web publishing plug-in appropriate for your browser and a Start Web Publisher button, which launches the Web Publisher applet. The page also includes a set of links to a QuickStart tutorial and to the entire Web Publisher online help system, Netshare & Web Publisher User's Guide.

The online help system is also available through user components such as agent services, search, and Web Publisher. To access the help system, you can use the Help menu command in Web Publisher, or you can click the Help button on one of the search interface forms, on the Agent Services page, or on the Web Publisher Services page.


 
Using Netshare

Netscape Netshare provides a Netscape Enterprise Server user with a personal home page from which they can store, share, and manage their server documents. Netshare is a convenient starting point for using the Netscape Enterprise Server user services: Web Publisher, agents, and search. From their home page, users can also obtain information about how they are defined in the server's user directory, such as their name, password, and telephone extension.

To access a user's default Netshare home page, the user types in this URL:

After authentication, the user's default Netshare home page is displayed with a set of links to many server functions: When you create a Netshare home directory for a user, the user is assigned as the owner of the directory and all its files. By default, only the owner can write to the directory although other users can read the files. Others cannot make any changes to the files unless the owner explicitly provides such access permissions.

 
Setting up the server and creating Netshare home directories

As the server administrator, you need to configure Netshare for your server and for your server's users before they can use Netshare. Once you have set up Netshare, you need to create a Netshare home directory for any user or group who wants to use Netshare.  Netshare provides two types of interface for server administrators: Server Manager forms (Set Up Netshare and Create Netshare) and a netshare command-line utility.

This section on using Netshare covers these topics:

 
Before you start

Before you set up Netshare for your users, you need to be sure that the Web Publishing functions are turned on for your server, that you understand how Netshare's default naming conventions operate, what the configuration file contains, and what it means to mark as user as licensed.
 

 Server features that must be enabled

In order to use the functions of Netshare fully, including Web Publisher, link management, agents, and search, each of these functions must be turned on for your server. By default, they are disabled.

To turn on the Web Publisher, follow these steps:

  1. From the Server Manager, choose Web Publishing.
  2. Click Web Publishing State.
  3. Click the On radio button.
  4. Click OK.
To turn on  link management, follow these steps:
  1. From the Server Manager, choose Web Publishing.
  2. Click Link Management.
  3. Click the Link Management On radio button.
  4. Click OK.
To turn on agents, follow these steps:
  1. From the Server Manager, choose Web Publishing.
  2. Click Web Publishing State. (This must be on.)
  3. From the Server Manager, choose Agents & Search.
  4. Click Agent Management. (Agents must be enabled.)
To turn on the search function, follow these steps:
  1. From the Server Manager, choose Agents & Search.
  2. Click Search State.
  3. Click the On radio button.
  4. Click OK.

 

 Netshare directory naming conventions

To facilitate handling large quantities of individual home directories for every Netshare user, a naming convention has been defined. Its format is <doc-root>/<netshare directory>/<home directory>. The default is to use the primary document directory for your server (<server>/docs), to use /netshare as the Netshare directory, and to use the user's User ID as the home directory's name. Thus, on a default Windows NT installation for the user JDoe, the Netshare user's home directory would created be at C:\Netscape\SuiteSpot\docs\netshare\JDoe.

As server administrator, you can select one of the additional document directories defined for your server as the document root, and you can define different directories for the Netshare and home directories. If you change these values on the Server Manager Set Up Netshare form, the configuration file is changed to reflect your changes, and all home directories added subsequently use the new directory values. If, however, you use the netshare utility to indicate different directories, the configuration file is not changed, so only the user directories currently being added are affected.

One situation in which you might want to change the default directory path is when you want to create a home directory for a user that does not map to their user ID. For example, the user JDoe wants an additional Netshare directory called Project1. In this case, the user ID would be JDoe and JDoe would be assigned as owner of the Project1 directory.

 

The Netshare configuration file

Netshare uses a configuration file, netshare.conf, that contains the following data: You can only modify this file from the Set Up Netshare form or manually through a text editor. When you use the netshare utility, the configuration file is not affected.

When you use the Set Up Netshare form to change a default directory or template file, you are updating the values in the configuration file. From then on, any home directory that you create uses the new values.

 

Marking users as licensed

In order to create a Netshare home directory for a user, the user must be marked as having been granted a Client Access License for a Netscape Enterprise Server. There are several ways to do this:

 
Access control for Netshare

When you create a Netshare home directory for a user ID, the server assigns the user as its owner and the user is the only one who can write to the directory. Other users can read the user's files, but cannot make any changes to them unless the user explicitly provides such access permissions.

The default access permission is to allow anyone defined as a valid server user to read any Netshare directory, but only the designated owner of the Netshare home directory can modify the files.

This is the default ACL that is applied to the Netshare parent directory:

        allow (all) user = 'owner';
When you create a Netshare home directory for a group, the server assigns ownership of the files and folders in that directory to the owner's user ID. This also gives all users in the group read-write access permission for all files and folders in the home directory. Because this requires creating a new ACL rule for this particular group, this forces the server to restart to pick up the new ACL information.
 

 

Using the Server Manager forms

You can use the Set Up Netshare and Create Netshare forms that are available through the Server Manager. These provide a more accesible interface for updating the Netshare configuration file and creating Netshare home directories.

 

The Set Up Netshare form

The Netscape Enterprise Server user interface available through the Server Manager provides the Set Up Netshare form that you can use to modify the Netshare configuration settings. You can change some of the Netshare configuration information for your server and the configuration file is updated with your changes. When you have set up Netshare for your server, you can create Netshare home directories for your users.

To change the values in the configuration file, follow these steps:

  1. From the Server Manager, choose Web Publishing.
  2. Click Set Up Netshare.
  3. Enter the new directory or template file values:
  4. Click Save to save your changes or Reset to return to the default values.

 

The Create Netshare form

There are three choices for creating Netshare home directories from the Server Manager: for an individual user, for a specified group, or for all users who have been marked as licensed. The last choice is particularly useful for server adminstrators who wish to add Netshare home directories for all existing users.

Note: You must have already set up Netshare for your server before you can create Netshare home directories and Web Publishing must be enabled before your users can use Netshare.

To create a Netshare home directory for a single user, follow these steps:

  1. From the Server Manager, choose Web Publishing.
  2. Click Create Netshare.
  3. Click the "A single user" radio button.
  4. Enter the user's user ID.
  5. Ignore the Owner field.
  6. [Optional] Enter another Netshare home directory if you do not want to accept the default of using the user ID.
  7. Click the Create button.
  8. This marks the user as licensed if not yet marked as such, creates the user's Netshare home directory, and assigns ownership of the files and folders in that directory to the user ID that was entered. If you attempt to create a home directory that already exists, you receive an error message.

To create a Netshare home directory for a group, follow these steps:
  1. From the Server Manager, choose Web Publishing.
  2. Click Create Netshare.
  3. Click the "A group" radio button.
  4. Enter the name of the group.
  5. Enter the name of the group's owner. This must be a valid member of the group.
  6. [Optional] Enter another Netshare home directory if you do not want to accept the default of using the group name.
  7. Click the Create button. This restarts the server because you have added a new ACL, granting special access to the members of the group. When you add a single user's Netshare, the default ACL is sufficient.
  8. This marks the group's owner as a licensed user if not yet marked as such, creates the group's Netshare home directory, and assigns ownership of the files and folders in that directory to the owner's user ID. This also gives all users in the group read-write access permission for all files and folders in the home directory. If you attempt to create a home directory that already exists, you receive an error message.

To create Netshare home directories for all users at once, follow these steps:
  1. From the Server Manager, choose Web Publishing.
  2. Click Create Netshare.
  3. Click the "All users marked as licensed" radio button.
  4. Click the Create button.
  5. This searches through the local or LDAP user directory for your server and creates a Netshare home  directory for each user who has been marked as licensed but who does not yet have a Netshare directory. If you attempt to create a home directory that already exists, you receive an error message.

    Note: You can use the netshare utility (the -l option) to perform a batch update, marking all users as licensed, before using this form.

 

The netshare command-line utility

Server administrators can use the netshare command-line utility to define the Netshare configuration settings, create Netshare home directories for an individual user or for a batch of users, and display the online help.

Several values are defined in the configuration file. See the section on syntax for details.  To accept the default values from the configuration file, skip these command-line options. (Some examples of how you can use netshare are provided for your convenience.) When you enter a different value for an option, it only applies to the home directory or directories being created at that time. If you want to modify the configuration file, you must use the Server Manager form or use your local text editor to edit the configuration file manually.

You can use the netshare command-line utility to:

When you use the netshare utility to create a Netshare home directory for an individual user, the server marks the user as licensed if not yet marked as such, creates the user's Netshare home directory, and assigns ownership of the files and folders in that directory to the user ID that was entered.

When you use the netshare utility to create a Netshare home directory for a group, the server marks the group's owner as a licensed user if not yet marked as such, creates the group's Netshare home directory, and assigns ownership of the files and folders in that directory to the owner's user ID. This also gives all users in the group read-write access permission for all files and folders in the home directory.

When you use the netshare utility to create Netshare home directories for all users at once, the server  searches through the local or LDAP user directory for your server and creates a Netshare home directory for each user who has been marked as licensed but who does not yet have a Netshare directory.
 

 

Syntax of the netshare utility

 

Examples of using the netshare utility


 

Setting access control for Web Publisher owners

The access control system supports a special user called owner. When an ACL rule designates the user to be the owner, the permissions defined by this rule apply to the owner assigned by Web Publisher for each document. For example:

allow (write, delete) user = owner;
Note
Do not create a user with the username of owner.
Ownership of web publishing documents can be assigned either through the Web Publishing|Index and Update Properties form or through Web Publisher. The Index and Update Properties form allows you to do a bulk assignment of ownership to a set of documents and Web Publisher performs individual assignments of file ownership to a user when the user publishes or uploads the file.

Only the owner can modify the access control (ACL) rules for a file. These rules define the actions users can perform on the file, such as moving, copying, renaming, or deleting it. An owner can reassign ownership of a file to another user, and if a file has no owner, anyone with a valid username can identify themselves as its owner. Because the username identified as the owner of a file can change, any access control that you place on a file should target the owner of a file rather than a specific username.

If the default access control (ACL) that governs your server is not restrictive or flexible enough for your web publishing needs, you can use the Server Preferences|Restrict Access function to create an ACL that is more appropriate for web publishing.

For example, you could create an ACL like this:

acl "uri=/publisher/";
allow (read, execute, list, info) user = anyone;
allow (write, delete) user = owner;
This ACL sets a restriction such that only the owner of a file within the additional document directory of /publisher can modify or delete the file.

See Chapter 6, "Controlling access to your server" for more information about setting access control.

 

Indexing and updating properties

Before users can perform a search across a set of documents and directories, information about the documents and directories needs to be indexed into the web publishing database. The web publishing database is stored as a search collection and is created as part of the server installation process. Initially it contains no data and must be populated by indexing the documents in the document directories.

The Web Publisher window lists the files and folders that are in the document directory selected when a user starts up Web Publisher, but the data initially is not indexed (and therefore is not available for searching) and the files have no owners (so anyone can define their username as the owner of a file, and thereby be able to set the access control for a file).

You can use the Index and Update Properties form to perform bulk indexing of documents to create searchable web publishing data and you can also use it to do a bulk assignment of owner for the files included in the collection. You can restrict or expand the scope of documents and directories to be indexed, and you can index just the file properties, called metadata, or you can also index the documents' contents. If you choose to index the contents of the files, you can search on any word in the documents although publishing and uploading files with Web Publisher may be slightly slower.
 

    Note
    Using this function clears the link status database of all current link checking information. You must recheck your links after indexing files.

  1. From the Server Manager, choose Web Publishing.

  2. Click the Index and Update Properties link.

  3. The Document Directory field displays the currently selected directory.
  4. You can index documents in the primary document directory, an additional document directory, or in a subdirectory. If you want to index a different directory, click the View button to see a list of directories. You can index any directory that is listed or you can view the subdirectories in a listed directory, and index one of those instead. Once you click the index link for a directory, you return to the Index and Update Properties form and the directory name appears in the Document Directory field.

    Note
    You can index the contents of your users' files and folders that are in their default user home directories as defined by the Content Management | User Document Directories function.For example, if user document directories are active on your server and the default ~USERNAME/public_html has been defined for your server, that entry is displayed as one of the permitted document directories you can index. This indexes all user document directories that exist currently on your server according to the criteria you select in the Index and Update Properties form.

    Note
    You cannot use this function to index files that are larger than 3MB in size. You can, however, do an automatic indexing of such large files through the Property Sheet in Web Publisher (through the Web Publisher View|Properties menu command) by checking the "Make contents searchable" checkbox.
     

  5. To also index the subdirectories within the specified directory, click the Include Subdirectories checkbox.

  6. You can index all files in the chosen directory by leaving the default *.* pattern in the "Include files matching pattern" field or you can define your own wildcard expression to restrict indexing to documents that match that pattern.
  7. For example, you could enter *.html to only index the content in documents with the .html extension, or you could use this pattern (complete with parentheses) to index all HTML documents:
    (*.htm|*.html)
    You can define multiple wildcards in an expression. See Chapter 3, "Managing your server" for details of the syntax for wildcard patterns. 

  8. If this is the first time you index web publishing documents, check the "Index unindexed documents" checkbox.
  9. In subsequent indexing operations, you can uncheck it or you can leave it checked to index any new documents that have been added to the document directory.

  10. You can make a change to files that have already been indexed.
  11. For example, you can use the "Update previously indexed documents" option to do a bulk ownership assignment or to index the content of files that did not have this option set when they were first indexed. These options are useful when you change many files at once. You can use the Web Publisher client to index and update individual files.

  12. You can do a bulk assignment of ownership to all files that match your criteria.
  13. To do this, check the "Set document owner to" checkbox and type in a username. Be sure to type in a valid username because the server does not perform any validity checks on the name. This updates the owner property in each file's collection entry.

  14. To index the document content, check the "Index document contents" checkbox. You can choose to index the documents' contents as well as their file metadata.

  15. Click OK to begin indexing and updating web publishing.
A summary of the indexing operation is displayed in the web browser window. The information is also logged to the yourServer/plugins/content_mgr/logs/wpsimport.log log file. New data  is appended to the log, so you may want to monitor its size as you proceed through many indexing operations.

Note
Once you have indexed documents into the web publishing collection, don't change any document directory's URL mapping or the collection's entries will target the URL mapping to the wrong physical file location. If you have to change a document directory, you need to reindex the documents in the new location. You can use the Repair function to remove the indexed data from the old directory mapping.
 

Changing the web publishing state

You can activate web publishing and you can turn it off. If you turn off web publishing, you also turn off link management. Documents that are subsequently moved or renamed may have incorrect links, and the link status database may not be up to date. The solution is to use the Web Publishing|Link Management function to manually turn link management off and then turn it back on again. This starts the link management function up again with an empty link status database. See "Changing the link management state" for more details of link management.

Note
If you turn web publishing off, all agents for the server are also turned off and clients cannot use Netscape Web Publisher to access agent services. When web publishing is turned back on, agents that were turned off solely because web publishing was turned off are turned back on. Agents that were disabled for other reasons are still disabled.
 

Warning

If your server is outside the firewall, Netscape recommends that you turn off directory indexing (from the Server Manager, choose Content Management|Document Preferences and click the Directory Indexing None radio button) as well as web publishing.  This ensures that your directory structure, filenames, and web publishing features are not accessible.

To change the web publishing state:
  1. Select your server on the Server Administration page.

  2. From the Server Manager, choose Web Publishing.

  3. Click the Web Publishing State link.

  4. To turn web publishing on, click the On radio button. To turn it off, click the Off radio button. The default value is On.

  5. Click OK to change the state of web publishing on your server.
 

Setting the web publishing language

You can change the web publishing language to any language supported by the user's installation, and these are listed for the server administrator in a drop-down list on the form.

Note
Be cautious when using this function. If you change the language of a collection, the system deletes all the existing data in the collection.
  1. From the Server Manager, choose Web Publishing.

  2. Click the Web Publishing Language link.

  3. Select a language from the drop-down list. The default is English.

  4. Click OK to set the language.
Your changes are reflected in the language.conf file, which is located in the server_root/plugins/search/admin directory.

After you change the web publishing language, your server is automatically restarted to apply the change.

 

Maintaining web publishing data

Web Publisher maintains multiple sets of data about the documents that are in the web publishing collection. When all web publishing data is synchronized, each file in the chosen document directory has a record in the web publishing collection and every property record in the collection has a corresponding file in the document directory.

Although you can limit the scope of the Repair and Report functions to checking only the files in a particular document directory for collection records, every property record in the collection is checked for a corresponding source document regardless of which directory the file might be in.

Occasionally, these can become out of synch. You can obtain a report on the state of your web publishing files, and then repair one or more directories as needed. For example, if a document that was indexed into a collection is deleted, there is a record in the collection that no longer has any corresponding source document. Repairing removes the collection records for any such document.

You can perform these functions to maintain your web publishing data:

Periodically, you may want to maintain your web publishing collections. You can perform the following collection management tasks:
  1. From the Server Manager, choose Web Publishing.

  2. Click the Maintain Web Publishing Data link.

  3. You can define the scope of the Repair and Report functions by choosing the document directory to check through. If you want to use a different directory, click the View button to see a list of directories. You can report on or repair any directory or subdirectory that is listed.

  4. Once you click the link for a directory, you return to the Maintain Web Publishing Data form and the directory name appears in the Document Directory field. 
  5. To also report on or repair the subdirectories within the specified directory, click the Include Subdirectories checkbox.

  6. To report on the collection, click the Report button. This reports on the selected document directory.

  7. To repair the collection, click the Repair button. This repairs inconsistencies in the selected document directory.

  8. To optimize the collection, click the Optimize button. This optimizes the entire web publishing collection.
 

Changing the link management state

At times, you may not need automatic link checking and updating. At these times, you can turn link management off to conserve resources and to improve searching and indexing performance. When you turn link management off, Web Publisher stops doing automatic link checking and you cannot use the Check Links function from the Web Publisher Services page.

You can also use this form to selectively turn the automatic link update feature on and off. When automatic link updating is on, Web Publisher changes the outgoing and incoming links in a file to keep them up to date as files are moved and renamed in Web Publisher. Because this revises the modification date for any file that has updated links, this feature is off by default.

Note
The automatic link update feature only affects links outgoing to or incoming from moved or renamed files. It does not affect HTML files that are being uploaded or published. Provided that link management is on, the links in these files are always updated as part of the upload or publish operation.
For further information about link management in Web Publisher, access the online Netshare & Web Publisher User's Guide through the Help menu command in Web Publisher or the Help button on the search interface, the Agent Services page, or the Web Publisher Services page.
     
  1. Stop your server. Use the Server Preferences On/Off form or simply click the green light ON indicator for your server instance at the Server Administration page.

  2. From the Server Manager, choose Web Publishing.

  3. Click the Link Management link.

  4. To change the state of link management, select the On or Off radio button.
  5. To deactivate link management, select the Off radio button. This clears the link status information so that when you try to check links in Web Publisher, you get an error message, and you cannot access any link status information.
    To reactivate link management, select the On radio button. This starts link management up again, which creates a new empty link status database. To get link status information, you must again check links for all your files. Links that have changed status since you turned link management off may have to be manually fixed. 

  6. To turn automatic link updating on, select the On radio button. You can only turn this on when link management is on.
  7. This starts up automatic link updating, which revises links from or to files that are subsequently moved or renamed. It does not, however, affect the links in any files that were moved or renamed while automatic link updating was turned off. 

  8. Click OK to apply your change.
  9. Restart your server.
 

Setting the version control archive

Netscape Web Publisher includes a version control system for keeping track of files and documents as they are updated and changed. Web Publisher manages version control for you, allowing you to compare different versions of a file, providing version history for any file under version control, and automatically incrementing version numbers for files edited under version control.

For further information about version control in Web Publisher, access the online Netshare & Web Publisher User's Guide through the Help menu command in Web Publisher or the Help button on the search interface, the Agent Services page, or the Web Publisher Services page.

Files under version control are stored in an archive directory. The path in the default installation is server_root/plugins/content_mgr/archive. Web Publisher uses this archive to store all files under version control.

To specify a different directory for Web Publisher to use as the version control archive directory, follow these steps:
     
  1. Stop the server. Use the Server Preferences On/Off form or simply click the green light ON indicator for your server instance at the Server Administration page.
  2. Move your current version control directory to the desired new location.

  3. From the Server Manager, choose Web Publishing.

  4. Click the Version Control link.

  5. Type the full path for the archive directory in the Archive Path field.

  6. Click OK to set the archive directory.
  7. Restart the server.
 

Unlocking files

If a file that has been locked in Web Publisher is required for another user, you can unlock it. This is true for files that were locked manually by the client or automatically by Web Publisher as part of an edit or download operation.

For further information about locking and unlocking files in Web Publisher, access the online Netshare & Web Publisher User's Guide through the Help menu command in Web Publisher or the Help button on the search interface, the Agent Services page, or the Web Publisher Services page.

Be cautious in using this function because by unlocking a file that was locked, you are forcing the file to be available for editing by other users. This is contrary to the intent of the lock owner, who may not know of the unlocking operation.
To unlock a file:
  1. From the Server Manager, choose Web Publishing.

  2. Click the Unlock File link.

  3. The Choose field displays the currently selected file or directory.

  4. If you want to unlock a different file or a file from another directory, click the View button to see a list of resources. You can unlock files that are listed or you can view the files in a listed directory, and select one of those files. Once you click the unlock link for a file, you return to the Unlock File form and the filename appears in the Choose field. 
  5. Click OK to unlock the file.
After you unlock a file, your server is automatically restarted to incorporate the lock change.

Note
You cannot use this form to unlock a file that begins with a period (as in .cshrc), a plus (+), an equals sign (=), an ampersand (&), or any hexadecimal character. You have to log into Web Publisher as the user and unlock the file there.
 

Adding custom properties

As server administrator, you can add your own custom Web Publisher file properties. These properties are added to the default set of file properties stored in the web publishing collection. Server clients can view visible custom properties in Web Publisher and use them in their document searches.

For further information about viewing and modifying properties in Web Publisher, access the online Netshare & Web Publisher User's Guide through the Help menu command in Web Publisher or the Help button on the search interface, the Agent Services page, or the Web Publisher Services page.

There is a limit to the number of each type of property you can have. These are the default settings:

You can change the maximum settings for these in the webpub.conf file, although larger sets of attributes impact the performance of your server. See "Configuring manually" in Chapter 11, "Using search" for details on how to change the webpub.conf file. To add a custom file property:
  1. From the Server Manager, choose Web Publishing.

  2. Click the Add Custom Properties link.

  3. Type a name in the Property Name field. The name has these restrictions:
  4. Select the property's type from the Property Type scrollable list. This value is not modifiable once you have created the property.
  5. Click one of the Permissions buttons, either Read only or Modifiable. By default, this is set to Modifiable.
  6. Note
    For modifiable custom properties defined as META-tagged attributes, the value in the document is extracted only the first time the document is indexed. Because users can input a different value in the attribute field through the Web Publisher Services Properties page, the server ignores the META-tagged value in subsequent indexing. In this way, the user's value is not overwritten.
  7. Click one of the Visible to User buttons, either Invisible or Visible. By default, this is set to Visible. This defines whether server clients can view the property through Web Publisher.
  8. If the property you are adding is actually an HTML file attribute that has been tagged with the HTML META tag, you can check this checkbox. From this point onward, when files containing this attribute are indexed, the contents of the META attribute is used as the value of the property and you can search for files that contain this META-tagged property. The property must conform to the same conventions as property names.
  9. Note
    Because all attributes tagged with META are defined as text, sorting operations on fields containing dates or numbers do not sort in the expected date or number order. With this feature, you can redefine META- tagged attributes to dates or numeric values to obtain valid sort sequences.
  10. Click OK to create the new custom property.
 

Managing properties

You can list all the file properties that are available for use. These include the default set plus any new custom properties you have created. You can remove or edit only those properties that you have created. These have active Remove and Edit links in the first two columns.

To manage file properties:

  1. From the Server Manager, choose Web Publishing.

  2. Click the Manage Properties link to obtain a listing of all available properties.
To remove a custom property:
  1. Click the Remove link for the property. The Remove Custom Property form appears.

  2. Click OK to remove the property. Click Back to return to the Manage Properties page without removing the property.
To edit a custom property:
  1. Click the Edit link for the property. The Edit Custom Property form appears.

  2. Change the property as needed. You can only change the property's name, permissions, visibility and its option of whether to capture META-tagged attributes.

  3. Click OK to update the property with your changes. Click Back to return to the Manage Properties page without editing the property. Click Reset to reset any property values you changed.

 

Customizing your Netshare home page

By default, a user's Netshare home page displays the netshare.html file in the right frame. Initially this HTML file contains mostly text and a few sample links, but you or your users can revise this file to contain other text, graphics, links, and other HTML elements.

This file is the starting point for a user's workspace on the remote server and is what other users first see when they access the user's home page. You or the owner of the home page may want to provide some explanation of what other files, folders, and services are available through the home page and display some navigational links to route other users through the site.

This is the default set of files that is installed in a Netshare home directory:

 

Customizing the Web Publisher user interface

Web Publisher uses a standard set of default properties to describe its files and folders. These properties are listed in the Manage Properties form and are used in the HTML forms that the Web Publisher user sees.

As server administrator, you can customize these forms to meet specific user requirements. These forms are defined as a set of modifiable pattern files that contain pattern variables for the Web Publisher properties. These variables are named by taking the attribute name defined in the dblist.ini file (located in the yourServer/plugins/search.admin directory) and adding the prefix $$. For example, you can $$ to the variable CM_LOCK_OWNER to create the $$CM_LOCK_OWNER variable for displaying the lock owner in an HTML pattern file.

The Web Publisher attributes

To understand how these work, look at the dblist.ini file that came as part of the default installation of your server. You can see there a series of attributes called NS-idxattr1 through NS-idxattr27. These are the default Web Publisher attributes and they follow a standard syntax:
NS-idxattrn=CM_attributeName;displayName;TYPE;size
where

The Web Publisher pattern files

The Web Publisher pattern files use the Web Publisher pattern variables to display values, and to pass values between the user's system and the remote server. The pattern files use a combination of HTML syntax and JavaScript to define additional variables and to display information to the user.

These default Web Publisher pattern files are in the yourServer/plugins/content_mgr/ui/text/en directory on an English language server:

The remaining pattern files display a short message, typically as a result of not being able to satisfy the request.

A good place to begin customizing the interface is by modifying the existing pattern files. After you see how they work and you understand pattern variables, you can create your own pattern files and change the configuration files and other pattern files to point to them.

There are three kinds of Web Publisher pattern variables:

Most modifications to the Web Publisher pattern files involve simply changing which attributes you want displayed in the properties forms, adding or removing variables from the pattern file. That is, adjusting the use of the variables defined in the dblist.ini file. Other modifications are likely to involve the pointer variables, identified by their "-NS" suffix. The Web Publisher-defined variables are not intended for general use, and thus are not described at length here.

Pointing pattern variables

There are some pattern variables that point at specific files and displays them in one of the frames in the browser. The pointer variables that you can use in your  pattern file are listed in Table 2.

Conditional variables

You can set up a search to use a variable conditionally so that if there is no value associated with the variable, nothing is displayed. The syntax is as follows:
variableName[conditionalized output]
For example, you could request that the document's title be output if it exists. If there is no title for this document, not even the label "Title:" is to be displayed. To do this, you would use code like this:
$$Title[<P>Title: <B>$$Title</B>]

 Figure 1 shows the file properties page displayed by the sys-prop.pat pattern file. The fields for Owner, Title, Author, Lock Status, URL, and so on are all defined in the pattern file. Most of the variables are in the dblist.ini file, but there are a few that are defined by Web Publisher.

Figure 1: The Web Publisher file properties page

 

To see how these work together, here are some of the more interesting lines from the file properties pattern file, sys-prop.pat, that define various fields and their labels:

<TD><B>Owner:</B></TD>
<TD><input name="CM_OWNER" value="$$CM_OWNER" size="40"</TD>

<TR VALIGN=BASELINE><TD NOWRAP><B>Title</B>:</TD><TD>$$Title</TD></TR>
<TR VALIGN=BASELINE><TD NOWRAP><B>Author</B>:</TD><TD>$$CM_AUTHOR</TD></TR>
<TR VALIGN=BASELINE><TD><B>Lock Status:</B></TD>
<TD>$$CM_LOCK_STAT (only lock owner may unlock) <SPACER type=horizontal size=10></SPACER>
$$CM_LOCK_VAL:<SPACER type=horizontal size=5></SPACER>
<INPUT TYPE="checkbox" NAME="CM_LOCK_STAT" ><BR></TD></TR>
$$IF_DOC_HAS_RENDITON[  
<TD NOWRAP><B>Rendition</B>:</TD>
<TD><A HREF="$$CM_URL?$$CM_HTML_REND_NS">HTML</A></TD>
</TR>
]
Notice these aspects:

Copyright 1997 Netscape Communications Corporation. All rights reserved.