ES | EN

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:

CorrectoIncorrecto
primeros-pasos.phpPrimerosPassos.php
enrutamiento-archivos.phpenrutamiento_archivos.php
hola-mundo.phpholamundo.php

Organización de Contenido

Páginas de sección (index.php)
Cada carpeta puede tener un index.php que 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.php para 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 en public/

← Volver a Características