Literal | Subiendo nuestra página estática a Codeberg

Esta es la segunda (o quizá tercera) parte para crear su sitio estático y subirlo a un servidor, en este caso codeberg. Con anterioridad les platique de las páginas estáticas en general y como crear una con pelican. Con esas bases podemos pasar a publicarla para todo el mundo desde codeberg. Les platicaré de esta herramienta y pasamos a la acción.

Codeberg

De codeberg supe por la recomendación de une fedinauta (miembrx del fediverso, en particular en mastodon) a quien va mi agradecimiento. Es una plataforma colaborativa y de almacenamiento tipo git. En particular hace uso de gitea, una opción con licencia MIT un poco más ligera, y le agrega algunas funcionalidades extras.

Siendo un esfuerzo independiente subsiste gracias a las donaciones de los usuarios, así que de tener la oportunidad no dejen de darles un poco de amor y otro poco de apoyo económico por medio de liberapay.

La metodología vista aquí no es exclusiva para codeberg, puede ser usada para un servidor propio, un espacio facilitado por la institución en que colaboren. Mientras puedan subir archivos html es un procedimiento similar.

Es sencillo registrase y aunque no se sepa mucho del uso de git, la misma plataforma te ayuda a dar los primeros pasos, aquí tomaremos un poco prestada su guía.

Así que pongamos manos a la obra.

Subir el sitio

Una vez que ya armamos, manipulamos y pusimos algo de contenido a su sitio estático con pelican la carpeta que usaremos es /path-to/pelicano/output/, ahí está contenido todo lo que necesitamos, lo demás archivos son útiles para nosotros pero no para codeberg o el servidor.

Si ya creamos nuestra cuenta en codeberg lo siguiente será iniciar sesión. La primer página que nos recibe es el panel de control, quizá ya hemos usado el espacio en codeberg o esté vacío. En caso de estar vacío no les aparecerá repositorio alguno.

Para crear un nuevo repositorio en la esquina superior derecha hay un símbolo + al que podemos dar clic para que se abra un menú, donde está la opción de crear un nuevo repositorio. Lo mismo se puede hacer desde la parte inferior derecha, a lado del titular que dice Repositorios en el signo de +.

Es necesario el repositorio se llame pages, de otra forma no podrá ser desplegado como un sitio web.

Una vez que demos el nombre del repositorio podemos agregar un poco más de información. De ya estar familiarizados con git podemos manipular esta parte como estemos acostumbrados. Si no lo mejor es dejar todos los demás espacios en blanco o como están por defecto.

Al final está el botón verde de Crear repositorio, damos clic y vamos a la parte de publicar.

A continuación veremos la página del proyecto, en particular la sección <> Código, como no hay nada nos dará una guía rápida con las siguientes opciones:

Clonar este repositorio
Crear un nuevo repositorio desde línea de comandos
Hacer push de un repositorio existente desde línea de comandos

La opción que usaremos es la de crear un nuevo repositorio desde la línea de comandos. Para esto debemos tener instalado git en la computadora. Lo podemos hacer desde los repositorios de todas las distribuciones populares de gnu/linux, para el caso de windows y macOS seguro hay varias ayudas por internet.

Ya con git y desde el directorio /path-to/pelicano/output, podemos consultar la guía rápida para crear el repositorio desde línea de comandos:

   cd /path-to/pelicano/output

Inicializamos el git en la carpeta donde está la salida del generador de sitios estáticos:

    git init

Nos movemos a la rama principal:

      git checkout -b main

Agregamos todo lo que hay en el directorio. Podríamos subir archivo por archivo, pero aquí somos atrabancados y subimos todo de golpe (la verdad es que es el modo de hacerlo la primera vez, después puede indicarse que sólo se subirá un artículo). Aquí solo ponemos los señalamientos para que sepa que se sube, aún no subimos nada:

        git add .

El commit es un comentario en la bitácora de cambios del repositorio, así ustedes o en caso de ser un esfuerzo colaborativo todos los participantes pueden llevar la cuenta de los cambios hechos. Entre comillas va el nombre del commit o la versión de los cambios:

  git commit -m "primer commit"

En el siguiente comando le decimos a git cual es la dirección del repositorio, para cada quien en lugar de deben poner el nombre de su usuario, el nombre del repositorio siempre será pages si queremos se despliegue como una página de internet:

    git remote add origin https://codeberg.org/<usuario>/pages.git

Finalmente subimos todos los cambios que hicimos en la carpeta. En el caso del primer commit subiremos todo, posteriormente con los comandos correctos de git se encargarán de buscar los cambios y subirlos. Nos pedirá nombre de usuario, con el que acceden a la plataforma, y la contraseña.

git push -u origin main

Si todo avanza bien podemos ver ya nuestra flamante página estática en:

   https://<usuario>.codeberg.page

En escriban el nombre que eligieron de usuario.

Por lo regular en un repositorio se agrega una lista de archivos a no subir, el gitignore. Para nuestro caso no es necesario, a menos que haya algo que no quieran subir de la carpeta, pero es mejor usar las características de pelican para evitar subir o listar en la página artículos que aún estén en preparación, así no metemos mucha mano a la carpeta.

Ya está el sitio, ahora seguro se preguntarán "¿debo escribir todas esas líneas cada que realicé un cambio?" La respuesta es no, es la ventaja de usar git. Codeberg ya sabe que en esa carpeta se alojan las páginas web y todo lo relacionado, ya sabe cual es la dirección del repositorio, lo único que deben hacer cada que realicen un cambio en las páginas o agreguen una es:

Ya que agregamos una página como nueva_pagina.md no olvidemos guardarla y construirla en pelican como vimos en el tutorial pasado (recordemos que pelicano es el nombre de mi proyecto, ustedes cambien la ruta y el nombre a su caso correspondiente):
```
  pelican /path-to/pelicano/content
  pelican --listen
```
El último comando es opcional, no es necesario, pero es bueno checar el sitio antes de subirlo, siempre saldrán errores que se nos fueron, así que más vale hacer las revisiones necesarias.
Nos dirigimos a la carpeta output/, si agregamos nuevo contenido debemos agregarlo:
```
     cd /path-to/pelicano/output
     git add .
```
Podrían agregar el archivo específico, pero también pueden dejar que git cheque los cambios pos sí sólo.
A continuación hacemos un nuevo commit:
```
      git commit -m "segundo commit"
```
Al hacer el commit nos informará los cambios detectados en la carpeta, pueden ver si ajusta con lo que cambiaron.
Por último hacemos un push para subir los cambios al repositorio:
```
      git push
```
De nueva cuenta nos pedirá nuestro nombre de usuario y contraseña, subirá los cambios, y listo.

Como hemos mencionado hay un procedimiento similar para subir la página en github o gitlab, en un publicación posterior intentaremos hacerlo para gitlab.