Next
Previous
Contents
At the top is the menu. Below this is the toolbar. Both of these are used to
perform operations on sites, and/or retrieve more general information.
Below these bars is the main part of Xsitecopy's user interface. As is
obvious from glancing at it, the UI is split into 2 main sections. On the
left is a tree view with a tree node for each of the sites that Xsitecopy
knows about.
If you expand a site, the files and directories that it is aware of will be
shown in a similar manner to the gnome file manager, gmc. Clicking on a file
or directory 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.
Basic Details
- Hostname is the name of your remote web server. For example, ftp.geocities.com.
- Port specifies the port that should be connected to on the
remote server. Unless you know you need to change this, it should be safe to
simply use the default value setup by your chosen protocol.
- 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 is 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 is the password required in order to login to the remote server. This will appear as asterisks on the screen.
- Site Statistics provides a short summary of the changes (if any) to the local site, since
the last update was performed.
Locations & Files
- 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
filesystem.
- 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 using the console application,
sitecopy, and a provided awk script. Support for report generation is
planned for a future version of Xsitecopy.
- 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.
Update Options
- Delete a file from the server if it is deleted locally. 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 a remote file if it is moved locally. 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.
- When uploading changed files, first delete them
- Convert all filenames to lowercase when uploading
- Use "safe mode"
- 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.
Excludes, ASCII, and Ignores
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'.
Existing Files
Deleted Files
Deleted files appear in a site's file tree because they represent an
operation that Xsitecopy must still perform when doing an update. However,
given that these files don't exist, the only information Xsitecopy can
report is just that.
Next
Previous
Contents