The current docs show nicely how to set up a dev environment,
however it is not clear how to set up the thing in a non-dev way
(I guess that is the "deployment" docs, right?)

Here are some things to consider when writing this. I got it up and
running in Ubuntu Maverick in a non-dev way. I had to install some
things with "pip" and used the distribution packages whenever
possible.

So stuff that needs documentation:

paster running on port 80 is not possible without having the whole
thing running as root. Which will then require to also have celeryd
running as root, as it needs to delete files that paster put there.
I solved this in a very hackish way with "Capabilities" on Linux.
Downside is, I had to grant /usr/bin/python the permission to
access ports <1024. I achieved this with

::

    sudo setcap 'cap_net_bind_service=+ep' /usr/bin/python2.6

(not saying we should recommend that to anyone. I guess we will
propose to run this as a local user on a nonpriviledged port and
proxy it through nginx or so.

Anyway, it runs beautiful as www-data on my server now.

Currently when you submit an image all that happens is it shows up
on the mainpage as a thumbnail. Boring! We should be able to view
those images on their own page.

If I upload the media entry of "A Walk in the Park" which has the
ID of 4d8e5b0048b1520586000000, I should be able to view that at:

[http://mediagoblin.example.org/\ :sub:`cwebber/m/d8e5b0048b1520586000000/](http://mediagoblin.example.org/`\ cwebber/m/d8e5b0048b1520586000000/)

(Eventually I'll also want to be able to view it by its prettier
slugified URL:

[http://mediagoblin.example.org/\ :sub:`cwebber/m/a-walk-in-the-park/](http://mediagoblin.example.org/`\ cwebber/m/a-walk-in-the-park/)

... but that's waiting on
`http://bugs.foocorp.net/issues/306 <http://bugs.foocorp.net/issues/306>`_
)

This URL should have the following things:


-  The image, fully sized (we don't have scaled down versions
   implemented yet besides the thumbnail, so that's fine)
-  The author's name
-  When it was uploaded
-  The title
-  The description

Mockup:

::

    | GNU MediaGoblin             | login | register |
    |------------------------------------------------|
    |                                                |
    |  The Terror of Tinman Tim                      |
    |  Posted by cwebber on May 8, 2011              |
    |   ___________________________________________  |
    |  |                                           | |
    |  |      __ ____                              | |
    |  |  (O)== |    |=(O)                         | |
    |  |     |  |O  o|         DESTROY ALL HUMANS  | |
    |  |     |__|[ww]|                             | |
    |  |    |    |  _ |  _                         | |
    |  |    | ((((((_ |((_                         | |
    |  |    |    |    |                            | |
    |  |    |____|____|                            | |
    |  |      |_|  \_\  _                          | |
    |  |    _/_/_   \_// /                         | |
    |  |    |___||   |/_/                          | |
    |  |                                           | |
    |  '-------------------------------------------' |
    |    _________________________________________   |
    |   | Just another piece on a robot who wants |  |
    |   | to do what any robot would want to do.  |  |
    |   '-----------------------------------------'  |
    |                                                |
    |  Comments:                                     |
    |   __________________________________________   |
    |  | Wow I love your robot!!!!!!              |  |
    |  |                 sue @ May 8 2011 11:45PM |  |
    |  '------------------------------------------'  |

Don't worry about the comments for now though.

In addition, the thumbs currently on the main page should link to
this URL.

In the verification email we would output the URL using HTML
encoded text, so that e.g. & -> &. We don't want that and we know
the URL won't contain user contributed content, so it is safe to
turn off HTML encoding here.

Patch to fix this:
`https://gitorious.org/mediagoblin/mediagoblin/merge\_requests/3 <https://gitorious.org/mediagoblin/mediagoblin/merge_requests/3>`_