Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
_data
_drafts
_layouts
_posts
community
dialogs
theme @ eaace2f
.gitignore
.gitmodules
CNAME
Gemfile
Gemfile.lock
README.md
_config.yml
about.html
atom.xml
blog.html
chief-technology-officer.html
client-success-specialist.html
clients.html
dir.ttl
impact.html
index.html
junior-open-smart-cities-analyst-1.html
junior-open-smart-cities-analyst-2.html
open-cities-strategies.html
open-smart-cities-expert.html
open-smart-cities-guide.html
operations-manager.html
our-offer.html
projects.html
publications.html
research-intern-urban-development.html
resources.html
senior-program-manager.html
what-we-do.html
work-with-us.html

README.md

Getting Started

Using Prose.io

You can use Prose.io to edit the website. To add a blog post:

  1. Click the "Authorize on GitHub" power icon in the bottom-right corner
  2. Click on the _posts folder
  3. Click "New File" and write the blog post
  4. Click the "Meta Data" icon in the right sidebar
  5. Fill in the "Author" field
  6. Click the "Save" icon in the right sidebar
  7. Re-open the blog post
  8. Click "Unpublished" at the right end of the toolbar
  9. Click the "Save" icon in the right sidebar

Using GitHub

One-Time Setup

gem install bundler
git clone git@github.com:opennorth/opennorth.ca.git
cd opennorth.ca
git submodule update --init
bundle
cd theme
git checkout master

Then, edit .git/modules/theme/config in the opennorth.ca directory, changing this line:

url = https://github.com/opennorth/theme.git

to:

url = git@github.com:opennorth/theme.git

Make Changes

To add a blog post, create a file in the _posts folder with a name following the pattern YYYY-MM-DD-lowercase-hyphenated-title.html and with contents of:

---
layout: post
title: A descriptive title
author: The author's name
---

To edit the staff or board, edit the _data/staff.yml and _data/board.yml files. Escape special characters by using the ASCI character code or preceding it with a forward slash.

To add a photo:

  1. Add the photo file to the theme/img/people directory. The filename must be the "slug" version of a person's name. A slug is the lowercase version of a name, with non-a-z characters replaced with hyphens -, with consecutive hyphens replaced with a single hyphen, and with leading and trailing hyphens removed. For example, the filename for "John Smith" is john-smith.jpg. For "John Q. Public Esq.", it's john-q-public-esq.jpg. For "Napoléon Bonaparte", it's napol-on-bonaparte.jpg. Note: You can simply inspect the HTML when previewing changes to see the expected filename.
  2. Commit the new file from the theme directory
  3. Run git push origin master from the theme directory
  4. Run git commit theme -m "Update theme" from the opennorth.ca directory
  5. Run git push origin gh-pages from the opennorth.ca directory

To change a photo:

  1. Replace the appropriate file in the theme/img/people directory
  2. Commit the updated file from the theme directory
  3. Run git push origin master from the theme directory
  4. Run git commit theme -m "Update theme" from the opennorth.ca directory
  5. Run git push origin gh-pages from the opennorth.ca directory

Preview Changes

Before committing your changes, always preview your changes. If not using Prose.io, start a server with:

bundle exec jekyll serve -w

Then, open localhost:4000 in a browser. While the server is running, you can make changes to files, then refresh the page in the browser to see your changes immediately! Press Ctrl+C to stop the server.

Note: This command compiles HTML files into the _site directory. Do not edit those files. Your changes to those files will not be saved.

Note: If the server is running, you must issue commands in a different Terminal window. Typing commands in the Terminal window in which the server is running will have no effect.

Theme

These files should be identical in this repository and nordouvert.ca:

  • .gitignore
  • .gitmodules
  • _config.yml
  • dir.ttl
  • Gemfile
  • Gemfile.lock

In other words, only these directories and files should differ:

  • _data/
  • _layouts/
  • _posts/
  • community/
  • communaute/
  • archive.html
  • atom.xml
  • CNAME
  • index.html
  • README.md