Genicsblog.com is the open-source Jekyll repository behind Genics Blog, a developer publication that publishes technical articles from multiple authors.
What is Genicsblog.com?
Genicsblog.com is the static site repository for Genics Blog, an open-source developer publication. It holds all the blog content and static pages, and it hosts the CI/CD workflow that builds the Jekyll site and deploys it. The repository is maintained by the Genics Blog team, with theme-related setup kept separately in the theme-files repository.
Key Features
- Open-source publication — All content and site code are publicly available; the site content excluding _posts is licensed under CC BY-SA 4.0, while individual posts belong to their respective authors.
- Jekyll static site — The site is built with Jekyll, producing a fast, static website; posts are written in Markdown and organized under _posts in author-specific folders.
- Structured content directories — _posts for published articles, _drafts for unpublished drafts, _series for series pages that group related articles, and _data for site metadata.
- CI/CD workflows — The .github directory contains workflows for building and deploying the site, plus issue and pull request templates for contributors.
- Author publishing workflow — Writers configure their profile, open a Submission Request issue, get approval, create a draft, and the team reviews and publishes it with small grammar/SEO/styling edits.
- Local development script — Running ./dev.sh clones the theme files, installs Ruby and Node dependencies, and serves the site at localhost:4000; it requires Ruby 3.x and Node.js 16.x.
- Separate theme repository — Styling and feature requests are handled in the theme-files repo, keeping content (this repo) and presentation (theme-files) concerns distinct.
Who is it for?
- Technical writers — Developers who want to publish articles on a developer blog can submit posts, have them reviewed, and get them published with SEO and styling polish.
- Open-source contributors — People who want to improve the site's CI/CD, fix content issues, or refine the publication workflow can open issues and submit pull requests in this repo.
- Jekyll site maintainers — Developers looking for a working example of a multi-author Jekyll publication with a structured content pipeline and automated deployment can study this repository's layout and scripts.
What can you do with it?
- Publish an article — Set up your author profile, submit a request, draft your post, and get it published after team review.
- Run the site locally — Clone the repo, install Ruby 3.x and Node.js 16.x, run ./dev.sh, and preview the site at localhost:4000.
- Manage series content — Create series pages under _series that group related posts together for readers.
- Contribute to site infrastructure — Propose changes to the CI/CD workflows or open issues about site-related discussions, while routing them to the appropriate repo.
How does it work?
The publishing workflow starts when an author configures their profile in the author docs. They then open a Submission Request issue in this repository. After approval, the author writes the article as a draft, and a team member reviews it, makes small edits for grammar, SEO, and styling, and publishes it.
FAQ
What are the prerequisites for local setup?
You need Ruby 3.x and Node.js 16.x installed. After that, run ./dev.sh from the repository root. The first build clones the theme-files repository and installs dependencies, and subsequent builds are faster.
How do I publish a post on Genics Blog?
You must first set up your profile, then create a submission request by opening an issue with the Submission Request template. Once approved, you create a draft, notify the team, and they review and publish it.
What license applies to the site content?
The content under _posts belongs to the respective authors, and you should contact them for licensing questions. The rest of the site content (excluding _posts) is licensed under CC BY-SA 4.0.
Where should I report styling or feature requests?
Styling and feature requests belong in the theme-files repository, not this one. This repository handles article publishing PRs and CI/CD changes; general site discussions can be opened as issues here.
How can I get help?
You can open an issue in this repository or join the Discord server at discord.genicsblog.com. If you get a "bundle not found" error, install bundler with gem install bundler.
