<@page title="FMPP - FreeMarker-based file PreProcessor" keywords="homepage"> <@sect title="What is FMPP?">

FMPP is a general-purpose text file preprocessing tool that uses FreeMarker templates. It process entire directories recursively. It can be used for generating complete static websites, source code, configuration files, etc. It can insert data from sources like CSV, XML, and JSON into the generated files. (You can add new kind of data sources in Java.) <@a href="qtour.html">See the Tutorial for a more concrete introduction.

FMPP can be used with UN*X-style command-line interface, or as Ant task, or can be embedded into your application using its Java API.

FMPP was written in Java, thus it runs on all modern platforms (Windows, "Linux", OS X, etc.).

FMPP is Free software under Apache License 2.0. <@a href="license.html">See license...

<@sect title="Features">

A quick list of FMPP capabilities:

<@sect title="Documentation"> <#if online>

This on-line documentation is for FMPP version ${pp.version} + FreeMarker ${pp.freemarkerVersion}. The full documentation of the version you are using can be found in the <@c>docs directory of the installed FMPP.

<@sect title="Download"> <#if online> <#macro downloadLink fileName> <#t> ${fileName}<#t> <#local rfile=basedir + pp.slash + "build/dist" + pp.slash + fileName /> <#if pp.realFileExists(rfile)> (${(pp.realFileSize(rfile)/1024/1024)?string("#0.0")} M) <#else> <#stop 'File to download missing: ${rfile}'>

The latest released version is FMPP ${pp.version} (comes with FreeMarker ${pp.freemarkerVersion}, but <@a href="installing.html#updatingFreeMarker">you can replace it with a later version).

Downloads include "binaries", all documentation, and source code.

<#t>

<@a href="installing.html">Installation instructions...

<@a href="versions.html">Change log (version history)...

FMPP is a Java application so it requires Java to be installed on your machine (version 5 or later).

The FMPP Apache Ant task (optional, seldom used nowadays) requires Ant 1.5.1 or later.

<#else>

To download the latest release, please visit the FMPP website: <@url href=fmppWebsite />

For <@e>text editor and IDE plug-ins and other FreeMarker template-related tools, please visit the FreeMarker homepage: <@url href=freemarkerWebsite />

<@sect title="Project history and status">

FMPP was mostly written in 2003 (so it predates Java generics, Maven-like dependency management, etc.), by a single guy (me), to automate some tasks at work. The code/design of my 15+ year younger myself (and of the era maybe) is funny/WTF at places, but it works, doesn't cut any corners, and was used quite heavily by many.

The project is in maintenance mode, but check the <@a href="versions.html">version history to see if it's still maintained. If you hit some blocker problem, it's likely that I will fix it and do a release. <@sect title="Contact">

Help: Ask on Stack Overflow with "fmpp" tag.

Suggestions: Use the Feature Request tracker, or write to <@myEmail />

<@reportBugs />