Copyright 2013-22 NPR. All rights reserved. No part of these materials may be reproduced, modified, stored in a retrieval system, or retransmitted, in any form or by any means, electronic, mechanical or otherwise, without prior written permission from NPR.

(Want to use this code? Send an email to nprapps@npr.org!)

nprapps.github.com

Getting Started

Follow the MacOS instructions on the Jekyll website, including setting up the recommended version of Ruby.

Matt Stiles wrote a helpful post explaining how to get set up. (The installation instructions are a bit dated, but the explanation about the overall setup of the teamblog still generally applies.)

Once you have Jekyll installed, run this to install dependencies:

$ bundle update --bundler

Then run this to set up the development server and have it automatically regenerate files::

$ bundle exec jekyll serve --watch

You can see it in your browser here:

http://localhost:4000

Things To Know

• Pushing code to the repo will automatically publish any changes you've made. If you're not ready to publish yet, save your changes to a separate branch, and then merge it back to master when you're ready.

• Writing a blog post? Use this as a starting point.

• Linking to a post we've written somewhere else (like Source)? Use this as a starting point.

How To Embed Code Snippets

A couple options:

• Tab-indent your code, and Markdown will recognize it as a code snippet. However, if that snippet includes {{ }} tags, wrap the block of code in {% raw %} {% endraw %} to escape it. (Example)

• Save your code snippet as a Gist on your GitHub account — for example, https://gist.github.com/alykat/8319004. Take the username and Gist ID in the URL and sub it into the script tag: <script src="https://gist.github.com/YOUR-USERNAME/GIST-ID.js"> </script>

Internship posting workflow

Make copies of the previous posts:

cp 2016-10-12-winter-2017-designer-developer-internship.markdown 2017-02-14-summer-2017-designer-developer-internship.markdown
cp 2016-10-12-winter-2017-photo-internship.markdown 2017-02-14-summer-2017-photo-internship.markdown

Add redirects to old posts by changing front matter, e.g. in _posts/2016-10-12-winter-designer-developer-internship.markdown:

---
layout: redirect
redirect_url: /2017/02/14/summer-2017-designer-developer-internship.html
title: "Be our design/code/??? intern for winter/spring 2017!"

...

---

Edit the new posts with new art, new links between the two (it's cool if you forget, it just means more redirect responses), and correct NPR human resources job posting URL.

Update index.html's internship badge with latest links.