{"id":15355721,"url":"https://github.com/burden/jekyll-bulma-blog","last_synced_at":"2025-04-14T05:41:23.495Z","repository":{"id":40229909,"uuid":"173374433","full_name":"burden/jekyll-bulma-blog","owner":"burden","description":"A fully-featured blog boilerplate for Jekyll made extraordinary with the help of Bulma.","archived":false,"fork":false,"pushed_at":"2023-04-12T00:23:08.000Z","size":290,"stargazers_count":14,"open_issues_count":5,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-27T19:29:04.734Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/burden.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-03-01T22:07:51.000Z","updated_at":"2020-01-30T03:54:09.000Z","dependencies_parsed_at":"2023-02-12T04:15:43.601Z","dependency_job_id":null,"html_url":"https://github.com/burden/jekyll-bulma-blog","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/burden%2Fjekyll-bulma-blog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/burden%2Fjekyll-bulma-blog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/burden%2Fjekyll-bulma-blog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/burden%2Fjekyll-bulma-blog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/burden","download_url":"https://codeload.github.com/burden/jekyll-bulma-blog/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248830418,"owners_count":21168272,"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":[],"created_at":"2024-10-01T12:25:21.843Z","updated_at":"2025-04-14T05:41:23.473Z","avatar_url":"https://github.com/burden.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# jekyll-bulma-blog\n\n\u003e A full-featured blog boilerplate for Jekyll made extraordinary with the help of Bulma.\n\n**[View Demo](https://jekyll-bulma-blog.burden.cc/)**\n\n![jekyll-bulma-blog](https://raw.githubusercontent.com/burden/jekyll-bulma-blog/master/screenshot.png)\n\n### Blog Features\n\n- Categories can have captions\n- Smart navigation knows which page is active\n- Archive pages for categories, tags, and year.\n  - Categories and tags pages can have descriptions\n- Atom feed\n- Featured blog post\n  - note: first post is used if nothing is specified.\n- Basic SEO\n  - schema.org (Website)\n  - open graph\n  - sitemap.xml\n- Contact page\n  - Honeypot and reCAPTCHA implemented to thwart spam-bots\n- Display your email address\n  - Your email is protected from spam-bots by using obfuscation\n- Create and edit blog posts with [Prose CMS](https://prose.io)\n    \n## Boilerplate Features\n\n- [Bulma 0.8](https://github.com/jgthms/bulma/tree/0.8.0)\n- Dependency management: [yarn](https://yarnpkg.com)\n- Asset pipeline: [jekyll-assets](https://rubygems.org/gems/jekyll-assets)\n  - [JS uglifier](https://rubygems.org/gems/uglifier/versions/3.2.0)\n- HTML compression: [compress.html](http://jch.penibelst.de/)\n- Testing: [html-proofer](https://github.com/gjtorikian/html-proofer)\n- Analytics: [Google Analytics](https://www.google.com/analytics/)\n\n## Dependencies\nYour development environment should have ruby and the gem package manager setup already.\n\n1. Install bundler `gem install bundler`\n2. Install [yarn](https://yarnpkg.com/en/docs/install)\n\n## Getting Started\n\n```\n$ bundle install\n$ yarn install\n$ bundle exec jekyll serve\n```\n\n## Usage\n\n### Add your email address\n\n```sh\n$ bundle exec rake email\nPlease type in an email address then press ENTER/RETURN\ncontact@example.com\n\nInstallation:\nUpdate src/_config.yml with the following pairs.\n\nemail-key: d05fIsWcv61GbThaN3FkOuL9mHXVnYgBQJUR8r2S7DizwKexqtAZMCP4Eoplyj\nemail-encoded: XhxWUXW@fIUzaNf.Xhz\n```\n\n### Contact Page\n\nThe contact page uses Formspree.io by default, unless deploying to Netlify.\n\nSome things to consider\n- 100 free submissions per month\n- Upon submission, it will Redirects you to thank you page (see thanks.html)\n- No registration required\n\nWhen deploying to Netlify, the blog will automatically integrate with Netlify Forms. If you still prefer to use Formspree.io, simply change the `site.contact.page.service` block to `formspree`\n\nIf you don't have access to `rake` or you don't care to obfuscate your email address, you can choose to display your email in plaintext by inputing your address in the `site.contact.email-plain` block. \n\n\n### Content Management\n\n#### Command Line\n\n```\ndraft      # Creates a new draft post with the given NAME\npost       # Creates a new post with the given NAME\npublish    # Moves a draft into the _posts directory and sets the date\nunpublish  # Moves a post back into the _drafts directory\npage       # Creates a new page with the given NAME\n```\n\n**Create a post**\n```\n$ bundle exec jekyll post \"Hello beautiful world\"\n```\nFor more examples and configuration options be sure to check out the `jekyll-compose` [repo](https://github.com/jekyll/jekyll-compose) \n\n#### Prose\nProse is an open source web-based authoring environment for CMS-free websites and designed for managing content on GitHub. Use it to create, edit, or delete files.\n\nProse has advanced support for Jekyll sites and markdown content. Prose detects markdown posts in Jekyll sites and provides syntax highlighting, a formatting toolbar, and draft previews in the site's full layout.\n\nPlease note that Prose only has access to the `src/_posts` directory. \n\n**Instructions**:  \n[Click here to authorize](https://prose.io) access to Github.\n\nBe sure to check out the Prose [repo](https://github.com/prose/prose), and [wiki](https://github.com/prose/prose/wiki/Prose-Configuration) for more information.\n\n### Configure Categories and Tags\n\nThis blog comes complete with Category and Tag pages thanks to the `jekyll-archives` plugin.\n\n `src/_data/catalog.yml`\n\nYou can change where Category and Tag pages are saved by editing the `jekyll-archives.permalinks` block in `_config.yml`\n\n#### Configure Prose CMS\nAfter editing your categories, you will need to update the prose block in `_config.yml`\n```\nprose:\n  ...\n  metadata:\n    src/_posts:\n      - name: \"category\"\n        field:\n          options:\n            - name: \"Category 1\"\n              value: \"category1\"\n```\n\n## Deploy\n\n### Deploy to Github Pages from Travis\n\n1. Point Travis to repository\n2. Configure Travis\n3. Generate a [Personal Access Token](https://github.com/settings/tokens) from Github\n  - The only scope needed is repo:public_repo\n4. Set `GITHUB_API=\u003ctoken\u003e` on Travis\n  - Make sure `Display value in build log` toggle is set to `Off`!\n\n### Deploy to Netlify  \n\n  [![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/burden/jekyll-bulma-blog)\n  \n  #### Wait, what happens when I click that button?\n\n  Good question. Here's what it will do...\n\n  1. Netlify will clone the git repository of this project into your Github account. This action will require your permission from Github, and of course a Netlify account. \n  2. Netlify will then create a new site for you, and configure it to use your shiny new repo. Right away you'll be able to deploy changes simply by pushing changes to your repo.\n  3. Enjoy your new blog 🎉","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fburden%2Fjekyll-bulma-blog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fburden%2Fjekyll-bulma-blog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fburden%2Fjekyll-bulma-blog/lists"}