_config.yml: Customize set up information for use as site.variablesindex.html: Course description and site navigationabout/: acknowledgements.md, audience.md, and why-. filesSTART-for-self-guided-students.md: Anyone should be able to start from herecomputer-setup.md: List preparations for prerequisite knowledge & technologysyllabus.md: Course details and policy. START-for-self-guided-students.md syllabus.md
\____________________________/
|
schedule.md
|
_______________________|_____________________
/ | \
readings/ lectures/ assignments/
schedule.md generates links for a list of assignments: for each of the major course element: reading, lecture, assignmentselement: must share a title: that is inserted into the
assignments: list and language:element: may share a common file name, language-short-description.md.assignments/ MUST have a lower case file name.readings/ and lectures/ have an UPPER first letter of the file name, for
proper inclusion in assignments/. readings/ lectures/ assignments/
--- --- ---
layout: page layout: page layout: page
element: reading element: lecture element: assignment
title: Hello World title: Hello World title: Hello World
language: Foo language: Foo language: Foo
--- --- exercises: ['Ba Ram', 'Ewe']
---
lectures/ --> materials/
---
layout: page
element: notes
title: Hello Foos
language: Foo
---
lectures/ use links to organize materials/.
[link text](/materials/file-name).MD after file-name assignments/
______________|_____________
/ | \
readings/ lectures/ exercises/
_____|_____
/ | \
solutions/ code/ data/
assignments/ organize exercises/ with the exercise: list of exercises/ title:---
layout: exercise
topic: Practice
title: Ba Ram
language: Foo
---
exercises/ file names share similar values to exercises/ YAML in the form:
Topic-title-Language.md.
Practice-ba-ram-Foo.mdexercises/ file names MUST start with an UPPER first letter.solutions/ file names MUST match the exercises/ file name and can use any extension. For example: Practice-ba-ram-Foo.txtsolutions/ files can be numbered following the exercises/ file name and before the file extension with a -.
Practice-ba-ram-Foo-1.txt,Practice-ba-ram-Foo-2.jpg, …code/ and data/ files can be linked to exercises
[Code file](/code/code-file.foo)[Data file](/data/data-file.csv)