{"id":13397400,"url":"https://github.com/coogie/oscailte","last_synced_at":"2025-05-15T11:04:06.639Z","repository":{"id":9223678,"uuid":"11038593","full_name":"coogie/oscailte","owner":"coogie","description":"Oscailte — A powerful light, clean, and responsive Jekyll theme.","archived":false,"fork":false,"pushed_at":"2025-03-21T21:03:14.000Z","size":2545,"stargazers_count":219,"open_issues_count":0,"forks_count":55,"subscribers_count":16,"default_branch":"master","last_synced_at":"2025-04-04T16:25:36.261Z","etag":null,"topics":["blog","blog-theme","github-pages","jekyll","jekyll-theme","jekyll-themes","remote-theme","ruby-gem","theme"],"latest_commit_sha":null,"homepage":"https://coog.ie/oscailte","language":"SCSS","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/coogie.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-06-28T21:27:44.000Z","updated_at":"2025-03-21T21:03:18.000Z","dependencies_parsed_at":"2025-04-04T16:17:12.592Z","dependency_job_id":"aa539f1c-7dba-40fa-9311-517b4bcb3422","html_url":"https://github.com/coogie/oscailte","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coogie%2Foscailte","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coogie%2Foscailte/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coogie%2Foscailte/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coogie%2Foscailte/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coogie","download_url":"https://codeload.github.com/coogie/oscailte/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248477775,"owners_count":21110565,"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","blog-theme","github-pages","jekyll","jekyll-theme","jekyll-themes","remote-theme","ruby-gem","theme"],"created_at":"2024-07-30T18:01:21.709Z","updated_at":"2025-04-11T20:36:43.696Z","avatar_url":"https://github.com/coogie.png","language":"SCSS","readme":"# Oscailte \u0026mdash; A Jekyll theme [![Gem Version](https://img.shields.io/gem/v/oscailte?style=flat-square)](https://rubygems.org/gems/oscailte)\n\nOscailte ([IPA: [ˈɔsˠkɪlʲtʲɪ]](http://en.wiktionary.org/wiki/Appendix:Irish_pronunciation) Gaeilge for \"Open\") is a light and clean theme for use on [Jekyll](https://jekyllrb.org/) sites, released under the MIT Licence.\n\n## Quicklinks\n  - [Installation](#installation)\n  - [Usage](#usage)\n    - [Enabling Comments (via Disqus)](#enabling-comments-via-disqus)\n    - [Social Networks](#social-networks)\n    - [Enabling Google Analytics](#enabling-google-analytics)\n    - [Enabling Excerpts on the Home Page](#enabling-excerpts-on-the-home-page)\n  - [Customising Oscailte](#customising-oscailte)\n    - [Site Colours](#site-colours)\n\n## Installation\n\n### Install as Remote Theme\u003c/strong\u003e\u003c/summary\u003e\n\nUsing [Jekyll Remote Theme](https://github.com/benbalter/jekyll-remote-theme) (enabled\nby default on Github Pages) is the quickest way to install Oscailte.\n\n1. Add the following to your site's `_config.yml` to activate Oscailte\n\n  ```yml\n  remote_theme: coogie/oscailte\n  ```\n\n### Install via Gemfile\u003c/strong\u003e\u003c/summary\u003e\n\n1. Add this line to your Jekyll site's `Gemfile`:\n\n```ruby\ngem \"oscailte\"\n```\n\n2. And add this line to your Jekyll site's `_config.yml`:\n\n```yaml\ntheme: oscailte\n```\n\n3. And then execute:\n\n```sh\n$ bundle\n```\n\n4. Or install it yourself as:\n\n```sh\n$ gem install oscailte\n```\n\n## Usage\n\nThe majority of Oscailte's settings are nested under the `oscailte` key.\nBelow are a list of all available ones, and their default values.\n\n```yml\noscailte:\n  posts_url:\n  google_analytics:\n  social:\n    twitter: username\n    github: username\n    dribbble: username\n    facebook: username\n    flickr: username\n    instagram: username\n    linkedin: username\n    mastodon: https://instance.url/@username\n    pinterest: username\n    telegram: username\n    keybase: username\n    rss: rss\n  strings:\n    skip_to_main_content: \"Skip to main content\"\n    x_minute_read: \"$x$ minute read\"\n    hero_title: \"Welcome to Oscailte!\u003cbr\u003e A powerful, clean, and responsive Jekyll theme.\"\n    recent_posts: \"Recent posts\"\n    view_all: \"View all\"\n    read_full: \"Read full\"\n    disqus_enable_javascript: 'Please enable JavaScript to view the \u003ca href=\"https://disqus.com/?ref_noscript\" rel=\"nofollow\"\u003ecomments powered by Disqus\u003c/a\u003e.'\n```\n\n### Enabling Comments (via Disqus)\n\nOptionally, if you have a Disqus account, you can tell Jekyll to use it to show a comments\nsection below each post.\n\nTo enable it, add the following lines to your Jekyll site:\n\n```yml\ndisqus:\n  shortname: my_disqus_shortname\n```\n\nYou can find out more about Disqus' shortnames [here](https://help.disqus.com/installation/whats-a-shortname).\n\nComments are enabled by default and will only appear in production, i.e.,\n`JEKYLL_ENV=production`\n\nIf you don't want to display comments for a particular post you can disable them by adding\n`comments: false` to that post's YAML Front Matter.\n\n:warning: `url`, e.g. `https://example.com`, must be set in you config file for Disqus to\nwork.\n\n### Social Networks\n\nYou can add links to the accounts you have on other sites, with respective icon, by adding\none or more of the following options in your config. These usernames are nested under\n`oscailte.social`, with the keys being simply the social network's name:\n\n```yml\noscailte:\n  social:\n    twitter: jekyllrb\n    github: jekyll\n    dribbble: jekyll\n    facebook: jekyll\n    flickr: jekyll\n    instagram: jekyll\n    linkedin: jekyll\n    pinterest: jekyll\n    telegram: jekyll\n    keybase: jekyll\n    rss: rss\n```\n\n### Enabling Google Analytics\n\nTo enable Google Analytics, add the following lines to your `_config.yml`:\n\n```yml\noscailte:\n  google_analytics: UA-NNNNNNNN-N\n```\n\nGoogle Analytics will only appear in production, i.e., `JEKYLL_ENV=production`\nOscailte will also inform Google Analytics of your user's request for DNT.\n\n### Enabling Excerpts on the Home Page\n\nTo display post-excerpts on the Home Page, simply add the following to your `_config.yml`:\n\n```yaml\nshow_excerpts: true\n```\n\n## Customising Oscailte\n\n### Site Colours\n\nOscailte makes extensive use of [CSS Custom Properties](https://developer.mozilla.org/en-US/docs/Web/CSS/--*)\nfor various parts of its look and feel. A full list of the properties used throughout can\nbe found in [`/_sass/_oscailte.scss`](./_sass/_oscailte.scss#L40). _Some_ of these\nproperties are generated via SCSS (such as typography), but are still Custom Properties\nin-browser (not Sass variables).\n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub at https://github.com/coogie/oscailte.\nThis project is intended to be a safe, welcoming space for collaboration, and contributors\nare expected to adhere to the [Contributor Covenant](https://contributor-covenant.org)\ncode of conduct.\n\n## License\n\nThe theme is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).\n","funding_links":[],"categories":["CSS","SCSS"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoogie%2Foscailte","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoogie%2Foscailte","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoogie%2Foscailte/lists"}