This repository contains the content and support files for my personal weblog. I follow a simple three-stage writing workflow (described here, mostly, so I don't forget the details). The three stages are as follows:
- Draft... Heavy on creative flow; light on structure/editing/proofing/presentation/etc.
- Ready... Thoughts crystallized; focus is on editing, proofing, and presentation.
- Final... Content is published; no changes (barring editorial corrections).
Each stage of the workflow has an associated folder in the repository. These folders will contain artifacts as follows:
Stage | Folder | Content |
---|---|---|
Draft | ./draft |
Markdown files |
Ready | ./ready |
A mix of HTML files and media (JPG, PNG, SVG, etc.) |
Final | ./docs |
A mix of HTML files, media (JPG, PNG, SVG, etc.), and styling (CSS) |
Finally, a small Powershell script, Move-Content.ps1
, is provided to facilitate moving between stages. Sample usage
is as follows:
Get a draft ready for publication:
PS ~> .\Move-Content.ps1 -Stage Render -Include some-cool-thing.md
Finalize content for release:
PS ~> .\Move-Content.ps1 -Stage Publish
By default, target files are selected by folder and extension. The -Include
and -Exclude
parameters help modify that:_
PS ~> .\Move-Content.ps1 -Stage Render -Exclude really-raw-idea.md
By default, target files are moved between stage folders. The -Preserve
switch turns promotion into a "copy" operation.
PS ~> .\Move-Content.ps1 -Stage Publish -Preserve