Hosting your own Maptime chapter website? Starter is a simple Jekyll theme and is desgined to be easily forked and tweaked to suit your own needs. Jekyll is a simple, blog-aware, static site generator for personal, project, or organization sites.
Once cloned into the Maptime organization your site will be hosted at http://maptime.io/ chapter where chapter is the name of your repo.
-
If we've finished onboarding your new chapter into the Maptime organization then should already have this template cloned into the
gh-pagesbranch of your chapter repo and have been given you privleges to push to it. Please skip ahead and begin to customize your site. -
Not yet in the Maptime fold? Fill out this form and we'll get you set up!
Edit the _config.yml file. Here's a quick rundown of the configuration options.
| Name | Required | Value | Description |
|---|---|---|---|
| baseurl | Yes | post | This value should always be the same. |
| permalink | No | how urls are generated | You can learn more about how they are generated here. |
| markdown | No | Determines which markdown engine is used | Generally, you don't need to touch this field for your own needs. |
| paginate | Yes | Number of posts on the front page | Starter supports pagination. Control the number of posts on a given page by changing this value |
| repo | Yes | Name of the repo on GitHub | As an example, the name of the starter repo is starter |
| github_org | Yes | Name of the organization or username on GitHub | Most of the time this will be 'maptime' |
| maptime: chapter | Yes | Name of your Maptime meetup | |
| maptime: twitter | No | Your Maptime Twitter username | |
| maptime: disqus | No | Disqus account name | Starter optionally supports comments on posts with Disqus. Create a new Disqus account for a site and fill this field with the account name. |
There are two kinds of content in Starter: post and event. You author these types of content in the _posts directory. Each content type has unique configuration options that you should declare at the top of the document. This is called Frontmatter.
Events are for actual planned meetups with RSVP information. Note that the filename of the post should match the date of the meetup date.
| Name | Required | Value | Description |
|---|---|---|---|
| layout | Yes | event | This value should always be the same. |
| category | Yes | event | This value should always be the same. |
| title | Yes | The title of your event | |
| rsvp | Yes | URL to rsvp | This could link to a page on Eventbrite, Meetup or another service. |
Posts are like blog posts. These are great for meetup follow ups or posts that don't have a meetup event tied to it.
| Name | Required | Value | Description |
|---|---|---|---|
| layout | Yes | post | This value should always be the same. |
| title | Yes | The title of your post | |
| author | No | Author's name | |
| image | No | URL path to an image | Images added here will show up as a Twitter card when a post is shared. |
-
Create an issue at the maptime-admin repo and we'll respond to it.
-
The site is powered by Jekyll. To make custom tweaks to your own site, you should read its documentation.
-
Starter makes the assumption you will be running the site on GitHub pages. You can learn more about GitHub Pages here.
BSD