Livingearth

*Theme

Structure

Local startup

To run project locally execute:

$  bundle exec jekyll serve

After that website could be acessed via URL http://127.0.0.1:4000/

Layouts

Refers to files within the _layouts directory, that define the markup for website.

default.html — The base layout that lays the foundation for subsequent layouts. The derived layouts inject their contents into this file at the line that says {{ content }}.
home.html — The layout for your landing-page / home-page / index-page. [More Info.]
page.html — The layout for your documents that contain FrontMatter, but are not posts.
post.html — The layout for your posts.
contact.html — Custom layout for contacts page.
404.html — The layout for 404.

Modules

Refers to modules within the _includes directory that can be inserted in multiple layouts across website.

footer.liquid — Defines the site's footer section.
head.liquid — Code-block that defines the <head></head> in default layout.
header.liquid — Defines the site's main header section.
about-us.liquid — About Us on homepage. Attributes: title, heading, subheading, image, button, url
blog.liquid — Blog module
boxes.liquid — Default module to show boxed sections like 'FUTURE LANDSCAPES'. data sets a path to .yml array inside _data. Other attributes: heading, subheading. Columns number could be changed in cols.
breadcrumbs.liquid — Breadcrumbs module that included in heading module.
contact-us.liquid — Contact Us form.
continents.liquid — 'OTHER CONTINENTS' module from Europe/Oceania pages. Array of continents is stored in _data/continents.yml. heading could be customized in attributes. exclude sets continent to exclude from list (current continent).
contribute.liquid — 'HOW TO CONTRIBUTE' section from homepage. Attributes: title, heading, subheading, image, button, url
countries.liquid — Countries section from Europe/Oceania pages. data points to an array of countries. Example: _data/europe/countries.yml.
get-in-touch.liquid — 'GET IN TOUCH' section which automatically included in page layout. Attributes: heading, subheading, button, url
heading.liquid — Page heading which automatically included in page layout and could be customized in general oage settings. Attributes: heading, subtitle, background, image, alt, nobuttons, button1, button1_url, button2, button2_url
index.liquid — Homepage heading which automatically included in home layout and could be customized in general oage settings. Attributes: smalltitle, title, subtitle, image, nobuttons, button1, button1_url, button2, button2_url
organisations.liquid — 'ORGANISATIONS' module from About page. Array of organisations is stored in _data/organisations.yml. heading and all could be customized in attributes.
our-blog.liquid — 'OUR BLOG' module from About page. heading, title, all, url could be customized in attributes.
our-events.liquid — 'OUR EVENTS' module from About page. heading, title, all, url could be customized in attributes.
our-vision.liquid — 'OUR VISION' section from About page. Attributes: heading, subheading, image, alt

Data

Array-like data is stored in _data folder and used for arrayed data by many modules.

Assets

Refers to various asset files within the assets directory.

assets/css/style.scss — Imports sass files from within the _sass directory and gets processed into the theme's stylesheet: _site/assets/css/styles.css.
assets/fonts/*.* — local fonts.
assets/img/*.* — site images.
assets/js/*.* — javascript.

Page settings

General

Those parameters are typical for all pages.

$  ---
$  layout: page
$  title: About
$  permalink: /about/
$  ---

layout: sets layout for current page
title: Page title which is used in <title> and in heading.liquid module.
permalink: sets final URL for current page (overrides default placement)

Headings

Customisation of headings inside layouts _layout/home.html and typical _layout/page.html is suported in general page settings.

$  ---
$  heading: Europe
$  subtitle: "We aim to capture the state and dynamics of Europe’s landscape."
$  background: "#07073f"
$  image: "/assets/img/heading/europe.jpg"
$  nobuttons: true
$  ---

heading: — sets page heading in heading.liquid module. If not set tetle is used.
subtitle: — sets small subheading in heading.liquid
background: — sets background color for heading.liquid
image: — URL for image on background of heading.liquid
nobuttons: true/false — turns on/off buttons in heading.liquid
button1, button2: — Buttons text in heading.liquid
button1_url, button2_url: — Buttons URL's in heading.liquid
nocontact: true/false — hides/shows get-in-touch.liquid module at the bottom.

Homepage

`index.md`

This page uses default _layout/home.html layout.
Page heading settings are set in General settings at the top of page.