forrest seed-business メモ

Using Forrestにあまり記載されていない、

$ forrest seed-business

に関するメモです。

必要事項を対話的に聞かれるので、回答していきます。

  • getProjectProperties: このプロジェクト(サイト)に関する情報です。
  1. What is the name of the project you wish to create a site for?
  2. Provide a brief description of the project.
  3. What is the domain for this project (not including protocol)?
  4. What is the URL for this project?
  • getGroupProperties: このプロジェクトが所属するグループに関する情報です。
  1. What name of the group you wish to create a site for?
  2. Provide a brief description of the group.
  3. What is the domain for this group (not including protocol)?
  4. What is the URL for this group?
  5. Who is the copyright owner of the site?
  • getSearchProperties: サイト内に設置する検索ボックスに関する情報です。
  1. Which search provider would you like to use? ([google], lucene)
  2. Where would you like the search box to be located? ([default], all, alt)

静的サイトを作成するために、次のコマンドを実行します。

$ forrest site

そのまま実行すると、いくつか「BROKEN: 」と表示されます。 必要に応じてコンテンツを作成するか、当該ページをコメントアウトすることでエラーがなくなります。

$FORREST_HOME/src/documentation/content/xdocs/site.xml

(略)
<!-- all label="All Team Members" href="all.html" description="The Apache Forrest JP team members organized by skill"/ -->
<!-- bySkill label="Team Skills" href="allBySkill.html" description="The Apache Forrest JP team members organized by skill"/ -->
<!-- withForrestSkill label="Apache Forrest" href="allWithSkill/Apache Forrest.html" description="The Apache Forrest Apache Forrest JP team members"/ -->
<!-- withForrestSkill label="Technical Authoring" href="allWithSkill/Developer Manuals.html" description="The Technical Authoring Team"/ -->
(略)

また、PDFに関するエラーが表示される場合、

fo:basic-link, Missing attribute:  Either external-destination or internal-destination must be specified.

PDFを作成しないように設定します。

$FORREST_HOME/src/documentation/skinconf.xml

(略)
<disable-pdf-link>true</disable-pdf-link>
(略)

これでエラーが出なくなるので、必要なコンテンツを作成していきます。