Merge remote-tracking branch 'cweb/master'
[mediagoblin.git] / docs / source / index.rst
1 .. MediaGoblin Documentation
2
3 Written in 2011, 2012 by MediaGoblin contributors
4
5 To the extent possible under law, the author(s) have dedicated all
6 copyright and related and neighboring rights to this software to
7 the public domain worldwide. This software is distributed without
8 any warranty.
9
10 You should have received a copy of the CC0 Public Domain
11 Dedication along with this software. If not, see
12 <http://creativecommons.org/publicdomain/zero/1.0/>.
13
14
15 ===========================================
16 Welcome to GNU MediaGoblin's documentation!
17 ===========================================
18
19 GNU MediaGoblin is a platform for sharing photos, video and other media
20 in an environment that respects our freedom and independence.
21
22 This is a Free Software project. It is built by contributors for all
23 to use and enjoy. If you're intrested in contributing, see `the wiki
24 <http://wiki.mediagoblin.org/>`_ which has pages that talk about the
25 ways someone can contribute.
26
27
28 Part 1: Site Administrator's Guide
29 ==================================
30
31 This guide covers installing, configuring, deploying and running a GNU
32 MediaGoblin website. It is written for site administrators.
33
34 .. toctree::
35 :maxdepth: 1
36
37 siteadmin/foreword
38 siteadmin/about
39 siteadmin/deploying
40 siteadmin/production-deployments
41 siteadmin/configuration
42 siteadmin/media-types
43 siteadmin/help
44 siteadmin/relnotes
45 siteadmin/theming
46 siteadmin/plugins
47
48
49 .. _core-plugin-section:
50
51 Part 2: Core plugin documentation
52 =================================
53
54 .. toctree::
55 :maxdepth: 1
56
57 plugindocs/flatpagesfile
58 plugindocs/sampleplugin
59 plugindocs/oauth
60 plugindocs/trim_whitespace
61 plugindocs/raven
62
63
64 Part 3: Plugin Writer's Guide
65 =============================
66
67 This guide covers writing new GNU MediaGoblin plugins.
68
69 .. toctree::
70 :maxdepth: 1
71
72 pluginwriter/foreward
73 pluginwriter/quickstart
74 pluginwriter/database
75 pluginwriter/api
76 pluginwriter/tests
77
78
79 Part 4: Developer's Zone
80 ========================
81
82 This chapter contains various information for developers.
83
84 .. toctree::
85 :maxdepth: 1
86
87 devel/codebase
88 devel/storage
89 devel/originaldesigndecisions
90
91
92 Indices and tables
93 ==================
94
95 * :ref:`search`
96 * :ref:`genindex`
97
98 .. * :ref:`modindex`
99
100 This guide was built on |today|.