Help Desk
Section 9.2.
Home Tour Join! Contents Team News Catalog Search Comm

How to Submit Documents in the ASI Web Management System

This might look complicated at first, but once you've seen it in action a few times, it's really very fast. The time-consuming part is waiting for the server to respond through the Internet; that can be a pain if the network is running slow.

  1. [] Start up WebSite Director.

    Enter your user information to sign on. If you don't have a WSD account, scroll down the page, fill out the form, and send it in. The ASI web team will send you a note when your new account is ready.

  2. Submit New Request

    That's the first button on the main WSD screen. It should take you to the "Submit New Request" screen.

  3. Add New Document

    You can alternatively skip a step by choosing Upload New Document; but going through Add New Document takes a tour through all the options, so that's what we'll show here.

  4. Add New Document or Upload New Document

    Now you have a choice of using "Upload" or "Browser Edit" to get the new document onto the web server. Let's follow the "Upload" path first.

    Note: You need to be running Netscape rev 2 or later, or Microsoft Internet Explorer (MSIE) rev 3 or later, to use the upload feature. Earlier versions of these browsers didn't have an upload feature.

    Don't click on "Upload" yet. First we have to find the file on your computer.

  5. BROWSE This looks like a button. Its appearance depends on which navigator, machine, and version of operating system you're using. It's on the right-hand side of the screen, in the gray area.

    A window should open that allows you to navigate around your computer and find the file you want to upload.

  6. Find the file that you want to upload on your computer, and click on "Open".

    Note that the filename of the file you selected appears in the text window next to the BROWSE button. Now your computer and your browser knows what file you want to send. Next we tell WSD where to put the file.

  7. In the "New Filename" text box, enter the name of the file as it will appear on the ASI web server. This should include the full pathname, including the destination directory.

    The pathname starts with "/" as the ASI web server's root directory. For example, if you were updating the 'basic-overview.html' file in the Dutch version of the Artemis Data Book, the file name would be:


  8. Now that you've told the system where the file is located on your computer, and where it's going on the ASI web, you can upload it.

    To do that, click the UPLOAD button.

    It might take a few seconds to copy the file from your computer into the WSD system.

    Note: Instead of uploading the document, you can alternatively use BROWSER EDIT to create it. See notes about this option at the end of these instructions.

  9. DOCUMENT TITLE. While you're on the Add New Document Area, type the title of the document in the "Title" field. This is the title that WSD will display at the top of the document, and also put into the table of contents for this section of the Artemis Data Book.

    The title can contain html, so if there are diacritical marks needed, go ahead and include the HTML codes for them.

    You can do this before step 8, or after. It doesn't matter.

  10. Document Info Button

    Now we fill in the information that WebSite Director needs to keep track of the document and publish it correctly.

    You can do this before step 8, or after. It doesn't matter; except that if you enter the Document Info first, you'll be able to Preview the document in Browser Edit with all the decorations in place. So I like to set the DOCUMENT INFO before uploading the body of the document.

    This takes you to a new screen with a form for entering lots of information about the document. Here's the list:

    Entered by WSD; it's WSD's name for this request.
    Request Type:
    ADD (It's a pop-up menu with some other options.)
    Destination of the new file on the web server
    The title you entered. (If you haven't already entered a file name, this is the place to do it.)
    A brief description of the file. WSD puts this information into a META tag. It's the description of the document that will appear in a search engine such as Yahoo or AltaVista.
    List of key words associated with this document. WSD will add some stock stuff like "moon luna space exploration" and so on; so you just need to enter key words unique to this document.

    In example cited above where you're editing the Dutch version of the Project Overview, you could enter "artemis project introduction overview summary dutch netherlands".

    Key words are used by search engines to find documents that match what someone is looking for.

    Pop-up menu that allows you to select the name of the person who wrote the document. In this case, that would be me, "Bennett, Gregory", since I wrote the thing.
    Pop-up menu that allows you to select the name of the person who maintains the document. Usually, that's you. In special cases where there are so many maintainers we can't figure out who is really maintaining it, you can select "ASI Web Team".
    Submitted by:
    WSD enters this automatically, though you can change it if you want to blame someone else.
    Next Rev #:
    WSD enters this automatically. It will probably start at revision 1.0. Each time you modify the document thereafter, WSD will increment the revision number by 0.1. You can set this to some other number if you want to.
    Index Position:
    This is where the document will appear in the Table of Contents for this section of the Artemis Data Book. It defaults to "Last", meaning the new document will be listed at the end of the contents for this section.

    Suppose you'd like your document to be second on the list. In that case, you would set the Index Position to 2.

    Publish Date:
    WSD automatically sets this to the current date, and "Tonight". If you want to delay publication until a future date, you can enter a different date. There's also an option to publish "Immediately" instead of waiting for WSD's Publisher to wake up and publish documents in the middle of the night. We only use "Immediately" if something needs to get out on the web right away. I often use it, bypassing all approval cycles; but I don't think anybody else has ever used it.

    You probably don't need to worry about the Publish Date options.

    WSD defaults to "None". I recommend using ADB.HEADER. You select this from a pop-up menu. See note 11, below.
    WSD defaults to "None". I recommend using ADB.FOOTER.
    WSD has a rather powerful template processing language which allows you to include any information WSD knows about a document in the body of the document. However, you probably don't need to worry about it. So just leave this box unchecked.

    If you want to learn more about WSD template processing, click on the red "Help" at the upper right corner of the screen, below the Website Director masthead, and navigate around the WSD manual until you find information about "templates".

  11. About Headers and Footers

    WebSite Director takes care of Headers and Footers for you, so you don't have to hard-code all that window dressing at the top and bottom of the document. (You can hard-code if you want to.)

    If you're translating Artemis Project web documents into a language other than English, we can create new versions of the ADB.HEADER and ADB.FOOTER templates in that language. In the mean time you can just use the standard header and footer, ADB.HEADER and ADB.FOOTER.

  12. Save your changes to the document information by clicking on "Update Info".

    If you just "Return" insead of "Update Info", no changes will be made. Either of these buttons takes you back to the "Add New Document" screen.

    Note: Don't use your browser's Back button in WSD, because if you do, you'll return to a previous screen without transmitting the data.

  13. If you have some comments you'd like to make about the documents, just type them in the "Comments" field. This could be instructions to people approving the document or to the ASI web team about how to format the work.

  14. View Document Button Check the document with the "View Document" button. If you have JavaScript enabled, the formatted document will show up in a new window. If not, it will appear in the same window WSD is using. (In this latter case, you'll need to use your Back button to get back to WSD.)

    You don't have to check the document, but it's a really good idea to do this. Checking the document at this stage can avoid lots of wasted time later in the process.

  15. Browser Edit Button If the document isn't quite what you want, but you just need to do a few changes, you can use the Browser Edit feature to fix it up.

    To use Browser Edit, click on "Browser Edit". That opens a text editing window, where you can make changes.

    While in Browser Edit, you can preview the formatted document with the Preview button. This works just like the View Document button mentioned in step 14.

    To save your changes, use the "Update" button. If you decide not to save any of the changes, use "Cancel".

    Note: Until you click on "Update", the server doesn't know anything about your changes. All this editing is happening off line, in your web browser.

  16. When you're done editing, "Update" takes you back to the "Add New Document" screen again. From here, you can use View Document, Document Info, and Browser Edit as much as you want until your document is ready to be sent into the ASI web management system.

  17. Save Request Button

    All ready to go? Take a deep breath, and click on SAVE.

    Don't forget to do this. If you "Cancel" without saving or go somewhere else with your browser and forget to save, WSD will forget all about your request. (You might be surprised at how often people go through all the trouble to get a file into the system, and then forget to tell WSD to save the request.)

  18. When you Save your request, you'll get a window confirming that it was saved. If something goes wrong (happens once in a while, but not very often) you'll see an error message instead.

    "OK" will take you back to the top Submit New Request screen, where you can submit another request, or Return back to the main WebSite Director screen.

  19. To get out of WSD, just surf somewhere else, or quit Netscape. You don't really sign off from WebSite Director; you just stop sending stuff to it, and it will stop listening.

Alternative Step 8: Using Browser Edit instead of Upload

Way back up there in step 8, where you uploaded the document, I mentioned that you have an alternative: Browser Edit. If your browser doesn't support file uploads, then this is the only alternative. As a matter of fact, I think it's easier so I only use "Upload" to get binary files (such as images) into the system. Instead of uploading a document for your computer in step 8, you can:

Once you've got the text into the server, the rest is the same.

Help Desk

Home Tour Join! Contents Team News Catalog Search Comm
ASI W9800266r1.0. Copyright © 2007 Artemis Society International, for the contributors. All rights reserved.
This web site contains many trade names and copyrighted articles and images. Refer to the copyright page for terms of use.
Author: Gregory Bennett. Maintained by .
Submit update to this page. Maintained with WebSite Director. Updated Thu, Mar 5, 1998.