Restructure everything to use django-amber

Author: inglesp

.gitignore

@@ -5,3 +5,5 @@ output
 *.pyc
 
 .DS_Store
+
+db.sqlite3

Makefile

@@ -11,10 +11,10 @@ help:
 	@echo ''
 
 build:
-	wok
+	python manage.py buildsite
 
 serve:
-	wok --serve
+	python manage.py serve 8000
 
 test:
 	./pre-flight-checks.sh

README.rst

@@ -15,31 +15,25 @@ more details).
 Development
 ~~~~~~~~~~~
 
-This site uses wok_. To install wok and other dependencies, run
-``pip install -r requirements.txt``. wok currently only works with Python 2.7.
+This site uses django-amber_. To install django-amber and other dependencies,
+run ``pip install -r requirements.txt``. django-amber is only known to work
+with Python 3.5.
 
-wok builds the site by assembling several components:
+django-amber builds the site by assembling several components:
 
-* Pages are found in ``content/``. Pages may be HTML, Markdown_ or reStrcturedText_, and contain some YAML metadata.
-* Statuc files are found in ``media/``.
-* The various jinja2_ templates for pages can be found in ``templates/``.
+* Pages are found in ``pythonineducation/data/page/[language]-[slug].md``.
+  Pages consist of some YAML metadata (currently just a page title), and some
+  Markdown_ content.  Pages will be served at /[language]/[slug]/.  For
+  instance, en-microbit.md will be served at /en/microbit/.
+* Static files are found in ``pythonineducation/static/``.
+* The various Django templates for pages can be found in
+  ``pythonineducation/templates/``.
 
-To build the site, run ``make build``. This pulls together all the components
-into a set of HTML files in ``output/``.
+To build the site, run ``python manage.py buildsite``. This pulls together all
+the components into a set of HTML files in ``output/``.
 
-Windows users: you need to run the (extensionless) ``wok`` script in
-``c:\pythonxx\scripts``. e.g. ``py -2 c:\python27\scripts\wok``.
-
-Alternatively, if you run ``make serve``, wok will build the site, serve the
-built site on port 8000, and watch for changes.
-
-Windows users: you ned to run the (extensionless) ``work`` script with the
-``--serve`` parameter in ``c:\pythonxx\scripts``. e.g.
-``py -2 c:\python27\scripts\wok --serve``.
-
-You can test that the site contains no broken links and that various common
-mis-spellings are caught correctly (hint, it's a "BBC micro:bit" for example)
-by running ``make test``.
+Alternatively, if you run ``python manage.py serve 8000``, django-amber will
+build the site, serve the built site on port 8000, and watch for changes.
 
 Travis will test branches, and branches won't get merged without review and
 passing tests, so dive in!
@@ -61,19 +55,18 @@ works:
   `ISO 639-1 <https://en.wikipedia.org/wiki/ISO_639-1>`_ language code. For
   example, the English version is found under the ``/en`` path whereas the
   German version is under the ``/de`` path.
-* In the ``template/`` directory of this repository as the page templates for
-  different languages. All inherit from the ``base.html`` template. They are
-  named ``page_XX.html`` where XX is the appropriate ISO 639-1 code for the
-  language for which the template is used. For example, English content uses
-  the ``page_en.html`` template whereas the German template is
-  ``page_de.html``. These pages should contain the localised header and footer.
-* In the ``content/`` directory of this repository are directories named after
-  the ISO 639-1 language code. They contain the content for this website in
-  the langauge referenced by the language code in the name of the directory.
-  For example, the English content is found in the ``content/en/`` directory
-  whereas the German content is in ``content/de/``. You must make sure that
-  the ``type`` field in the YAML header for the content is set to the correct
-  page template for the language.
+* In the ``pythonineducation/templates/`` directory of this repository as the
+  page templates for different languages. All inherit from the ``base.html``
+  template. They are named ``page_XX.html`` where XX is the appropriate ISO
+  639-1 code for the language for which the template is used. For example,
+  English content uses the ``page_en.html`` template whereas the German
+  template is ``page_de.html``. These pages should contain the localised header
+  and footer.
+* In the ``pythonineducation/data/page/`` directory of this repository are
+  files named after the ISO 639-1 language code. They contain the content
+  for this website in the langauge referenced by the language code in filename.
+  For example, the English content for the micro:bit page is found in the file
+  called ``en-microbit.md``,whereas the German content is in ``de-microbit.md``.
 * If in doubt, just look at what happens in the English version of the site and
   adapt to the desired language.
 
@@ -99,9 +92,7 @@ for the project.
 Note: this is tied to a single user on GitHub, however any other GitHub user
 with valid permissions can replace the key on Travis.
 
-.. _wok: http://wok.mythmon.com/
+.. _django-amber: https://github.com/inglesp/django-amber
 .. _Markdown: https://pythonhosted.org/Markdown/
-.. _reStructuredText: http://docutils.sourceforge.net/rst.html
-.. _jinja2: http://jinja.pocoo.org/
 .. _issue: https://github.com/python/pythonineducation.org/issues
 .. _CONTRIBUTING.rst: ./CONTRIBUTING.rst