...
Once you’ve made the desired changes, then do the following:
DCS and REST
...
Building an Individual Document
- Be sure to source env.sh, so that the TRAFODION_VER environment variable is defined.
- Build the document using
mvn clean site
...
- in the directory containing the document; for example:
dcs
...
- or docs/odb_user.
- If you have not previously built the JDBC drivers, the DCS and REST documents will give spurious errors about missing that dependency. The documents can be built fine, skipping over that dependency using
mvn -P'!jdbc' site
.
- If you have not previously built the JDBC drivers, the DCS and REST documents will give spurious errors about missing that dependency. The documents can be built fine, skipping over that dependency using
Verify the content in the generated
target
directory.The
target/index.html
file provides the entry point for the web book
...
.
For those that have API documentation, the
target/apidocs/index.html
file
...
is the entry point
...
.
- For those that have PDF, the
target/index.pdf
file contains the PDF version of the document.
Building the Entire Website, including Documents
- Be sure to source env.sh, so that the TRAFODION_VER environment variable is defined.
- Build everything using
mvn clean post-site
in the top-level directory.- As above, to skip over JDBC dependency, use
mvn -P'!jdbc' post-site
.
- As above, to skip over JDBC dependency, use
- Verify the contents in the generated
docs/target
directory.- All documents are in
docs/target/docs
directory.
- All documents are in
Other Documentation
- Build the document using
mvn clean site
against the directory containing the document; for example:docs/client_install
ordocs/odb_user
. Verify the content in the generated
target
directory. Thetarget/index.pdf
file contains the PDF version of the document whiletarget/site/index.html
contains the web-book version of the document.
...
Anchor | ||||
---|---|---|---|---|
|
...
The external version of the Trafodion Document Tree is published to http://trafodion.incubator.apache.org/docs. Please refer to Publish below.
...
The build version of the Trafodion Document Tree is located in docs/target/docs
, which is created when you build the Trafodion web site in Maven.
...
The Document Directories are copied under the Version Directories thereby creating the web-accessible Trafodion document tree.
Populate Trafodion Document Tree
The build version of the Trafodion Document Tree is populated as follows:
...
...
Run maven post-site
build step.
...
Run maven post-site
build step.
...
- Create Version Directories, if needed.
- Create Document Directories, if needed.
- Copy
$SQ_HOME/dcs/target/site/
to the appropriate Document Directories.
...
Run maven post-site
build step.
...
Run maven post-site
build step.
...
- Create Version Directories, if needed.
- Create Document Directories, if needed.
- Copy
$SQ_HOME/core/rest/target/site/
to the appropriate Document Directories.
...
Run maven post-site
build step.
Anchor modify-documentation-publish modify-documentation-publish
...
Info |
---|
Publication is done when a committer is ready to update the external web site. You do not perform these steps as part of checking in changes. |
Do the following:
- Build the web site.
- Build the different document as described in Making Changes above.
- Build the Trafodion Document Tree as described in Build Trafodion Document Tree above.
The resulting docs/target/docs/
directory is checked into the web-site SVN branchRefer to Website Publishing for how the website and documents get published.