Security Onigiri

Security Onigiri is a Jekyll theme for publishing translated articles, with a Bulma CSS frontend and a built-in admin panel for writing posts. It runs on Jekyll, the Ruby-based static site generator, and is hosted on GitHub at the security-onigiri/security-onigiri repository.

What is Security Onigiri?

Security Onigiri is a Jekyll theme that provides a complete blogging setup for translated articles. It takes Markdown posts with title, author, and original-link metadata and generates a static site styled with Bulma CSS. The theme includes an admin panel at /admin, letting you create posts through a web interface. It's built for Jekyll 3+ and uses standard Ruby tooling with Bundler.

Key Features

• Admin panel — Access a web-based post editor at /admin on your local Jekyll server; create new posts by entering a title and clicking "New post".
• Metadata fields for attribution — Add your_name as the author and original-link as the source URL via "New metadata field" in the admin panel, so each translated article credits its original author.
• Bulma CSS styling — The frontend is built with the Bulma CSS framework, providing a clean, responsive layout out of the box.
• Simple local setup — Install Jekyll and Bundler, run bundle install and bundle exec jekyll serve, then browse to localhost:4000.
• GitHub Pages deployment — After committing changes, run ./deploy.sh to publish the site to https://security-onigiri.github.io.

Who is it for?

• Technical translators — Publish translated security or tech articles while keeping author credit and original links explicit in the post metadata.
• Jekyll users — Bloggers who prefer writing in Markdown but want a browser-based admin panel for quicker edits.
• Open-source contributors — Developers who want to fork the repository, add translated posts, and open pull requests; the included deploy.sh handles publishing.

What can you do with Security Onigiri?

• Create a translated article blog: Set up a Jekyll site locally, write posts in Markdown, and publish them to GitHub Pages with a single script.
• Manage posts from the browser: Use the admin panel to write and edit posts, add titles, and attach metadata fields like author and source URL without using Git.
• Collaborate via pull requests: Commit your changes or open a pull request to the repository, then run ./deploy.sh to update the live site.

How does Security Onigiri work?

1. Install Jekyll and Bundler, then clone the repository with git clone https://github.com/security-onigiri/security-onigiri.
2. Run bundle install to install dependencies, then bundle exec jekyll serve to start a local server at localhost:4000.
3. Open the admin panel at /admin, click "New post", enter a title, and add metadata fields such as author name and original link.
4. Commit your changes or open a pull request, then run ./deploy.sh to publish the site to https://security-onigiri.github.io/.

FAQ

Does Security Onigiri require Ruby?

Yes, because Jekyll is Ruby-based. You need to install Jekyll and Bundler first, then run bundle install to set up the theme's dependencies.

How do I deploy Security Onigiri to GitHub Pages?

Commit your changes, then execute ./deploy.sh from the repository root. The script publishes the static site to the GitHub Pages URL https://security-onigiri.github.io/.

Can I use Security Onigiri without the admin panel?

Yes. The admin panel is an optional web interface; you can also write posts directly as Markdown files in the _posts directory with the required front matter fields.

Is Security Onigiri free?

Yes, it's an open-source theme hosted on GitHub, so you can clone and modify it freely for your own site.