Initialize Hugo website with custom infinite-scroll theme

- Set up complete Hugo project structure with bilingual support (EN/DE)
- Create custom pyx-theme with modern, clean design
- Implement infinite scrolling single-page layout with sections
- Style with white background, black text, and blue accent color
- Add responsive navigation with smooth anchor scrolling
- Move logo assets to static/images directory
- Configure i18n translations for English and German (Swiss spelling)
- Add company data structure in data/company.yaml
- Create archetypes for consistent content frontmatter
- Update CLAUDE.md with comprehensive project documentation

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
2026-02-08 14:21:10 +01:00
parent cef300360c
commit 5674fe005a
23 changed files with 898 additions and 20 deletions

View File

@@ -0,0 +1,10 @@
{
"permissions": {
"allow": [
"Bash(hugo version:*)",
"Bash(hugo --quiet:*)",
"Bash(hugo server:*)",
"Bash(git add:*)"
]
}
}

19
.gitignore vendored Normal file
View File

@@ -0,0 +1,19 @@
# Hugo
/public/
/resources/_gen/
/assets/jsconfig.json
hugo_stats.json
# OS
.DS_Store
Thumbs.db
# Editor
.vscode/
.idea/
*.swp
*.swo
*~
# Build
node_modules/

0
.hugo_build.lock Normal file
View File

View File

@@ -1,26 +1,31 @@
# CLAUDE.md # Project Context: Pyx Engineering AG (Hugo Website)
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. ## 1. Corporate Identity
* **Company:** Pyx Engineering AG
* **Industry:** IT Consulting Services / [ML ops, technologies like Kafka, Elasticsearch]
* **Tone of Voice:** Professional, precise, reliable, and high-quality (Swiss engineering standard).
* **Language:** Provide a multilanguage website in English (US) and German (CH) - *Note: Always use Swiss-German spelling (no "ß", use "ss").*
## Repository Overview ## 2. Technical Stack
* **SSG:** Hugo (v0.150 or newer))
* **Deployment:** manual deployment for now
* **Auth:** HTTPS access to Gitea repo on https://git.jammann.ch/joe/pyx-website
* **Styling:** logos available in EPS and PNG format. Choose whatever fits better
This is an asset repository for the PyX website containing logo files: ## 3. Content Architecture
- `pyx.eps` - PyX logo in EPS format (PostScript, 2558x742) * **Services:** Located in `/content/services/`. Each service should have a dedicated page.
- `pyx_hires.png` - PyX logo in PNG format (2558x742, RGB) * **Projects/References:** Essential for credibility. Format: Image, project scope, year, and services provided.
* **Frontmatter Requirements:** Every `.md` file must include: `title`, `description` (for SEO), `date`, and `thumbnail`.
* **Global Data:** Company address, phone, and UID are stored in `/data/company.yaml`.
## Repository Status ## 4. Claude's Operational Guidelines
* **Hugo Best Practices:** Use `partials` for reusable elements (Header/Footer). Use `shortcodes` for UI components in Markdown files.
* **Image Handling:** Always use Hugo Resource Processing (`.Resize`, `.Fill`, `.Process "webp"`) to ensure fast load times.
* **Clean Code:** Keep layouts modular. Avoid hardcoding strings; use i18n or data files where possible.
* **SEO Focus:** Ensure proper `H1` to `H3` hierarchy. Meta descriptions should be concise and professional.
This directory is not currently a git repository. To initialize version control: ## 5. Current Roadmap & Tasks
- [ ] Initialize project structure and Hugo theme.
- [ ] Draft content for "About Us" and "Core Services".
- [ ] Implement Swiss-compliant Imprint (Impressum) and Privacy Policy.
```bash
git init
git add .
git commit -m "Initial commit: Add PyX logo assets"
```
## Working with Assets
When modifying or adding new logo variants:
- Maintain the existing naming convention (`pyx_*.ext`)
- Keep both vector (EPS) and raster (PNG) formats when possible
- Document resolution and format specifications for new assets

53
README.md Normal file
View File

@@ -0,0 +1,53 @@
# Pyx Engineering AG Website
Corporate website for Pyx Engineering AG built with Hugo.
## Development
### Prerequisites
- Hugo v0.123.7+ (Extended version recommended)
### Local Development
```bash
# Start development server
hugo server -D
# Build site
hugo
# Create new content
hugo new services/my-service.md
hugo new projects/my-project.md
```
### Project Structure
- `/content/` - Site content (Markdown files)
- `/content/services/` - Service pages
- `/content/projects/` - Project/reference pages
- `/content/about/` - About pages
- `/data/company.yaml` - Company information (address, phone, UID)
- `/themes/pyx-theme/` - Custom Hugo theme
- `/static/images/` - Logo and static assets
- `/i18n/` - Translation files (English/German)
### Languages
The site supports:
- English (default)
- German (Swiss spelling - use "ss" instead of "ß")
### Content Guidelines
All content pages should include frontmatter:
```yaml
---
title: "Page Title"
description: "SEO description"
date: 2026-02-08
thumbnail: "image.jpg"
---
```
## Deployment
Manual deployment - build with `hugo` and upload `/public/` directory to web server.
## Repository
https://git.jammann.ch/joe/pyx-website

6
archetypes/default.md Normal file
View File

@@ -0,0 +1,6 @@
---
title: "{{ replace .File.ContentBaseName "-" " " | title }}"
description: ""
date: {{ .Date }}
draft: true
---

14
archetypes/services.md Normal file
View File

@@ -0,0 +1,14 @@
---
title: "{{ replace .File.ContentBaseName "-" " " | title }}"
description: ""
date: {{ .Date }}
draft: true
thumbnail: ""
weight: 10
---
## Overview
## Key Features
## Technologies

6
content/_index.de.md Normal file
View File

@@ -0,0 +1,6 @@
---
title: "Pyx Engineering AG"
description: "IT Beratungsdienstleistungen - ML Ops, Kafka, Elasticsearch"
---
Willkommen bei Pyx Engineering AG - Ihr Partner für hochwertige IT-Beratungsdienstleistungen.

6
content/_index.md Normal file
View File

@@ -0,0 +1,6 @@
---
title: "Pyx Engineering AG"
description: "IT Consulting Services - ML Ops, Kafka, Elasticsearch"
---
Welcome to Pyx Engineering AG - Your partner for high-quality IT consulting services.

9
data/company.yaml Normal file
View File

@@ -0,0 +1,9 @@
name: Pyx Engineering AG
address:
street: ""
city: ""
postal: ""
country: "Switzerland"
phone: ""
email: "info@pyx.ch"
uid: ""

48
hugo.toml Normal file
View File

@@ -0,0 +1,48 @@
baseURL = 'https://www.pyx.ch/'
languageCode = 'en-us'
title = 'Pyx Engineering AG'
theme = 'pyx-theme'
# Multilingual configuration
defaultContentLanguage = 'en'
defaultContentLanguageInSubdir = false
[languages]
[languages.en]
languageName = 'English'
weight = 1
title = 'Pyx Engineering AG'
[languages.en.params]
description = 'IT Consulting Services - ML Ops, Kafka, Elasticsearch'
[languages.de]
languageName = 'Deutsch'
weight = 2
title = 'Pyx Engineering AG'
[languages.de.params]
description = 'IT Beratungsdienstleistungen - ML Ops, Kafka, Elasticsearch'
# Image processing
[imaging]
resampleFilter = 'Lanczos'
quality = 85
anchor = 'Smart'
# Output formats
[outputs]
home = ['HTML', 'RSS', 'JSON']
section = ['HTML', 'RSS']
# Markup
[markup]
[markup.goldmark]
[markup.goldmark.renderer]
unsafe = true
[markup.highlight]
style = 'monokai'
lineNos = false
# Params
[params]
author = 'Pyx Engineering AG'
defaultImage = '/images/pyx_hires.png'

50
i18n/de.toml Normal file
View File

@@ -0,0 +1,50 @@
[home]
other = "Home"
[about]
other = "Über uns"
[services]
other = "Dienstleistungen"
[projects]
other = "Projekte"
[phone]
other = "Telefon"
[email]
other = "E-Mail"
[impressum]
other = "Impressum"
[privacy]
other = "Datenschutz"
[allRightsReserved]
other = "Alle Rechte vorbehalten"
[readMore]
other = "Mehr erfahren"
[exploreServices]
other = "Unsere Dienstleistungen"
[aboutDescription]
other = "Pyx Engineering AG ist ein Schweizer IT-Beratungsunternehmen, spezialisiert auf moderne Dateninfrastruktur und Machine Learning Operations. Wir liefern hochwertige Lösungen mit Schweizer Präzision und Zuverlässigkeit."
[mlOpsDescription]
other = "End-to-End Machine Learning Operations, von der Modellentwicklung bis zur Produktionsbereitstellung und Überwachung."
[kafkaDescription]
other = "Apache Kafka Expertise für den Aufbau robuster, skalierbarer Echtzeit-Datenstreaming-Plattformen."
[elasticsearchDescription]
other = "Such- und Analyselösungen auf Basis von Elasticsearch für Ihre datengetriebenen Anwendungen."
[projectsComingSoon]
other = "Projekte folgen in Kürze"
[projectsComingSoonDescription]
other = "Wir arbeiten derzeit daran, unsere erfolgreichen Kundenprojekte zu präsentieren. Schauen Sie bald wieder vorbei!"

50
i18n/en.toml Normal file
View File

@@ -0,0 +1,50 @@
[home]
other = "Home"
[about]
other = "About"
[services]
other = "Services"
[projects]
other = "Projects"
[phone]
other = "Phone"
[email]
other = "Email"
[impressum]
other = "Imprint"
[privacy]
other = "Privacy Policy"
[allRightsReserved]
other = "All rights reserved"
[readMore]
other = "Read more"
[exploreServices]
other = "Explore Our Services"
[aboutDescription]
other = "Pyx Engineering AG is a Swiss IT consulting company specializing in modern data infrastructure and machine learning operations. We deliver high-quality solutions with Swiss precision and reliability."
[mlOpsDescription]
other = "End-to-end machine learning operations, from model development to production deployment and monitoring."
[kafkaDescription]
other = "Apache Kafka expertise for building robust, scalable real-time data streaming platforms."
[elasticsearchDescription]
other = "Search and analytics solutions powered by Elasticsearch for your data-driven applications."
[projectsComingSoon]
other = "Projects Coming Soon"
[projectsComingSoonDescription]
other = "We're currently working on showcasing our successful client projects. Check back soon!"

View File

Before

Width:  |  Height:  |  Size: 30 KiB

After

Width:  |  Height:  |  Size: 30 KiB

View File

@@ -0,0 +1,22 @@
<!DOCTYPE html>
<html lang="{{ .Site.Language.Lang }}">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ .Title }} | {{ .Site.Title }}{{ end }}</title>
<meta name="description" content="{{ if .Description }}{{ .Description }}{{ else }}{{ .Site.Params.description }}{{ end }}">
<meta name="author" content="{{ .Site.Params.author }}">
<link rel="stylesheet" href="/css/style.css">
{{ block "head" . }}{{ end }}
</head>
<body>
{{ partial "header.html" . }}
<main>
{{ block "main" . }}{{ end }}
</main>
{{ partial "footer.html" . }}
</body>
</html>

View File

@@ -0,0 +1,28 @@
{{ define "main" }}
<section>
<header>
<h1>{{ .Title }}</h1>
{{ if .Description }}
<p>{{ .Description }}</p>
{{ end }}
</header>
<div class="list">
{{ range .Pages }}
<article>
<h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
{{ if .Params.thumbnail }}
{{ $image := .Resources.GetMatch .Params.thumbnail }}
{{ if $image }}
<img src="{{ ($image.Resize "400x").RelPermalink }}" alt="{{ .Title }}">
{{ end }}
{{ end }}
{{ if .Description }}
<p>{{ .Description }}</p>
{{ end }}
<a href="{{ .RelPermalink }}">Read more</a>
</article>
{{ end }}
</div>
</section>
{{ end }}

View File

@@ -0,0 +1,23 @@
{{ define "main" }}
<article>
<header>
<h1>{{ .Title }}</h1>
{{ if .Params.date }}
<time datetime="{{ .Date.Format "2006-01-02" }}">{{ .Date.Format "January 2, 2006" }}</time>
{{ end }}
</header>
{{ if .Params.thumbnail }}
<figure>
{{ $image := .Resources.GetMatch .Params.thumbnail }}
{{ if $image }}
<img src="{{ ($image.Resize "800x").RelPermalink }}" alt="{{ .Title }}">
{{ end }}
</figure>
{{ end }}
<div class="content">
{{ .Content }}
</div>
</article>
{{ end }}

View File

@@ -0,0 +1,91 @@
{{ define "main" }}
<!-- Hero Section -->
<section id="home" class="hero">
<div class="section-content">
<img src="/images/pyx_hires.png" alt="{{ .Site.Title }}" class="logo">
<h1>{{ .Site.Title }}</h1>
<p>{{ .Site.Params.description }}</p>
<a href="#services" class="cta">{{ i18n "exploreServices" }}</a>
</div>
<div class="scroll-indicator"></div>
</section>
<!-- About Section -->
<section id="about" class="about">
<div class="section-content">
<h2>{{ i18n "about" }}</h2>
<div class="content">
{{ .Content }}
<p>{{ i18n "aboutDescription" }}</p>
</div>
</div>
</section>
<!-- Services Section -->
<section id="services" class="services">
<div class="section-content">
<h2>{{ i18n "services" }}</h2>
<div class="service-list">
{{ range where .Site.Pages "Section" "services" }}
<article>
<h3><a href="{{ .RelPermalink }}">{{ .Title }}</a></h3>
{{ if .Description }}
<p>{{ .Description }}</p>
{{ else }}
<p>{{ .Summary }}</p>
{{ end }}
</article>
{{ end }}
{{ if eq (len (where .Site.Pages "Section" "services")) 0 }}
<!-- Placeholder services -->
<article>
<h3>ML Operations</h3>
<p>{{ i18n "mlOpsDescription" }}</p>
</article>
<article>
<h3>Kafka Solutions</h3>
<p>{{ i18n "kafkaDescription" }}</p>
</article>
<article>
<h3>Elasticsearch</h3>
<p>{{ i18n "elasticsearchDescription" }}</p>
</article>
{{ end }}
</div>
</div>
</section>
<!-- Projects Section -->
<section id="projects" class="projects">
<div class="section-content">
<h2>{{ i18n "projects" }}</h2>
<div class="project-list">
{{ range where .Site.Pages "Section" "projects" }}
<article>
{{ if .Params.thumbnail }}
{{ $image := .Resources.GetMatch .Params.thumbnail }}
{{ if $image }}
<img src="{{ ($image.Resize "600x").RelPermalink }}" alt="{{ .Title }}">
{{ end }}
{{ end }}
<div class="project-content">
<h3><a href="{{ .RelPermalink }}">{{ .Title }}</a></h3>
{{ if .Description }}
<p>{{ .Description }}</p>
{{ end }}
</div>
</article>
{{ end }}
{{ if eq (len (where .Site.Pages "Section" "projects")) 0 }}
<!-- Placeholder message -->
<article>
<div class="project-content">
<h3>{{ i18n "projectsComingSoon" }}</h3>
<p>{{ i18n "projectsComingSoonDescription" }}</p>
</div>
</article>
{{ end }}
</div>
</div>
</section>
{{ end }}

View File

@@ -0,0 +1,34 @@
<footer>
<div class="footer-content">
<div class="company-info">
<h3>{{ .Site.Data.company.name }}</h3>
{{ with .Site.Data.company.address }}
<address>
{{ if .street }}{{ .street }}<br>{{ end }}
{{ if .postal }}{{ .postal }} {{ end }}{{ if .city }}{{ .city }}<br>{{ end }}
{{ if .country }}{{ .country }}{{ end }}
</address>
{{ end }}
{{ with .Site.Data.company.phone }}
<p>{{ i18n "phone" }}: <a href="tel:{{ . }}">{{ . }}</a></p>
{{ end }}
{{ with .Site.Data.company.email }}
<p>{{ i18n "email" }}: <a href="mailto:{{ . }}">{{ . }}</a></p>
{{ end }}
{{ with .Site.Data.company.uid }}
<p>UID: {{ . }}</p>
{{ end }}
</div>
<nav class="footer-nav">
<ul>
<li><a href="{{ "/impressum" | relLangURL }}">{{ i18n "impressum" }}</a></li>
<li><a href="{{ "/privacy" | relLangURL }}">{{ i18n "privacy" }}</a></li>
</ul>
</nav>
</div>
<div class="footer-bottom">
<p>&copy; {{ now.Year }} {{ .Site.Data.company.name }}. {{ i18n "allRightsReserved" }}</p>
</div>
</footer>

View File

@@ -0,0 +1,23 @@
<header>
<nav>
<a href="{{ "/" | relLangURL }}" class="logo">
<img src="/images/pyx_hires.png" alt="{{ .Site.Title }}">
</a>
<ul>
<li><a href="{{ "/" | relLangURL }}#home">{{ i18n "home" }}</a></li>
<li><a href="{{ "/" | relLangURL }}#about">{{ i18n "about" }}</a></li>
<li><a href="{{ "/" | relLangURL }}#services">{{ i18n "services" }}</a></li>
<li><a href="{{ "/" | relLangURL }}#projects">{{ i18n "projects" }}</a></li>
</ul>
<!-- Language switcher -->
<ul class="language-switcher">
{{ if .IsTranslated }}
{{ range .Translations }}
<li><a href="{{ .RelPermalink }}">{{ .Language.LanguageName }}</a></li>
{{ end }}
{{ end }}
</ul>
</nav>
</header>

View File

@@ -0,0 +1,371 @@
/* Reset and Base Styles */
* {
margin: 0;
padding: 0;
box-sizing: border-box;
}
:root {
--primary-blue: #0066cc;
--text-black: #1a1a1a;
--background-white: #ffffff;
--light-gray: #f5f5f5;
--medium-gray: #e0e0e0;
}
html {
scroll-behavior: smooth;
scroll-snap-type: y mandatory;
}
body {
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
color: var(--text-black);
background: var(--background-white);
line-height: 1.6;
}
/* Header */
header {
position: fixed;
top: 0;
left: 0;
right: 0;
background: rgba(255, 255, 255, 0.95);
backdrop-filter: blur(10px);
z-index: 1000;
border-bottom: 1px solid var(--medium-gray);
}
header nav {
max-width: 1200px;
margin: 0 auto;
padding: 1rem 2rem;
display: flex;
justify-content: space-between;
align-items: center;
}
header nav a.logo {
display: flex;
align-items: center;
}
header nav img {
height: 32px;
width: auto;
}
header nav ul {
display: flex;
list-style: none;
gap: 2rem;
align-items: center;
}
header nav a {
color: var(--text-black);
text-decoration: none;
font-weight: 500;
transition: color 0.3s ease;
}
header nav a:hover {
color: var(--primary-blue);
}
header .language-switcher {
gap: 0.5rem;
}
header .language-switcher a {
padding: 0.25rem 0.75rem;
border: 1px solid var(--medium-gray);
border-radius: 4px;
font-size: 0.9rem;
}
header .language-switcher a:hover {
background: var(--light-gray);
border-color: var(--primary-blue);
}
/* Main Content */
main {
margin-top: 65px;
}
/* Section Styles */
section {
min-height: 100vh;
display: flex;
flex-direction: column;
justify-content: center;
align-items: center;
padding: 4rem 2rem;
scroll-snap-align: start;
}
section:nth-child(even) {
background: var(--light-gray);
}
.section-content {
max-width: 1200px;
width: 100%;
}
/* Hero Section */
.hero {
text-align: center;
}
.hero .logo {
max-width: 400px;
width: 100%;
height: auto;
margin-bottom: 2rem;
}
.hero h1 {
font-size: 3rem;
font-weight: 700;
margin-bottom: 1rem;
color: var(--text-black);
}
.hero p {
font-size: 1.5rem;
color: #666;
margin-bottom: 2rem;
}
.hero .cta {
display: inline-block;
padding: 1rem 2rem;
background: var(--primary-blue);
color: white;
text-decoration: none;
border-radius: 8px;
font-weight: 600;
transition: background 0.3s ease, transform 0.2s ease;
}
.hero .cta:hover {
background: #0052a3;
transform: translateY(-2px);
}
/* Services Section */
.services {
background: var(--light-gray);
}
.services h2 {
font-size: 2.5rem;
margin-bottom: 3rem;
text-align: center;
color: var(--text-black);
}
.service-list {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
gap: 2rem;
width: 100%;
}
.service-list article {
background: white;
padding: 2rem;
border-radius: 8px;
box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
transition: transform 0.3s ease, box-shadow 0.3s ease;
}
.service-list article:hover {
transform: translateY(-4px);
box-shadow: 0 4px 16px rgba(0, 102, 204, 0.2);
}
.service-list h3 {
font-size: 1.5rem;
margin-bottom: 1rem;
color: var(--primary-blue);
}
.service-list h3 a {
color: var(--primary-blue);
text-decoration: none;
}
.service-list p {
color: #666;
line-height: 1.8;
}
/* About Section */
.about {
background: white;
}
.about h2 {
font-size: 2.5rem;
margin-bottom: 2rem;
text-align: center;
}
.about .content {
max-width: 800px;
margin: 0 auto;
font-size: 1.1rem;
line-height: 1.8;
color: #444;
}
/* Projects Section */
.projects h2 {
font-size: 2.5rem;
margin-bottom: 3rem;
text-align: center;
}
.project-list {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(350px, 1fr));
gap: 2rem;
width: 100%;
}
.project-list article {
background: white;
border-radius: 8px;
overflow: hidden;
box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
transition: transform 0.3s ease;
}
.project-list article:hover {
transform: translateY(-4px);
}
.project-list img {
width: 100%;
height: 200px;
object-fit: cover;
}
.project-list .project-content {
padding: 1.5rem;
}
.project-list h3 {
font-size: 1.3rem;
margin-bottom: 0.5rem;
color: var(--text-black);
}
/* Footer */
footer {
background: var(--text-black);
color: white;
padding: 3rem 2rem 1rem;
}
.footer-content {
max-width: 1200px;
margin: 0 auto;
display: grid;
grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
gap: 2rem;
margin-bottom: 2rem;
}
footer h3 {
color: var(--primary-blue);
margin-bottom: 1rem;
}
footer a {
color: #ccc;
text-decoration: none;
transition: color 0.3s ease;
}
footer a:hover {
color: var(--primary-blue);
}
footer ul {
list-style: none;
}
footer li {
margin-bottom: 0.5rem;
}
.footer-bottom {
max-width: 1200px;
margin: 0 auto;
padding-top: 2rem;
border-top: 1px solid #444;
text-align: center;
color: #888;
}
/* Scroll Indicator */
.scroll-indicator {
position: absolute;
bottom: 2rem;
left: 50%;
transform: translateX(-50%);
animation: bounce 2s infinite;
}
.scroll-indicator::before {
content: "↓";
font-size: 2rem;
color: var(--primary-blue);
}
@keyframes bounce {
0%, 20%, 50%, 80%, 100% {
transform: translateX(-50%) translateY(0);
}
40% {
transform: translateX(-50%) translateY(-10px);
}
60% {
transform: translateX(-50%) translateY(-5px);
}
}
/* Responsive */
@media (max-width: 768px) {
header nav {
flex-direction: column;
gap: 1rem;
}
header nav ul {
gap: 1rem;
}
.hero h1 {
font-size: 2rem;
}
.hero p {
font-size: 1.2rem;
}
section {
min-height: auto;
padding: 3rem 1rem;
}
.service-list,
.project-list {
grid-template-columns: 1fr;
}
}

View File

@@ -0,0 +1,10 @@
name = "Pyx Theme"
license = "Proprietary"
description = "Custom theme for Pyx Engineering AG"
homepage = "https://www.pyx.ch/"
tags = ["corporate", "multilingual", "business"]
min_version = "0.123.0"
[author]
name = "Pyx Engineering AG"
homepage = "https://www.pyx.ch/"