diff --git a/_episodes/02-formatting.md b/_episodes/02-formatting.md index 843a6d61fe2b5f813381d044a2c14835e3e5a4cd..4d895acbdd9d152cc1273110096f11d358a2ac05 100644 --- a/_episodes/02-formatting.md +++ b/_episodes/02-formatting.md @@ -24,6 +24,11 @@ each of which has: * some teachable content * some exercises +The diagram below shows the internal structure of a single episode file +(click on the image to see a larger version): + +Formatting Rules + ## Locations and Names Episode files are stored in `_episodes` so that [Jekyll][jekyll] will create a [collection][jekyll-collection] for them. diff --git a/_episodes/03-organization.md b/_episodes/03-organization.md index 1972754c16f159b445405590bfc14bf01a769a50..93483fdbef5a29325cce1a3a3d917085451d4dc2 100644 --- a/_episodes/03-organization.md +++ b/_episodes/03-organization.md @@ -20,9 +20,10 @@ We could load these from the web, but that would make offline authoring difficult. Instead, each lesson's repository is self-contained. -![Source and Destination Files]({{ site.root }}/fig/file-mapping.svg) +The diagram below shows how source files and directories are laid out, +and how they are mapped to destination files and directories: -![Formatting Rules]({{ site.root }}/fig/episode-format.png) +![Source and Destination Files]({{ site.root }}/fig/file-mapping.svg) > ## Collections > diff --git a/fig/SWC_episode_format_small.png b/fig/episode-format-small.png similarity index 100% rename from fig/SWC_episode_format_small.png rename to fig/episode-format-small.png