| layout | root | permalink |
|---|---|---|
lesson |
. |
index.html |
The material provided here seeks to take a Software Carpentry (SWC) lesson approach to describing the process by which the standard SWC lesson style may be altered so as to allow for a lesson's rendered HTML to not only be viewed using a webserver, but just also when using basic file:/// URIs, which we term an "offline rendering".
As this lesson is unlikely to be given within an official SWC event, it also seeks to provide a template that allows for non-SWC branding (or perhaps SWC de-branding ?) to be applied, whilst maintaining the look and feel that people familiar with studying content from official SWC lessons will have become used to, as well as making it easier for content from within non-SWC lessons to be re-used withn official SWC material.
Those of you who think you may have seen this before are correct. This is a newer version of the work here: https://vuw-ecs-kevin.github.io/offline-capable-lesson/
This lesson is therefore "Alpha" in that the change history from the previous project lesson need to be applied to a more up-to-date Software Carpentry base.
It should also be noted that some of the suggestions from that previous work have since been incorperated into the Carpentry base lesson: but not all!
This material assumes readers will have become familiar with the standard SWC procedure for creating standalone lessons and/or will be have access to a local copy (cloned or otherwise) of SWC lesson-templated source material, and the toolchain required to render the source material with a
make site{: .prereq}
{% include links.md %}