Parse Community Blog

To run the site locally, you'll need Jekyll and the GitHub Pages gem. The GH Pages gem is required to provide your local site with a similar environment to prod. For example, the site.github param is automatically provided by GitHub in prod.

View Demo View Github

Setup

To run the site locally, you'll need Jekyll and the GitHub Pages gem. The GH Pages gem is required to provide your local site with a similar environment to prod. For example, the site.github param is automatically provided by GitHub in prod.

Prerequesites

  • Ruby 2.1 or higher;
  • Jekyll 3 or higher;
  • Bundler (gem install bundler).

Running

bundle install
bundle exec jekyll serve

Open http://127.0.0.1:4000/ in your web browser.

Contributing

Send your contribution via PR. Once it is merged, it will be automatically published to the site.

Adding an Author

Authors are key-value stored, so you will need to give yourself a key inside _config.yml - for example:

  flovilmart:
    name: Florent Vilmart
    byline: Core Contributor on Parse
    github: flovilmart
    twitter: flovilmart
    site: http://parseplatform.org/

Everything but name is optional.

Authoring an Article

To generate a new post, create a new file in the _posts directory. Be sure to add your name as the author of the post and include several categories if appropriate. Here is a sample header:

layout: post
title: Welcome to the new Parse Blog
date: 2017-07-06 13:08 -0700
comments: true
author: flovilmart
categories: [Announcements, Learn, Events, Customers, Videos]

More info can be found in the official docs.

Using categories & adding new ones

When adding a category to a blog post please remember to capitalize words. For categories with multiple words please separate words with dashes instead of spaces eg. New-Year not New Year.

The current list of categories:

  • Announcements
  • Community
  • Customers
  • Events
  • GitHub
  • JavaScript
  • Learn
  • New-Year
  • NodeJS
  • Notice
  • PHP
  • Release
  • SDK
  • Security
  • Update
  • Videos
  • Tutorial
  • Open-Source
  • Hacktoberfest
  • Engineering
  • Design

If you would like to use a new category please make a new file in the categories folder, for example:

---
layout: blog
permalink: /blog/categories/announcements/
pagination:
    enabled: true
    category: Announcements
    permalink: /:num/
---

GitHub