========
 README
========

This is the flatpages file plugin. It allows you to add pages to your
MediaGoblin instance which are not generated from user content. For
example, this is useful for these pages:

* About this site
* Terms of service
* Privacy policy
* How to get an account here
* ...


How to add pages
================

To add pages, you must edit template files on the file system in your
`local_templates` directory.

The directory structure looks kind of like this::

    local_templates
    |- flatpagesfile
       |- flatpage1.html
       |- flatpage2.html
       |- ...


The ``.html`` file contains the content of your page. It's just a
template like all the other templates you have.

Here's an example::

   {% extends "flatpagesfile/base.html" %}
   {% block mediagoblin_content %}
   <h1>About this site</h1>
   <p>
     This site is a MediaGoblin instance set up to host media for
     me, my family and my friends.
   </p>
   {% endblock %}


.. Note::

   If you have a bunch of flatpages that kind of look like one
   another, take advantage of Jinja2 template extending and create a
   base template that the others extend.