cff-version: 1.2.0
message: "If you use this software, please cite it as below."
type: software
title: BlogIt
abstract: "__BlogIt__ is a command line program for curating front matter in CommonMark (Markdown) documents used in producing a blog. __BlogIt__ primary purpose is curating the fornt matter 
posts. It also supports a preprocessor for handling markdown linked files as HTML linked files and code include blocks. Additional functionality includes editing, checking and 
publishing the CommonMark document to a blog directory structure.

Here's an example of creating a blog from scratch while levaraging __BlogIt__.

~~~shell
# Pick an editor, example nano in the case
export EDITOR=nano
mkdir -p $HOME/Site/website/blog
cd $HOME/Site/website
# Create your first post
nano $HOME/Documents/FirstPost.md
# Create/curate the Front Matter for your first blog post
BlogIt edit $HOME/Documents/FirstPost.md
# Check to make sure everything is ready to go
BlogIt check $HOME/Documents/FirstPost.md
# Publishing into your blog's directory tree
BlogIt $HOME/Document/FirstPost.md
# See the blog post ready in your blog directory
tree blog
~~~

Run a Common Mark to HTML converter like Pandoc on the Common Mark files to produce HTML. Then you're ready to run [PageFind](https://pagefind.com) for search and 
[FlatLake](https://flatlake.app) to render your blog's JSON API."
authors:
  - family-names: Doiel
    given-names: Robert
    orcid: https://orcid.org/0000-0003-0900-6903
    email: rsdoiel@gmail.com

contacts:
  - family-names: Doiel
    given-names: Robert
    orcid: https://orcid.org/0000-0003-0900-6903
    email: rsdoiel@gmail.com

repository-code: "https://github.com/rsdoiel/BlogIt"
version: 0.0.3
date-released: 2025-07-28

license-url: "https://www.gnu.org/licenses/agpl-3.0.html#license-text"
keywords:
  - blog
  - front matter
  - CommonMark
  - Markdown

{
  "@context": "https://w3id.org/codemeta/3.0",
  "type": "SoftwareSourceCode",
  "codeRepository": "https://github.com/rsdoiel/BlogIt",
  "author": [
    {
      "id": "https://orcid.org/0000-0003-0900-6903",
      "type": "Person",
      "givenName": "Robert",
      "familyName": "Doiel",
      "email": "rsdoiel@gmail.com"
    }
  ],
  "maintainer": [
    {
      "id": "https://orcid.org/0000-0003-0900-6903",
      "type": "Person",
      "givenName": "Robert",
      "familyName": "Doiel",
      "email": "rsdoiel@gmail.com"
    }
  ],
  "dateCreated": "2025-07-12",
  "dateModified": "2025-09-13",
  "datePublished": "2025-09-13",
  "description": "__BlogIt__ is a command line program for curating front matter in CommonMark (Markdown) documents used in producing a blog. __BlogIt__ primary purpose is curating the fornt matter \nposts. It also supports a preprocessor for handling markdown linked files as HTML linked files and code include blocks. Additional functionality includes editing, checking and \npublishing the CommonMark document to a blog directory structure.\n\nHere's an example of creating a blog from scratch while levaraging __BlogIt__.\n\n~~~shell\n# Pick an editor, example nano in the case\nexport EDITOR=nano\nmkdir -p $HOME/Site/website/blog\ncd $HOME/Site/website\n# Create your first post\nnano $HOME/Documents/FirstPost.md\n# Create/curate the Front Matter for your first blog post\nBlogIt edit $HOME/Documents/FirstPost.md\n# Check to make sure everything is ready to go\nBlogIt check $HOME/Documents/FirstPost.md\n# Publishing into your blog's directory tree\nBlogIt $HOME/Document/FirstPost.md\n# See the blog post ready in your blog directory\ntree blog\n~~~\n\nRun a Common Mark to HTML converter like Pandoc on the Common Mark files to produce HTML. Then you're ready to run [PageFind](https://pagefind.com) for search and \n[FlatLake](https://flatlake.app) to render your blog's JSON API. It also works with [antennaApp](https://rsdoiel.github.io/antennaApp).",
  "keywords": [
    "blog",
    "front matter",
    "CommonMark",
    "Markdown"
  ],
  "name": "BlogIt",
  "license": "https://www.gnu.org/licenses/agpl-3.0.html#license-text",
  "programmingLanguage": [
    "TypeScript"
  ],
  "runtimePlatform": "Deno >= 2.5.0",
  "softwareRequirements": [
    "Deno >= 2.5.0",
    "Git >= 2.3"
  ],
  "softwareSuggestions": [
    "CMTools >= v0.0.40",
    "Pandoc >= 3.6"
  ],
  "version": "0.0.5",
  "developmentStatus": "wip",
  "issueTracker": "https://github.com/rsdoiel/BlogIt/issues",
  "releaseNotes": "Added release process, now supporting easy command line install via curl or irm.",
  "copyrightYear": 2025,
  "copyrightHolder": "R. S. Doiel"
}