Arquitectura del Sistema de Archivos
La organización de tu contenido define la estructura de tu sitio. Esta guía describe las mejores prácticas para construir sitios Wordless escalables y mantenibles.
Estructura del Proyecto
wordless-site/
├── public/ (raíz web)
│ ├── index.php (punto de entrada)
│ ├── .htaccess (reglas de enrutamiento)
│ └── assets/
│ ├── css/
│ ├── js/
│ └── img/
├── content/ (todo el contenido del sitio)
│ ├── index.php (página de inicio)
│ ├── about.php
│ ├── en/ (sección en inglés)
│ │ ├── index.php
│ │ └── features/
│ ├── es/ (sección en español)
│ │ ├── index.php
│ │ └── features/
│ └── docs/ (documentación)
├── templates/ (archivos de vista)
│ ├── layouts/
│ │ └── base.php
│ ├── partials/
│ └── page.php
├── app/ (código de aplicación)
├── bootstrap/ (inicialización)
└── storage/ (caché, logs)
Convenciones de Nombres
Nombres de Archivos
Usa nombres en minúsculas con guiones para todos los archivos:
| Correcto | Incorrecto |
|---|---|
primeros-pasos.php | PrimerosPassos.php |
enrutamiento-archivos.php | enrutamiento_archivos.php |
hola-mundo.php | holamundo.php |
Organización de Contenido
- Páginas de sección (
index.php) - Cada carpeta puede tener un
index.phpque actúa como página de listado o introducción de la sección - Páginas de contenido
- Archivos individuales que representan una única página o artículo
- Secciones de idioma
- Carpetas de nivel superior por idioma (
en/,es/) con sus propios metadatos heredables
Mejores Prácticas
- Mantén el contenido plano cuando sea posible — menos anidamiento es más fácil de gestionar
- Usa
index.phppara las páginas de listado de sección - Los metadatos de idioma en la carpeta raíz de idioma se heredan automáticamente
- Las rutas de activos (
/assets/css/,/assets/js/) viven enpublic/