Mount sphinx docs at http://docs.mediagoblin.org

[Christopher Allan Webber]

GNU MediaGoblin sphinx docs are make'able by cd'ing into the docs
directory and running make.

We should have docs.mediagoblin.org run the latest docs out of git
master.

[Will Kahn-Greene]

I have it in my queue to track down Matt when the docs are in a
better state and help him help me get this done. I'm hoping that'll
be the end of this week.

I don't want to push anything until then because things are in flux
and need to be de-lorem-ipsummed in a serious way.

[Will Kahn-Greene]

Putting this in the 0.0.1 target.

[Will Kahn-Greene]

build_mediagoblin_docs.sh

[Will Kahn-Greene]

I wrote Matt the attached script to run which will clone the repo,
checkout the revish, build the docs, and copy the stuff to the
specified target directory.

It probably has some bugs, but I did some minor testing and it
seemed ok.

Part of me is tempted to create a scripts/ directory in the
repository and put this there.

Chris: What do you want to do with infrastructure scripts like
this?

[Christopher Allan Webber]

Thanks Will!

I'm not sure how I feel about it being checked in to the
repository. I think I'd rather have it checked in with the website
stuff if that can be done cleanly, but since that's managed by the
movable type system, maybe it can't. My main concern is confusing
users that there are scripts here but that maybe they aren't really
for users, just for the website?

I guess if it's going to be checked in it can be checked in to
scripts/ for now.

[Will Kahn-Greene]

That's exactly the dilemma I was thinking, too.

I won't check it in. At some point p, we'll get a wiki and I can
put it there. Or if there's a critical mass of infrastructure
scripts, we can create another repository. Or some third option.

[Matt Lee]

`http://bugs.foocorp.net/projects/mediagoblin/wiki <http://bugs.foocorp.net/projects/mediagoblin/wiki>`_

[Will Kahn-Greene]

Matt set up the script and it's running, however, the server is
using Sphinx 0.6.6 and it needs to be running something post-1.0.

So outstanding items:


1. install a more recent version of sphinx on the server running
   build\_mediagoblin\_docs.sh

[Will Kahn-Greene]

This is all fixed now! Closing it out!

[Will Kahn-Greene]

This is done, so I'm closing it out which means "Closed" this
time.

[Will Kahn-Greene]

The original url for this bug was ​http://bugs.foocorp.net/issues/266 .