Skip to content
This repository has been archived by the owner on Feb 22, 2022. It is now read-only.

Course content structure #28

Merged
merged 19 commits into from
Nov 18, 2019
Merged

Course content structure #28

merged 19 commits into from
Nov 18, 2019

Conversation

gumaerc
Copy link
Contributor

@gumaerc gumaerc commented Nov 14, 2019

Pre-Flight checklist

  • Testing
    • Code is tested
    • Changes have been manually tested

What are the relevant tickets?

Closes #3

What's this PR do?

Adds an example content structure from the Spring 2010 Linear Algebra course, minus the Instructor Insights and Video Lectures sections. PDF's hosted along with the course on OCW are stored in the static folder for now and linked to with a relative URL. The appearance / origanization of the assignments section is slightly different in that it is not organized in a table like the OCW page. In markdown, representing multi line content in a table cell is messy.

How should this be manually tested?

Run the site and visit each section by typing the folder name at the end of the URL, for example: http://localhost:3000/exams

@noisecapella noisecapella self-assigned this Nov 15, 2019
---
The problem sets make up 15% of the course grade. Problems are assigned from the required text: Buy at Amazon Strang, Gilbert. Introduction to Linear Algebra. 4th ed. Wellesley-Cambridge Press, 2009. ISBN: 9780980232714.

## Problem set 1 - [(Solutions PDF)](assignments/MIT18_06S10_pset1_s10_soln.pdf)

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The PR description says this is in the static folder but it's with the course content. Did you figure out how this should work with CDNs?

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nevermind, I was looking at an older commit

Copy link
Contributor Author

@gumaerc gumaerc Nov 15, 2019

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The PR description says this is in the static folder but it's with the course content. Did you figure out how this should work with CDNs?

I think that's outside the scope of this PR. Ultimately, this content will be edited in a browser through some kind of CMS, whether that ends up being Netlify or something else. Netlify has CDN integration through either Cloudinary or Uploadcare. It allows you to upload content and embed it in a page, generating the markdown for you with the CDN link. While Netlify CMS doesn't currently support Hugo Page Bundles in the way they're implemented here, their lead dev has commented that support could be added for this within a month:

decaporg/decap-cms#513

For this PR, it's just solving the issue of "As a content author I would like to organize my course content in sections." Since there's another Issue for "As a content author I would like to use a GUI to write my course content and their respective resources," I figured here we would be just adding some sample content separated into course sections, as if you had done it without a GUI.


| EXAMS | SOLUTIONS |
|------------------------------------------------------|----------------------------------------------|
| Exam 1 [(PDF)](exams/MIT18_06S10_exam1_s10.pdf) | [(PDF)](exams/MIT18_06S10_exam1_s10_sol.pdf) |
Copy link

@noisecapella noisecapella Nov 15, 2019

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

When I click on one of the solutions links I see a default mostly empty page. Is that what the 404 page would be?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There were some typos in the links, I fixed them. That is the 404 page though, which is currently blank. We should make an issue to fix that.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sure, I just made an issue for that #31

@gumaerc gumaerc merged commit e734a8d into master Nov 18, 2019
@gumaerc gumaerc deleted the cg/course-content-structure branch November 18, 2019 19:12
noisecapella pushed a commit that referenced this pull request Nov 18, 2019
* Add sample syllabus leaf page bundle.

* Clean formatting on syllabus page.

* Add sample calendar section

* Add sample assignments page.

* Add assignment PDF's to assignments leaf bundle.

* Add shortcode template for a page resource link and implement it in the assignments page to generate links to the assignment PDFs.

* Denote that the embedded PDF's are solutions

* Add readings section

* Beautify markdown tables

* Back off custom shortcode to use hugo bundle resources and just put assignment pdf's in the static folder for now using relative links.

* Add exams section

* Add study materials section

* Add tools section

* Add related-resources page

* Standard formatting on related-resources page

* Fix some typos in the paths to the solution PDF's

* Add "buy it on amazon" stock image

* Fix links on the syllabus page

* Update some links in the sample content.
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

As a content author I would like to organize my course content in sections
2 participants