{"id":13553287,"url":"https://github.com/raviriley/agency-jekyll-theme","last_synced_at":"2025-05-14T02:08:03.722Z","repository":{"id":40643728,"uuid":"211786772","full_name":"raviriley/agency-jekyll-theme","owner":"raviriley","description":"Jekyll version of the newest Agency Bootstrap theme, plus new features: Google Analytics, Markdown support, custom pages, and more!","archived":false,"fork":false,"pushed_at":"2025-01-27T18:06:12.000Z","size":7717,"stargazers_count":380,"open_issues_count":13,"forks_count":739,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-11T22:19:02.512Z","etag":null,"topics":["bootstrap","bootstrap-theme","github-pages","hacktoberfest","jekyll","jekyll-theme","jekyll-themes","liquid","remote-theme","ruby","ruby-gem","rubygems","theme"],"latest_commit_sha":null,"homepage":"https://raviriley.github.io/agency-jekyll-theme-starter/","language":"JavaScript","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/raviriley.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"custom":"https://paypal.me/raviriley"}},"created_at":"2019-09-30T06:04:44.000Z","updated_at":"2025-04-05T17:52:56.000Z","dependencies_parsed_at":"2023-12-27T10:28:47.236Z","dependency_job_id":"091e9250-2d1e-4086-ae05-406263d03ae6","html_url":"https://github.com/raviriley/agency-jekyll-theme","commit_stats":{"total_commits":228,"total_committers":13,"mean_commits":17.53846153846154,"dds":0.08333333333333337,"last_synced_commit":"665975cc30b952979fdaed065520c88e43a8905f"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raviriley%2Fagency-jekyll-theme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raviriley%2Fagency-jekyll-theme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raviriley%2Fagency-jekyll-theme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/raviriley%2Fagency-jekyll-theme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/raviriley","download_url":"https://codeload.github.com/raviriley/agency-jekyll-theme/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254052942,"owners_count":22006717,"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","github-pages","hacktoberfest","jekyll","jekyll-theme","jekyll-themes","liquid","remote-theme","ruby","ruby-gem","rubygems","theme"],"created_at":"2024-08-01T12:02:21.427Z","updated_at":"2025-05-14T02:07:58.706Z","avatar_url":"https://github.com/raviriley.png","language":"JavaScript","funding_links":["https://paypal.me/raviriley","https://www.paypal.me/raviriley"],"categories":["JavaScript","bootstrap"],"sub_categories":[],"readme":"# Agency Jekyll Theme\n[![RubyGems Downloads](https://img.shields.io/gem/dt/jekyll-agency?label=gem%20downloads)](https://rubygems.org/gems/jekyll-agency)\n[![LICENSE](https://img.shields.io/badge/license-MIT-blue)](/LICENSE.txt)\n[![Tip Me via PayPal](https://img.shields.io/badge/PayPal-tip_me-green?logo=paypal)](https://www.paypal.me/raviriley)\n[![template button](https://img.shields.io/badge/Generate_theme_from_template-2ea44f)][generate]\n[![Featured on Jekyll-Themes.com](https://img.shields.io/badge/featured%20on-JekyllThemes-red.svg)](https://jekyll-themes.com/agency-jekyll-theme/)\n\n## Preview - click for live demo\n\n[![screenshot](/screenshot.PNG)][demo-page]\n\n## Warning\n\n\u003e :warning: **Notice for those using legacy Formspree contact forms:** :warning:\n\u003e\n\u003e Email-based forms are being [phased out](https://help.formspree.io/hc/en-us/articles/360056076314) by Formspree. [#11](https://github.com/raviriley/agency-jekyll-theme/pull/11) updated this theme to use the [new Formspree structure](https://help.formspree.io/hc/en-us/articles/360017735154-How-to-prevent-spam). Click [here](https://help.formspree.io/hc/en-us/articles/360056076314) for instructions on updating your site's form.\n\n## About\n\nThis is the [Agency Bootstrap theme](https://startbootstrap.com/themes/agency/), converted to a gem-based Jekyll theme with GitHub Pages support.\n\nWhile this has been done before, [here](https://github.com/y7kim/agency-jekyll-theme), [here](https://github.com/SotiriosVrachas/jekyll-theme-startbootstrap-agency), and [here](https://github.com/laklau/agency-jekyll-theme/), these are outdated and have not been updated or maintained for years. I built this theme from the most recent Bootstrap source.\n\nI also added a lot of new features that go beyond the original theme's capabilities:\n\n- GitHub Pages support\n- [template repo][template] to get up and running in minutes\n- contact form functionality powered by [Formspree.io](https://formspree.io)\n- multiple language support (currently English, Spanish, \u0026 German)\n- custom pages\n- 404 page\n- legal/Privacy Policy page\n- Google Analytics support\n- Markdown support\n- custom images\n- logo support (instead of just title text)\n- automatically updating copyright years\n- custom navigation bar, even without the header image(s)\n- customizable footer\n- custom accent color and dark/light colors\n- horizontal scrolling support for client section\n\u003c!--\n- custom colors with automatic gradient generation (coming soon)\n- site title logo text font customization (coming soon)\n- horizontal scrolling support for portfolio section (coming soon)\n- about section (different from the timeline) --\u003e\n\nThe Jekyll structure of this theme includes:\n\n- `_portfolio` files - what generate the portfolio grid. YAML front matter handles all the details\n- the `page` layout allows custom pages, as seen in the legal and 404 pages\n- `sitetext.yml` enables complete customization of all site text\n- `navigation.yml` enables fully customizable navigation\n- `style.yml` enables fully customizable colors, background images, and other style-related things\n\n**If you enjoy this theme, please consider [supporting me](https://www.paypal.me/raviriley) to continue developing and maintaining it.**\n\n\u003cdiv align=\"center\"\u003e\n\n[![Support via PayPal](https://cdn.rawgit.com/twolfson/paypal-github-button/1.0.0/dist/button.svg)](https://www.paypal.me/raviriley)\n\n\u003c/div\u003e\n\n## Installation\n\nThere are three ways to install this theme:\n\n1. As a gem-based theme\n2. Use the [starter template][template] (best for GitHub Pages)\n3. As a remote theme\n\n#### 1. Gem-based Theme Installation\n\nReplace the contents of your `_config.yml` file with the sample [\\_config.yml](https://raw.githubusercontent.com/raviriley/agency-jekyll-theme/master/_config.yml).\n\nInstall the gem with:\n\n```sh\n$ bundle add jekyll-agency\n```\n\nOr manually.\n\n1. Add this line to your Jekyll site's `Gemfile`:\n   ```ruby\n   gem \"jekyll-agency\"\n   ```\n2. Then execute:\n   ```sh\n   $ bundle install\n   ```\n\n#### 2. Using the [Starter Template][template]\n\nThis is the fastest and easiest way to get up and running on GitHub Pages.\n\nSimply generate your own repository by clicking the button below. Then replace the sample content with your own and configure for your needs.\n\n\u003cdiv align=\"center\"\u003e\n\n[![Use this template](https://img.shields.io/badge/Generate-Use_this_template-2ea44f?style=for-the-badge)][generate]\n\n\u003c/div\u003e\n    \n#### 3. Remote Theme Installation\n\nReplace your `_config.yml` file with the starter [\\_config.yml](https://raw.githubusercontent.com/raviriley/agency-jekyll-theme-starter/master/_config.yml).\n\nReplace your `Gemfile` with the starter [Gemfile](https://raw.githubusercontent.com/raviriley/agency-jekyll-theme-starter/master/Gemfile).\n\nThen install gems.\n\n```sh\n$ bundle install\n```\n\n\u003c!--\n## Documentation and Usage\n\n**TODO:** Write usage instructions here. Describe available layouts, includes, or assets.\n\nnavheader is used only for the home page. nav is used everywhere else.\n\nLayouts:\n\nIncludes:\n\n--\u003e\n\n## Contributing\n\nThis project is intended to be a welcoming space for collaboration. If you have an idea, suggestion, feature request, etc., feel free to open an issue or pull request.\n\nFor bug reports, follow the provided template.\n\n#### Improvements - Up for Grabs\n\n- [x] multiple language support thanks to [@rbenitezpagan](https://github.com/rbenitezpagan)\n  - [x] Spanish thanks to [@rbenitezpagan](https://github.com/rbenitezpagan)\n  - [x] German thanks to [@bkfirmen](https://github.com/bkfirmen)\n  - [ ] Chinese\n  - [ ] Arabic\n  - [ ] etc\n- [ ] customizable background coloring for each section\n\n## Development\n\nTo set up your environment to develop this theme, clone this repo or your fork.\n\n```sh\n$ git clone https://github.com/raviriley/agency-jekyll-theme.git\n$ cd agency-jekyll-theme\n```\n\nThen run:\n\n```sh\n$ bundle install\n```\n\nTo test the theme, run this. (Using the `--trace` flag for verbose errors.)\n\n```sh\n$ bundle exec jekyll serve --trace\n```\n\nThen open your browser at:\n\n- http://localhost:4000\n\nAdd pages, documents, data, etc. like normal to test the theme's 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](https://opensource.org/licenses/MIT).\n\n\u003c!--\n\n## Example Implementations\n\n- [CV Enterprises](https://cventerprises.org)\n- [Mortazavi Lab at UC Irvine](https://mortazavilab.github.io/)\n\n--\u003e\n\n[demo-page]: https://raviriley.github.io/agency-jekyll-theme-starter/\n[template]: https://github.com/raviriley/agency-jekyll-theme-starter\n[generate]: https://github.com/raviriley/agency-jekyll-theme-starter/generate\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraviriley%2Fagency-jekyll-theme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraviriley%2Fagency-jekyll-theme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraviriley%2Fagency-jekyll-theme/lists"}