Skip to content

pblasucci/pblasucci.github.io

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

78 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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 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