pblasucci / pblasucci.github.io

Paul Blasucci's Weblog

paul.blasuc.ci (née pblasucci.github.io)

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:

1. Draft... Heavy on creative flow; light on structure/editing/proofing/presentation/etc.
2. Ready... Thoughts crystallized; focus is on editing, proofing, and presentation.
3. 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 provider 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