General

General

The General section of the Settings dialog provides the following controls:

Suppress Login Dialog

Whenever SiteSucker encounters a page that requires authentication, it first looks for the appropriate credentials in the Keychain. If nothing is found in the Keychain, it displays the Login Dialog.

Check this box to suppress display of the Login Dialog and skip the download of any pages that require authentication. For more information on authentication, see Password-protected Sites.

Ignore Robot Exclusions

Check this box to have SiteSucker ignore robots.txt directives, the Robots META tag, and the X-Robots-Tag HTTP header. See Robot Exclusions for more information about robots.txt, the Robots META tag, and the X-Robots-Tag HTTP header.

Note: SiteSucker always honors robots.txt directives aimed specifically at SiteSucker.

Warning: Ignoring robot exclusions is not recommended. Robot exclusions are usually put in place for a good reason and should be obeyed.

Always Download HTML and CSS

Check this box to have SiteSucker always download HTML and CSS files despite the File Replacement setting. Use this control to force SiteSucker to download fresh copies of HTML and CSS files.

Ask For Destination

Check this box to have SiteSucker ask you to choose the destination folder when you start a download.

File Replacement

Use this control to specify when SiteSucker should replace existing files. You can choose from the following options:

  • Never - SiteSucker never replaces your local files and only downloads those files that haven't already been downloaded.
  • Always - SiteSucker always deletes your local files and replaces them with files downloaded from the Internet.
  • With Newer - SiteSucker only replaces existing files if a newer copy is found on the Internet.

Note: In some cases, existing HTML and CSS files may replaced even when the Never setting is used. This may happen, for example, when File Modification is set to None but the existing file has been localized.

File Modification

Use this control to specify how SiteSucker should modify files after they are downloaded. You can choose from the following options:

  • None - SiteSucker does not modify files.
  • Localize - SiteSucker will localize downloaded files so that you will get the best results when browsing a site offline. This feature modifies the downloaded HTML and CSS documents by replacing every absolute link to a file on a Web server with the corresponding relative link to the local file. If there isn't a local file associated with a link, this setting will ensure that the link points to the file on the Web server.
  • Delete After Analysis - SiteSucker deletes HTML and CSS files after they are downloaded and analyzed.

Path Constraint

Use this control to limit downloaded files to those at a specific site, those within a specific directory, or those containing a specific path. This option works in conjunction with the Path settings. SiteSucker provides the following download options:

  • None - SiteSucker downloads the file specified in the URL text box and every file that it links to and every site that these files link to, etc. Be aware that this option could result in a HUGE download if allowed to continue forever.
  • Host - SiteSucker limits the download to those files on the host of the original file being downloaded. For example, if the URL is http://www.example.com/directory/home.html, this setting limits the download to those URLs beginning with http://www.example.com or https://www.example.com.
  • Subdomains - SiteSucker limits the download to those files within the second-level domain and all subdomains of the original file being downloaded. Extending the previous example, this setting will download URLs beginning with http://www.example.com, https://images.example.com, http://guide.example.com, or https://example.com.
  • Directory - SiteSucker only downloads those files that are within the directory of the original file being downloaded. Extending the previous example, this setting limits the download to those URLs beginning with http://www.example.com/directory/ or https://www.example.com/directory/.
  • Path Settings - SiteSucker downloads the file specified in the URL text box and any files referenced which have paths included in the Path settings.

Destination Folder

Use this control to select the local destination folder where files will be saved. By default, SiteSucker saves files to the Downloads folder in the user's home directory. To change the destination folder, choose the Set Destination Folder... menu item.