Outlines are equivalent to Joomla templates and are installed in Joomla as templates. Outlines all inherit from a ‘Base Oultine’ which is not visible in Joomla as a template. This inheritance can be turned off.
It is recommend to alter the ‘Base Outline’ for global changes and if you are only going to have one arrangement then you only ever need to adjust this template. The outline ‘Helium – Default’ is configured to inherit all of the ‘Base – outline’ so it would be this that you use as you joomla template. The ‘Helium – Home – Particles’ is just a demo showing particles (which only exist in Gantry) functioning on a Gantry template/outline.
To get an new Outline loaded
- put example1.yaml in /custom/layouts/
- and then goto outlines in gantry admin
- Click add (+)
- it will appear in there for adding under presets
Once you have loaded the layout in outlines the edits to the file /custom/layouts/example1.yaml will not work as this is only a preset file and not the actual the layout/template file.
When you add a layout from a preset what happens is:
- It copies the layout example1.yaml into /custom/config/23/example1.yaml (the 23 is the id given to the layout)
- adds a/custom/config/23/index.yaml
You can edit these files and you layout will change.
- NB: don’t just delete the preset files it can cause errors, delete from within the gantry framework
- NB: you can create a new outline from an exisiting outline and then edit that from within /custom/config/{No.}/
- NB: CSS styling might not be automatically applied because it is a new section that is not styled.
Notes
- When you edit the base outline it alters the files g5_helium/custom/config/default/
- A container is set in the outline and cannot be altered in the gantry admin because it has been sectioned in the yaml file so even if you remove all of the modules the sections will remain.
- The ‘Helium – Default’ in this instance has an ID of 9 so if you did any alterations they would be stored in g5_helium/custom/config/19/
- You should always alter the ‘Base Outline’ when designing a site as all outlines will inherit of this outline. So edit stuff you want site wide here and then create other outlines to override this where needed, if at all.