search

datacarpentry / lesson-template-ARCHIVED

This is a repository that is a template for lessons
http://datacarpentry.github.io/lesson-template
Other
7 stars 14 forks source link

Styling for DC lessons #3

Open lwasser opened 9 years ago

lwasser commented 9 years ago

Hi All, In the process of updating the python ecology lessons I setup a very basic set of styles (using SWC styles) and a landing page for the lessons: http://datacarpentry.github.io/python-ecology/

@qjcg added a few updates to it as well! (John - why can't i every find your name when i try to tag you in git??)

Let's begin the discussion surrounding what we want these lessons to look like. It could be cool to have a running list of lesson contributors on the landing page. i started that using manual additions. we could YAML it.

Also right now, there are many more styles then we need in the style sheets. we minus well clean that up too for simplicity sake.

Any and all feedback welcome. Once we decide on a format, we can apply to all repos and then have links from the DC website like SWC has. it's very nice to reference links when teaching rather than having to setup new ones or using the git repo directly.

Please respond with.

  1. what types of additional tweaks / styling you think the repo needs - if any?
  2. if you'd like to work with me to refine the DC lesson layout.
tracykteal commented 9 years ago

The lesson template in this repo is adapted from @lwasser Python lesson template. I'll work in this repo to clean it up, and please go ahead and PR and make suggestions!

tracykteal commented 9 years ago

I was using the _data directory to add information to the index.md file. The idea was that there wouldn't be any lesson specific information hard coded in to the template, so if we wanted to update it, it would be easy to do across all the lessons. I think that's not as important though, and it's better to have it in the YAML header where it's more expected. So, I'm going to switch it back to being in the header.

lwasser commented 9 years ago

cool --how did you use the data directory to populate content? the lessons.html is the end template that renders.

lwasser commented 9 years ago

ok i see how you're using the data folder now. the lessons are being populated from the YAML so we'll have to make a note to update the lessons yml file.

tracykteal commented 9 years ago

I changed it back to just use the YAML header in PR https://github.com/datacarpentry/lesson-template/pull/7

I think that's best, as it's the most expected