mirror of
https://github.com/GSA/notifications-admin.git
synced 2026-09-06 08:18:24 -04:00
43 lines
3.1 KiB
Markdown
43 lines
3.1 KiB
Markdown
|
|
# New Templates Glossary
|
|
|
|
This document serves as a glossary for the templates directory structure of the project.
|
|
|
|
## Directory Structure
|
|
|
|
- `/templates`
|
|
- `base.html`: The main base template from which all other templates inherit. This template is a combination of `main_template`, `admin_template`, `withoutnav_template`, `settings_templates`, and `content_template`.
|
|
- **/layouts**: Contains shared layouts used across the site. Simply put, it defines the overall structure or skeleton of the application (less frequently revised).
|
|
- `withnav_template.html`: A variation of the base layout that includes a sidebar.
|
|
- `org_template.html`: A variaton of the withnav_template
|
|
- **/components**: Houses reusable UI components that can be included in multiple templates and can be tailored with different content or links depending on the context.(more frequently revised or customized)
|
|
- `head.html`: Template for the site's <head>, included in `base.html`.
|
|
- `header.html`: Template for the site's header, included in `base.html`.
|
|
- `footer.html`: Template for the site's footer, included in `base.html`.
|
|
- `settings_navigation.html`: The settings navigation used in `withnav_template.html` that previously extended `settings_template.html`.
|
|
- `org_nav.html`: The organization's navigation used solely in `org_template.html`.
|
|
- `main_nav.html`: The main navigation used in `withnav_template.html`
|
|
- `service_navigation.html`: The service navigation used in `withnav_template.html`. In withnav_template.html, the `serviceNavigation` block will be left empty in any child templates that previously extended `settings_template.html`.
|
|
- **/views** (or **/pages**): Individual page templates that use the base layouts, components, and partials to present content.
|
|
|
|
### Best Practices
|
|
|
|
- Use **inheritance** `{% extends %}` to build on base layouts.
|
|
- Employ **components** `{% include %}` for reusable UI elements to keep the code DRY and facilitate easier updates.
|
|
|
|
### Observation Notes
|
|
- The macro-options.json files in the header and footer component act as structural guides. They aren't directly used as data passed to the usaFooter function/macro. Instead, these files outline the expected properties and provide a description of their purpose. The `usaFooter` macro component is currently only invoked in the `admin_template`, which will eventually serve as the `base.html` template. This will simplify the approach when we change the footer macros to componenets by eliminating the need to dynamically pass this data from the base.html template. This is also true for `usaHeader` macro component.
|
|
|
|
|
|
|
|
### Old Layout Templates We Don't Need
|
|
- withoutnav_template.html Delete
|
|
- main_template.html Delete
|
|
- settings_templates.html `withnav_template` can be used to replace `settings_template`.
|
|
- settings_nav.html (move to /components/ directory)
|
|
- main_nav.html (move to /components/ directory)
|
|
- service_navigation.html (move to /components/ directory)
|
|
- org_template, could be under it's own directory called /layout/organization
|
|
- org_nav.html (move to /components/ directory)
|
|
- content_template.html Delete
|