Docs: Building sites

This section is for the people who build client sites with Gansey and for the clients who edit them afterwards. It covers pages and the page builder, every built-in widget, entrance animations, the theme, the site parts that make up headers, footers and templates, the styles for the robot check and what modules add, structured content, the media library, and how to move a whole site or theme between installs as files.

Everything you build is a document the core renders on the server. A page, a header, a footer and a listing template are all made of the same sections, columns and widgets, edited in the same builder, saved as revisions and published by pointing at one of them. The theme is a single token document that turns into --gsy-* CSS custom properties, so a change there restyles every page at once.

In this section

PagesA page is a title, a path, a few navigation settings and a list of saved revisions.The page builderThe builder edits the real page.WidgetsEach widget has its own settings (see Widgets) and a layout for the box it sits in, edited under Placement and Colour:WidgetsA widget is one piece of content.AnimationsAny widget, and any whole section, can play an entrance animation.ThemeThe theme is one token document for the whole site: colours, fonts, buttons, layout, header and footer, plus a site-wide stylesheet.Site partsA site part is a recurring piece of the site built in the page builder: a header, a footer, or a whole-page template such as the not-found page.Content types and entriesPages suit one-off content.MediaThe media library holds every image, document, font and video the site uses.Theme kits and site filesTwo ways to move a design or a whole site as files: a theme kit packs the look (tokens, headers, footers and templates, with their fonts and images) to reuse on another site, and a site folder keeps an entire site's page