Overview

Genics Blog is an open-source developer publication that allows authors to publish their content on the blog. The repository holds all the content for the blog, including static pages, and also hosts the workflow for building and deploying the Jekyll site. The theme-related setup for the site is done in the theme-files repository.

Features

• Open-source developer publication
• Allows authors to publish their content on the blog
• Workflow for building and deploying the Jekyll site
• Hosts static pages of the site
• Theme-related setup in the theme-files repository
• Structured repository with separate folders for drafts, published posts, and series pages
• CI/CD workflows with issue and pull request templates
• Metadata used by the site stored in the _data folder

Installation

To set up the local environment and build the website, follow these steps:

1. Install Ruby (preferably version 3.x) and Node.js (preferably version 16.x).
2. Run the dev.sh script to clone the theme files and install the required dependencies.

   ./dev.sh
   

3. The first build may take a few moments. Once completed, you can preview the site at localhost:4000.
4. Subsequent builds should be faster.

If you encounter any issues, here are some troubleshooting steps:

• If you get a permission error, provide correct permissions to the bash script by running:

  chmod +x dev.sh
  

  Then try running ./dev.sh again.

• If you receive an error stating that the command bundle is not found, make sure you have Ruby installed. Then, run the following command to install bundler:

  gem install bundler
  

  After the installation, run ./dev.sh again.

Feel free to open an issue or join the Discord server for assistance.

Summary

Genics Blog is an open-source developer publication that provides a platform for authors to publish their content. It offers a structured repository for managing blog posts, static pages, and series pages. The installation process involves setting up Ruby and Node.js, and running a script to clone theme files and install dependencies. Overall, Genics Blog offers an accessible and collaborative platform for developers to share their knowledge and insights.