From: Christopher Allan Webber <cwebber@dustycloud.org>
Date: Mon, 12 Dec 2011 15:44:48 +0000 (-0600)
Subject: Added the "Media types" chapter
X-Git-Url: https://vcs.fsf.org/?a=commitdiff_plain;h=9bc2fc6c6a327a79ff5ad9d8f11f5b8f968154a6;p=mediagoblin.git

Added the "Media types" chapter
---

diff --git a/docs/source/index.rst b/docs/source/index.rst
index 6ffe0974..f9c9285d 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -16,6 +16,7 @@ Table of Contents:
    deploying
    production-deployments
    configuration
+   media-types
    help
    theming
    codebase
diff --git a/docs/source/media-types.rst b/docs/source/media-types.rst
new file mode 100644
index 00000000..809efe07
--- /dev/null
+++ b/docs/source/media-types.rst
@@ -0,0 +1,34 @@
+.. _media-types-chapter:
+
+====================
+Enabling Media Types
+====================
+
+In the future, there will be all sorts of media types you can enable,
+but in the meanwhile there's only one additional media type: video.
+
+First, you should probably read ":doc:`configuration`" to make sure
+you know how to modify the mediagoblin config file.
+
+Video
+=====
+
+To enable video, first install gstreamer and the python-gstreamer
+bindings (as well as whatever gstremaer extensions you want,
+good/bad/ugly).  On Debianoid systems:
+
+    sudo apt-get install python-gst0.10
+
+Next, modify (and possibly copy over from mediagoblin.ini) your
+mediagoblin_local.ini.  Uncomment this line in the [mediagoblin]
+section:
+
+    media_types = mediagoblin.media_types.image, mediagoblin.media_types.video
+
+Now you should be able to submit videos, and mediagoblin should
+transcode them.
+
+Note that you almost certainly want to separate Celery from the normal
+paste process or your users will probably find that their connections
+time out as the video transcodes.  To set that up, check out the
+":doc:`production-deployments`" section of this manual.