Skip to content

Add Jekyll site structure, navigation, and GitHub Pages deploy workflow#6

Merged
nduytg merged 1 commit into
masterfrom
codex/set-up-jekyll-site-structure-4ggj3z
Apr 19, 2026
Merged

Add Jekyll site structure, navigation, and GitHub Pages deploy workflow#6
nduytg merged 1 commit into
masterfrom
codex/set-up-jekyll-site-structure-4ggj3z

Conversation

@nduytg
Copy link
Copy Markdown
Owner

@nduytg nduytg commented Apr 19, 2026

Motivation

  • Convert the repository to a GitHub Pages-friendly Jekyll site with clear collections and navigation to make content easier to publish and browse.
  • Provide a reusable site layout and content entry points so evergreen cheat sheets, projects, and time-based blog posts are presented consistently.
  • Enable automated build and deployment to GitHub Pages and remove the custom CNAME so the repository uses the default Pages domain pattern.

Description

  • Add a GitHub Actions workflow (.github/workflows/pages-deploy.yml) to build the site with Jekyll, upload the generated _site, and deploy Pages on pushes to main.
  • Update _config.yml to define site metadata, docs and projects collections, and default layouts, and add _data/navigation.yml for top navigation.
  • Add a base layout (_layouts/default.html), collection content (_docs/getting-started.md, _projects/platform-engineering-case-study.md), a new blog post (_posts/2026-04-19-site-structure-update.md), and site pages (index.md, cheat-sheets.md, projects.md, blog.md, about.md).
  • Update README.md to document the Jekyll content model and CI/CD workflows, remove CNAME, and tweak pymarkdown config (.pymarkdown.json) to enable front-matter and adjust rules.

Testing

  • Ran local pre-commit hooks and pymarkdown linter via pre-commit run --all-files, and the checks completed successfully.
  • The new GitHub Actions Pages workflow is configured to build on pull requests and deploy on pushes to main, and it will run on the next eligible push to main (no deployment run occurred in this PR).

Codex Task

@nduytg nduytg merged commit 780021d into master Apr 19, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant