This FAQ is provided with the hopes to be helpful for users using SilkPage. The information is updated as the questions and answers becomes appearant to the SilkPage team.

D.1. General Information
What is SilkPage
For whom is SilkPage intended
I don't know anything about XML, can I still use SilkPage
What are the differeces between SilkPage and DocBook Website
On what is SilkPage based
What is the relation between SilkPage releases and DocBook Website
D.2. Usage and Customization
How do I create my first Website
How do I migerate my website from DocBook Website to SilkPage
How can I change the link labels of the footer items generated by SilkPage
SilkPage generates a Google based search field for my website, how can I turn it off
What is RSS
What are all RSS formats and versions ? Which one should I choose
D.3. Installation
What is required to run SilkPage
How do I install the SilkPage software
On what platforms SilkPage can be installed and run
I can't even run SilkPage with the config target to test my installation, what's wrong

D.1. General Information

What is SilkPage
For whom is SilkPage intended
I don't know anything about XML, can I still use SilkPage
What are the differeces between SilkPage and DocBook Website
On what is SilkPage based
What is the relation between SilkPage releases and DocBook Website

What is SilkPage

Refer to Section 1, “What is SilkPage?” section.

For whom is SilkPage intended

SilkPage is for everyone who believes in Open Standards, XML and quality. The only pre-requisite to use SilkPage is some basic knowledge of XML, to be able to encode your website content. While the SilkPage software is well documented, it's (cuurently) based on a command line executions. If you can't sand command line executions, then SilkPage is not for you.

I don't know anything about XML, can I still use SilkPage

No, to use SilkPage, you need to provide your Website content in XML format. Therefore, you need to know the XML (very) basics. Refer to A Technical Introduction to XML to get started.

What are the differeces between SilkPage and DocBook Website

SilkPage is based on DocBook Website. Both applications share almost the identical features, such as Website publishing. However, SilkPage provides some extra features:

On what is SilkPage based

SilkPage is mainly based on DocBook Website.

What is the relation between SilkPage releases and DocBook Website

Piror to every release, SilkPage team takes the current version of DocBook Website releases, makes modifications (if necessary), and prepares its own release. The DocBook Website output may have a different look/feel than SilkPage output. Moreover, SilkPage provides extra features not present in DocBook Website.

D.2. Usage and Customization

How do I create my first Website
How do I migerate my website from DocBook Website to SilkPage
How can I change the link labels of the footer items generated by SilkPage
SilkPage generates a Google based search field for my website, how can I turn it off
What is RSS
What are all RSS formats and versions ? Which one should I choose

How do I create my first Website

  1. Section 1.1, “Create Site Scratch” Create a brand new site from scratch

  2. Section 1.2, “Create Site Layout” Structure your Website by organizing your XML content

  3. Section 1.3, “Create Site Pages” Create XML source pages and content

How do I migerate my website from DocBook Website to SilkPage

SilkPage is based on DocBook Website. The only thing you need to do to port your website to SilkPage is to copy the content of your website under $SILKPAGE_HOME /src/en. Note that en is the two letter ISO code for languages. You can use the language of your choice. Refer to default.lang for valid language codes.

How can I change the link labels of the footer items generated by SilkPage

Refer to Section 3.2, “Page Source Link Items Parameters” to learn how you can control this feature.

SilkPage generates a Google based search field for my website, how can I turn it off

Refer to Section 3.1, “Search Field Parameters” to learn how you can control this feature.

What is RSS

RSS is a format for syndicating news and the content of news-like sites, including major news sites like Wired, news-oriented community sites like Slashdot, and personal weblogs. Refer to All About RSS for a complete desciption.

What are all RSS formats and versions ? Which one should I choose

There are 0.90 and 0.91 by Netscape , 1.0 by RSS-DEV and 0.9x and 2.0 by UserLand Software . Refer to the What's RSS Article to find out more.

D.3. Installation

What is required to run SilkPage
How do I install the SilkPage software
On what platforms SilkPage can be installed and run
I can't even run SilkPage with the config target to test my installation, what's wrong

What is required to run SilkPage

Refer to Section 1, “System Requirement”.

How do I install the SilkPage software

It's simple, for all platforms you can download the .zip archive file and unpack it on the hard disk using your favorite tool. See Section 3.2, “Installing SilkPage Distribution” for more information.

On what platforms SilkPage can be installed and run

Any operating system supporting Java (J2SE), Standard Edition. However, it should be mentioned that we use GNU/Linux as our reference operating system.

I can't even run SilkPage with the config target to test my installation, what's wrong

The most common hiccup is when $JAVA_HOME or/and $ANT_HOME are not set. Make sure that you have done the following before installing and running SilkPage:

  1. Download the J2SE release (version 1.4 or later) from: http://java.sun.com/j2se

  2. Install the J2SE according to the instructions included with the release.

  3. Set an environment variable $JAVA_HOME to the pathname of the directory into which you installed the J2SE release.

  4. Download the ant release (version 1.6.1 or later) from: http://ant.apache.org

  5. Install Ant according to the instructions included with the release.

  6. Set an environment variable $ANT_HOME to the pathname of the directory into which you installed the ANT release.

In addition, make sure that Section 1.2, “DocBook Parameters” are set correctly.