{"id":15201510,"url":"https://github.com/bookiza/bubblin-jekyll","last_synced_at":"2026-03-06T09:02:22.901Z","repository":{"id":59151704,"uuid":"105785648","full_name":"bookiza/bubblin-jekyll","owner":"bookiza","description":"The official theme in use at The Bubblin Blog","archived":false,"fork":false,"pushed_at":"2019-10-08T16:02:47.000Z","size":399,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-02-28T15:36:46.186Z","etag":null,"topics":["bubblin-jekyll","jekyll-site","jekyll-themes","theme-preview"],"latest_commit_sha":null,"homepage":"https://bubblin.io/blog/","language":"CSS","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/bookiza.png","metadata":{"files":{"readme":"README.md","changelog":"History.markdown","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}},"created_at":"2017-10-04T15:34:25.000Z","updated_at":"2019-10-08T16:02:43.000Z","dependencies_parsed_at":"2022-09-13T10:50:24.704Z","dependency_job_id":null,"html_url":"https://github.com/bookiza/bubblin-jekyll","commit_stats":null,"previous_names":["marvindanig/bubblin-jekyll"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/bookiza/bubblin-jekyll","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bookiza%2Fbubblin-jekyll","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bookiza%2Fbubblin-jekyll/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bookiza%2Fbubblin-jekyll/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bookiza%2Fbubblin-jekyll/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bookiza","download_url":"https://codeload.github.com/bookiza/bubblin-jekyll/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bookiza%2Fbubblin-jekyll/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30168607,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-06T07:56:45.623Z","status":"ssl_error","status_checked_at":"2026-03-06T07:55:55.621Z","response_time":250,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["bubblin-jekyll","jekyll-site","jekyll-themes","theme-preview"],"created_at":"2024-09-28T03:04:44.755Z","updated_at":"2026-03-06T09:02:22.849Z","avatar_url":"https://github.com/bookiza.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bubblin-jekyll\n\nThe `Bubblin-Jekyll` is the Jekyll theme in use at [The Bubblin Blog](https://bubblin.io/blog/). It is a particularly useful theme for situations where you want to add a blog to your site, say on the side of your rails app (website) or over a url like this:\n\n\u003e https://example.com/blog/\n\n\n`Bubblin-Jekyll` was originally a fork off of [Minima](https://github.com/jekyll/minima)—the default gem-theme of Jekyll-but it has been rewritten completely using the [Toucaan CSS](https://github.com/marvindanig/toucaan) fundamentals for its themed layout.\n\nA tutorial on how to setup a jekyll blog using the `bubblin-jekyll` theme alongside your rails app is available [here](https://bubblin.io/blog/).\n\n[Theme preview](https://jekyll.github.io/bubblin-jekyll/)\n\n![bubblin-jekyll theme preview](/screenshot.png)\n\n## Installation\n\nAdd this line to your Jekyll site's Gemfile:\n\n```ruby\ngem \"bubblin-jekyll\"\n```\n\nAnd add this line to your Jekyll site:\n\n```yaml\ntheme: bubblin-jekyll\n\nsearch: true\n```\n\nAnd then execute:\n\n    $ bundle\n\n### Layouts\n\nRefers to files within the `_layouts` directory, that define the markup for your theme.\n\n  - `default.html` \u0026mdash; The base layout that lays the foundation for subsequent layouts. The derived layouts inject their contents into this file at the line that says ` {{ content }} ` and are linked to this file via [FrontMatter](https://jekyllrb.com/docs/frontmatter/) declaration `layout: default`.\n  - `home.html` \u0026mdash; The layout for your landing-page / home-page / index-page.\n  - `page.html` \u0026mdash; The layout for your documents that contain FrontMatter, but are not posts.\n  - `post.html` \u0026mdash; The layout for your posts.\n\n### Includes\n\nRefers to snippets of code within the `_includes` directory that can be inserted in multiple layouts (and another include-file as well) within the same theme-gem.\n\n  - `disqus_comments.html` \u0026mdash; Code to markup disqus comment box.\n  - `footer.html` \u0026mdash; Defines the site's footer section.\n  - `google-analytics.html` \u0026mdash; Inserts Google Analytics module (active only in production environment).\n  - `head.html` \u0026mdash; Code-block that defines the `\u003chead\u003e\u003c/head\u003e` in *default* layout.\n  - `header.html` \u0026mdash; Defines the site's main header section. By default, pages with a defined `title` attribute will have links displayed here.\n  - `icon-* files` \u0026mdash; Inserts github and twitter ids with respective icons.\n\n### Sass\n\nRefers to `.scss` files within the `_sass` directory that define the theme's styles.\n\n  - `bubblin-jekyll.scss` \u0026mdash; The core file imported by preprocessed `main.scss`, it defines the variable defaults for the theme and also further imports sass partials to supplement itself.\n  - `bubblin-jekyll/_base.scss` \u0026mdash; Resets and defines base styles for various HTML elements.\n  - `bubblin-jekyll/_layout.scss` \u0026mdash; Defines the visual style for various layouts.\n  - `bubblin-jekyll/_syntax-highlighting.scss` \u0026mdash; Defines the styles for syntax-highlighting.\n\n### Assets\n\nRefers to various asset files within the `assets` directory.\nContains the `main.scss` that imports sass files from within the `_sass` directory. This `main.scss` is what gets processed into the theme's main stylesheet `main.css` called by `_layouts/default.html` via `_includes/head.html`.\n\nThis directory can include sub-directories to manage assets of similar type, and will be copied over as is, to the final transformed site directory.\n\n### Plugins\n\nBubblin-jekyll comes preinstalled with the [`jekyll-seo-tag`](https://github.com/jekyll/jekyll-seo-tag) plugin to make sure your website gets the most useful meta tags. See [usage](https://github.com/jekyll/jekyll-seo-tag#usage) to know how to set it up.\n\n## Usage\n\n### Customization\n\nTo override the default structure and style of bubblin-jekyll, simply create the concerned directory at the root of your site, copy the file you wish to customize to that directory, and then edit the file.\ne.g., to override the [`_includes/head.html `](_includes/head.html) file to specify a custom style path, create an `_includes` directory, copy `_includes/head.html` from minima gem folder to `\u003cyoursite\u003e/_includes` and start editing that file.\n\nThe site's default CSS has now moved to a new place within the gem itself, [`assets/main.scss`](assets/main.scss). To **override the default CSS**, the file has to exist at your site source. Do either of the following:\n- Create a new instance of `main.scss` at site source.\n  - Create a new file `main.scss` at `\u003cyour-site\u003e/assets/`\n  - Add the frontmatter dashes, and\n  - Add `@import \"bubblin-jekyll\";`, to `\u003cyour-site\u003e/assets/main.scss`\n  - Add your custom CSS.\n- Download the file from this repo\n  - Create  a new file `main.scss` at `\u003cyour-site\u003e/assets/`\n  - Copy the contents at [assets/main.scss](assets/main.scss) onto the `main.scss` you just created, and edit away!\n- Copy directly from Bubblin-Jekyll gem\n  - Go to your local bubblin-jekyll gem installation directory ( run `bundle show bubblin-jekyll` to get the path to it ).\n  - Copy the `assets/` folder from there into the root of `\u003cyour-site\u003e`\n  - Change whatever values you want, inside `\u003cyour-site\u003e/assets/main.scss`\n\n--\n\n### Change default date format\n\nYou can change the default date format by specifying `site.bubblin-jekyll.date_format`\nin `_config.yml`.\n\n```\n# Bubblin-Jekyll date format\n# Refer to http://shopify.github.io/liquid/filters/date/ to customize\nbubblin-jekyll:\n  date_format: \"%b %-d, %Y\"\n```\n\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 section below each post.\n\nTo enable it, add the following lines to your Jekyll site:\n\n```yaml\n  disqus:\n    shortname: my_disqus_shortname\n```\n\nYou can find out more about Disqus' shortnames [here](https://help.disqus.com/customer/portal/articles/466208).\n\nComments are enabled by default and will only appear in production, i.e., `JEKYLL_ENV=production`\n\nIf you don't want to display comments for a particular post you can disable them by adding `comments: false` to that post's YAML Front Matter.\n\n--\n\n### Enabling Google Analytics\n\nTo enable Google Anaytics, add the following lines to your Jekyll site:\n\n```yaml\n  google_analytics: UA-NNNNNNNN-N\n```\n\nGoogle Analytics will only appear in production, i.e., `JEKYLL_ENV=production`\n\n\n--\n\n### Enabling Heap Analytics\n\nTo enable Heap Anaytics, add the following lines to your Jekyll site:\n\n```yaml\n  heap_analytics: NN-NNNNNNNNN\n```\n\nHeap will appear only in production, i.e., with `JEKYLL_ENV=production`\n\n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub at . This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.\n\n## Development\n\nTo set up your environment to develop this theme, run `script/bootstrap`.\n\nTo test your theme, run `script/server` (or `bundle exec jekyll serve`) and open your browser at `http://localhost:4000`. This starts a Jekyll server using your theme and the contents. As you make modifications, your site will regenerate and you should see the changes in the browser after a refresh.\n\n## License\n\nThe theme is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbookiza%2Fbubblin-jekyll","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbookiza%2Fbubblin-jekyll","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbookiza%2Fbubblin-jekyll/lists"}