{"id":14979365,"url":"https://github.com/eliottvincent/bay","last_synced_at":"2025-04-12T20:38:30.576Z","repository":{"id":37677871,"uuid":"217248392","full_name":"eliottvincent/bay","owner":"eliottvincent","description":"🐟 A simple theme for Jekyll. Live at https://eliottvincent.github.io/bay/","archived":false,"fork":false,"pushed_at":"2025-01-02T21:00:01.000Z","size":6255,"stargazers_count":161,"open_issues_count":3,"forks_count":396,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-05T19:06:47.408Z","etag":null,"topics":["blog-theme","jekyll","jekyll-blog","jekyll-theme","jekyll-themes","theme"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eliottvincent.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","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":"2019-10-24T08:21:45.000Z","updated_at":"2025-03-27T19:15:48.000Z","dependencies_parsed_at":"2022-07-12T16:42:58.081Z","dependency_job_id":"90dfd0b5-7d71-4320-bb09-04291d8f7c81","html_url":"https://github.com/eliottvincent/bay","commit_stats":{"total_commits":77,"total_committers":4,"mean_commits":19.25,"dds":"0.11688311688311692","last_synced_commit":"9d329c8704a01d1d7e40d0279e73558ebd5bc3df"},"previous_names":[],"tags_count":24,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eliottvincent%2Fbay","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eliottvincent%2Fbay/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eliottvincent%2Fbay/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eliottvincent%2Fbay/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eliottvincent","download_url":"https://codeload.github.com/eliottvincent/bay/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248631668,"owners_count":21136554,"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","jekyll-themes","theme"],"created_at":"2024-09-24T13:59:53.152Z","updated_at":"2025-04-12T20:38:30.554Z","avatar_url":"https://github.com/eliottvincent.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bay\n\n[![Version](https://img.shields.io/gem/v/bay_jekyll_theme)](https://rubygems.org/gems/bay_jekyll_theme)\n[![Downloads](https://img.shields.io/gem/dt/bay_jekyll_theme)](https://rubygems.org/gems/bay_jekyll_theme)\n\nBay is a simple theme for Jekyll. [[view live]](https://eliottvincent.github.io/bay)\n\nInspired by [dangrover.com](http://dangrover.com/). Current theme used at [eliottvincent.com](http://eliottvincent.com/).\n\n![](/screenshot.png)\n\n\n## Table of contents\n1. [Installation](#installation)\n2. Website sections\n    1. [Header](#header)\n    2. [Footer](#footer)\n    3. [Home page](#home-page)\n    4. [Blog page](#blog-page)\n5. [GitHub Pages](#github-pages)\n6. [Development instructions](#development)\n\n\n### Installation\n\n\nThe easiest solution is to [fork this repo](https://github.com/eliottvincent/bay/fork).\nIf you want to start from a clean website, follow the steps below:\n\nCreate a new Jekyll website:\n```\njekyll new mysite\n```\n\nOpen `Gemfile` and replace the line:\n```\ngem \"minima\"\n```\nwith:\n```\ngem \"bay_jekyll_theme\"\n```\n\nOpen `_config.yml` and replace the line:\n```\ntheme: minima\n```\nwith:\n```\ntheme: bay_jekyll_theme\n```\nor, for GitHub Pages:\n```\nremote_theme: eliottvincent/bay\n```\n\nFinally, install the dependencies:\n```\nbundle install\n```\n\nand build the website!\n```\njekyll serve\n```\n\n\nThe website will look somewhat empty at first. That's normal. Follow the next instructions to complete the header and footer components, and the home and blog pages.\n\n#### Header\nOpen the `_config.yml` file and add the following:\n```yml\nheader:\n  pages:\n    - name: Home\n      slug: /     # \u003c-- index.md\n    - name: Blog  # \u003c-- blog.md\n    - name: Whatever  # \u003c-- whatever.md\n```\nRe-run `jekyll serve` to see the header updated.\n\n#### Footer\nOpen the `_config.yml` file and add the following:\n```yml\nfooter:\n  show_powered_by: true\n  contact:\n    - type: email\n      name: Email\n      value: yourmail@domain.com\n    - type: wechat\n      value: YourWeChatUsername\n      link: \"#\"\n  follow:\n    - type: twitter\n      name: Twitter\n      link: http://twitter.com/YourTwitterUsername\n      username: \"@YourTwitterUsername\"\n    - type: facebook\n      name: Facebook\n      link: http://facebook.com/YourFacebookUsername\n    - type: linkedin\n      name: LinkedIn\n      link: http://linkedin.com/in/YourLinkedInUsername\n    - type: github\n      name: GitHub\n      link: http://github.com/YourGitHubUsername\n    - type: dribbble\n      name: Dribbble\n      link: https://dribbble.com/YourDribbbleUsername\n    - type: rss\n      name: RSS\n      link: /feed.xml\n```\nRe-run `jekyll serve` to see the footer updated.\n\n#### Home page\nCreate (or edit) the `index.markdown` file and add the following:\n```yml\n---\nlayout: home\nprofile_picture:\n  src: /assets/img/profile-pic.jpg\n  alt: website picture\n---\n\n\u003cp\u003e\n  Welcome to my site!\n\u003c/p\u003e\n```\n\n#### Blog page\nCreate `blog.markdown` file and add the following:\n```yml\n---\nlayout: blog\ntitle: Blog\nslug: /blog\n---\n\nThis is an example of a \"Blog\" page, displaying a list of posts.\n\u003cbr /\u003e\n```\n\n\nYour website is ready!\n\n\n### GitHub Pages\n\nYou can deploy your website to GitHub Pages, but you cannot use the 1-click GitHub Pages build and deploy system. The issue is that the Bay theme relies on Jekyll 4.3+ (which uses a more modern Sass processor), whereas the GitHub Pages build system uses an older version of Jekyll.\n\nHowever, it's fairly easy to build and deploy your website with GitHub Actions, yet use GitHub Pages to host it.\n\nFurther explanations and instructions can be found on the official [Jekyll website](https://jekyllrb.com/docs/continuous-integration/github-actions/).\n\nYou can also refer to the [`.github/workflows/deploy.yml`](https://github.com/eliottvincent/bay/blob/master/.github/workflows/deploy.yml) file in this repository.\n\n### Development\n\n#### Run development instance (with hot-reload)\n```sh\nbundle exec jekyll serve\n```\n\n#### Build and publish the gem\n```sh\ngem build bay_jekyll_theme.gemspec\n```\n\n```sh\ngem push bay_jekyll_theme-1.x.x.gem\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feliottvincent%2Fbay","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feliottvincent%2Fbay","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feliottvincent%2Fbay/lists"}