Next
Previous
Contents
At the top is the menu. At the moment, all you can do from the menu is
exactly the same as from the toolbar. You can use the buttons in this bar to
perform operations on your website(s). It can also be used to create &
delete sites, as well as get further help.
The main area below the toolbar is split into 2. On the left is a tree
view. This shows the title of each site as an entry in the tree.
If you expand these items, the files that are related to the selected site
will be shown. Clicking on a file brings up information about that file in
the right side of the window.
If you click on a site, the details and attributes of that site will be displayed in the main area of the program. These are divided into what are hopefully logical sections. Each section is separated by a frame, described below.
Server Details
- Hostname is the name of your remote web server. For example, ftp.geocities.com.
- Protocol determines the method that sitecopy uses to transfer
your files. This is totally dependant upon whether or not you would normally upload files to your website using FTP, or whether you are using a WebDAV server. You should choose the protocol accordingly. Note:- If xsitecopy has been compiled without WebDAV support, FTP will be the only option here.
- Username - the name you normally use to login when uploading files. If this is incorrect, you will receive errors when trying to upload your files.
- Password - the password required in order to login to the remote server. This will appear as asterisks on the screen.
Update Attributes
- Delete remote file if local is deleted. If this is not checked, then any local files that are deleted will be forgotten about. Selecting this option will force sitecopy to delete anything that is deleted on the local copy of the remote site.
- Move remote file if local is moved. When not checked, sitecopy will
not bother to check if a file has been moved locally, when it appears to be
deleted. If you wish all local file moves to be mirrored on the remote site,
ensure this option is checked.
- Use passive mode FTP, should only be unchecked if you actually
know you want it unchecked.
- When uploading changed files, first delete them. This option should
not be checked by default. If you find that your FTP server has trouble
dealing with over-writing files, then this option will force sitecopy to
first delete a changed file remotely, before uploading the newer local copy.
Statistics
Provides a short summary of the changes (if any) to the local site, since
the last update was performed.
Locations
- Directory for local files, is an absolute path in your file system. It
should be the root directory of your website that resides on your
hard disk (or over NFS).
- Directory for remote files, is the directory that all files will be
uploaded into. It must exist on the remote site for a successful
update to be completed. The directory must either have a / prefix if it is
an absolute path, or a / prefix if it is relative to your remote login
directory.
- Root URL of the remote site, is a non-essential field, that can be used to
generate a "recent changes" web page. Currently, (as of version 0.5.2), this
is only possible manually, using the changes.awk script provided with the
distribution. However, integrated report generating is a planned feature.
File attributes
- Permissions mode, can be one of Ignore All, Executables Only, or Maintain
For All. These options force XSitecopy to either ignore permissions of
uploaded files, maintain them for files with the execute bit set locally, or ensure
ALL remote files have the same permission bits as the local site,
respectively.
- Symbolic links, can be treated in various ways. Follow all, will tell
XSitecopy to upload the file (or directory?) that any symbolic links point to.
Ignore links, tells XSitecopy not to care if it encounters a symbolic link
on the local site. Maintain all, will attempt to create symbolic links on
the remote site, if this is supported by the selected protocol.
Advanced
Chances are that while you're editing html locally, things like backup files
will get created. While useful, it's likely you don't want them uploaded to
your remote web site. The excludes section allows you to specify regular
expressions. Any files on the local site matching these expressions will be
ignored by XSitecopy.
For example my excludes consist of:
because I don't want any backups or core dumps uploaded. I also have a
sub-directory on my local site called 'oldweb' which I keep for nostalgic
purposes only. This is not uploaded by specifying it as 'an exclude'.
Next
Previous
Contents