Commit 729d5d57 authored by Raniere Silva's avatar Raniere Silva
Browse files

Merge pull request #10 from gvwilson/removing-motivational-slideshow

Removing motivational slideshow
parents 398e6888 6e1ae138
Loading
Loading
Loading
Loading
+5 −43
Original line number Diff line number Diff line
@@ -63,8 +63,7 @@ plots, and diagrams used in the lessons must go in a `fig/` directory.

Files used to display the lesson, such as artwork, CSS, and
Javascript, are stored in `img/`, `css/`, and `js/` directories of
their own, while the `deck.js/` directory contains files used to make
HTML slideshows.  We keep website artwork in the `img/` directory
their own.  We keep website artwork in the `img/` directory
separate from figures used in the lesson (which are stored in `fig/`)
to make it simple to update the former automatically.  Most authors
should not need to modify any of the support files themselves.
@@ -98,22 +97,18 @@ The root directory holds the content of the lesson, and must contain:
    this lesson, and is about the filesystem. (Note that we use hyphens
    rather than underscores in filenames.) See "Topics" below.

4.  `motivation.md`: slides for a short introductory presentation (three
    minutes or less) explaining what the lesson is about and why people
    would want to learn it. See "Introductory Slides" below.

5.  `reference.md`: a cheat sheet summarizing key terms and commands,
4.  `reference.md`: a cheat sheet summarizing key terms and commands,
    syntax, etc., that can be printed and given to learners. See
    "Reference Guide" below.

6.  `discussion.md`: notes about more advanced ideas that would
5.  `discussion.md`: notes about more advanced ideas that would
    distract from the main lesson, and pointers to where to go next.
    See "Discussion Page" below.

7.  `instructors.md`: the instructor's guide for the lesson. See
6.  `instructors.md`: the instructor's guide for the lesson. See
    "Instructor's Guide" below.

8.  `CONTRIBUTING.md`: instructions for people who want to contribute.
7.  `CONTRIBUTING.md`: instructions for people who want to contribute.
    This file should be edited to replace references to `lesson-template`
    with references to your lesson's repository.

@@ -337,39 +332,6 @@ random number generation is outside the scope of the lesson,
    summary(ex_dat)
    ```

## Motivational Slides

Every lesson must include a short slide deck in `motivation.md` suitable for a short
presentation (3 minutes or less) that the instructor can use to explain
to learners how knowing the subject will help them.  The slides must
use level-2 headings as slide titles, but may use anything within the slide:

    ---
    layout: slides
    title: Lesson Title
    subtitle: Motivation
    ---
    ## Our Mission

    We make scientists and engineering more productive
    by teaching them basic computing skills.


    ## The Problem

    - Surveyed 1972 scientists in 2008.
    - "How do you use computers?"
    - "How did you learn what you know?"

**Notes:**

1.  We use [deck.js](http://imakewebthings.com/deck.js/) for our slides
    as it is simpler and prettier than alternatives like
    [reveal.js](http://lab.hakim.se/reveal-js/).

2.  For examples of slideshows, please see the
    [slideshow repository](https://github.com/swcarpentry/slideshows).

## Reference Guide

The reference guide in `reference.md` is a cheat sheet for learners to print, doodle on,
+0 −3
Original line number Diff line number Diff line
@@ -200,9 +200,6 @@ cover, and that coverage to include:

Along with the lesson materials themselves, each lesson must contain:

*   *Introductory slides* to give learners a sense of where the next
    two or three hours are going to take them.

*   A *reference guide* that learners can use during the lesson and take
    away afterward.  This must include a glossary of terms, not only to
    help learners, but also to help lesson authors summarize what the
+5 −1
Original line number Diff line number Diff line
@@ -12,8 +12,12 @@
      <article>
      <div class="row">
        <div class="col-md-10 col-md-offset-1">
          $if(subtitle)$
          <a href="index.html"><h1 class="title">$title$</h1></a>
          <h2 class="subtitle">$subtitle$</h2>
          $else$
          <h1 class="title">$title$</h1>
          $if(subtitle)$<h2 class="subtitle">$subtitle$</h2>$endif$
          $endif$
$body$
        </div>
      </div>

_layouts/slides.html

deleted100644 → 0
+0 −47
Original line number Diff line number Diff line
<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
  <meta name="viewport" content="width=1024, user-scalable=no">

  <title>Software Carpentry</title>

  <!-- Required stylesheet -->
  <script src="js/deckjs-custom.js"></script>
  <script>includedeck(["css/slideshow.css"],{});</script>
  <style>
    .slide.title-slide h1 {padding-bottom: 0;} /* title is long... */
    a {text-decoration: underline;} /* make links clearer */
    pre {font-size: 75%;} /* make code blocks smaller */
  </style>

  <!-- Required Modernizr file -->
  <script src="js/modernizr.custom.js"></script>
</head>
<body>
  <div class="deck-container">

    <!-- Begin slides. Just make elements with a class of slide. -->
$body$
    <!-- End slides. -->

    <!-- Begin extension snippets. Add or remove as needed. -->

    <!-- deck.navigation snippet -->
    <div aria-role="navigation">
      <a href="#" class="deck-prev-link" title="Previous">&#8592;</a>
      <a href="#" class="deck-next-link" title="Next">&#8594;</a>
    </div>

    <!-- deck.status snippet -->
    <p class="deck-status" aria-role="status">
      <span class="deck-status-current"></span>
      /
      <span class="deck-status-total"></span>
    </p>

    <!-- End extension snippets. -->
  </div>
</body>
</html>

_layouts/slides.revealjs

deleted100644 → 0
+0 −62
Original line number Diff line number Diff line
<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
  <meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0">

$for(author-meta)$
  <meta name="author" content="$author-meta$">
$endfor$
$if(date-meta)$
  <meta name="date" content="$date-meta$">
$endif$
  <title>$if(title-prefix)$$title-prefix$ - $endif$$pagetitle$</title>

$for(css)$
  <link rel="stylesheet" href="$css$" $if(html5)$$else$type="text/css" $endif$/>
$endfor$

  <script src="js/deckjs-custom.js"></script>
  <script>
      // TODO: finer filter on what is needed (vs profile-5)
      includedeck("css/swc-slides.css", {
         BEFOREINIT: function() {
            $$(".slide.auto li:not(li li):not(.notslide)").addClass("slide");
         }
      });
  </script>
</head>
<body>
  <div class="deck-container">

$if(omit-title)$
$else$
    <div class="slide title-slide" data-container-class="no-status">
        <h1 class="var-title"></h1>
        <img class="logo" src="img/software-carpentry-banner.png" alt="Software Carpentry"/>
    </div>
$endif$

    <!-- Begin slides. Just make elements with a class of slide. -->
$body$
    <!-- End slides. -->

    <!-- Begin extension snippets. Add or remove as needed. -->

    <!-- deck.navigation snippet -->
    <div aria-role="navigation">
      <a href="#" class="deck-prev-link" title="Previous">&#8592;</a>
      <a href="#" class="deck-next-link" title="Next">&#8594;</a>
    </div>

    <!-- footer -->
    <p class="deck-status deck-progress-10"> <span class="deck-status-current"></span> / <span class="deck-status-total"></span><span class="var-title">will be replaced by the title</span></p>
    <!-- progress bar -->
    <div class="progress-bar" data-progress-size=":spe.bottom(0, 1) ; left: slide.left+'px' ; height: designRatio+'px'" data-progress="width: detail.p * slide.width" style="position: absolute;"> </div>

    <!-- End extension snippets. -->
  </div>

</body>
</html>
Loading