How to generate a static site using Wyam

I use Wyam to statically generate this site. This is to document the steps I take to run Wyam locally, test my posts and push the site to GitHub:

I have a directory structure that looks like this:

The Input directory looks like this:

I place my posts in Markdown in the posts directory.

The run.cmd contains the following:

@echo off

..\..\Wyam-Exec\Wyam-v0.15.1-beta\Wyam.exe -r Blog -t CleanBlog -pw

This assumes that:

• I have Wyam-Exec directory two directories above my blog directory
• I have different Wyam versions I can test with. For example, I am using a beta version here

The config.wyam contains the following:

Settings.Host = "khaledhikmat.github.io";

GlobalMetadata["Title"] = "Khaled Hikmat";

GlobalMetadata["Description"] = "Coding Thoughts";

GlobalMetadata["Intro"] = "Software old timer";

GlobalMetadata["Image"] = "images/liquid.jpg";

This drives the site's metadata.

While I am in my blog directory, I open up a command box and type:

cmd

This starts Wyam, launches its internal web site listening on port 5080 and it also monitors the input directory for any changes. I add my blogs, edit them and test locally using the 5080 site.

Once I am satisfied, I copy the content of the output directory:

and paste it into my site GitHub pages structure and replace all files. To publish to GitHub, I issue the following git commands:

git add --all

git commit -am "Added/Edited new/existing posts"

git push

This publishes my changes to GitHub pages.