Graze

Graze is a static site generator. It takes a template and a configuration file and generates a static web site. The generated site is pure HTML / CSS / JavaScript and can be hosted on any web server. The Graze templates are created using the Razor Syntax.

Getting started

Download and extract the Graze. It comes with an example.
Run graze.exe.

The static site (index.html) is generated into the output folder.

NuGet

Graze is also available from the NuGet. To get started, first create a new “Empty Project” with Visual Studio and then add the Graze using NuGet. Graze.exe and the template-folder are installed into the root of your project.


Install-Package graze

Examples

The GrazeWP7 uses Graze to generate marketing sites for Windows Phone 7 applications.

Graze templates

The Graze templates are created using the Razor syntax. Here’s an example:


<html>
<head>
    <title>@Model.Title</title>
</head>
<body>
    <h1>@Model.Description</h1>
</body>
</html>

Graze configuration

The configuration for Graze is done in XML. Here’s an example configuration:


<?xml version="1.0" encoding="utf-8" ?>
<data>
	<site>
		<Title>Graze</Title>
		<Description>Graze: Static site generator using Razor</Description>
	</site>
</data>

The configuration file represents the data which is injected to the generated static site.

Generating the static site

Once the Graze template and the configuration file are in place, the static site can be generated running the graze.exe. The static site is generated into the output-folder.


<html>
<head>
    <title>Graze</title>
</head>
<body>
    <h1>Graze: Static site generator using Razor</h1>
</body>
</html>

Features

Dynamic configuration

The configuration.xml represents the data which is shown on the generated site. In the template you can access a configuration parameter using the @Model-keyword. New configuration options can be added freely and old ones can be removed.

Lists and loops

Lists can be created in XML and accessed in the Graze template. Example XML:


  <Features>
    <Feature>Layouts defined using Razor syntax.</Feature>
    <Feature>Dynamic data models created in XML.</Feature>
    <Feature>Supports complex data models and arrays.</Feature>
    <Feature>Fast static site generation.</Feature>
    <Feature>Pure HTML / CSS / Javascript output. Host in Apache, IIS etc.</Feature>
  </Features>

Example template for accessing the list:


    <h2>Features:</h2>
    <ul>
        @foreach (var feature in Model.Features)
        {
            <li>@feature</li>
        }
    </ul>

Ifs

The programming language behind the Graze template is C# so if and if-else statements are available. Given the following configuration:


  <Family>
	<Member Age="50">Saul</Member>
	<Member Age="31">Claire</Member>
	<Member Age="11">John</Member>
  </Family>

We can output different HTML from our template based on the member’s age


	@foreach(var member in @Model.Family)
	{
		var membersAge = int.Parse(member.Age);
		
		if (membersAge >= 18)
		{
			<p>@member.Member is an adult</p>
		}
		else
		{
			<p>@member.Member is a child</p>
		}
	}

Generated output:


			<p>Saul is an adult</p>
			<p>Claire is an adult</p>
			<p>John is a child</p>

Complex types

By default all the data in the XML is of type string when accessed from the template. But complex types can be created also:


<Link Url="https://github.com/mikoskinen/graze">Source code hosted in GitHub</Link>


<a href="@Model.Link.Url">@Model.Link.Link</a>

Case sensitive

The configuration and the templates are case sensitive.

Extras

The Graze’s core can create the site’s model from the configuration file’s site-element. But, the model can be enhanced using extras. Graze comes bundled with the following extras:

Markdown
HTML
RSS
YouTube

The example template bundled with the Graze shows how to use these model enhancers.

Folder structure

Graze expects the following folder structure:


graze.exe
--template/
----configuration.xml
----index.cshtml
----assets

The assets folder is copied wholly to the output folder. The assets folder can include the CSS / JSS / image files required by the template.

License


MIT License
Copyright (C) 2012 Mikael Koskinen

Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in
the Software without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
of the Software, and to permit persons to whom the Software is furnished to do
so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

RazorEngine

Graze uses the RazorEngine.

RazorEngine is available under MS-PL.

MarkdownSharp

Graze uses the MarkdownSharp.

MarkdownSharp is available under MS-PL.

strogo / graze Goto Github PK

graze's Introduction