User:
Password:

showWiki Markup Help

Headings

=Heading1=

==Heading2==

===Heading3===

Inline

** strong **

__ emphasis __

$$ code $$

^^ ^superscript ^^

~~ _subscript ~~

Blocks

* unordered list item

+ numbered list item

{{{verbatim text}}}

|| table || cells ||

-- horizontal line

Q: quoted block

> a quoted line

{{style='background-color: red'}} block

Links

http://external.link/

[URL | label]

[/internal/path | label]

Macros

$image(src=path float=left|right)

{code lang="XQuery"} code block {/code}

Installation and Setup

Posted by editor on October 21, 2007 at 22:23; Wiki ID: Installation

Installing the .war Distribution

The .war distribution can be easily deployed into an existing servlet engine like Tomcat or Jetty. The distribution already contains a prepared database, so no additional configuration is required.

After installation, you can log in with the default user: editor, password: atom.

Building from Source

Prerequisites

AtomicWiki requires a recent build of eXist from SVN. The best choice is the eXist-memproc branch, at least until it has been merged into SVN trunk.

You need to compile eXist first.

Back in AtomicWiki, edit build.properties and change exist.home to point to your eXist installation directory.

Building

Call build.sh or build.bat in the AtomicWiki directory with the setup target, e.g.:

C:\Source\AtomicWiki>build.bat setup

The setup process includes 3 steps:

copy necessary jars from the eXist installation into the local directories
build a few extra Java classes needed by the wiki
initialize the database with default content and upload the required configuration data

Start the Server

Call startup.bat or startup.sh to launch the included web server.

If everything worked correct, you should be able to browse to

http://localhost:8000/

Generating a .war Archive

Calling ant with target "war" creates a file atomic.war in the root directory. This can be deployed into an external servlet engine like e.g. tomcat.

Other Settings

The file configuration.xml specifies a number of settings which are required for the wiki to run properly. The document is read from the database collection /db/atom and can be edited there, though this should not be necessary on a default installation.

Most important, the base-uri attribute specifies an absolute URI pointing to the current web application context, e.g. http://localhost:8000/. The XQuery scripts will try to guess this value if it is left empty. However, when moving the web application to a different context, it might become necessary to adjust the base-uri manually.