publica un lloc des del teu repo de github

què hi guanyes

El teu repositori es descarrega, es revisa i es publica sota elteunom.does.software, servit per HTTPS des dels nostres servidors. No hi ha DNS a configurar ni certificat a renovar, perquè el nom ja és nostre i el certificat de comodí ja el cobreix.

Cada publicació conserva l'anterior, així que pots tornar enrere des del tauler quan un desplegament surt malament. També tens un editor de fitxers al tauler, per a l'arranjament d'una línia que no et ve de gust fer obrint el portàtil.

què ha de contenir el teu repo

Aquí no es construeix res. Servim el que hi ha al repositori, tal qual, així que el repo ha de guardar els fitxers acabats: un index.html a l'arrel de la branca que li indiquis, més tot el que carregui.

Si el teu projecte necessita un pas de build, executa'l on ja l'executes i fes commit del resultat, o empeny una branca ja construïda. Un repositori que només conté fonts publicarà les teves fonts, que no és el que vols.

1. Comprova que hi ha un index.html al nivell superior de la branca que importaràs.
2. Comprova els tipus de fitxer. Només es publiquen html, css, js, mjs, json, txt, pdf, webmanifest, les imatges png, jpg, jpeg, webp, gif, svg, ico i les tipografies woff, woff2, ttf; la resta es descarta.
3. Comprova la mida. Cap fitxer solt per sobre de 15 MB, i el lloc sencer per sota de 100 MB als plans gratuït i Starter, 300 MB a Pro.

importa'l

Connecta el proveïdor un cop des del teu compte i la llista d'importació et mostrarà els teus repositoris, privats inclosos.

1. A compte, connexions, connecta GitHub o GitLab. És la mateixa connexió amb la qual pots iniciar sessió.
2. Obre el teu subdomini, ves a la secció lloc i tria importar des d'un repositori.
3. Tria el repositori i la branca. Deixa la branca buida per seguir la principal.
4. Publica. El primer desplegament triga uns segons; quan acaba, el nom ja està servint.

desplegar a cada push

Activa desplegar en fer push i creem un webhook al repositori. A partir d'aquí, cada push a la branca que vas triar publica una versió nova pel seu compte.

Només compten els push a aquella branca exacta. Un push a una altra branca, una branca esborrada o una etiqueta s'ignoren, així que pots continuar treballant sense publicar mitja funcionalitat.

Si un desplegament falla, el lloc que ja estava en marxa continua en marxa. La fallada i el seu motiu apareixen al tauler, i no es canvia res fins que la versió nova s'ha descarregat i revisat sencera.

aplicacions d'una sola pàgina i 404

El router d'un framework necessita que cada URL retorni el mateix index.html. Activa l'interruptor d'aplicació d'una sola pàgina i qualsevol ruta que no sigui un fitxer real rep index.html amb un 200, que és el que espera un router de client.

Amb l'interruptor apagat, una ruta que no existeix busca un 404.html al teu propi lloc i el serveix amb un 404 de debò. Si no n'inclous cap, al visitant li surt la nostra pàgina d'error, que si més no li diu que el nom existeix.

els límits

Servir fitxers i redirigir són excloents. Mentre el lloc està encès, la redirecció de l'arrel i les regles per ruta continuen configurades però deixen de servir. El reenviament de correu no es toca i continua funcionant alhora.

Les versions que es guarden per tornar enrere van amb el pla: una al gratuït, tres a Starter, deu a Pro. El nombre de fitxers es talla a 1000, o 5000 a Pro.