# Clone / download the quickstart repository and install dependencies.
git clone [email protected]:oal/babble-quickstart.git my-website
cd my-website
composer install
# Start dev server
composer dump-autoload -o
php babble serve
# Build static HTML version
php babble build
Static HTML files that can be served from anywhere, even without PHP support. Built with php babble build
.
Cached HTML files and dependency tracking generated upon a page's first page load. This is used when access to the admin interface is required in production, and pages are re-cached when changes occur.
YAML files for your site's content. This directory contains sub directories for each model,
in which content is stored as one record per file, organized by record ID
(example: /models/Page/about.yaml
).
Defines data types for the site. All data types (models) must be capitalized (Page, not page) .yaml files. See this directory for examples.
Similar to models, but may be used in "list" fields. Example: You want a gallery. Create an "Image" block with the fields "image" and "description", and set this as the only available block for your list field. This allows you to specify any number of "Image" blocks for this content type.
Contains any publicly available content, including index.php which initiates Babble and serves all requests. As long as index.php is left unchanged, you are free to make changes in this directory.
This directory contains Twig templates which will be matched against request path and models.
Templates starting with a lowercase character are rendered directly (like blog.twig
)
when a request to /blog
is received. Capitalized templates are matched against models,
so if there's a Page.twig
file, and a request for /about
doesn't match about.twig
,
it will be assumed to be a Page
, and rendered accordingly.
Templates prefixed with underscores (_) are hidden, and can be used with template
inheritance or for special purposes (_404.twig
is used when no content was found).
Often you want a _base.twig
file for your site's layout, and extend from this for any
other page.