Repository files navigation

To propose a lesson, please consult ourcall for lessons. Before submitting a proposal, consult as well ourauthor guidelines and look over ourpublished lessons and ourpublishing pipeline.

After your lesson has been accepted into our review process, your assigned editor will work with you to upload your lesson to this ph-submissions repository.

For more information, see ourauthor guidelines andeditor guidelines. Ourtranslation guidelines are currently being updated.

We publish all our lessons inMarkdown. Lessons should be titled: "lesson-name". The lesson markdown file will be uploaded to the corresponding language folder (for example,"en"), and placed either in thedrafts/originals directory or thedrafts/translations directory. Sample lessons, with proper yaml header, can be viewed in these directories.

Image files should be named: "lesson-image-1", "lesson-image-2". Image files go in theimages directory, inside a folder named with the same slug as your lesson.

The live URL for the English lessons in the publishing pipeline:http://programminghistorian.github.io/ph-submissions/en/drafts/originals/LESSON-SLUG

To run this Jekyll site, you'll need Ruby version 2.6.2.

It's best to install involves usingrbenv to install Ruby withrbenv install 2.6.2.

Next runrbenv global 2.6.2 to set this version globally.

Install thebundler usinggem install bundler:2.1.4

Then build and serve the site withbundle exec jekyll serve