{"id":15187404,"url":"https://github.com/jonaharagon/jekyll-bootstrap-theme","last_synced_at":"2025-10-02T01:31:30.118Z","repository":{"id":39750284,"uuid":"364315696","full_name":"jonaharagon/jekyll-bootstrap-theme","owner":"jonaharagon","description":"A basic but extensible Jekyll theme based on Bootstrap 5.","archived":true,"fork":false,"pushed_at":"2023-03-29T10:45:05.000Z","size":1756,"stargazers_count":21,"open_issues_count":5,"forks_count":12,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-01-16T21:53:16.894Z","etag":null,"topics":["bootstrap","bootstrap-theme","bootstrap5","github-pages","jekyll","jekyll-theme","ruby-gem"],"latest_commit_sha":null,"homepage":"https://jonaharagon.github.io/jekyll-bootstrap-theme/","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/jonaharagon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"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":"2021-05-04T16:16:17.000Z","updated_at":"2024-10-07T13:10:25.000Z","dependencies_parsed_at":"2024-09-23T14:30:41.887Z","dependency_job_id":"4e54cc5a-3fb4-4767-b3b3-6fc5bb2a08d3","html_url":"https://github.com/jonaharagon/jekyll-bootstrap-theme","commit_stats":{"total_commits":15,"total_committers":3,"mean_commits":5.0,"dds":0.2666666666666667,"last_synced_commit":"55fe176d6dcbc27dec5878a65d0842c88c613527"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonaharagon%2Fjekyll-bootstrap-theme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonaharagon%2Fjekyll-bootstrap-theme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonaharagon%2Fjekyll-bootstrap-theme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonaharagon%2Fjekyll-bootstrap-theme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jonaharagon","download_url":"https://codeload.github.com/jonaharagon/jekyll-bootstrap-theme/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234922819,"owners_count":18907828,"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":["bootstrap","bootstrap-theme","bootstrap5","github-pages","jekyll","jekyll-theme","ruby-gem"],"created_at":"2024-09-27T18:21:16.774Z","updated_at":"2025-10-02T01:31:24.767Z","avatar_url":"https://github.com/jonaharagon.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# jekyll-bootstrap-theme\n\n[![Gem Version](https://badge.fury.io/rb/jekyll-bootstrap-theme.svg)](https://badge.fury.io/rb/jekyll-bootstrap-theme)\n\nA basic but extensible Jekyll theme based on Bootstrap 5.\n\n[Theme preview](https://jonaharagon.github.io/jekyll-bootstrap-theme/) - **[One-Click Install (GitHub Pages)](https://github.com/jonaharagon/jekyll-bootstrap-template/generate)** - [RubyGems.org](https://rubygems.org/gems/jekyll-bootstrap-theme)\n\n![Bootstrap theme preview](/screenshot.png)\n\n## Install\n\nIf you are able to install custom Gems on your build server/web server, install via the **Gemfile** method described here. GitHub Pages users cannot install custom Gems, and must instead use the **Remote Theme** Jekyll plugin to use this theme.\n\n### Gemfile\n\nAdd this line to your `Gemfile`:\n\n```ruby\ngem 'jekyll-bootstrap-theme'\n```\n\nAnd add this line to your site's `_config.yml`:\n\n```yaml\ntheme: jekyll-bootstrap-theme\n```\n\nAnd then execute:\n\n    $ bundle\n\nOr install it yourself as:\n\n    $ gem install jekyll-bootstrap-theme\n\n### Remote Theme (GitHub Pages)\n\n#### One-Click Install\n\n- **[Create Repository from Pre-Made Template](https://github.com/jonaharagon/jekyll-bootstrap-template/generate)**\n\n#### Manual Install\n\nGitHub Pages websites cannot use custom Gems. Instead, you can add this repository as a `remote_theme`:\n\nAfter making a Jekyll repo, add `gem \"jekyll-remote-theme\"` to the `:jekyll_plugins` group in your `Gemfile`, then run `bundle` to install the plugin:\n\n```ruby\ngroup :jekyll_plugins do\n  [...]\n  gem \"jekyll-remote-theme\"\nend\n```\n\nAdd the following to your site's `_config.yml` to activate the plugin and select this theme:\n\n```yaml\nplugins:\n  - jekyll-remote-theme\n\nremote_theme: jonaharagon/jekyll-bootstrap-theme\n```\n\nOptionally, you can specify a [release](https://github.com/jonaharagon/jekyll-bootstrap-theme/releases), [branch](https://github.com/jonaharagon/jekyll-bootstrap-theme/branches), or [tag](https://github.com/jonaharagon/jekyll-bootstrap-theme/tags) to lock the theme version in place:\n\n```yaml\nremote_theme: jonaharagon/jekyll-bootstrap-theme@v0.1.0\n```\n\n## Theme Contents\n\n### Layouts\n\nFiles within the `_layouts` directory, that define the markup for your theme:\n\n - `default.html` - The base layout that lays the foundation for subsequent layouts. Includes a navigation bar and footer on all pages.\n - `home.html` - The layout for your homepage/landing page. Includes a blog post listing with pagination support.\n - `page.html` - The layout for documents and other pages that contain Front Matter, that are not posts.\n - `post.html` - The layout for your blog posts.\n\n#### Home Layout\n\n##### Main Heading, Custom Content Injection\n\nThe home layout will inject all content from your `index.md` / `index.html` before the optional posts heading. This will allow you to include non-posts related content to be published on the landing page under a dedicated heading. We recommended that you title this section with a Heading2 (##), and enable a posts heading if you add additional content.\n\n##### Posts Listing\n\nIt will be automatically included only when your site contains one or more valid posts or drafts (if the site is configured to show_drafts).\n\nThis section is untitled by default. You can customize this heading by defining a `list_title` variable in the document's front matter, which will be rendered with an `\u003ch2\u003e` tag.\n\n### Includes\n\nSnippets 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 - `footer.html` — Defines the site's footer section.\n - `head.html` — Code-block that defines the `\u003chead\u003e\u003c/head\u003e` in default layout.\n - `custom-head.html` — Placeholder to allow users to add more metadata to `\u003chead /\u003e`.\n - `header.html` — Defines the site's main header section. By default, pages with a defined `title` attribute will have links displayed here.\n - `social.html` — Renders social-media icons based on the `bootstrap.social_links` data in the config file.\n\n### Sass\n\n`.scss` files within the `_sass` directory that define the theme's styles.\n\n - `bootstrap/*` - Default Bootstrap SCSS files.\n - `_custom-variables.scss` - This file can be overridden to add any custom variables. It is loaded *after* Bootstrap's variables but *before* the rest of Bootstrap, allowing you to override any of [Bootstrap's variables](https://github.com/twbs/bootstrap/blob/main/scss/_variables.scss). (*Note: Cannot override styles*)\n - `_custom-styles.scss` - This file can be overridden to add any custom styles. It is loaded *after* all other CSS. (*Note: Cannot override variables*)\n\n### Assets\n\n - `assets/css/bootstrap-theme.scss` - Imports sass files from `_sass` and gets processed into the final stylesheet.\n - `assets/css/bootstrap-icons.css` - Loads [Bootstrap Icons](https://icons.getbootstrap.com)\n - `assets/js/bootstrap.bundle.min.js` - Bootstrap's Javascript bundle, loaded on every page by default.\n - `assets/fonts/bootstrap-icons.woff(2)` - Bootstrap Icons font files.\n\n### Plugins\n\nThis theme comes with [`jekyll-seo-plugin`](https://github.com/jekyll/jekyll-seo-tag) preinstalled 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## Configuration\n\nThis theme can be configured with various settings in [`_config.yml`](/_config.yml).\n\n### Site Author\n\n`site.author` is expected to be a mapping of attributes instead of a simple scalar value:\n\n```yaml\nauthor:\n  name: 'Github User'\n  email: 'github@example.com'\n```\n\n### Navbar Customization\n\nIf you want to link only specific pages in your header, uncomment this and add the path to the pages in order as they should show up\n\n```yaml\nbootstrap:\n  header_pages:\n   - about.md\n   - second.html\n   - folder/third.md\n```\n\n### Social Network Icons\n\nYou can add links to the accounts you have on other sites, with respective icon, by adding one or more of the following options in your config. These must be complete URLs to function properly.\n\n```yaml\nbootstrap:\n  social_links:\n    twitter: 'https://example.com/@jekyllrb'\n    github:  'https://example.com/@jekyllrb'\n    facebook: 'https://example.com/@jekyllrb'\n    instagram: 'https://example.com/@jekyllrb'\n    linkedin: 'https://example.com/@jekyllrb'\n    google: 'https://example.com/@jekyllrb'\n    youtube: 'https://example.com/@jekyllrb'\n    twitch: 'https://example.com/@jekyllrb'\n    telegram: 'https://example.com/@jekyllrb'\n    whatsapp: 'https://example.com/@jekyllrb'\n    discord: 'https://example.com/@jekyllrb'\n    slack: 'https://example.com/@jekyllrb'\n```\n\n### Post Excerpts\n\nTo display post excerpts on the Home layout, set `site.excerpts.show` to true. You can also choose to automatically cut off excerpts after 32 words (approx. 2 lines):\n\n```yaml\nexcerpts:\n  show: true\n  auto_truncate: true\n```\n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub at https://github.com/jonaharagon/jekyll-bootstrap-theme. 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 Requirements:**\n\n- `yarn`\n\nUpdating packages: `yarn run assets:clean \u0026\u0026 yarn upgrade \u0026\u0026 yarn run assets:install`\n\n## License\n\nThe theme is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonaharagon%2Fjekyll-bootstrap-theme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjonaharagon%2Fjekyll-bootstrap-theme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonaharagon%2Fjekyll-bootstrap-theme/lists"}