astro-pi.org editorial documentation

These docs cover the essentials on how to update content on astro-pi.org.

Key pages are managed by our Content Management System (CMS), Contentful. This allows editors to update the website themselves without having to request development work.

Contentful builds up pages with Components. Components are things, such as banners, blocks, or cards. Some components are managed in Contentful, whereas others are static (e.g. the header bar). Components can contain further components, meaning you can build up pages with ease.

You can preview components so you can visualise what it is you're building.

tip

Bookmark these URLs for fast access. The URL you're redirected to may change, so only bookmark these short URLs.

• CMS Documentation system URL (https://astro-pi-cms-docs.rpf-internal.org/)
  • The CMS Documentation system is where you can read how to use Contentful and what components we have available to use
• Isolated Component Previews (https://astro-pi-org-staging.herokuapp.com/rails/view_components)
  • Preview components in isolation without content to get a feel for what they look like
  • Please note that there are a lot of other components which are not used by the CMS
  • Only the ones documented have CMS control