tericcabrel / oss-cameroon-blog

The place where cameroonian developers share their thoughts

OSS Cameroon Blog

Installation

Clone the project

git clone https://github.com/osscameroon/blog.git oss-blog
cd oss-blog
npm install

Development

First, run the development server:

npm start

Open http://localhost:3000 with your browser to see the result.

You can start editing the page by modifying pages/index.js. The page auto-updates as you edit the file.

Post

Frontmatter

Frontmatter follows Hugo's standards.

Currently 7 fields are supported.

title (required)
date (required)
tags (required, can be empty array)
lastmod (optional)
draft (optional)
summary (optional)
images (optional, if none provided defaults to socialBanner in siteMetadata config)
authors (optional list which should correspond to the file names in `data/authors`. Uses `default` if none is specified)
layout (optional list which should correspond to the file names in `data/layouts`)
canonicalUrl (optional, canonical url for the post for SEO)

Here's an example of a post's frontmatter:

---
title: 'OSS Cameroon vision'
date: '2022-05-20'
lastmod: '2022-05-22'
tags: ['open-source', 'community', 'guide']
draft: false
summary: 'This community has been created to solve an issue in the Cameroonian developer's community. This post explains our goal and where we want to go with this project.'
images: ['/static/images/post.jpg']
authors: ['default', 'tericcabrel']
layout: PostLayout
canonicalUrl: https://blog.osscameroon.com/posts/oss-cameroon-vision
---

Compose

Run the command below to create a new post. Follow the interactive prompt to generate a post with pre-filled front matter.

node ./scripts/compose.js