mi_pagina_web · Estructura madre completa

Plantilla genérica para cualquier proyecto web

1. Regla clave

Solo @public_html/ es pública. bases_datos/, configuracion/, backups/ y extras/ deben quedar fuera de la publicación.

No deben publicarse contraseñas, tokens, claves API, cadenas de conexión, copias de seguridad ni bases de datos.

2. Estructura global válida

Google Drive
└── ---@web/
    └── www/
        ├── @public_html/                  ← zona pública
        │   └── mi_pagina_web/             ← proyecto web publicado
        ├── bases_datos/                    ← NO pública
        ├── configuracion/                  ← NO pública
        ├── backups/                        ← NO pública
        └── extras/                         ← NO pública

---@web/ es el contenedor principal del proyecto y puede compartirse con Linux. Es la raíz del servidor dentro de este modelo de trabajo.

www/ agrupa el entorno real del proyecto. @public_html/ contiene únicamente lo que se va a publicar.

3. Ejemplo completo dentro de mi_pagina_web/ PÚBLICO

mi_pagina_web/
├── index.html                       ← página de entrada
├── favicon.ico
├── README.md                        ← documentación del proyecto
├── paginas/                         ← opcional: HTML secundarios
│   ├── blog.html
│   ├── contacto.html
│   └── ...
├── css/
│   └── style.css
├── js/
│   └── script.js
├── imagenes/
│   ├── logo.png
│   └── ...
├── documentos/                     ← solo documentos que deban ser públicos
└── modulos/                        ← opcional: utilidades/componentes públicos
    ├── cookies/
    └── ...

Variante mínima

Para aprender o para una web muy pequeña, index.html puede contener HTML, CSS y JavaScript juntos.

Variante organizada

En proyectos mayores conviene separar páginas, estilos, JavaScript, imágenes y módulos comunes.

La estructura interna puede adaptarse al proyecto. Lo importante es mantener clara la diferencia entre contenido público y datos privados.

4. Zonas privadas NO PUBLICAR

CarpetaQué guardaRegla
bases_datos/Exportaciones, SQLite, SQL, datos de usuarios u otros datos persistentes.No exponer por HTTP.
configuracion/Configuraciones privadas, secretos, tokens, claves API, credenciales, variables de entorno.Nunca copiar secretos a @public_html/.
backups/ZIP, copias anteriores, snapshots y archivos de recuperación.No publicar copias de seguridad.
extras/Material auxiliar privado: fuentes originales, scripts de mantenimiento, recursos de trabajo, borradores.Publicar solo una copia concreta si realmente debe ser accesible.

5. Rutas y enlaces

Los enlaces públicos deben escribirse respecto a la ubicación real de los archivos.

<!-- Desde mi_pagina_web/index.html -->
<link rel="stylesheet" href="css/style.css">
<script src="js/script.js" defer></script>
<img src="imagenes/logo.png" alt="Logo">
<a href="paginas/contacto.html">Contacto</a>

Si se mueve o renombra un archivo, hay que revisar href, src, fetch(), importaciones, formularios y cualquier ruta construida en JavaScript.

6. Flujo de trabajo recomendado

  1. Diseñar la estructura.
  2. Crear carpetas y colocar cada archivo en su ubicación definitiva.
  3. Escribir o adaptar HTML, CSS y JavaScript.
  4. Comprobar todas las rutas por HTTP/HTTPS.
  5. Revisar privacidad, cookies y seguridad.
  6. Crear copia de seguridad.
  7. Eliminar únicamente archivos obsoletos.
  8. Actualizar Git.
  9. Subir a GitHub.
  10. Publicar y verificar GitHub Pages u otro servidor.

7. Checklist antes de publicar

8. Ejemplo de ruta de publicación

/mnt/shared/GoogleDrive/---@web/www/@public_html/mi_pagina_web/

La ruta concreta puede variar según el montaje de Google Drive o el servidor. La regla estructural no cambia: mi_pagina_web/ vive dentro de @public_html/; las carpetas privadas viven fuera.