Congelato 1.3.0

Congelato

Razor based static site generator

Parameters

-i input directory

-o output directory

-c site config

-a comma seperated list of assemblies you want to add to the build

Example usage

congelato -i _stevenpearsdev -o stevenpearsdev -c _tshapeddev.yml -a newfeature.dll

Site structure

Congelato tries to run similar to other site generators so that it's easy to transfer.

So from the input directory it expects a structure like this

inputDir
  _posts
  _pages
  _layouts

all other files and directories are copied as-is

Site Config

The config file also tries to adhere to rules set by other generators. There is a data property for adhoc information too

url: tshaped.dev
title: tshaped.dev
description: >
  The geeky ramblings of Steven Pears.<br/>
  Mostly .NET and Alexa based.
data:
  steve: pears

Layouts

Layouts can be nested - everything after the yaml block at the top is the .NET template, so using statements go after the yaml, not at the very top.

As a base layout or page - the next piece of content in the chain is always rendered by the statement @await Content()

An example layout:

---
layout: default
---
<%
using AddedAssemblyNamespace;
%>
<div class="container">
    <div class="row">
      <div class="col-lg-8 col-md-10 mx-auto">
        @await Content()
      </div>
    </div>
  </div>

  <hr>

Posts

posts are a similar thing with most popular config options applied, they also have the data element for other information. If posts have a markdown extension they will be converted to HTML for you

example post

---
title: Introducing Alexa.NET - Screencasts
date: 2019-12-30T12:22:00
author: Steven Pears
layout: post
permalink: /2019/12/30/introducing-alexa-net-screencasts
tags:
  - alexa
  - video
  - 'c#'
---
So I got a request on [Twitter](https://twitter.com) from a user ...