KompoZer User Guide

 1 - Introduction

 2 - Quick start

 3 - Using KompoZer

 4 - Stylesheets

 5 - Scripts

 6 - Inserts

 7 - Templates

 8 - Site Manager

 9 - Preferences

10 - Publishing

• Introduction
• Validating
• Publishing

      Appendices

KompoZer User Guide - Section 10

10    Publishing

10.1 Introduction

Publishing a site means transferring the site, i.e. the pages, images and stylesheets involved, to a web server from which they may be accessed, usually but not necessarily, by the public. This process is called ‘Uploading’. Prior to publishing there are a few checks which should be carried out.

10.2    Validating the site.

Validating simply means checking that the page or site operates as intended. Designers may by now have a plethora of files some of which are obsolete or are not required for the published site. A good practice is to create a new folder structure and in it place those files, and only those files, which are needed.

This can be done using your usual file manager e.g. Windows Explorer but the KompoZer File Manager can be set up to do this task by ‘Publishing’ these to a new folder.

10.2.1    Markup Cleaner

KompoZer provides a Markup Cleaner Tools > Markup Cleaner which can be used to remove redundant code which clutters the file but does not contribute to the page content. This does not necessarily remove all redundant content but makes a good contribution to it.

10.2.2    Browser testing

The next stage of validation has already been taken care of by KompoZer. Users have a high assurance that the code generated represents valid HTML or CSS. The site should next be run using a browser. Possible problems include you having omitted to transfer files to the correct folders, naming the folders incorrectly, including getting the case wrong. 

The site should be checked on a range of different browsers. Several modern Mozilla based browsers behave very similarly so do not provide additional confidence. Check with browsers from other sources and be very conscious that a few visitors may still be using very old browsers.

In late 2007 a minimal set of browsers to test on might be Firefox (latest version), Opera (latest version), Internet Explorer 6 and Internet Explorer 7. Both these latter two behave differently from each other and also from other browsers so use both. In spite of the availability of Internet Explorer 7 version 6 remains the most widely deployed so it is essential to check with this.

10.2.3    Formal validation

Browsers are often very tolerant of incorrect code. A much more rigorous test is to submit pages to the W3C validators. There are two: one checks that the page code conforms to the HTML specification, the second that the style sheet (internal and external linked) code conforms to the CSS specification. KompoZer provides direct access to the first of these.

To validate a page. Open it in KompoZer. On the Menu choose Tools > Validate HTML. A validator window opens and the page is automatically submitted for validation. The result will be displayed in the window. (On Windows systems at least this validation is no longer possible for files on the local disk.)

To validate pages with internal stylesheets or separate external stylesheets the validators may be used independently. The URLs are given in the References (Appendix 2). Pages may be validated either from the local disk or after the files have been uploaded.

While the W3C validators check rigorously for conformity with specifications this does not guarantee that the code will run correctly. Unfortunately none of the current browsers fully support the specifications! This is why browser validation is an essential step.

10.3    Publishing

You can publish your web pages to a web server on which you have an account. Your ISP probably offers limited free space but you can buy space from professional hosting providers.

To publish a site you need to know the settings for the space so that you can set up your system.

Files may be uploaded using any available FTP program but KompoZer has built-in facilities which are integrated with the Site Manager which makes this task very simple.

While uploading using KompoZer is simple the facilities and the folder structures supported are limited. You may prefer to use one of the available open source or freeware FTP programs.

10.3.1    Setting up your site

While setting up Site Manager you may already have configured the ‘remote’ site (sections 8.4 and 8.2), if not, either proceed as detailed there, go directly to Publish Settings via Edit > Publishing Site settings.

Enter the following details:

• In the ‘Site names’ box enter the name that you want to know the site by.
• HTTP address (URL) of your site. From your ISP (see hints).
• Publishing address – This is the ftp address to which you will publish.
• User name – From your ISP.
• Password – From your ISP.
• If you wish to, check ‘Save Password’.

If you have several sites set up and you have one site that you always or usually publish to you may wish to click on the name of this site then ‘Set as default’. This simplifies uploading.

Click OK.

10.3.2    Uploading

Open the page that you want to upload. An easy way to do this is from the Site Manager.

1. Click the ‘Publish’ button.
2. On the ‘Publish Page’ window on the ‘Publish’ tab, if it is not your default, in the ‘Site name’ box select the site to which you want to publish. The ‘Page title’ and ’File name’ should already be completed.
3. If the page is to be uploaded to a sub-directory, rather than the root directory, enter the name of a sub-directory and any of the other data if required.
   Note This directory must exist. KompoZer cannot create it.
4. If it is the first time to upload the page, and if it includes images or uses external style sheets, check the box ‘Include images and other files’. (If it is not the first time and these other files have not changed the box may be left unchecked.) The files will be placed in the same directory as the page. If you want them to go in a sub-directory check the box ‘Use this site sub-directory’ and name the directory. In this case the directory will be created if needed.
   Note  this is a sub-directory of the root directory not any directory detailed in the previous point. If you want to use such a directory this must be explicitly detailed e.g. pagesubdirectory/filessubdirectory/
   Note all the Images and style sheets will be placed in the same directory. This is the only arrangement supported by the Site Manager Publisher.
5. You should not need to refer to the ‘Settings’ tab as the data should be collected via the Site name you have selected but you may view the data and change if you wish.
6. Click ‘Publish’. A ‘Publishing’ window will appear and uploading will commence. (If you are on a dial-up connection this will be connected.)
7. Within a short time you should receive confirmation of correct publication similar to the first figure above.      
8. One possible source of problems occurs if you are prevented from accessing the site by a firewall. In this case you may receive a ‘Publishing failed’ message similar to that shown in the second figure.

The ‘Troubleshooting’ button takes you to the KompoZer help system but this is short of aid in this area at present.

Other possible problems include

• Some required files are missing
• File or directory names incorrect e.g. Wrong case

Once you have published a page, if you need to publish it again, your settings (e.g. subdirectories) should be remembered by KompoZer. You will not see steps 2 to 4 again unless changes have been made to the page.

C’est fini !