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

[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 .