{"id":14979562,"url":"https://github.com/foggalong/wren","last_synced_at":"2025-10-28T18:31:54.713Z","repository":{"id":19965462,"uuid":"23232404","full_name":"Foggalong/Wren","owner":"Foggalong","description":"A page-like Jekyll theme","archived":false,"fork":false,"pushed_at":"2024-04-08T14:14:13.000Z","size":3685,"stargazers_count":3,"open_issues_count":8,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-10-11T19:41:30.299Z","etag":null,"topics":["blog-theme","jekyll","jekyll-blog","jekyll-theme-minimal","jekyll-themes","responsive-jekyll-theme"],"latest_commit_sha":null,"homepage":"https://foggalong.github.io/Wren","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Foggalong.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2014-08-22T16:46:36.000Z","updated_at":"2023-08-12T00:07:47.000Z","dependencies_parsed_at":"2024-04-08T15:41:04.187Z","dependency_job_id":"5f5a8859-c4d6-463c-ae55-afd7d970e01e","html_url":"https://github.com/Foggalong/Wren","commit_stats":{"total_commits":175,"total_committers":3,"mean_commits":"58.333333333333336","dds":"0.011428571428571455","last_synced_commit":"68d5b53a7eb8c85942834764fecbb97c70c21d70"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Foggalong%2FWren","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Foggalong%2FWren/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Foggalong%2FWren/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Foggalong%2FWren/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Foggalong","download_url":"https://codeload.github.com/Foggalong/Wren/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219859014,"owners_count":16556038,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blog-theme","jekyll","jekyll-blog","jekyll-theme-minimal","jekyll-themes","responsive-jekyll-theme"],"created_at":"2024-09-24T14:00:17.883Z","updated_at":"2025-10-28T18:31:54.702Z","avatar_url":"https://github.com/Foggalong.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Wren\n\n[![Jekyll CI Status]][jekyll-ci-link]\n[![CodeFactor Rating]][codefactor-link]\n[![Download Count]][ruby-toolbox-link]\n[![MIT Licensed]][license-link]\n\n[Jekyll CI Status]: https://github.com/Foggalong/Wren/actions/workflows/codeql-analysis.yml/badge.svg\n[jekyll-ci-link]: https://github.com/Foggalong/Wren/actions/workflows/codeql-analysis.yml\n[CodeFactor Rating]: https://img.shields.io/codefactor/grade/github/foggalong/wren/main?color\u0026label=CodeFactor\n[codefactor-link]: https://www.codefactor.io/repository/github/foggalong/wren\n[Download Count]: https://img.shields.io/gem/dt/jekyll-wren?color=bright-green\u0026label=Downloads\n[ruby-toolbox-link]: https://www.ruby-toolbox.com/projects/jekyll-wren\n[MIT Licensed]: https://img.shields.io/badge/License-MIT-brightgreen.svg\n[license-link]: #licenses\n\nA paper-style theme for [Jekyll]. Check out the GitHub pages [deployment] to see what the default looks like and read on for information on usage and customisation. Be aware that this **beta** software so will contain bugs; use it at your own risk.\n\n[Jekyll]: https://jekyllrb.com\n[deployment]: https://foggalong.github.io/Wren\n[wiki]: https://github.com/Foggalong/Wren/wiki\n\n## Features\n\n- 🎨 Responsive, [customisable] design\n- 🕔 See post reading time\n- 🗄️ 'First published on' icons\n- 🏷️ Browse posts by tags\n- 🧑 Browse posts by author\n- 📺 Embedded [YouTube, Twitch, etc][videos]\n- 🦶🏼 [Extendable] head, foot, and post meta\n- 📃 Optional [pagination]\n- 📰 Atom/RSS feed of posts\n- 📈 In-built search engine optimization\n\n[customisable]: #custom-styling\n[videos]: https://foggalong.github.io/Wren/video-embed-demo\n[extendable]: #custom-templates\n[pagination]: #pagination\n\n## Installing\n\nWhether you fork this repo or start from scratch there are two supported options for using Wren as your theme. Which works better for you will depend on your personal priorities.\n\n### Theme Gem\n\nUse the `jekyll-wren` gem, fetched automatically from [RubyGems] or downloaded from the [releases page] and installed locally. Either way you'll need to add\n\n```yaml\ntheme: jekyll-wren\n```\n\nto your [config] and\n\n```ruby\ngem \"jekyll-wren\", \"~\u003e 0.4\"\n```\n\nto your [Gemfile] plugins list.\n\nThe upsides are that builds will be quicker and you'll have more control over the version through the Gemfile. The downside is that it will prevent building with GitHub Pages' builder since Wren isn't on the [whitelist] (though you'll still be able to build locally and push to a GitHub pages branch/repo).\n\n[RubyGems]: https://rubygems.org\n[releases page]: https://github.com/Foggalong/Wren/releases/latest\n[config]: https://github.com/Foggalong/Wren/blob/main/_config.yml#L22-L23\n[Gemfile]: https://github.com/Foggalong/Wren/blob/main/Gemfile#L22-L28\n\n### Remote Theme\n\nIt's possible to use the theme directly from this repo. You'll need to add\n\n```yaml\nplugins:\n  - jekyll-remote-theme\n\nremote_theme: foggalong/wren@0.4\n```\n\nto your [config] and then\n\n```ruby\ngem \"jekyll-remote-theme\", \"~\u003e 0.4\"\n```\n\nto your [Gemfile] plugins list.\n\nThe upside is that this will work with GitHub Pages' builder ([Jekyll Remote Theme] is on the [whitelist]). The downsides are that builds will be slower and your [version control] is slightly weaker; you're tied to `HEAD` or a specific version.\n\n[Jekyll Remote Theme]: https://github.com/benbalter/jekyll-remote-theme\n[version control]: https://github.com/benbalter/jekyll-remote-theme#declaring-your-theme\n\n## Config Options\n\nThe [config.yml] in this repo can be used as a template for your own Wren instance. The file is thoroughly commented so it's worth having a read to know all the options available.\n\n[config.yml]: https://github.com/Foggalong/Wren/blob/main/_config.yml\n\n## Custom Templates\n\n[Minima] has a feature which allows users to create a [_includes/custom-head.html] file which is then [included] with the rest of the head. This is a useful feature if, for example, you want your website to cover favicons for more browsers than the default setup does.\n\n[_includes/custom-head.html]: https://github.com/jekyll/minima/blob/master/_includes/custom-head.html\n[included]: https://github.com/jekyll/minima/blob/master/_includes/head.html#L12\n\nWren keeps this feature and extends it so that `custom-foot.html` (displayed above the copyright notice) and `custom-meta.html` (displayed at the end of a post's meta line) can also be specified.\n\n## Custom Styling\n\nLike [Minima] (on which Wren's [SASS] is built) there are a whole bunch of variables which you can change to personalise the theme. To do this you just add lines such as\n\n```scss\n$background-color: #3d9da3;\n```\n\nto [`assets/style.scss`] and you're good to go. The list of what's customisable is slightly different (and longer!) than Minima so have a look at the full list of [style variables].\n\n[Minima]: https://github.com/jekyll/minima\n[`assets/style.scss`]: https://github.com/Foggalong/Wren/blob/main/assets/style.scss\n[style variables]: https://github.com/Foggalong/Wren/blob/main/_sass/wren/initialize.scss#L10-L87\n\n## Pagination\n\nIf the following two [config.yml] lines aren't commented, Wren will use [Jekyll Paginate][Paginate] to split the posts page into multiple pages of `paginate` many posts with url `paginate_path`.\n\n```yaml\npaginate: 5\npaginate_path: \"/blog/:num\"\n```\n\nNote that due to [Paginate]'s technical limitations this will only happen on the main posts page, not other post lists such as the tags page. It's generally quite limited in how it works compared to [Paginate v2], but the latter isn't on the [whitelist].\n\nAnother caveat is that, if you're using Paginate, the main post list page **must** have filename `index.html`; that's why in this repo it's `blog/index.html`. If you're not using Paginate though, Wren allows you to put that file anywhere and called whatever you like without problems.\n\n[Paginate v2]: https://github.com/sverrirs/jekyll-paginate-v2\n\n## Error Pages\n\nWren includes [`error.html`], a layout for formatting error pages; they're centered, have different spacing, and slightly different `\u003ch1\u003e` formatting. In [`errors/`] there are some examples; those aren't in the theme-gem (see [#25]) but to use them just copy to your website's repo. See this [tutorial] for configuring error pages on GitHub pages, Apache, and Nginx.\n\n[`error.html`]: https://github.com/Foggalong/Wren/blob/main/_layouts/error.html\n[`errors/`]: https://github.com/Foggalong/Wren/tree/main/errors\n[#25]: https://github.com/Foggalong/Wren/issues/25\n[tutorial]: https://jekyllrb.com/tutorials/custom-404-page\n\n## Philosophy\n\nI ❤️ [Wrens]. They're smol, quick, and rotund. When I was little we had a family of them come nest in our garden and they sang the most brilliant songs. Oh wait? You're saying this was supposed to be the project's philosophy? Let's just just say it's to be small, fast, and round.\n\n[Wrens]: https://en.wikipedia.org/wiki/Wren\n\n## Licenses\n\nWren is released under the [MIT License] and is built with [Jekyll] and a whole host of other MIT licensed projects.\n\n[MIT License]: https://choosealicense.com/licenses/mit\n\nIn order to remain compatible with GitHub Pages Wren only uses plugins from the [whitelist]. Massive props to [Remote Theme], [Feed], [Paginate], and [SEO] for doing their thing in the background without me needing to worry about it. Further features are achieved through [Liquid] templates, some of which are based on existing Ruby plugins. These include [Reading Time], [Embed Video], [Tag Cloud].\n\n[whitelist]: https://pages.github.com/versions\n[Remote Theme]: https://github.com/benbalter/jekyll-remote-theme\n[Feed]: https://github.com/jekyll/jekyll-feed\n[Paginate]: https://github.com/jekyll/jekyll-paginate\n[SEO]:  https://github.com/jekyll/jekyll-seo-tag\n[Liquid]: https://github.com/Shopify/liquid\n[Reading Time]: https://github.com/risan/jekyll-reading-time\n[Embed Video]: https://github.com/nathancy/jekyll-embed-video\n[Tag Cloud]: https://superdevresources.com/tag-cloud-jekyll\n\nStyle wise, Wren's [SASS] is forked from [Minima] which proved crucial in knowing what did and didn't need to be covered by Jekyll themes. The icons (apart from are based on designs from [Font Awesome], redrawn for the smaller form factor. Credit also to Antoine Boulanger's guide on [SVG Favicons].\n\n[SASS]: https://sass-lang.com\n[Font Awesome]: https://github.com/Rush/Font-Awesome-SVG-PNG\n[SVG Favicons]: https://link.medium.com/oDf4MMhiqjb\n\nThe only part of Wren _not_ MIT licensed is the [default profile image], a [CC-BY-NC] licensed [photo] of a Bewick Wren taken by [Minette Layne].\n\n[default profile image]: images/profile-hq.jpg\n[photo]: https://flic.kr/p/4E9FY2\n[Minette Layne]: https://www.flickr.com/people/minette_layne\n[CC-BY-NC]: https://creativecommons.org/licenses/by-nc/2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffoggalong%2Fwren","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffoggalong%2Fwren","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffoggalong%2Fwren/lists"}