Jomatu Wiki: Documentation

Jomatu Tutorial: How to upload a web page


Uploading files is performed via the File Manager component in the Edit Facility. There are four categories of files you can upload:

Using our example website, our starting point is in the Edit Facility (the documentation for getting to this point can be found on the 'How to edit your website text' page - steps 1-3).

In this particular tutorial we're going to upload a new web page template file (read our 'Creating a template file' for more information). Once we've uploaded this file, we will add a new link to it from our home page's main navigation.

To upload our new web page file, click the File Manager button in the editor.

Step 1: click on the 'File Manager' button

Upload Web Page File - Step One

Clicking the 'File Manager' button launches the 'File Manager' window. In this window you will see a thumbnail of all the files that you've uploaded to Jomatu. As this tutorial follows on from the 'How to upload an image file' tutorial, we can see our previously uploaded image in this list. To upload our new document file, click on the 'Upload New File' link.

Step 2: click on the 'Upload New File' link

Upload Web Page File - Step Two

Clicking the 'Upload New File' link launches the 'Upload New File' window. The first section here offers five options which are solely concerned with web images and is covered in the 'How to upload an image file' tutorial. As we're uploading a document file, this section does not apply.

Step 3: click on the 'Browse' button to locate our document file

Upload Web Page File - Step Three

When you click the 'Browse' button, a pop-up window appears showing the storage devices, folders and files on your own computer. Use this window to locate your file†.

Step 5: locate your upload file and select it

Upload Web Page File - Step Four

When you locate your file, either double-click the file, or single click (to highlight it) and click the 'Open' button. Note: this button name may be different on your computer†. The pop-up window will disappear and you will see your file name (usually with the path to that file) appear in the 'File to upload' form field.

Step 5: click the 'Upload' button to upload the file to your website

Upload Web Page File - Step Five (a)

Depending on your file size and internet connection speed, file uploading may take several minutes to complete. During file uploading you'll see the following message:

Upload Web Page File - Step Five (b)

When file uploading has completed, you'll be automatically returned to the main File Manager window. Here you can see your uploaded web page file, represented as a thumbnail, in the list.

Upload Web Page File - Step Five (c)

Note: Once we've uploaded our website template page, we can create as many new pages from it as we like - we don't need to re-upload the template page again (unless of course we've made changes to the website template file).

Next to the website page icon, we can see two new buttons: a green 'Edit' button which we can click to Edit this file, and a blue 'Copy' button which we can click to copy the file. We want to create a new web page based on this new uploaded template file, so we need to copy the template file as follows.

Step 6: create our new web page by copying the uploaded template file

To copy our template file, click the blue button next to the icon.

Upload Web Page File - Step Six

This brings us to the 'Copy web page (create new page)' facility. Here we need to provice a name for our new web page (technically, the file name). Note: to ensure maximum compatability, the characters we can choose are restricted to alpha-numerics (a-z, 0-9), a dash (-) and an underscore (_) character.

Step 7: Enter a web page name for our new web page

It's a good idea to chose something meaningful, so, as this new page of ours is to list our company's services, we'll call it 'our-services'. Note: we don't need to provide a 'file extension' (e.g. '.html'), as the file extension is inherited from the file from which we're copying.

Upload Web Page File - Step Seven

Clicking the 'Create Web Page' button will create our new web page.

Step 8: Edit our new web page

At this stage our new page 'our-services' is simply a copy of the website template file that we uploaded earlier and, as such, probably doesn't have any unique content. We need to edit our new page to add the content. One way to do this would be to close the File Manage, add a link from the web page we're currently editing to our new page, then use the Jomatu Browse Facility to locate our new web page (using this new link) so we can click the 'Edit' button to edit it. However, we have the option of editing our new page immediately by clicking the green 'Edit' button next to the new web page's icon in the File Manager list.

Upload Web Page File - Step Eight

Note: clicking the green 'Edit' button will replace the existing Edit Facility. If you have made any changes that you'd like to keep, then close the File Manager, publish your changes, then re-enter the File Manager to bring you back to the above screen.

Step 9: Edit our new web page

Clicking the green 'Edit' button replaces the existing Edit Facility with the new one in which we're editing our new web page.

Upload Web Page File - Step Nine

Add your new web page's content and click the 'Publish' button. Finally, you'll want to create at least one link to your new page, so click the 'Browse' button to return to the Jomatu Browse Facility, locate the web page(s) you want to link to the new page, and edit them to add the new link. Linking to a web page is just like linking to any other document file and is covered in the 'Upload Document File' document, steps 6 & 7.

Editing a web page has been covered in the previous manuals, so we won't repeat that here. Remember, if you're adding a new link into your website's navigation, you'll need to change that for all the web pages in your website that use that navigation.

This completes the 'How to upload a web page file' documentation.

* A web page template file should already exist for your website. To be usable for Jomatu, all the links must either be absolute, relative to the document root or relative to the Jomatu Repository folder (where the new web pages will reside).

† This particular pop-up window is a part of your computer's operating system; it is not created by Jomatu. Therefore the methods for locating your files will be dependent on your particular system. The example shown was generated on a computer running Microsoft Windows.