As a continuation of the farmOS.org Redesign, I have been working on adding support for tutorials and other community content on farmos.org, but the work stalled out in mid-January as other work took precedence. A minimal amount of work is required for its completion, though the cost above reflects the hours I’ve already accrued, plus the remaining time that I’ve estimated.
The main scope of the remaining work includes:
- Bug fix: Filter the “Home” path from the main navigation list
- Feature: List and link to all content posts at
- Feature: Render Front Matter in the markup for each post (see below)
- Feature: Install the plugins gatsby-plugin-sharp and gatsby-remark-images and enable images to be colocated with markdown files and referenced by their relative file address (eg,
- Test & deploy to Netlify
The issue of Front Matter is one I brought up in a previous topic, and as I mentioned there, I will start with just a few properties that seem essential:
title: The title of the post, required for this first pass, though later if someone wanted they could generate a fallback from the first heading.
date: Official publication date, in
yyyy-mm-ddformat, also required.
author: We could have a default like “Anonymous” or “farmOS Community”, or just make it required. Later this could also link to other posts by the same author and/or their bio, GitHub, Twitter, etc.
slug: The last segment of the URL’s path (eg,
intro-tutorial-to-farmos), probably optional since it would be easy to generate from the path of the markdown file or from the
canonical: Optional, and strictly not necessary for this first pass, but it’s trivial to add a
<meta>tag for this to the
<head>, so we may as well.
- Complete implementation of all features and bug fixes listed in the above description.
A prepared feature branch, containing those features, that is ready to merge into the
- A test branch with a link to a source repository that contains sample content for testing, if content is not already available for publication.