Making with Code

Configuration #

Configuration Files #

Multiple configuration files are provided to build Making with Code for various audiences:

  • dev (default)
  • teachers
  • students

To build for a particular audience, use the environment flag:

hugo --environment teachers

Configuration Params #

The following params are defined. Making with Code extends the Book theme, so those params are defined as well. You should not need to modify these directly. Instead, use the environment flag.

ShowTeaching #

Show teaching content on courses, units, lessons, and modules.

ShowNotes #

Show teaching notes (only if ShowTeaching is also set).

ShowDev #

Shows the development documentation and content within the dev_note shortcode.

Points to the site logo, by default "fablearn.png".

CustomCSS #

A list of custom CSS files to inject into the header.

ExcludeTypesFromMenu #

Certain types are only intended to be included in larger blocks of content, not on their own. Defaults to ["teaching", "notes"]

Teacher #

The name which should be used when referring to the teacher. (See the teacher shortcode.)

LookAction #

The symbol to indicate that the reader should read or watch something. (See the look-action shortcode.)

CodeAction #

The symbol to indicate that the reader should do something in code or in their Terminal. (See the code-action shortcode.)

WriteAction #

The symbol to indicate that the reader should write or draw something on paper or a Google Doc. (See the write-action shortcode.)

BookSection #

This param from the Book theme is ignored.