tomchristie/mkdocs — pull request #97 by edbrannin (2014-06-09 07:20:30+00:00)
Title: Windows: Fix tests & building the mkdocs documentation on Windows

This pull request includes everything in #92.

Notable changes beyond #92:
* Include `ez_setup.py` for easier installation on systems without `setuptools` (such as AppVeyor CI), [as recommended by the `setuptools` docs](https://pythonhosted.org/setuptools/setuptools.html#using-setuptools-without-bundling-it)
* Changed one test to use `tempfile.mkdtemp()` instead of `tempfile.NamedTemporaryFile()` because Windows doesn't like to read open files
* Changed nav.FileContext.make_absolute() to use posixpath instead of os.path because it's only used to compare a filename against mkdocs.yml paths

This weekend I learned it's pretty easy to set up Windows-based CI for this:

1. Go to http://www.appveyor.com/ and click `SIGN IN` in the upper-right corner
2. Connect to GitHub
3. Make a new build, select the `mkdocs` repo
4. [Optional] In Settings → General, build all branches.
5. In Settings → Build, select `SCRIPT` and `CMD`, then enter `python setup.py install` and `c:\python27\scripts\mkdocs build`
6. In Settings → Test, select `SCRIPT` and `CMD`, then enter `python setup.py test`
7. In Settings → Artifacts, add `dist/*.egg` and the `site` folder (because why not).
8. In Settings → Badges, copy the Markdown snippet into README.md and tweak as desired.

...Looks like [steps 4- can also be set up with a YAML file](http://www.appveyor.com/docs/appveyor-yml). Let me know if you'd like me to write/test/push one for you.

I hope I've done my homework well enough. Please let me know if you still have any reservations about accepting this pull request. I'd really like to start using mkdocs at work.