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.
That's the first button on the main WSD screen. It should take you to the "Submit New Request" screen.
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.
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.
A window should open that allows you to navigate around your computer and find the file you want to upload.
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.
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:
/nl/adb/01/basic-overview.html
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.
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.
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:
- Request:
- Entered by WSD; it's WSD's name for this request.
- Request Type:
- ADD (It's a pop-up menu with some other options.)
- Filename:
- Destination of the new file on the web server
- Title:
- The title you entered. (If you haven't already entered a file name, this is the place to do it.)
- Description:
- 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.
- Keywords:
- 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.
- Author:
- 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.
- Maintainer:
- 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.
- Header:
- WSD defaults to "None". I recommend using ADB.HEADER. You select this from a pop-up menu. See note 11, below.
- Footer:
- WSD defaults to "None". I recommend using ADB.FOOTER.
- Options:
- 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".
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.
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.
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.
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.
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.)
"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.