@lucis/gatsby-theme-lodge

gatsby-theme-lodge

Gatsby theme for building beautiful and customisable landing pages for Freemasons's Lodges. (about Freemasonry)

Built with :heart: for Brazilian Lodge "Acácia da Borborema" nº 41.

It uses gatsby-transformer-pages-json for building the site with full customization.

WIP ALERT: I'm still building this architecture and it will change overtime. The page creation is stil being done in the theme side but we will probably overcome this issue and move it to the plugin.

Install

yarn add @luciannojunior/gatsby-theme-lodge

How to use

In your gatsby-config.js:

module.exports = {
  plugins: [`@luciannojunior/gatsby-theme-lodge`],
}

Configuration

Most of this theme's customization happens in pages.json file, that is created automatically on your site's data folder (you can change this with contentPath option). This file must follow this pattern:

{
  "pages": {
    "home": {
      "homepage": true,
      "component": "Home",
      "props": {
        "landing": {
          "landingText": {
            "lodgeName": "Regeneração Campinense nº 02",
        ...
    },
   "o-que-e-maconaria": {
      "component": "Maconaria"
    },
    ...
  },
  "menu": [
    {
      "page": "home",
      "value": "Início"
    },
    ...
  ],
}

}

Pages

The pages objects declares which pages will be created in the Gatsbys site.

• A simple slugify heuristic is used using the page's name, which is described by the key provided (i.e: "o-que-e-maconaria" will create a page in the /o-que-e-maconaria path).
• The component provided will be resolved from gatsby-theme-lodge/src/components and rendered within the created page. We will provide default components to be used and you can also providing your own components using Component Shadowing.
• You should provide a homepage boolean attribute as true to the home page of you site, so we will build this page's path in / (or in the basePath provided to themes's settings)

Menu

• The menu array describes how the Menu component will show the items. It must reference pages by its name, or provide a path to a external URL.

Components

Home

• Default Home component. It composes some different components of that page (Landing, Cards, Location and Gallery).

Configuration:

Prop name	Type	Description
landing	Object	Landing component configuration (see Landing)
cards	Object	Cards component configuration (see Cards)
location	Object	Location component configuration (see Location)
gallery	Object	Gallery component configuration (see Gallery)

Landing

• Wraps a video background (or image background for mobile users) and displays a couple of information about the Lodge.

Configuration:

Prop name	Type	Description
landingText	Object	Describes the informations displayed in the Landing component (see LandingText)

LandingText

• Displays an animated set of texts to describe the Lodge

Configuration:

Prop name	Type	Description	Example
location	String	Textual address of the Lodge	Situada na Rua Siqueira Campos, Campina Grande - PB
lodgeName	String	Name of the Lodge	Regeneração Campinense nº 02
meetings	String	When do the Lodge's meetings happen?	quartas-feiras às 19:00hrs

Cards

• Displays four content cards with links to site's page (static links for now).

Configuration:

Prop name	Type	Description
historia	CardEntry	Check EntryType below.
diretoria	CardEntry	Check EntryType below.
veneraveis	CardEntry	Check EntryType below.
filantropia	CardEntry	Check EntryType below.

CardEntry

Prop name	Type	Description	Example
title	String	Title of the card	O que é Maçonaria?
path	String	Path that will be used to the title link	/o-que-e-maconario
text	String	Content of the car	Free text.

Location

• Displays info about the Lodge's location and a Google Maps iframe to that adress.

Configuration:

Prop name	Type	Description	Example
address	String	Address of the Lodge	Rua Siqueira Campos, 1020 - Campina Grande - PB
addressLink	String	Link that will be attached to the address displayed	https://goo.gl/maps/QdaPBrDC7ZqodP7RA
gMapsUrl	String	URL to Google Maps Iframe	Get it on Google Maps
title	String	Title to the address iframe	--

Gallery

• Slideshow that loops a set of pictures (that should be provided inside static/images folder).

Configuration:

Prop name	Type	Description	Example
pictures	String[][]	Array of tuples describing the name of the file and the respective alternative text	[['1', 'Alternative text 1'], ['2', 'Alternative Text 2']]

WIP