Flamel is a static-site generator written in F#. It is named after the scrivener and alchemist, Nicolas Flamel, as alchemy is the process of transmuting things into another form, much like a static site generator does.
- Visual Studio or MonoDevelop with the F# binding
- .NET/Mono 4.0 or higher
Once compiled, run the generator from the command line as follows and navigate to
http://localhost:8141 to view the generated site:
source-directory is a child of the current working directory. If no
source-directory is specified, the current working directory will be used.
Generated files are currently output to the same directory that the Markdown files they were generated from are located.
Flamel does not (currently) use any sort of templating language. The output page structure is built using partial regular HTML files in the
_includes directory of the source folder you specify. The included files are:
header.inc.html: should include an opening
<html>tag, an opening
<head>tag, any other elements that need to be placed in the
<head>section, and then the last line should be an opening
body.inc.html: should include a closing
<title>tag as the first line, any other elements that need to be placed in the
<head>section that you want after the
<title>, a closing
<head>tag, and an opening
nav.inc.html: should include whatever navigation you want, or you could leave it as an empty file if you want to put your navigation elsewhere (such as in your footer) without editing the order the pages are constructed in the generator
footer.inc.html: any page footer content you want should be placed here, as well as closing
If you want a certain string to appear either before or after your page title, you should specify that with the respective
Pages are structured as follows:
- Page title extracted from Markdown files (will be between
<title>tags and any text you specify)
- HTML page content extracted from Markdown files
A sample site can be found in the
This project's source code is licensed under the MIT License. See the LICENSE file for a copy of the full license.
It would be appreciated if you link back to this project page in the footer of your site or on a credits page of some sort if you use Flamel to build your website, however it is not required. The sample site's footer says "Alchemized by Flamel" for the link text, but you can choose to use something else if you want.
This project uses Tomas Petricek's F# Formatting library, which is licensed under the Apache License. A copy of the Apache License can be found in the
lib directory, along with the library DLL.
The sample site provided with this project includes Nicolas Gallagher's Normalize.css.