dunglas / dunglas/frankenphp-website

Add Italian (it) locale to the website

Open
#49 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
HTML
Stars
6
Forks
23
PR merge metrics
No merged PRs in 30d

Description

### Summary

The Italian documentation already exists upstream in [`php/frankenphp/docs/it`](https://github.com/php/frankenphp/tree/main/docs/it), but the website does not build or serve an Italian version yet. Every other translated language (fr, es, ja, zh, ru, tr, pt-br) is wired into `hugo.yaml` and `clone-documentation.php` — Italian is simply missing.

### Motivation

This was requested by the community. Massimiliano Arione (freelance web developer & Symfony specialist) asked:

> Could we give a push to the Italian docs translation, which is in the repo but not on the website? Thanks

### Proposal

Enable the `it` locale end to end, mirroring the existing languages:

- Register `it` in `hugo.yaml` (menu, weight, `contentDir`)
- Add `it` to the `languages` array in `clone-documentation.php` so the Italian docs get cloned at build time
- Translate the site chrome: `i18n/it.yaml`, `data/it/**` (home + help pages), `content/it/help`
- Add the missing `static/img/flags/it.svg` for the language switcher

### Type

Enhancement (new feature) — it adds a new supported language to the site, rather than fixing broken behavior.

Contributor guide

Open the contributing guide

Research direction

Compare an existing language in hugo.yaml, clone-documentation.php, i18n/, data/, content/, and static/img/flags/. Add the Italian counterparts named in the proposal and run the site build to verify the docs clone, language menu, homepage, help pages, and it.svg all work. Done means the website builds and serves the Italian documentation end to end.

Written by the indexing model from the issue text.

Assessment

Tech stack
hugo, php
Domain
documentation, internationalization, web-dev
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
65/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.