Fork me on GitHub

Binary And Source Distributions

If you already know how to use Fulcrum and simply want the latest binaries or source, you can get them from the Apache Mirror System.

Building all Fulcrum components

Building Fulcrum from GIT is very easy because it has been Maven-enabled. To get all Fulcrum dependencies you may find it conveniet to get all of them in one repo. Therefore you would begin with turbine-fulcrum-build GIT repository (if you are not familiar with the Apache GIT repositories, please refer to the documentation).

        git clone --recurse-submodules https://github.com/apache/turbine-fulcrum-build.git  
You get all current Fulcrum components (thanks to git submodules) in one repo! Of course each fulcrum component has it's own repository. Find them in .gitmodules and select, what you want. eihter using the gitbos repo URLs or the github repo
        git clone  https://gitbox.apache.org/repos/asf/turbine-fulcrum-parser.git
        // equivalent
        git clone https://github.com/apache/turbine-fulcrum-parser.git 

Maven 3 Build

Please refer to the Maven 3 Getting Started document for instructions on how to install and use Maven.

From the root directory of the Fulcrum project (where you checked out the code to or unpacked a source distribution), simply run

        mvn install 
This will start a process that will build each component. After the component is built, it will be installed into you local maven repository.

To build a local copy of the documentation, use this:

        mvn site   
This will build a local copy of the web site in the 'target/site' directory. Note, this uses a LOT of memory. If you can't build all of them, build them individually.

Current Build Issues

Depending on your version of Maven, you may have various problems with the reports being generated, or you may run out of memory when you do a complete build. One approach to take is to turn off running unit tests

    $  mvn site -DskipTests=true
and/or excluding various components:
    $  mvn -pl parser,crypto site