This section covers the following topics:
This guide describes how to use Site Studio Publisher to publish a Site Studio Web site. With Site Studio, you store the Web sites you build in Oracle Content Server. At some point, you may find that you would like to create a static copy of a Web site and transfer it from an Oracle Content Server environment to a pure web server environment that is not running an Oracle Content Server instance. This process is referred to as publishing.
Site Studio Publisher creates a static snapshot of a dynamic site by traversing all the links in a Web site (visiting all of the linked pages) and downloading a copy of each page and all of the resources (images, flash movies, and so on) on each page. Your entire Web site, including the content of queries, layout pages, fragments, contributor data files, and native documents, are then copied and published to the new server.
The most efficient use of a dynamic site would have immediate updates and automatically update only the changed areas of the Web site. Since Site Studio Web sites are dynamic and created using a large number of variables, it is very difficult to track and publish the affected areas of the Web site in a reliable and consistent manner. Site Studio Publisher can selectively process, or not process, pages on a Web site based on different control methods. When each asset does not need to be compared each time, then it is much easier to keep the static site up to date, and the site owner can easily control the process.
Site Studio Publisher operates from an initial list of available links, and then compares them to a previous version of links used by Site Studio Publisher. The use of controls and filters can control the list, and also limit Site Studio Publisher to using only certain parts of the list. The first time Site Studio Publisher examines a Web site, all links are examined and added to the list.
When Site Studio Publisher examines a link and determines that it has changed, the content is analyzed and the new set of links for that page is determined. If the examination is skipped, either because no changes were found or because the controls and filters require that a specific link is skipped, then the previous list of links is used for comparison.
To enable Site Studio Publisher, perform these tasks:
Log in to the Oracle Content Admin Server page with administrator credentials.
Go to the Component Manager.
Click the checkbox next to Site Studio Publisher under the Web Content Management section.
Click Update at the bottom of the page.
A dialog will appear confirming your selection.
The server must be restarted to complete enabling Site Studio Publisher.
To install and enable the Site Studio Publisher component on a 10gR3 Oracle Content Server instance, see the Content Server 10gR3 documentation.
Site Studio Publisher is run from the Site Studio Administration section of the Oracle Content Server user interface.
To get to the Site Studio Publisher interface, perform these tasks:
Log in to the Oracle Content Server with administrator credentials.
Open the Administration tray or page, depending on your layout.
Select Site Studio Administration.
Select Site Studio Publisher.
To publish a Web site from an Oracle Content Server environment to a web server, all the content of your site is copied by Site Studio Publisher. However, the copy of the site must be both complete and self-contained. That is, the copy must contain all of the resources of the original site, and pages in the copy must refer only to resources within the copy itself. To create a self-contained copy, Site Studio Publisher rewrites any absolute (full) URLs within the original site to relative URLs to allow the static copy to be hosted on a different hosting instance.
Site Studio Publisher uses the following procedures to identify and evaluate links and resources contained in a particular page:
When handling HTML, Site Studio Publisher looks for any attributes in tags that may contain links (for example, the 'HREF' attribute in an 'A' tag or the 'SRC' attribute in an 'IMG' tag), and downloads these images. If the link is absolute, the link in the copied site is updated to refer to the downloaded image (through a relative URL) instead of the original image.
Be careful when appending URL parameters to a page URL. By default, in Site Studio Publisher, extra page parameters that result in a variant of the dynamic page are not used when naming the static page. Site Studio pages should not be customized by appending URL parameters to a node reference, as any appended parameters are ignored (that is, any node parameters not defined using Site Studio are not used in naming the pages).
In all patterns listed below, double quotation marks (") and single quotation marks (') are treated as equivalent. The crawler attempts to match any valid URL within the quotes.
|something.src = "foo.gif";||foo.gif||none|
|top.location.href = "other.html";||other.html||none|
|var g_httpCgiUrl = "...";||See note 1|
|var ssAssetsPath = "..."||See note 1|
|var ssUrlPrefix = "..."||See note 1|
|link(XXX)||?IdcService=SS_GET_PAGE&ssDocName=XX||See note 2|
|nodelink(YYY)||?IdcService=SS_GET_PAGE&nodeId=YYY||See note 2|