index.html 26 KB
Newer Older
maneesha's avatar
maneesha committed
1
<!-- ****IMPORTANT REMINDER****   -->
2
<h1>Delete this line and email the link to your workshop page to admin@software-carpentry.org.  If this is a self organized workshop, please be sure to include any other details Software Carpentry staff may need to know in your email.</h1>
maneesha's avatar
maneesha committed
3
4
5
6


<!-- See instructions in the comments below for how to edit specific sections of this workshop template. -->

7
---
8
9
10
11
12
13
14
15
16
17
18
19
20
21
layout: workshop      # DON'T CHANGE THIS.
root: .               # DON'T CHANGE THIS.
venue: "FIXME"        # brief name of host site without address (e.g., "Euphoric State University")
address: "FIXME"      # street address of workshop (e.g., "123 Forth Street, Blimingen, Euphoria")
country: "FIXME"      # country (lowercase two-letter ISO code such as "fr" - see https://en.wikipedia.org/wiki/ISO_3166-1)
language: "FIXME"     # language (lowercase two-letter ISO code such as "fr" - see https://en.wikipedia.org/wiki/ISO_639-1)
latlng: "FIXME"       # fractional latitude and longitude (e.g., "41.7901128,-87.6007318"; you can use http://www.latlong.net/)
humandate: "FIXME"    # human-readable date (e.g., "Feb 17-18, 2020")
humantime: "FIXME"    # human-readable time (e.g., "9:00 am - 4:30 pm")
startdate: FIXME      # use YYYY-MM-DD format like 2015-01-01
enddate: FIXME        # use YYYY-MM-DD format like 2015-01-02
instructor: ["FIXME"] # list of names like ["Kay McNulty", "Betty Jennings", "Betty Snyder"]
helper: ["FIXME"]     # list of names like ["Marlyn Wescoff", "Fran Bilas", "Ruth Lichterman"]
contact: "FIXME"      # contact email address for workshop organizer, such as "grace@hopper.org"
22
etherpad:         # optional (insert the URL for your Etherpad if you're using one)
23
eventbrite:       # optional (insert the alphanumeric key for Eventbrite registration, e.g., "1234567890AB")
24
---
25
<!--
26
27
  HEADER

28
29
30
31
  Edit the values in the block above to be appropriate for your workshop.
  If the value is not 'true', 'false', 'null', or a number, please use
  double quotation marks around the value, unless specified otherwise.
  And run 'tools/check' *before* committing to make sure that changes are good.
32
33
34
-->

<!--
35
36
  EVENTBRITE

37
38
39
40
41
  This block includes the Eventbrite registration widget if
  'eventbrite' has been set in the header.  You can delete it if you
  are not using Eventbrite, or leave it in, since it will not be
  displayed if the 'eventbrite' field in the header is not set.
-->
42
43
{% if page.eventbrite %}
<iframe
44
  src="https://www.eventbrite.com/tickets-external?eid={{page.eventbrite}}&ref=etckt"
45
  frameborder="0"
46
  width="100%"
47
  height="248px"
48
49
50
51
  scrolling="auto">
</iframe>
{% endif %}

52
<h2 id="general">General Information</h2>
53

54
<!--
55
56
  INTRODUCTION

57
58
59
  Edit the general explanatory paragraph below if you want to change
  the pitch.
-->
60
61
62
63
64
65
66
67
68
69
<p>
  <a href="{{site.swc_site}}">Software Carpentry</a>'s mission
  is to help scientists and engineers get more research done in less
  time and with less pain by teaching them basic lab skills for
  scientific computing.  This hands-on workshop will cover basic
  concepts and tools, including program design, version control, data
  management, and task automation.  Participants will be encouraged to
  help one another and to apply what they have learned to their own
  research problems.
</p>
70
71
72
73
74
75
76
<p align="center">
  <em>
    For more information on what we teach and why,
    please see our paper
    "<a href="http://journals.plos.org/plosbiology/article?id=10.1371/journal.pbio.1001745">Best Practices for Scientific Computing</a>".
  </em>
</p>
77

78
<!--
79
80
  AUDIENCE

81
82
83
  Explain who your audience is.  (In particular, tell readers if the
  workshop is only open to people from a particular institution.
-->
84
<p id="who">
85
86
  <strong>Who:</strong>
  The course is aimed at graduate students and other researchers.
87
88
  <strong>You don't need to have any previous knowledge of the tools that will
    be presented at the workshop.</strong>
89
90
</p>

91
<!--
92
93
  LOCATION

94
95
96
97
98
  This block displays the address and links to maps showing directions
  if the latitude and longitude of the workshop have been set.  You
  can use http://itouchmap.com/latlong.html to find the lat/long of an
  address.
-->
99
{% if page.latlng %}
100
<p id="where">
101
  <strong>Where:</strong>
102
  {{page.address}}.
103
  Get directions with
104
  <a href="//www.openstreetmap.org/?mlat={{page.latlng | replace:',','&mlon='}}&zoom=16">OpenStreetMap</a>
105
  or
106
  <a href="//maps.google.com/maps?q={{page.latlng}}">Google Maps</a>.
107
108
109
</p>
{% endif %}

110
<!--
111
112
  SPECIAL REQUIREMENTS

113
114
  Modify the block below if there are any special requirements.
-->
115
<p id="requirements">
116
  <strong>Requirements:</strong> Participants must bring a laptop with
117
118
119
  a few specific software packages installed (listed
  <a href="#setup">below</a>). They are also required to abide by
  Software Carpentry's
120
121
122
  <a href="{{site.swc_site}}/conduct.html">Code of Conduct</a>.
</p>

123
<!--
124
125
  CONTACT EMAIL ADDRESS

126
127
128
129
  Display the contact email address set in the header.  If an address
  isn't set in the header, the Software Carpentry admin address is
  used.
-->
130
<p id="contact">
131
132
133
134
135
136
137
138
139
140
141
142
  <strong>Contact</strong>:
  Please mail
  {% if page.contact %}
    <a href='mailto:{{page.contact}}'>{{page.contact}}</a>
  {% else %}
    <a href='mailto:{{site.contact}}'>{{site.contact}}</a>
  {% endif %}
  for more information.
</p>

<hr/>

143
<!--
144
145
  SCHEDULE

146
147
148
149
  Show the workshop's schedule.  Edit the items and times in the table
  to match your plans.  You may also want to change 'Day 1' and 'Day
  2' to be actual dates or days of the week.
-->
150
<h2 id="schedule">Schedule</h2>
151

152
<!-- DO NOT EDIT SURVEY LINKS -->
153
154
155
156
<p><em>Surveys</em></p>
<p>Please be sure to complete these surveys before and after the workshop.</p>
<p><a href='{{ site.swc_pre_survey }}{{ site.github.project_title }}'>Pre-workshop Survey</a></p>
<p><a href='{{ site.swc_post_survey }}{{ site.github.project_title }}'>Post-workshop Survey</a></p>
157

158
159
<div class="row">
  <div class="col-md-6">
160
161
    <h3>Day 1</h3>
    <table class="table table-striped">
162
      <tr> <td>09:00</td>  <td>Automating tasks with the Unix shell</td> </tr>
163
      <tr> <td>10:30</td> <td>Coffee</td> </tr>
164
165
166
167
      <tr> <td>12:00</td>  <td>Lunch break</td> </tr>
      <tr> <td>13:00</td>  <td>Building programs with Python</td> </tr>
      <tr> <td>14:30</td>  <td>Coffee</td> </tr>
      <tr> <td>16:00</td>  <td>Wrap-up</td> </tr>
168
169
    </table>
  </div>
170
  <div class="col-md-6">
171
172
    <h3>Day 2</h3>
    <table class="table table-striped">
173
174
175
176
177
178
      <tr> <td>09:00</td>  <td>Version control with Git</td> </tr>
      <tr> <td>10:30</td>  <td>Coffee</td> </tr>
      <tr> <td>12:00</td>  <td>Lunch break</td> </tr>
      <tr> <td>13:00</td>  <td>Managing data with SQL</td> </tr>
      <tr> <td>14:30</td>  <td>Coffee</td> </tr>
      <tr> <td>16:00</td>  <td>Wrap-up</td> </tr>
179
180
181
182
    </table>
  </div>
</div>

183
<!--
184
185
  ETHERPAD

Raniere Silva's avatar
Raniere Silva committed
186
187
  At `_misc/etherpad.txt` you will find a template for the etherpad.

188
189
190
  Display the Etherpad for the workshop.  You can set this up in
  advance or on the first day; either way, make sure you push changes
  to GitHub after you have its URL.  To create an Etherpad, go to
191

192
      http://pad.software-carpentry.org/YYYY-MM-DD-site
193

194
195
  where 'YYYY-MM-DD-site' is the identifier for your workshop,
  e.g., '2015-06-10-esu'.
196
197
-->
{% if page.etherpad %}
198
<p id="etherpad">
199
200
201
202
203
204
  <strong>Etherpad:</strong> <a href="{{page.etherpad}}">{{page.etherpad}}</a>.
  <br/>
  We will use this Etherpad for chatting, taking notes, and sharing URLs and bits of code.
</p>
{% endif %}

205
206
<hr/>

207
<!--
208
209
  SYLLABUS

210
211
212
213
214
215
216
  Show what topics will be covered.

  1. If your workshop is R rather than Python, remove the comment
     around that section and put a comment around the Python section.
  2. Some workshops will delete SQL.
  3. Please make sure the list of topics is synchronized with what you
     intend to teach.
217
218
  4. You may need to move the div's with class="col-md-6" around inside
     the div's with class="row" to balance the multi-column layout.
219
220
221
222
223

  This is one of the places where people frequently make mistakes, so
  please preview your site before committing, and make sure to run
  'tools/check' as well.
-->
224
<h2 id="syllabus">Syllabus</h2>
225

226
227
<div class="row">
  <div class="col-md-6">
228
    <h3 id="syllabus-shell">The Unix Shell</h3>
229
    <ul>
230
      <li>Files and directories</li>
231
232
233
234
      <li>History and tab completion</li>
      <li>Pipes and redirection</li>
      <li>Looping over files</li>
      <li>Creating and running shell scripts</li>
235
      <li>Finding things</li>
Raniere Silva's avatar
Raniere Silva committed
236
      <li><a href="{{site.swc_githubio}}/shell-novice/reference.html">Reference...</a></li>
237
238
    </ul>
  </div>
239
  <div class="col-md-6">
240
    <h3 id="syllabus-python">Programming in Python</h3>
241
242
243
244
245
    <ul>
      <li>Using libraries</li>
      <li>Working with arrays</li>
      <li>Reading and plotting data</li>
      <li>Creating and using functions</li>
246
      <li>Loops and conditionals</li>
247
248
      <li>Defensive programming</li>
      <li>Using Python from the command line</li>
Raniere Silva's avatar
Raniere Silva committed
249
      <li><a href="{{site.swc_githubio}}/python-novice-inflammation/reference.html">Reference...</a></li>
250
251
    </ul>
  </div>
252
253
  <!--
  <div class="col-md-6">
254
    <h3 id="syllabus-r">Programming in R</h3>
255
256
257
258
    <ul>
      <li>Working with vectors and data frames</li>
      <li>Reading and plotting data</li>
      <li>Creating and using functions</li>
259
      <li>Loops and conditionals</li>
260
      <li>Using R from the command line</li>
Raniere Silva's avatar
Raniere Silva committed
261
      <li><a href="{{site.swc_githubio}}/r-novice-inflammation/reference.html">Reference...</a></li>
262
263
    </ul>
  </div>
264
  -->
265
266
  <!--
  <div class="col-md-6">
267
    <h3 id="syllabus-matlab">Programming in MATLAB</h3>
268
269
270
271
272
273
274
275
276
277
    <ul>
      <li>Working with arrays</li>
      <li>Reading and plotting data</li>
      <li>Creating and using functions</li>
      <li>Loops and conditionals</li>
      <li>Defensive programming</li>
      <li><a href="{{site.swc_githubio}}/matlab-novice-inflammation/reference.html">Reference...</a></li>
     </ul>
   </div>
   -->
278
279
</div>

280
281
<div class="row">
  <div class="col-md-6">
282
    <h3 id="syllabus-git">Version Control with Git</h3>
283
284
285
286
287
288
289
290
291
    <ul>
      <li>Creating a repository</li>
      <li>Recording changes to files: <code>add</code>, <code>commit</code>, ...</li>
      <li>Viewing changes: <code>status</code>, <code>diff</code>, ...</li>
      <li>Ignoring files</li>
      <li>Working on the web: <code>clone</code>, <code>pull</code>, <code>push</code>, ...</li>
      <li>Resolving conflicts</li>
      <li>Open licenses</li>
      <li>Where to host work, and why</li>
Raniere Silva's avatar
Raniere Silva committed
292
      <li><a href="{{site.swc_githubio}}/git-novice/reference.html">Reference...</a></li>
293
294
    </ul>
  </div>
295
  <div class="col-md-6">
296
    <h3 id="syllabus-sql">Managing Data with SQL</h3>
297
298
299
300
301
302
303
304
305
    <ul>
      <li>Reading and sorting data</li>
      <li>Filtering with <code>where</code></li>
      <li>Calculating new values on the fly</li>
      <li>Handling missing values</li>
      <li>Combining values using aggregation</li>
      <li>Combining information from multiple tables using <code>join</code></li>
      <li>Creating, modifying, and deleting data</li>
      <li>Programming with databases</li>
Raniere Silva's avatar
Raniere Silva committed
306
      <li><a href="{{site.swc_githubio}}/sql-novice-survey/reference.html">Reference...</a></li>
307
308
309
310
311
312
    </ul>
  </div>
</div>

<hr/>

313
<!--
314
315
  SETUP

316
317
318
  Delete irrelevant sections from the setup instructions.  Each
  section is inside a 'div' without any classes to make the beginning
  and end easier to find.
319

320
321
322
323
  This is the other place where people frequently make mistakes, so
  please preview your site before committing, and make sure to run
  'tools/check' as well.
-->
324

325
<h2 id="setup">Setup</h2>
326

327
<p>
328
329
  To participate in a Software Carpentry workshop, you will need
  access to the software described below. In addition, you will
330
  need an up-to-date web browser.
331
332
</p>
<p>
David LeBauer's avatar
David LeBauer committed
333
334
  We maintain a list of common issues that occur during installation as a reference for instructors
  that may be useful on the
335
  <a href = "https://github.com/swcarpentry/workshop-template/wiki/Configuration-Problems-and-Solutions">Configuration Problems and Solutions wiki page</a>.
336
337
</p>

338
<div id="shell"> <!-- Start of 'shell' section. -->
339
  <h3>The Bash Shell</h3>
340

341
342
343
344
  <p>
    Bash is a commonly-used shell that gives you the power to do simple
    tasks more quickly.
  </p>
345

346
347
  <div class="row">
    <div class="col-md-4">
348
      <h4 id="shell-windows">Windows</h4>
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
      <ol>
        <li>Download the Git for Windows <a href="https://git-for-windows.github.io/">installer</a>.</li>
        <li>Run the installer and follow the steps bellow:
          <ol>
            <!-- Git 2.6.1 Setup -->
            <!-- Welcome to the Git Setup Wizard -->
            <li>Click on "Next".</li>
            <!-- Information -->
            <li>Click on "Next".</li>
            <!-- Select Destination Location -->
            <li>Click on "Next".</li>
            <!-- Select Components -->
            <li>Click on "Next".</li>
            <!-- Select Start Menu Folder -->
            <li>Click on "Next".</li>
            <!-- Adjusting your PATH environment -->
            <li>
              <strong>
                Select "Use Git from the Windows Command Prompt" and click on "Next".
              </strong>
                If you forgot to do this programs that you need for the workshop will not work properly.
                If this happens rerun the installer and select the appropriate option.
            </li>
            <!-- Configuring the line ending conversions -->
373
374
375
376
377
378
            <li>
              Click on "Next".
              <strong>
                Keep "Checkout Windows-style, commit Unix-style line endings" selected.
              </strong>
            </li>
379
            <!-- Configuring the terminal emulator to use with Git Bash -->
380
381
382
383
384
            <li>
              <strong>
                Select "Use Windows' default console window" and click on "Next".
              </strong>
            </li>
385
386
387
388
389
390
391
392
393
            <!-- Configuring experimental performance tweaks -->
            <li>Click on "Next".</li>
            <!-- Installing -->
            <!-- Completing the Git Setup Wizard -->
            <li>Click on "Finish".</li>
          </ol>
        </li>
      </ol>
      <p>This will provide you with both Git and Bash in the Git Bash program.</p>
394
    </div>
395
    <div class="col-md-4">
396
      <h4 id="shell-macosx">Mac OS X</h4>
397
      <p>
398
399
        The default shell in all versions of Mac OS X is Bash, so no
        need to install anything.  You access Bash from the Terminal
400
        (found in
401
        <code>/Applications/Utilities</code>). You may want to keep
402
        Terminal in your dock for this workshop.
403
404
      </p>
    </div>
405
    <div class="col-md-4">
406
      <h4 id="shell-linux">Linux</h4>
407
      <p>
408
409
410
411
        The default shell is usually Bash, but if your
        machine is set up differently you can run it by opening a
        terminal and typing <code>bash</code>.  There is no need to
        install anything.
412
413
      </p>
    </div>
414
  </div>
Raniere Silva's avatar
Raniere Silva committed
415
</div> <!-- End of 'shell' section. -->
416

417
418
<div id='git'> <!-- Start of 'Git' section. GitHub browser compatability
           is given at https://help.github.com/articles/supported-browsers/-->
419
  <h3>Git</h3>
420

421
422
423
424
  <p>
    Git is a version control system that lets you track who made changes
    to what when and has options for easily updating a shared or public
    version of your code
425
    on <a href="https://github.com/">github.com</a>. You will need a
426
427
    <a href="https://help.github.com/articles/supported-browsers/">supported</a>
    web browser (current versions of Chrome, Firefox or Safari,
428
    or Internet Explorer version 9 or above).
429
  </p>
430

431
432
  <div class="row">
    <div class="col-md-4">
433
      <h4 id="git-windows">Windows</h4>
434
      <p>
435
436
        Git should be installed on your computer as part of your Bash
        install (described above).
437
438
      </p>
    </div>
439
    <div class="col-md-4">
440
      <h4 id="git-macosx">Mac OS X</h4>
441
      <p>
Greg Wilson's avatar
Merging    
Greg Wilson committed
442
443
444
445
        <strong>For OS X 10.9 and higher</strong>, install Git for Mac
        by downloading and running the most recent "mavericks" installer from
        <a href="http://sourceforge.net/projects/git-osx-installer/files/">this list</a>.
        After installing Git, there will not be anything in your <code>/Applications</code> folder,
446
        as Git is a command line program.
Greg Wilson's avatar
Merging    
Greg Wilson committed
447
448
449
        <strong>For older versions of OS X (10.5-10.8)</strong> use the
        most recent available installer labelled "snow-leopard"
        <a href="http://sourceforge.net/projects/git-osx-installer/files/">available here</a>.
450
451
      </p>
    </div>
452
    <div class="col-md-4">
453
      <h4 id="git-linux">Linux</h4>
454
      <p>
455
456
        If Git is not already available on your machine you can try to
        install it via your distro's package manager. For Debian/Ubuntu run
457
458
        <code>sudo apt-get install git</code> and for Fedora run
        <code>sudo yum install git</code>.
459
460
      </p>
    </div>
461
  </div>
462
</div> <!-- End of 'Git' section. -->
463

Raniere Silva's avatar
Raniere Silva committed
464
465
466
467
468
469
470
471
472
<div id="editor"> <!-- Start of 'editor' section. -->
  <h3>Text Editor</h3>

  <p>
    When you're writing code, it's nice to have a text editor that is
    optimized for writing code, with features like automatic
    color-coding of key words.  The default text editor on Mac OS X and
    Linux is usually set to Vim, which is not famous for being
    intuitive.  if you accidentally find yourself stuck in it, try
Raniere Silva's avatar
Raniere Silva committed
473
    typing the escape key, followed by <code>:q!</code> (colon, lower-case 'q',
Raniere Silva's avatar
Raniere Silva committed
474
475
476
477
478
479
480
    exclamation mark), then hitting Return to return to the shell.
  </p>

  <div class="row">
    <div class="col-md-4">
      <h4 id="editor-windows">Windows</h4>
      <p>
481
        nano is a basic editor and the default that instructors use in the workshop.
482
        To install it,
Raniere Silva's avatar
Raniere Silva committed
483
484
485
486
487
        download the <a href="{{site.swc_installer}}">Software Carpentry Windows installer</a>
        and double click on the file to run it.
        <strong>This installer requires an active internet connection.</strong>
      </p>
      <p>
Raniere Silva's avatar
Raniere Silva committed
488
        Others editors that you can use are
489
490
        <a href="http://notepad-plus-plus.org/">Notepad++</a> or
        <a href="http://www.sublimetext.com/">Sublime Text</a>.
Raniere Silva's avatar
Raniere Silva committed
491
492
        <strong>Be aware that you must
          add its installation directory to your system path.</strong>
493
        Please ask your instructor to help you do this.
Raniere Silva's avatar
Raniere Silva committed
494
495
496
497
498
      </p>
    </div>
    <div class="col-md-4">
      <h4 id="editor-macosx">Mac OS X</h4>
      <p>
499
        nano is a basic editor and the default that instructors use in the workshop.
Raniere Silva's avatar
Raniere Silva committed
500
501
502
        It should be pre-installed.
      </p>
      <p>
Raniere Silva's avatar
Raniere Silva committed
503
        Others editors that you can use are
504
505
        <a href="http://www.barebones.com/products/textwrangler/">Text Wrangler</a> or
        <a href="http://www.sublimetext.com/">Sublime Text</a>.
Raniere Silva's avatar
Raniere Silva committed
506
507
508
509
510
      </p>
    </div>
    <div class="col-md-4">
      <h4 id="editor-linux">Linux</h4>
      <p>
511
        nano is a basic editor and the default that instructors use in the workshop.
Raniere Silva's avatar
Raniere Silva committed
512
513
514
        It should be pre-installed.
      </p>
      <p>
Raniere Silva's avatar
Raniere Silva committed
515
        Others editors that you can use are
Raniere Silva's avatar
Raniere Silva committed
516
        <a href="https://wiki.gnome.org/Apps/Gedit">Gedit</a>,
517
518
        <a href="http://kate-editor.org/">Kate</a> or
        <a href="http://www.sublimetext.com/">Sublime Text</a>.
Raniere Silva's avatar
Raniere Silva committed
519
520
521
522
523
      </p>
    </div>
  </div>
</div> <!-- End of 'editor' section. -->

524
<div id="python"> <!-- Start of 'Python' section. Remove the third paragraph if
525
526
527
           the workshop will teach Python using something other than
           the IPython notebook.
           Details at http://ipython.org/ipython-doc/2/install/install.html#browser-compatibility -->
528
  <h3>Python</h3>
529

530
531
532
533
  <p>
    <a href="http://python.org">Python</a> is a popular language for
    scientific computing, and great for general-purpose programming as
    well.  Installing all of its scientific packages individually can be
534
    a bit difficult, so we recommend
535
    <a href="https://www.continuum.io/anaconda">Anaconda</a>,
536
    an all-in-one installer.
537
  </p>
538

Greg Wilson's avatar
Greg Wilson committed
539
540
    <p>
      Regardless of how you choose to install it,
541
542
      <strong>please make sure you install Python version 3.x</strong>
      (e.g., 3.4 is fine).
Greg Wilson's avatar
Greg Wilson committed
543
    </p>
544

545
546
547
    <p>
      We will teach Python using the IPython notebook, a programming environment
      that runs in a web browser. For this to work you will need a reasonably
548
      up-to-date browser. The current versions of the Chrome, Safari and
549
550
551
      Firefox browsers are all <a
      href='http://ipython.org/ipython-doc/2/install/install.html#browser-compatibility'>supported</a>
      (some older browsers, including Internet Explorer version 9
552
      and below, are not).
553
554
    </p>

555
556
  <div class="row">
    <div class="col-md-4">
557
      <h4 id="python-windows">Windows</h4>
558
559
      <ol>
        <li>Open <a href="http://continuum.io/downloads">http://continuum.io/downloads</a> with your web browser.</li>
560
        <li>Download the Python 3 installer for Windows.</li>
561
562
        <li>Install Python 3 using all of the defaults for installation <em>except</em> make sure to check <strong>Make Anaconda the default Python</strong>.</li>
      </ol>
563
    </div>
564
    <div class="col-md-4">
565
      <h4 id="python-macosx">Mac OS X</h4>
566
567
      <ol>
        <li>Open <a href="http://continuum.io/downloads">http://continuum.io/downloads</a> with your web browser.</li>
568
        <li>Download the Python 3 installer for OS X.</li>
569
570
        <li>Install Python 3 using all of the defaults for installation.</li>
      </ol>
571
    </div>
572
    <div class="col-md-4">
573
      <h4 id="python-linux">Linux</h4>
574
      <ol>
575
        <li>Open <a href="http://continuum.io/downloads">http://continuum.io/downloads</a> with your web browser.</li>
576
        <li>Download the Python 3 installer for Linux.</li>
577
578
579
580
        <li>Install Python 3 using all of the defaults for installation.
        (Installation requires using the shell. If you aren't
        comfortable doing the installation yourself
        stop here and request help at the workshop.)</li>
581
        <li>
582
          Open a terminal window.
583
584
        </li>
        <li>
585
586
587
          Type <pre>bash Anaconda-</pre> and then press
          tab. The name of the file you just downloaded should
          appear.
588
589
        </li>
        <li>
590
591
592
593
594
595
596
          Press enter. You will follow the text-only prompts.  When
          there is a colon at the bottom of the screen press the down
          arrow to move down through the text. Type <code>yes</code> and
          press enter to approve the license. Press enter to approve the
          default location for the files. Type <code>yes</code> and
          press enter to prepend Anaconda to your <code>PATH</code>
          (this makes the Anaconda distribution the default Python).
597
        </li>
598
599
      </ol>
    </div>
600
  </div>
601
<!--
602
603
604
605
606
  <p>
  Once you are done installing the software listed above,
  please go to <a href="setup/index.html">this page</a>,
  which has instructions on how to test that everything was installed correctly.
  </p>
607
-->
608
</div> <!-- End of 'Python' section. -->
609

610
<div id="r"> <!-- Start of 'R' section. -->
611
  <h3>R</h3>
612

613
614
615
616
617
618
  <p>
    <a href="http://www.r-project.org">R</a> is a programming language
    that is especially powerful for data exploration, visualization, and
    statistical analysis. To interact with R, we use
    <a href="http://www.rstudio.com/">RStudio</a>.
  </p>
619

620
621
  <div class="row">
    <div class="col-md-4">
622
      <h4 id="r-windows">Windows</h4>
623
      <p>
624
625
626
627
628
        Install R by downloading and running
        <a href="http://cran.r-project.org/bin/windows/base/release.htm">this .exe file</a>
        from <a href="http://cran.r-project.org/index.html">CRAN</a>.
        Also, please install the
        <a href="http://www.rstudio.com/ide/download/desktop">RStudio IDE</a>.
629
630
      </p>
    </div>
631
    <div class="col-md-4">
632
      <h4 id="r-macosx">Mac OS X</h4>
633
      <p>
634
635
636
637
638
        Install R by downloading and running
        <a href="http://cran.r-project.org/bin/macosx/R-latest.pkg">this .pkg file</a>
        from <a href="http://cran.r-project.org/index.html">CRAN</a>.
        Also, please install the
        <a href="http://www.rstudio.com/ide/download/desktop">RStudio IDE</a>.
639
640
      </p>
    </div>
641
    <div class="col-md-4">
642
      <h4 id="r-linux">Linux</h4>
643
      <p>
644
645
646
647
        You can download the binary files for your distribution
        from <a href="http://cran.r-project.org/index.html">CRAN</a>. Or
        you can use your package manager (e.g. for Debian/Ubuntu
        run <code>sudo apt-get install r-base</code> and for Fedora run
648
        <code>sudo yum install R</code>).  Also, please install the
649
        <a href="http://www.rstudio.com/ide/download/desktop">RStudio IDE</a>.
650
651
      </p>
    </div>
652
  </div>
653
</div> <!-- End of 'R' section. -->
654

655
<div id="sql"> <!-- Start of 'SQLite' section. -->
656
  <h3>SQLite</h3>
657

658
659
660
661
662
  <p>
    SQL is a specialized programming language used with databases.  We
    use a simple database manager called
    <a href="http://www.sqlite.org/">SQLite</a> in our lessons.
  </p>
663

664
665
  <div class="row">
    <div class="col-md-4">
666
      <h4 id="sql-windows">Windows</h4>
667
      <p>
668
669
670
        The <a href="{{site.swc_github}}/windows-installer">Software Carpentry Windows Installer</a>
        installs SQLite for Windows.
        If you used the installer to configure nano, you don't need to run it again.
671
672
      </p>
    </div>
673
    <div class="col-md-4">
674
      <h4 id="sql-macosx">Mac OS X</h4>
675
      <p>
676
        SQLite comes pre-installed on Mac OS X.
677
678
      </p>
    </div>
679
    <div class="col-md-4">
680
      <h4 id="sql-linux">Linux</h4>
681
      <p>
682
        SQLite comes pre-installed on Linux.
683
684
      </p>
    </div>
685
  </div>
686
687

  <p><strong>If you installed Anaconda, it also has a copy of SQLite
Raniere Silva's avatar
Raniere Silva committed
688
    <a href="https://github.com/ContinuumIO/anaconda-issues/issues/307">without support to <code>readline</code></a>.
689
    Instructors will provide a workaround for it if needed.</strong></p>
690
</div> <!-- End of 'SQLite' section. -->
691

692
693
<!--
  Uncomment this section if you are using our virtual machine.
694

695
<div id="vm">
696
  <h3>Virtual Machine</h3>
697

698
699
700
701
702
703
704
705
706
707
  <p>
    Some instructors prefer to have learners use a virtual machine (VM)
    rather than install software on their own computers.  If your
    instructors have chosen to do this, please:
  </p>
  <ol>
    <li>
      Install <a href="https://www.virtualbox.org/">VirtualBox</a>.
    </li>
    <li>
708
      Download our <a href="{{site.swc_vm}}">VM image</a>.
709
710
711
712
713
714
715
716
717
718
      <strong>Warning:</strong> this file is 1.7 GByte, so please
      download it <em>before</em> coming to your workshop.
    </li>
    <li>
      Load the VM into VirtualBox by selecting "Import Appliance" and
      loading the <code>.ova</code> file.
    </li>
  </ol>
</div>
-->