Skip to content
This repository has been archived by the owner on Jan 3, 2018. It is now read-only.

Commit

Permalink
Reorganizing material to put novice + intermediate at top level
Browse files Browse the repository at this point in the history
  • Loading branch information
gvwilson committed Feb 16, 2014
1 parent 6bf3e7f commit b8c7dc3
Show file tree
Hide file tree
Showing 556 changed files with 50 additions and 113 deletions.
53 changes: 28 additions & 25 deletions Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -17,15 +17,17 @@ MARKDOWN_SRC = \
rules.md \
setup.md \
team.md \
$(wildcard shell/novice/*.md) \
$(wildcard git/novice/*.md) \
$(wildcard python/novice/*.md) \
$(wildcard sql/novice/*.md) \
$(wildcard teaching/novice/*.md)
$(wildcard novice/shell/*.md) \
$(wildcard novice/git/*.md) \
$(wildcard novice/python/*.md) \
$(wildcard novice/sql/*.md) \
$(wildcard novice/extras/*.md) \
$(wildcard novice/teaching/*.md) \
$(wildcard novice/ref/*.md)

NOTEBOOK_SRC = \
$(wildcard python/novice/??-*.ipynb) \
$(wildcard sql/novice/??-*.ipynb)
$(wildcard novice/python/??-*.ipynb) \
$(wildcard novice/sql/??-*.ipynb)

# Slides.
SLIDES_SRC = \
Expand All @@ -40,15 +42,16 @@ HTML_DST = \
$(patsubst %.md,$(OUT)/%.html,$(MARKDOWN_SRC)) \
$(patsubst %.md,$(OUT)/%.html,$(NOTEBOOK_MD))

# Source for book (in order, with some substutitions).
BOOK_SRC = \
intro.md \
shell/novice/index.md $(wildcard shell/novice/*-*.md) \
git/novice/index.md $(wildcard git/novice/*-*.md) \
python/novice/index.md $(patsubst %.ipynb,%.md,$(wildcard python/novice/??-*.ipynb)) \
sql/novice/index.md $(patsubst %.ipynb,%.md,$(wildcard sql/novice/??-*.ipynb)) \
extras/novice/index.md $(wildcard extras/novice/*-*.md) \
teaching/novice/index.md $(wildcard teaching/novice/*-*.md) \
ref/novice/index.md $(wildcard ref/novice/*-*.md) \
novice/shell/index.md $(wildcard novice/shell/*-*.md) \
novice/git/index.md $(wildcard novice/git/*-*.md) \
novice/python/index.md $(patsubst %.ipynb,%.md,$(wildcard novice/python/??-*.ipynb)) \
novice/sql/index.md $(patsubst %.ipynb,%.md,$(wildcard novice/sql/??-*.ipynb)) \
novice/extras/index.md $(wildcard novice/extras/*-*.md) \
novice/teaching/index.md $(wildcard novice/teaching/*-*.md) \
novice/ref/index.md $(wildcard novice/ref/*-*.md) \
bib.md \
tmp/gloss.md \
rules.md \
Expand Down Expand Up @@ -92,7 +95,7 @@ $(BOOK_DST) : $(OUT)/index.html $(BOOK_TMP) _templates/book.tpl tmp/gloss.md bin
# Build HTML versions of Markdown source files using Jekyll.
$(OUT)/index.html : $(MARKDOWN_SRC) $(NOTEBOOK_MD)
jekyll -t build -d $(OUT)
sed -i -e 's!img src="python/novice/!img src="!g' $(OUT)/python/novice/??-*.html
sed -i -e 's!img src="novice/python/!img src="!g' $(OUT)/novice/python/??-*.html

# Build Markdown versions of IPython Notebooks.
%.md : %.ipynb _templates/ipynb.tpl
Expand All @@ -104,25 +107,25 @@ tmp/gloss.md : gloss.md
sed -e 's!](#!](#g:!g' -e 's!<a name="!<a name="#g:!g' $< > $@

# Patch image paths in the sections.
tmp/shell/novice/%.md : shell/novice/%.md
tmp/novice/shell/%.md : novice/shell/%.md
@mkdir -p $$(dirname $@)
sed -e 's!<img src="img!<img src="shell/novice/img!g' $< > $@
sed -e 's!<img src="img!<img src="novice/shell/img!g' $< > $@

tmp/git/novice/%.md : git/novice/%.md
tmp/novice/git/%.md : novice/git/%.md
@mkdir -p $$(dirname $@)
sed -e 's!<img src="img!<img src="git/novice/img!g' $< > $@
sed -e 's!<img src="img!<img src="novice/git/img!g' $< > $@

tmp/python/novice/%.md : python/novice/%.md
tmp/novice/python/%.md : novice/python/%.md
@mkdir -p $$(dirname $@)
sed -e 's!<img src="img!<img src="python/novice/img!g' $< > $@
sed -e 's!<img src="img!<img src="novice/python/img!g' $< > $@

tmp/sql/novice/%.md : sql/novice/%.md
tmp/novice/sql/%.md : novice/sql/%.md
@mkdir -p $$(dirname $@)
sed -e 's!<img src="img!<img src="sql/novice/img!g' $< > $@
sed -e 's!<img src="img!<img src="novice/sql/img!g' $< > $@

tmp/extras/novice/%.md : extras/novice/%.md
tmp/novice/extras/%.md : novice/extras/%.md
@mkdir -p $$(dirname $@)
sed -e 's!<img src="img!<img src="extras/novice/img!g' $< > $@
sed -e 's!<img src="img!<img src="novice/extras/img!g' $< > $@

# All other Markdown files used in the book.
tmp/%.md : %.md
Expand Down
46 changes: 17 additions & 29 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -313,61 +313,49 @@ Reorganize, rewrite, or delete this material as you think best.
Lesson Material
---------------

* Our old lesson material,
which we plan to retire in Spring 2014,
* Our old lesson material
is in the `lessons` directory.

* The new material for novices is in the directories
`shell/novice`, `python/novice`, `git/novice`, and `sql/novice`.
We plan to retire it in Spring 2014,
* The new material for novices is in the directories under `novice`.
The shell and Git materials are written in Markdown,
while the Python and SQL use the IPython Notebook.

* New material for intermediate learners is currently under development
in directories called `*/intermediate`.

* Our R material is in `lessons/misc-R`;
we are currently working to merge it into the main directory structure.
in directories under `intermediate`.

Site Map
--------

The most important files and directories are **highlighted**.

* CITATION - how to cite Software Carpentry.
* CONTRIBUTING.md - how to contribute new material.
* LICENSE.md - our license.
* Makefile - rebuild this site (type `make` on its own for a list of targets).
* README.md - how to use this site.
* bib.md - bibliography.
* contents.md - site map used in place of `index.html` on the main web site.
* **gloss.md** - glossary of terms.
* **index.html** - template for bootcamp home pages.
* intro.md - introduction to book version of this site.
* rules.md - the rules of programming (used in the book version of this site).
* **team.md** - who we are.
* _config.yml - Jekyll configuration directives.
* _includes/ - snippets of HTML that can be included in other files by Jekyll.
* _layouts/ - Jekyll page layouts.
* _site/ - output directory when building the site locally.
* **_site/** - output directory (created when building the site locally).
* _templates/ - template files for Pandoc conversion of IPython Notebooks.
* bib.md - bibliography.
* bin/ - miscellaneous tools used in building the site.
* branding/ - graphical assets related to Software Carpentry.
* contents.md - site map used in place of `index.html` on the main web site.
* css/ - CSS files for this site.
* data/ - miscellaneous data files used by examples.
* extras/ - supplementary materials included in the book version of this site.
* git/ - lessons on Git.
* gloss.md - glossary of terms.
* img/ - images used throughout this site.
* index.html - template for bootcamp home pages.
* intro.md - introduction to book version of this site.
* **intermediate/** - intermediate lesson material (under development).
* js/ - Javascript files used in this site.
* lessons/ - old lesson material.
* make/ - lesson on Make (intermediate only).
* python/ - lessons on Python.
* r/ - lessons on R (under construction).
* ref/ - reference guides.
* regex/ - lesson on regular expressions (intermediate only).
* rules.md - the rules of programming (used in the book version of this site).
* **lessons/** - old lesson material.
* **novice/** - novice lesson material.
* setup/ - setup tools for installing bootcamp software.
* setup.md - setup instructions for software used in bootcamps.
* shell/ - lessons on the Unix shell.
* slides/ - slideshows (under construction).
* sql/ - lessons on SQL and databases.
* teaching/ - instructor's guides.
* team.md - who we are.

FAQ
---
Expand Down
10 changes: 5 additions & 5 deletions contents.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,11 +10,11 @@ in the last four years.
## For Novices

* [Introduction](intro.html)
* [The Unix Shell](shell/novice/index.html)
* [Version Control with Git](git/novice/index.html)
* [Programming with Python](python/novice/index.html)
* [Using Databases and SQL](sql/novice/index.html)
* [A Few Extras](extras/novice/index.html)
* [The Unix Shell](novice/shell/index.html)
* [Version Control with Git](novice/git/index.html)
* [Programming with Python](novice/python/index.html)
* [Using Databases and SQL](novice/sql/index.html)
* [A Few Extras](novice/extras/index.html)

These lessons are also available in [book form](book.html).

Expand Down
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes
File renamed without changes
File renamed without changes.
File renamed without changes
File renamed without changes
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
Loading

0 comments on commit b8c7dc3

Please sign in to comment.