SiteXpert FAQ

Question ID:
Q1026
Question:
How do I set up output locations in the Options / Output?
 
General description
In Options / Output you can find six different text boxes where you should specify destination locations of all the files generated by SiteXpert.
There are three groups of these options, each containing an HTTP location and Upload directory. In case you are generating a search engine (professional edition only) there is also a fourh group where you must specify the CGI files locations.
Here is a detailed description of all the output locations:
Main output page name: Name of the output HTML page (default: sitemap.html). Please specify file name only without a path.
Upload directory for HTML files: Depending on your choice between local or FTP upload, this is the FTP or local directory where the HTML pages generated by SiteXpert will be saved (uploaded). Note: If your layout contains relative paths, the links in the generated site map will be invalid unless you set this option to the root directory of the mapped web site. If you want the links to be always valid (no matter where the site map is uploaded), make sure you don't use relative paths (you can use Layout Wizard options or Suffix Builder to control this).
Images directory: Specifies the HTTP path to directory containing images generated by SiteXpert. This can be an absolute path (e.g. "/images" or "http://www.mydomain.com/images"), relative path (e.g. "images"), or you can leave this field empty to generate images in the same directory as output HTML files. The value of this field should be the HTTP representation of the directory specified in the field "Upload directory for images".
Upload directory for images: Depending on your choice between local or FTP upload, this is the FTP or local directory where the images generated by SiteXpert will be saved (uploaded). This directory should reflect the path specified in the field "Images directory".
Scripts directory: Specifies the HTTP path to directory containing scripts (JavaScript files) generated by SiteXpert. This can be an absolute path (e.g. "/js" or "http://www.mydomain.com/js"), relative path (e.g. "js"), or you can leave this field empty to generate scripts in the same directory as output HTML files. The value of this field should be the HTTP representation of the directory specified in the field "Upload directory for scripts".
Upload directory for scripts: Depending on your choice between local or FTP upload, this is the FTP or local directory where the scripts (.js files) generated by SiteXpert will be saved (uploaded). This directory should reflect the path specified in the field "Scripts directory".
Options required if search engine are going to be generated (professional edition only):
CGI Scripts directory: Specifies the HTTP path to the directory containing CGI scripts (usually this should be "cgi-bin"). This should be an absolute path (e.g. '/cgi-bin' or 'http://www.mydomain.com/cgi-bin'). The value of this field should be the HTTP representation of the directory specified in the field 'Upload directory for CGI scripts'.
Upload directory for CGI scripts: Depending on your choice between local or FTP upload, this is the FTP or local directory where the CGI script and database files generated by SiteXpert will be saved (uploaded). This directory should reflect the HTTP path specified in the field 'CGI Scripts directory'.
Typical use cases
Generaly there are a few possible SiteXpert use cases and we'll analize what should be entered in all text boxes depending on the use case.
1. I want my site map with all files to be located in the same directory
In this case you only have to fill out the fields 'Main output page name' and 'Upload directory for HTML files'. Skipping the rest of the fields tells SiteXpert to place all the other files (e.g. images, scripts) in the same directory where you want to upload the site map file.
Let's assume you have your web server pages located at /usr/home/paul/public_html and you want your site map file to be named as 'mytree.htm'. Simply enter appropriate values into both text boxes (mytree.htm into 'Main output page name' and '/usr/home/paul/public_html' into 'Upload direcotry for HTML files'. If you want to upload your web site into a direcotry on your computer (e.g. for test purposes), in 'Upload direcotry for HTML files' type something like this 'c:\temp\website\sitemap'.
2. I want to have my site map html file separated from the other site map files (images, scripts)
In this case fill out the first two fields the same way as described in the previous example. You must also specify the HTTP directories and upload locations for images and scripts files. For example if you want images to be placed under the 'images' subdirectory and scripts under 'scripts', specify appropriate direcories in the upload section. Make sure that the HTTP directories match corresponding upload directories. We strongly recommend to specify absolute urls in all HTTP directories text boxes (e.g. 'http://www.mydomain.com/images' to avoid problems when you want the site map to be inluded on several web pages located in different directories /see below/ ).
3. I want to include SiteXpert generated files into several pages located in different directories
In this use case all the HTTP directories have to be absolute to allow all web pages to find the images and script files. If your web site is located at http://www.mydomain.com/ and you have two subdirectories - 'images' and 'scripts', you should enter http://www.mydomain.com/images as Images directory (HTTP path) and 'http://www.mydomain.com/scripts' as Scripts directory (HTTP path). In the Upload directories please enter appropriate paths, e.g.: '/usr/home/paul/public_html/images' and '/usr/home/paul/public_html/scripts'. If search engine is generated (professional edition) make sure that the CGI scripts directory (HTTP path) ponts to the location where CGI scripts may be executed.