Skip to content

README.md

Latest commit

 

History

History
112 lines (81 loc) · 4.41 KB

README.md

File metadata and controls

112 lines (81 loc) · 4.41 KB

landerox.com

Deploy Lint Links Zensical

Source code for the personal website at landerox.com.

This repository powers a bilingual (EN/ES) digital space focused on Data Platforms, Cloud Architecture, Automation, and Production AI.

Live Versions: English | Español

What's Inside?

The site is structured into three main areas, designed to share knowledge and document engineering experiences:

  1. Personal Positioning: An overview of my professional background, technical focus areas, and ways we can collaborate.
  2. Engineering Projects: A deep dive into reference implementations, architectural patterns, and real-world solutions I've built.
  3. Technology Radar: A curated, opinionated tracking of tools and frameworks, categorized by their adoption level and maturity.

Tech Stack

This site is statically generated for speed and reliability, using modern and fast tooling:

  • Framework: Zensical (a highly extensible Python static site generator).
  • Package Management: uv for lightning-fast Python dependency resolution.
  • Task Runner: just to automate local development workflows.
  • Hosting: Deployed seamlessly to GitHub Pages via GitHub Actions.

For a complete breakdown of the stack and the reasoning behind these choices, check out the docs/tooling.md and docs/decisions.md files.

Running the Site Locally

Want to explore the code or run the site on your machine? You have two easy options:

Option A: Dev Container (Recommended)

The easiest way to get started without polluting your local environment.

  1. Open this repository in VS Code with the Dev Containers extension installed (or use GitHub Codespaces).
  2. The included .devcontainer/ configuration will automatically provision Python 3.13, uv, just, lychee (for link checking), and pinact with pinned versions.

Option B: Local Installation

If you prefer a bare-metal setup, ensure you have Python 3.13+, uv, and just installed.

git clone https://github.com/landerox/landerox.github.io.git
cd landerox.github.io

# Install all dependencies using uv
just sync

# Start the development server
just serve               # English server at http://127.0.0.1:8000
just serve-es            # Spanish server at http://127.0.0.1:8001

# Build the static site into the `site/` directory
just build

Tip: Run just in your terminal with no arguments to see a full list of available tasks.

Repository Layout

Navigating the codebase is straightforward:

  • content/en/ & content/es/ — Markdown files containing the actual bilingual content of the site.
  • zensical.toml & zensical.es.toml — Main configuration files for the site.
  • .github/workflows/ — CI/CD pipelines for linting, deployment, and link validation.
  • docs/ — Internal documentation for maintaining the site:

Contributing

While this is primarily a personal site, I highly appreciate bug reports, typo fixes, and corrections. Please refer to the Contributing Guidelines before submitting a Pull Request.

License

This project is open-source and available under the MIT License.