|
|
This document has been specifically created for users of Anakia.
If you use Anakia to generate a website for your project, you
can easily migrate to Maven and automatically inherit a great
look and feel designed by CSS experts. This is an ideal
opportunity for you to start integrating Maven into your
project. Using Maven is not an all or nothing scenario, with
very little effort you can use Maven to generate only your site
documentation. As you become more familiar with Maven, you can
then slowly start utilizing other features of Maven.
これは、Anakiaのユーザ向けの文書です。
現在Anakiaでプロジェクトのウェブサイト構築して方は、簡単にMavenに移行できます。
同時に、CSSのエキスパートがデザインしたすばらしいルック&フィールを受け継ぎます。
これは、Mavenをプロジェクトに統合する理想的な機会です。
Mavenを使用するということは、すべての機能を使用するかどうかではないのです。
ほんの少しの労力を払えば、サイトドキュメンテーションを生成する機能だけを使用することが出来ます。
そして、Mavenに慣れたあとで、段々と他の機能を使い始めることが出来ます。
The process of creating a Maven-generated site from your Anakia
documentation is outlined below:
Anakia文書からMavenでサイトを生成するまでのプロセスの概要は、以下の通りです:
-
Install Maven on your system. Please refer to the
Getting Started
documentation for assistance.
システムにMavenをインストールします。
詳しくは初めにを参照して下さい。
-
Create a project descriptor and then add Maven delegators to
your build file. Please refer to the Integration
document for
assistance. You'll also be able to change the default colors
used by Maven when generating your site by setting the
appropriate properties. If you are only interested in using
Maven for the generation of your site (and not compilation),
you do not have to complete the <build> element
section of the project descriptor.
プロジェクトディスクリプタを作成して、ビルドシステムに
Mavenのデリゲータを追加します。
詳しくはMavenの統合を参照して下さい。
また、Mavenがサイトを生成するときのデフォルトの色を変更するプロパティがあります。
サイトの自動生成機能だけを使うなら(コンパイルしないなら)、
プロジェクトディスクリプタの <build> エレメントは不完全なもので構いません。
-
Use Maven to generate your site by invoking the
maven site:generate
Ant target. You can also
automatically deploy your site to a web server with
maven site:deploy
.
maven site:generate のAntターゲットから
Mavenを起動してサイトを生成します。
maven site:deploy と起動することで、自動的にサイトを
Webサーバに公開できます。
If your project does not store its documentation in the
xdocs
directory located in the base directory of
the project, you'll have to define the Ant property
${docs.src}
in a properties file or via the command
line to point to the appropriate location.
プロジェクトのドキュメンテーションが、基準となるディレクトリ直下の
xdocsディレクトリに置かれていなければ、
propertiesファイルかコマンドラインで、Antの${docs.src}
プロパティに正しい場所を設定する必要があります。
Prior to writing this document, several random Jakarta projects
were selected and their documentation was generated using Maven
to demonstrate how easy it is to switch from Anakia to Maven.
Give it a try, we promise you'll like it!
この文書を作成するのに先立って、AnakiaからMaven
に切り替えるのがどれだけ簡単か実演するために、
いくつかのJakartaプロジェクトをランダムに選択して、
Mavenを使ってドキュメンテーションを生成してみました。
試してみて下さい。きっと気に入るはずです。
|
