strlog is a static site server

This project serves blog posts using the built-in http module provided by the NodeJS standard library. In addition, it parses markdown files to provide page styling and supports tags for organizing posts. The github repository itself serves as a content repository. When set up with a CI pipeline, publishing a post is as simple as pushing a git commit.

hosting your own copy:

• Pull a release from the release branch. This branch is updated with features but purged of my own personal posts.
• Unzip the archive.
• Navigate to the root directory and run npm start local. The server will default to port 5000.

roadmap

3. hyperlink list pagination
4. routing cleanup
5. linktree style homepage styled off the error route
6. full markdown parsing

caveats

Markdown parsing is an audacious claim for what is really just a series of regex string replace calls. It is not possible to fully cover the mardown spec this way because it is not context-aware. Sufficiently complex Markdown will break the "parser".

directory structure

The repository contains the following important directories:

• ./posts: holds directories titled with the date in ISO 8601 format representing a single blog post each. Two files are required:
  • A Markdown file called post.md.
  • A JSON file with three attributes: the post name, title, and an array of topics which may be empty.
  • Additionally, you may add any resources, such as photos, to this directory.
  • A special directory called "about" holds the content for the about page.
• resources: holds template html files, the favicon, an icon for link embeds, fonts and CSS.
• src: source code, split roughly into routing / file reading (server.js) and markdown parsing / html building (format.js).
• test: holds the unit tests.

Licenses

Code original to the project is licensed under AGPL with the exception of the SUSE font, which is covered under the Open Font License.