added openid docs
[mediagoblin.git] / mediagoblin / config_spec.ini
1 [mediagoblin]
2 # HTML title of the pages
3 html_title = string(default="GNU MediaGoblin")
4
5 # link to source for this MediaGoblin site
6 source_link = string(default="https://gitorious.org/mediagoblin/mediagoblin")
7
8 # Enabled media types
9 media_types = string_list(default=list("mediagoblin.media_types.image"))
10
11 # database stuff
12 sql_engine = string(default="sqlite:///%(here)s/mediagoblin.db")
13
14 # This flag is used during testing to allow use of in-memory SQLite
15 # databases. It is not recommended to be used on a running instance.
16 run_migrations = boolean(default=False)
17
18 # Where temporary files used in processing and etc are kept
19 workbench_path = string(default="%(here)s/user_dev/media/workbench")
20
21 # Where to store cryptographic sensible data
22 crypto_path = string(default="%(here)s/user_dev/crypto")
23
24 # Where mediagoblin-builtin static assets are kept
25 direct_remote_path = string(default="/mgoblin_static/")
26
27 # set to false to enable sending notices
28 email_debug_mode = boolean(default=True)
29 email_smtp_use_ssl = boolean(default=False)
30 email_sender_address = string(default="notice@mediagoblin.example.org")
31 email_smtp_host = string(default='')
32 email_smtp_port = integer(default=0)
33 email_smtp_user = string(default=None)
34 email_smtp_pass = string(default=None)
35
36 # Set to false to disable registrations
37 allow_registration = boolean(default=True)
38
39 # tag parsing
40 tags_max_length = integer(default=255)
41
42 # Enable/disable comments
43 allow_comments = boolean(default=True)
44
45 # Whether comments are ascending or descending
46 comments_ascending = boolean(default=True)
47
48 # By default not set, but you might want something like:
49 # "%(here)s/user_dev/templates/"
50 local_templates = string()
51
52 # Whether or not celery is set up via an environment variable or
53 # something else (and thus mediagoblin should not attempt to set it up
54 # itself)
55 celery_setup_elsewhere = boolean(default=False)
56
57 # Whether or not users are able to upload files of any filetype with
58 # their media entries -- This is useful if you want to provide the
59 # source files for a media file but can also be a HUGE security risk.
60 allow_attachments = boolean(default=False)
61
62 # Cookie stuff
63 csrf_cookie_name = string(default='mediagoblin_csrftoken')
64
65 # Push stuff
66 push_urls = string_list(default=list())
67
68 exif_visible = boolean(default=False)
69 original_date_visible = boolean(default=False)
70
71 # Theming stuff
72 theme_install_dir = string(default="%(here)s/user_dev/themes/")
73 theme_web_path = string(default="/theme_static/")
74 theme_linked_assets_dir = string(default="%(here)s/user_dev/theme_static/")
75 theme = string()
76
77 # plugin default assets directory
78 plugin_web_path = string(default="/plugin_static/")
79 plugin_linked_assets_dir = string(default="%(here)s/user_dev/plugin_static/")
80
81
82 [storage:publicstore]
83 storage_class = string(default="mediagoblin.storage.filestorage:BasicFileStorage")
84 base_dir = string(default="%(here)s/user_dev/media/public")
85 base_url = string(default="/mgoblin_media/")
86
87 [storage:queuestore]
88 storage_class = string(default="mediagoblin.storage.filestorage:BasicFileStorage")
89 base_dir = string(default="%(here)s/user_dev/media/queue")
90
91 [media:medium]
92 # Dimensions used when creating media display images.
93 max_width = integer(default=640)
94 max_height = integer(default=640)
95
96 [media:thumb]
97 # Dimensions used when creating media thumbnails
98 # This is unfortunately not implemented in the media
99 # types yet. You can help!
100 # TODO: Make plugins follow the media size settings
101 max_width = integer(default=180)
102 max_height = integer(default=180)
103
104 [media_type:mediagoblin.media_types.image]
105 # One of BICUBIC, BILINEAR, NEAREST, ANTIALIAS
106 resize_filter = string(default="ANTIALIAS")
107 #level of compression used when resizing images
108 quality = integer(default=90)
109
110 [media_type:mediagoblin.media_types.video]
111 # Should we keep the original file?
112 keep_original = boolean(default=False)
113
114 # 0 means autodetect, autodetect means number_of_CPUs - 1
115 vp8_threads = integer(default=0)
116 # Range: 0..10
117 vp8_quality = integer(default=8)
118 # Range: -0.1..1
119 vorbis_quality = float(default=0.3)
120
121 # Autoplay the video when page is loaded?
122 auto_play = boolean(default=True)
123
124 [[skip_transcode]]
125 mime_types = string_list(default=list("video/webm"))
126 container_formats = string_list(default=list("Matroska"))
127 video_codecs = string_list(default=list("VP8 video"))
128 audio_codecs = string_list(default=list("Vorbis"))
129 dimensions_match = boolean(default=True)
130
131 [media_type:mediagoblin.media_types.audio]
132 keep_original = boolean(default=True)
133 # vorbisenc quality
134 quality = float(default=0.3)
135 create_spectrogram = boolean(default=True)
136 spectrogram_fft_size = integer(default=4096)
137
138 [media_type:mediagoblin.media_types.ascii]
139 thumbnail_font = string(default=None)
140
141 [media_type:mediagoblin.media_types.pdf]
142 pdf_js = boolean(default=True)
143
144
145 [celery]
146 # default result stuff
147 CELERY_RESULT_BACKEND = string(default="database")
148 CELERY_RESULT_DBURI = string(default="sqlite:///%(here)s/celery.db")
149
150 # default kombu stuff
151 BROKER_TRANSPORT = string(default="sqlalchemy")
152 BROKER_HOST = string(default="sqlite:///%(here)s/kombu.db")
153
154 # known booleans
155 CELERY_RESULT_PERSISTENT = boolean()
156 CELERY_CREATE_MISSING_QUEUES = boolean()
157 BROKER_USE_SSL = boolean()
158 BROKER_CONNECTION_RETRY = boolean()
159 CELERY_ALWAYS_EAGER = boolean()
160 CELERY_EAGER_PROPAGATES_EXCEPTIONS = boolean()
161 CELERY_IGNORE_RESULT = boolean()
162 CELERY_TRACK_STARTED = boolean()
163 CELERY_DISABLE_RATE_LIMITS = boolean()
164 CELERY_ACKS_LATE = boolean()
165 CELERY_STORE_ERRORS_EVEN_IF_IGNORED = boolean()
166 CELERY_SEND_TASK_ERROR_EMAILS = boolean()
167 CELERY_SEND_EVENTS = boolean()
168 CELERY_SEND_TASK_SENT_EVENT = boolean()
169 CELERYD_LOG_COLOR = boolean()
170 CELERY_REDIRECT_STDOUTS = boolean()
171
172 # known ints
173 CELERYD_CONCURRENCY = integer()
174 CELERYD_PREFETCH_MULTIPLIER = integer()
175 CELERY_AMQP_TASK_RESULT_EXPIRES = integer()
176 CELERY_AMQP_TASK_RESULT_CONNECTION_MAX = integer()
177 REDIS_PORT = integer()
178 REDIS_DB = integer()
179 BROKER_PORT = integer()
180 BROKER_CONNECTION_TIMEOUT = integer()
181 CELERY_BROKER_CONNECTION_MAX_RETRIES = integer()
182 CELERY_TASK_RESULT_EXPIRES = integer()
183 CELERY_MAX_CACHED_RESULTS = integer()
184 CELERY_DEFAULT_RATE_LIMIT = integer()
185 CELERYD_MAX_TASKS_PER_CHILD = integer()
186 CELERYD_TASK_TIME_LIMIT = integer()
187 CELERYD_TASK_SOFT_TIME_LIMIT = integer()
188 MAIL_PORT = integer()
189 CELERYBEAT_MAX_LOOP_INTERVAL = integer()
190
191 # known floats
192 CELERYD_ETA_SCHEDULER_PRECISION = float()
193
194 # known lists
195 CELERY_ROUTES = string_list()
196 CELERY_IMPORTS = string_list()