Overview
========

The purpose of this example website is twofold:

. To show you how to build and publish a website using a combination
  of link:links.html[AsciiDoc] and the link:links.html[A-A-P] "super
  make" program.
. To serve as a blueprint for packaging link:links.html[Python]
  applications into a stand-alone Wizard installer for the Microsoft
  Windows platform.

This example can be hosted under both UNIX (has been tested under
FreeBSD and Linux) and
Microsoft Windows. The instructions for building the
link:execution-environment.html[Execution Environment] and
link:installation-wizard.html[Installation Wizard] apply only to
Microsoft Windows.

As well as explaining how the site is built and published, these web
pages show how the entire site development environment can be packaged
into a executable Windows installation wizard using the
link:links.html[Inno Setup program].

This allows the developer to package the website along with
publication tools for installation on the end-user's Windows PC.

This example can serve a model for distributing one or more Python
applications to Windows platforms packaged in a setup wizard
that installs:

- Python applications.
- Application data.
- A stand-alone Python execution environment.
- Icons to run the applications.

The complete source for this site along with scripts used to build,
publish and package it can be found in the `examples/website` directory
of the link:links.html[AsciiDoc] distribution which can be downloaded
from http://www.methods.co.nz/asciidoc/downloads.html[].

NOTE: I use UNIX forward-slash directory separators and shell commands
throughout this documentation, if you're using Microsoft Windows
you'll need to make a mental adjustment.
