CMS Directory structure

The directory structure below illustrates applications(pages), media files and bundled code within the mukau cms.

.
├── about/
│   ├── migrations
│   └── templates
├── bundles
├── contact/
│   ├── migrations
│   └── templates
├── flex/
│   ├── migrations
│   └── templates
├── home/
│   ├── migrations
│   ├── static/
│   │   └── css
│   └── templates/
│       └── home
├── indicator/
│   ├── migrations
│   └── templates
├── mapviewer/
│   ├── migrations
│   └── templates
├── media/
│   ├── images
│   └── original_images
├── menus/
│   └── migrations
├── mukau_wagtail_cms/
│   ├── settings
│   ├── static
|       ├── css
│       ├── js
|       └── img
│   └── templates
├── nginx
├── search/
│   ├── migrations
│   └── templates/
│       └── search
├── side_by_side/
│   ├── migrations
│   └── templates
├── site_settings/
│   └── migrations
├── static
└── streams/
    ├── migrations
    └── templates

The "home" app

Location: ./home/

This app is here to create the homepage providing a HomePage model with migrations to create one containing snippets and blocks therein.

Other apps, representing pages, can be structured in a similar manner. To learn how to create a new page go to CMS Mechanism to display or edit a Mukau webpage section.

Templates

Location: ./home/templates/

The templates directory contains base.html, 404.html and 500.html. These files are very commonly needed on Wagtail sites to they have been added into the template.

Other apps created within the Mukau CMS can contain this template directory.

Static files

Location: ./mukau_wagtail_cms/static/

The static directory contains js, css and img files utilized within the templates of the CMS.

Django settings

Location: ./mukau_wagtail_cms/settings/

The Django settings files are split up into base.py, dev.py, production.py and local.py.

base.py This file is for global settings that will be used in both development and production. Aim to keep most of your configuration in this file. dev.py This file is for settings that will only be used by developers. For example: DEBUG = True production.py This file is for settings that will only run on a production server. For example: DEBUG = False local.py This file is used for settings local to a particular machine. This file should never be tracked by a version control system.

Dockerfile

Location: ./Dockerfile

Contains configuration for building and deploying the site as a Docker container.