Parse Community Blog

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/
---