Editing Content
| Parent pages: Contributing | README |
Table of contents
- Overview
- Add a new section to the homepage
- Add a new page
- Update the sponsorship page
- Edit navigation
- Modify header (masthead)
- Modify footer
- Update social links
- Styling changes
- Safe editing checklist
Overview
Use this page for content and structure changes in the site source files.
Add a new section to the homepage
- Open
_pages/index.html. - Add a new
<section ... id="your-section-id">...</section>block where you want it to appear. - If the section should appear in top navigation, add a matching entry in
_data/navigation.ymlwithurl: /#your-section-id. - Preview locally and verify anchor scrolling.
Add a new page
- Create a file in
_pages/(for example_pages/about.md). - Add front matter:
--- title: "About" layout: page permalink: /about/ --- - Add page content below front matter.
- Add a link in
_data/navigation.ymlif the page should appear in the masthead.
Update the sponsorship page
- Edit content in
_pages/sponsorship.md(copy, headings, sponsor cards). - Add or update sponsor logos in
assets/images/, then reference them with<img src="/assets/images/...">. - If you need the link in the top navigation, add or update the entry in
_data/navigation.yml. - Adjust sponsor layout styles in
assets/css/custom-styles.css(.sponsor-grid,.sponsor-card,.sponsorship-page).
Edit navigation
Update _data/navigation.yml (main: list). For homepage sections, use anchors like /#purpose; for standalone pages, use their permalink paths.
Modify header (masthead)
- Navigation source:
_data/navigation.yml - Header template:
_includes/masthead.html - Site-level masthead settings:
_config.yml(logo,masthead_title,subtitle,sticky-masthead,masthead-opacity)
Modify footer
- Footer markup:
_includes/footer.html - Footer links metadata:
_config.ymlunderfooter.links - Footer copyright:
_config.ymlunderfooter.copyright
Update social links
Edit _config.yml:
footer:
links:
- label: "LinkedIn"
icon: "fab fa-linkedin"
url: "https://..."
These links are rendered by _includes/footer.html.
Styling changes
- Theme imports/skin:
assets/css/main.scss - Site-specific overrides:
assets/css/custom-styles.css
Prefer assets/css/custom-styles.css for local customization changes.
Primary button and social hover colors are controlled by CSS variables in assets/css/custom-styles.css, including --kcdp-primary and --kcdp-primary-hover.
Safe editing checklist
- Keep content edits in
_pages/, configuration edits in_config.yml, and component edits in_includes//_layouts/. - Do not edit generated output in
_site/. - Preview locally before opening a PR.