maptime / maptime.github.io

The official Maptime website

maptime.github.io

This is the central repo of the maptime.io website. This is a Jekyll site served on Github Pages. If your environment is already setup, type in your terminal (the '$' refers to your prompt):

$ git clone [email protected]:maptime/maptime.github.io.git
$ cd maptime.github.io
$ jekyll serve --watch

Setting up your environment

Set up git and jekyll, which depend on ruby and homebrew:

For the code snippets below, you'll want to copy everything after the $ and paste into a terminal window.

Install Homebrew

Paste this into terminal

ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)"

Hit Return to start installation.

After it finishes, make sure brew is configured correctly by running:

$ brew doctor

Install Git

1. In terminal, run the following commands:

brew update
brew install git

2. Then follow the Set Up Git instructions provided by GitHub to configure your github account through git.

Install Ruby

1. MacOS comes with a built-in version of Ruby, but it's frequently out of date, and requires installing gems with sudo. It's better to install Ruby from homebrew:

brew install ruby

2. Then add /usr/local/opt/ruby/bin to $PATH:

$ echo 'export PATH=/usr/local/opt/ruby/bin:$PATH' >> ~/.bash_profile

Install Jekyll

Run the following in terminal:

$ gem install jekyll -v 2.4.0
$ gem install rdiscount

Clone this repo

Clone the maptime.github.io repo on your computer. Then switch into that file directory.

$ git clone -b master [email protected]:maptime/maptime.github.io.git
$ cd maptime.github.io

maptime.github.io's Issues

Any interest in displaying excerpts rather than full posts on the home page?

In config.yml we can create our own tag to identify the post's excerpt. Wordpress made this famous with the <!--more--> tag, which can be replicated with excerpt_separator: <!--more--> in Jekyll. All you have to do is drop this tag into your markdown posts where you want to cut off the post to display as a teaser. This can be helpful, especially for mobile users on narrow screens, if a user wants to skip a post without scrolling through it.

Clicking the title of the post, or a "read more..." link would take them to the full post.

This could also be useful for Twitter/Facebook description meta tags. Last week I added a description variable to the front matter, but we could ditch that and just use {{ post.excerpt }} instead.

Nav items difficult to see with map header (chapters page)

Continents are white, as are the nav items. Given the zoom level on page load they kinda disappear into the map.

Maptime Madison Website

Hi, I'm trying to make the maptime madison website from the starter and would like to have privileges to have a repo for it and privileges to upload files to it if possible. Thanks!

Add nav elements

Breaking up #6 per #8. 🌴

Apply redesign to home page

Tutorials page

There should be a page that aggregates and links to all the tutorials we have and associated materials so they can be in one spot!

Nav items overlap at the edge of mobile/desktop view

Add Lessons & Resources page

Breaking up #6 per #8. 🎃

make blog about CoC post and tweet it

Add OSM + AdaInitiative Post

Add Chapters page

Breaking up #6 per #8. 🏊

Clean up root directory

There are some images hanging out in root that should be in /img

Fix formatting on pages copied from Wordpress

Breaking up #6 per #8. 🐦

Apply redesign to Chapters page

Add CoC to website

Need to get the Code of Conduct up on the new website.

OOCSS

Would like to clean up the stylesheets a bit. In order:

• Modularize our stylesheets
• Generate a styleguide
• OOCSS?

Image in /about is missing

@bethschechter do you know which image this was supposed to go to? http://maptime.io/about/

We're currently maintaining chapters data in two places

It looks like we're currently maintaining two separate files for maptime chapters. I moved the file chapters.json over to _data so we could access maptime chapters information with Jekyll expressions. I had to change the extension to JSON rather than GeoJSON because Jekyll only supports YAML and JSON. Leaflet was still able to map the features despite having a JSON extension.

I see a recent commit 7f05b5e updated information on chapters/map/maptimes.geojson, and the readme is still referencing this file. I suggest that we move the README into /chapters and reference /_data/chapters.json for adding new chapters. We could then remove the map subdirectory entirely.

FYI @geografa mentioned that you may need to update your Jekyll to version 2.4.0 in order for _data/chapters.json to work properly.

cc @almccon @geografa

translate main pages

This will require some architecture changes for translations. @abenrob has some experience here ;)

Can we start with the main pages? Blog posts should prob remain in native languages.

http://nicoespeon.com/en/2013/04/building-a-multinlingual-jekyll-blog/

create links within /about to code of conduct

Delete master branch and make gh-pages the main branch?

I find that when working with gh-pages sites it's made a lot easier to delete the master branch and make gh-pages the default branch. It makes it a lot easier to submit PRs for the right branch and may make things less confusing for GH newbies.

Redirect images HTML to new location

Sort Chapters

Chapters need to be sorted alphabetically on /chapters. Unsure if this needs to be done to the json or if it can be done with jekyll.

Import content from Wordpress maptime.io

Import existing pages from current Maptime site, e.g. http://maptime.io/about

Should probably take the form of subdirectories like { site.baseurl }/about.

Add categories / tags to blog post

As a way to sort chapter blog posts by chapter. @reidab already updated the site so that categories are enabled. cc @geografa

Favicon

You guys need a funky favicon!

Maybe a nifty looking map marker, or the m from the maptime logo.

content background

Do we intend for that grid background to show through all the content?

Clean up chapters.json and chapters template

• No organizers for MaptimeSTL?
• Remove moreInfo property, replace with:
  • website (url)
  • meetup (url)
  • github (url) -- represents either a Repo in a personal account, or a chapter Org account
• Remove duplicate information
  • contact vs. organizers
  • title vs twitter -- Are these always the same?
• Update /chapters/index.html templates to use updated chapters.json
• Footer is whacky on chapters page

Create Maptime has a New Web Site post

to announce new website! preferably with an infinitely recursive image of a computer screen with a the website showing a computer screen with the website showing a computer screen with the website...

White text on bright yellow background is illegible

As in the page footer and main menu drop-down options (i.e. the CoC).

Clean up chapters page

Current /chapters page on chapters branch is a mess. It has its own template and scripts are inline. We should:

• bring scripts out as includes
• bring css out as includes
• use default as the template
• feed GeoJSON into page to populate chapter listing

add tiny "in founding partnership with Stamen" on footer

links to Stamen

populate chapters list from _data/chapter.js

Add Read Mores to all blog posts

How about an unpublished documentation page for development

What do you think about a /docs directory that outlines the different variables we've developed for the Front Matter? We can add the built-in variable published: false so it only shows up while you're hacking on the site.

While developing the site just add the unpublished flag to the Jekyll command:
jekyll serve -w --unpublished.

It can be really helpful when working on a site as a team where each individual might not know all of the options/variables that are available to them.

Add comfortaa to header text

Jobs page

There should be a place where maptimers can post jobs or where people who are hiring can find maptimers!

Add categories to tutorials

Add a category key to the tutorials.yml and sort the lessons-resources page into topic areas.

move images currently hosted on Wordpress

Add all older blog posts.

Update the on-boarding process

We have chapters.json figured out -- it feeds the map and chapters listing.

Two methods for creating chapter websites have also emerged:

1. Creating a chapter directory under the official maptime site (maptime.io/atlanta)
2. Creating a separate website using the starter repo (github.com/maptime/atlanta)

Both options will result in the url maptime.io/chaptername.

@alan and I agree that the first option is our preference as it allows us to automatically aggregate posts from chapters. In any case we should move README.md out of /chapters to the root directory and codify the process of starting a chapter.

Twitter and Open Graph descriptions aren't evaluating

Looks like the loops within the twitter and open graph descriptions aren't being evaluated. This would prevent a description for a page from showing up automagically on twitter/facebook when you post a link (I'm pretty sure).

This is all going down in /includes/head.html.

<meta name='twitter:description' content='{{page.content | markdownify | strip_html | trim_spaces | truncatewords: 30 | escape | replace:"'","&lsquo;" }}' />
  <meta property='og:description' content='{{page.content | markdownify | strip_html | trim_spaces | truncatewords: 30 | escape | replace:"'","&lsquo;" }}' />

We probably can't inject the entire page's content, rather have a description variable at the top of each page/post.

Maybe autogenerate the chapters page from the geojson?

Check out how wherecamp.org works. The main page is a list of local groups around the world, and it's all parsed from a geojson file that includes lots of specific metadata. Here's what their geojson looks like: https://raw.githubusercontent.com/reidab/wherecamp.org/gh-pages/wherecamps.geojson

That could be awesome

Port over newest blog posts from wordpress

• OpenStreetMap and the Ada Initiative #osm4ada
• Maptime is growing up :)

Add Maptime is Growing Up blog post

Fix overflow on marker popup

chapter titles stretch beyond popup wrapper

Apply redesign to individual chapter page

MaptimeATL chapter page

Hacking on our chapter page

• Header image
• First blog post -- recap of first meeting?

cc @landonreed

Add Contact page

Breaking up #6 per #8. 🍦

swap images for main pages

keep each page banner interesting. let's swap these out. prob need to adjust the yml and layouts and then put images in a common folder

• home
• about
• contact
• resources