A Jekyll theme customized for the puzzleduck.org blog
JekyllBlog
jekyll-theme-puzzleduck — Jekyll Blog Template
By PuZZleDucK
A Jekyll theme customized by PuZZleDucK for the personal blog puzzleduck.org, based on Minima and using Materialize, under the MIT license.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Desktop homepage1 / 3
Desktop captureTop of page
Actual screenshot captured by the server browser.
All pages & views 3
Screenshots show visual appearance; interactive behavior may differ.
Recorded 2026-10-03View source
What stands out
A quick read of the recorded project description.
Based on Minima and uses Materialize
Distributed as a gem, integrated via the Gemfile and the theme configuration option
Supports configuring linkedin_username, android_username, copyright_name, copyright_email, and source_url in _config.yml
Post front matter supports title-image, reading images under /assets/img/
Under the MIT license
Template Details
jekyll-theme-puzzleduck is a Jekyll theme written by PuZZleDucK for the puzzleduck.org blog. The repository contains only the theme itself, and the author states in the README that it is based on Minima and uses Materialize. The theme is distributed as a gem; installation is done by adding gem "jekyll-theme-puzzleduck" to the Jekyll site's Gemfile and setting theme: jekyll-theme-puzzleduck in the site configuration, then running bundle install; alternatively, run gem install jekyll-theme-puzzleduck directly.
For configuration, the README lists additional links and attribution items that can be set in _config.yml: linkedin_username, android_username, copyright_name, copyright_email, source_url. Each post requires a title-image in its front matter, pointing to an image under /assets/img/. The repository also includes development steps: clone the repository, run bundle install, add your own _posts, configuration files, and index.md, then preview with bundle exec jekyll serve.
The available information does not describe the theme's visual style details, the compatible Jekyll version range, or other configurable options beyond the fields above; the demo site is puzzleduck.gitlab.io/Development-Adventures. The repository was last updated in 2018, and no maintenance status statement is provided.
JekyllBlog
Is it right for your project?
Use Cases
- Building a Jekyll site for a personal blog and applying an existing theme
- Referring to the theme's configuration fields and front matter conventions to organize post images
- Cloning the repository locally, adding _posts and configuration files, then running jekyll serve to preview the theme
Suitable For
- Developers building personal blogs with Jekyll
- Users who need MIT-licensed theme code that can be freely modified
- Sites that want to include the theme as a gem and configure links and attribution information themselves
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Add gem "jekyll-theme-puzzleduck" to the Jekyll site's Gemfile, set theme: jekyll-theme-puzzleduck in the site configuration, then run bundle install.
- 2
Alternatively, install directly with gem install jekyll-theme-puzzleduck.
- 3
Configure linkedin_username, android_username, copyright_name, copyright_email, and source_url in _config.yml as needed.
- 4
Each post's front matter must provide a title-image, with the image placed under /assets/img/.
- 5
Local development: after cloning the repository, run bundle install, add your own _posts, configuration files, and index.md, then run bundle exec jekyll serve.
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version in the public repository under the MIT license; the free scope is the code of that version and does not mean external services or third-party assets are free.
Must comply with when using
- Free use, modification, commercial use, and distribution of this version's code are permitted.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
- The code is provided as is; warranties and liability limitations are governed by the original license and applicable law.
Additional costs & items to verify
- Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses and cannot be judged solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may incur separate charges.
View Original Text Basis
https://github.com/PuZZleDucK/jekyll-theme-puzzleduck/blob/master/LICENSE.txthttps://github.com/PuZZleDucK/jekyll-theme-puzzleduck/blob/master/README.mdPermission is hereby granted, free of charge
Original License Text
Compiled by DeepSeek based on repository license and README ·2026-10-03. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- GitHub
- Documentation and maintenance reference score
- Partly documented · 65 / 100
- Technologies
- Jekyll
- Website type
- Blog
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2018-03-18
- Screenshot last checked
- 2026-10-03
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies Jekyll as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Automatically checked against source and license rules; no manual editorial review.
Inspect the recorded source material
SHA-256: c1942d08a39fa3f1c81f6fe10c30ee4e80490ba715b72b126694fde4fc66dd36
2026-10-03T06:33:18.504Z
Source file / repository# jekyll-theme-puzzleduck
This is the Jekyll theme for the PuZZleDucK.org blog.
[Theme preview](https://puzzleduck.gitlab.io/Development-Adventures)
## Installation
Add this line to your Jekyll site's Gemfile:
```ruby
gem "jekyll-theme-puzzleduck"
```
And add this line to your Jekyll site:
```yaml
theme: jekyll-theme-puzzleduck
```
And then execute:
$ bundle install
Or install it yourself as:
$ gem install jekyll-theme-puzzleduck
## Additional configuration
Configure additional links in ```_config.yml```
- linkedin_username
- android_username
- copyright_name
- copyright_email
- source_url
For each post the following should be provided in the front matter
- title-image (an image from /assets/img/)
## Development
```bash
git clone https://github.com/PuZZleDucK/jekyll-theme-puzzleduck.git
cd jekyll-theme-puzzleduck
bundle install
# add some _posts, a config file and index.md for testing
bundle exec jekyll serve
```
## About
Based on Minima and using Materialize.
## License
The theme is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
Explore similar templates
Compare previews and descriptions within the same stack and category.
al-folio
A Jekyll academic homepage theme for scholars and researchers, with a clean responsive design and out-of-the-box support for publication lists, project showcases, CVs, and blogs.
Jekyll · Portfolio
minimal-mistakes
Minimal Mistakes is a two-column Jekyll theme for personal sites, blogs, project documentation, or portfolios.
Jekyll · Portfolio
Beautiful Jekyll
Beautiful Jekyll is a mature, easy-to-use Jekyll blog theme maintained by Dean Attali since 2015, with over 50,000 users.
Jekyll · Blog
jekyll-TeXt-theme
A customizable Jekyll theme for personal sites, team sites, blogs, projects, and documentation.
Jekyll · Blog
startbootstrap-clean-blog-jekyll
The official Jekyll version of Start Bootstrap's Clean Blog theme, offering a blog home page, about page, contact page, and sample post pages, with a Formspree-powered contact form.
Jekyll · Blog
So Simple
A minimal reading-oriented Jekyll theme by Michael Rose for personal blogs, portfolios, and long-form reading. It offers multiple layouts, microformat markup, Disqus comments, Google Analytics, Jekyll SEO Tag, three skins, and aggregation by year, category, and tag with a grid view.
Jekyll · Blog