13. Modify Web Site

The Trafodion website uses the following technologies:

• Framework: Apache Maven Site
• Skin: Reflow Maven Skin
• Theme: Bootswatch Cerulean
• Markdown: markdown (markdown was chosen since it supports in-line HTML, which provides better table control than APT. Asciidoc does not work well with the Reflow Maven Skin; we tested.)

The code is located in the docs directory. The code organization follows the Maven standard.

• docs/src/site.xml is configured per the Reflow Maven Skin documentation. Pages and menus are defined and configured in this file. By default, all pages use an automated table of contents; override as needed.
• docs/src/site/markdown contains the files that generate the different HTML files.
• docs/target contains the generated HTML files after you run a build.

You add/rename/delete pages in docs/src/site/markdown. You make corresponding changes in docs/src/site.xmladding/renaming/deleting pages from menus and defining page configuration; for example: removal of the table of contents bar and the special page formatting provided by the Reflow skin. Refer to the Maven Documentation for more information.

When possible, ensure that you write in active voice and to the point.

Special functions such as buttons etc. can be access by clicking Preview in the theme preview. There’s a <> feature on each function, which allows you to copy the special <div> you need to insert the selected object.

Typically, you’ll use Eclipse to develop and build the website pages. The configuration goal is: clean site. The pom.xml file in the top-level directory drives the build steps for the web site.

The website files are located in docs/target. Open index.html from your browser and test your changes. For example, you want to validate the page layout, page navigation, links, and review the overall content on the pages you modified or added/deleted.

Tables

markdown supports a simple format for tables. You can use markdown-style writing in such tables.

    Table Header   | Table Header
    ---------------|---------------
    Text           | Text
    Text           | Text

However, no special formatting can be done; for example, creating a bulleted list in a cell. If you need tables with such formatting, then you will need to define the table in raw HTML format. No markdown-style writing is supported for HTML tables; use pure HTML tagging instead.

Call-Out Boxes

You can create a simple callout box using an HTML table.

Example

<table><tr><td><strong>NOTE</strong><br />Whatever you want to say here.</td></tr></table>

Generates

Publishing