This document will explain how to upload HTML files that have embedded images and links to local files to CleverPath Portal.
The examples here will be using a Microsoft Word doc containing a graphic that is exported to HTML. The same basic steps can be applied to HTML documents created using other methods as well.
The operating system that CleverPath Portal is installed on does not play a factor in the uploading of the files. Primarily this document will use Win2000/WinXP as example client machines.
Additional Software Requirements
Additionally, an archiving utility that can create .zip or .jar files is required. Windows XP does not require any additional software to extract or compress .zip files.
Creating the HTML file
We will start by creating a simple Microsoft Word document and embedding a single image with some text.
- Open Microsoft Word and select File/New. You will be presented with a blank document.
- Type some simple text to start with:
- Next, select Insert/Picture/Clip Art. Any of the options can be used, but for this example the installed clip art is being used. Select any of the images from the Clip Art selector:
- Select File/Save As and change the file type to Web Page (*.htm; *.html) from the drop down menu listed next to Save as type. This can be named anything you want:
- This will create both an htm or html file and a directory in the location specified. Both will have the name as displayed in the File name box (shown in above image) with a slight variation. The actual htm or html file will be named "This is a test HTML document.htm", and the folder created will be named "This is a test HTML document_files":
- At this point the folder will contain the image placed into the document, a .WMZ file and an .XML file - these are pointers for the image file:
- In order to publish this new htm file to the portal and have the images remain in tact, you will need to zip together the htm file and the folder that were created during the Save As process. This will create a zip file named This is a test HTML document.zip.
- At this point, log into CleverPath Portal as a user who has rights within the Knowledge area of the portal. Navigate to Knowledge/Library and select 'Publish File'. This will open the Publish Content area of the Library.
- In the upper right corner of the screen is a drop down menu named 'Publisher'. Using this drop down menu, change the publisher to 'Archive Extractor'.
- Next to 'Zip/Jar File;' is a text box with a Windows Explorer type Browse button. Click on 'Browse' and navigate to the location of the zip file created in step 7 above. Once located, make any necessary changes to the Folder, Document and Workgroup settings, then click on OK.
- You will receive the message "File successfully uploaded. Content will be available shortly". Depending on how large the zip file is, this could take a significant amount of time. The test files used in this demonstration will be available almost immediately. Refresh the page by clicking on 'Library' in the left side menu frame. At this point you will now see a Portal folder named 'This is a test HTML document_files' and the 'This is a test HTML document.htm' file in the root of the Library.
- Click on the 'This is a test HTML dlcument.htm' file in either the left or right frame of the portal and the file will be displayed with the image in tact.
Because there are several ways of creating HTML documents, the steps here may not apply exactly as far as the way the actual HTML is created or the embedded images are saved. However the steps for publishing these documents will remain the same.
Another way to do this might also be to store the images in a directory within your Web Server. Since the pathing information for "img src" in the HTML will then be a link to the image file located on the Web Server, there is no need to zip all the files together, only the HTML document will be published (using the standard publisher instead of the Archive Extractor as outlined in steps 9 and 10 above.) This method will involve working with your Web Administrator to store the images on the Web Server.
We take pride in our technical documents and are interested in your feedback. Please email your comments to us directly at: firstname.lastname@example.org.
Be sure to include the document id in the message.