The basic idea remains the same, but should work much better now.  The
difference is that images/example.py.diff is now a patch with complete
context and becomes the authoritative source for both the visible flavor
of an example as well as for its figure-generating variant.  Both
tutorial/example.py and images/example.py are extracted from this file
by 'make html'.  Thanks to the complete context the diffs are quite
readable and may be modified directly.

Alternatively, one may also modify the generated scripts.  When
tutorial/example.py has been modified, it will be patched and saved as
images/example.py.  The patching is done using the tool 'wiggle' that
works much better than 'patch'.  If a conflict occurs, conflict markers
are added to the output file and its dated back to the dawn of time
(i.e. 1970) in order to mark the conflicts as not yet resolved.  After
resolving, 'make html' is simply run again.

Upon a successful execution of the figure-generating script the diff
gets recreated automatically, 'generate-diffs' no longer exists.

These classes used not to have any features beyond
kwant.system.{Finite,Infinite}System, but this is no longer the case.

lowercase FAQ.rst, FAQ.py, etc., give meaningful names to labels,
and stop building an user-visible tutorial/faq.py

Apply pep8 fixes and refactor some sections to be more idiomatic
(e.g. avoiding triple nested loops). Also some minor reorganisation
of the sections to give the text a better flow.

 The total density of states now integrates to `N`, the size of the system.

In addition to basic updates to skip permanent redirect, remove an
obsolete reference to macports installation instructions on the main
website.

  `integrate` is a more accurate name for a function that integrates
   the spectral density. Docstrings and tutorial updated.

closes #125

The site() method was never widely advertised, so no one will miss it.

This was deprecated several releases ago

Rafal Skolasinski authored 7 years ago and Joseph Weston committed 7 years ago

Current implementation uses ``kwant.physics.Bands``. This example fails
when one substitute ``k_x**2`` with for example ``k_x**4`` due to farther
then nearest neighbours hoppings. Using wraparound provides also easier way
to extend it to multidimensional band structures (except of plotting).

The Mathjax CDN is shutting down:
https://www.mathjax.org/cdn-shutting-down/

Closes #116.