Crear un repositorio de GitHub a partir de archivos de código fuente ya existentes

En esta guía encontrarás cómo configurar los despliegues de GitHub en WordPress.com utilizando archivos de código fuente locales. Se asume que tienes una cuenta de GitHub y que has configurado Git en tu ordenador.

Crear un repositorio Git local

Si ya tienes un repositorio de Git local, puedes saltarte este paso y pasar a la sección Añadir tus archivos a GitHub.

Tengo un proyecto wp-env

Este es el entorno de desarrollo oficial de WordPress basado en Docker. Esta sección da por hecho que ya has configurado un proyecto wp-env. Si no lo has hecho, puedes seguir esta guía. 

Supongamos que has creado un nuevo tema y un plugin. La estructura de archivos de tu proyecto será algo parecido a esto:

<project root>/wp-content/themes/mytheme
<project root>/wp-content/plugins/myplugin

o

<project root>/themes/mytheme
<project root>/plugins/myplugin

1. En <project root> en tu terminal, ejecuta git init para crear un repositorio de Git.
2. A continuación, ejecuta git add . para indicarle a Git que empiece a rastrear tus archivos.
3. Después, ejecuta git commit -m “Initial commit” para confirmar los archivos.

Ahora puedes saltar a la sección Añadir tus archivos a GitHub.

Tengo un proyecto de Studio de WordPress.com

Supongamos que has creado un nuevo tema y un plugin en tu proyecto de Studio. La estructura de archivos de tu proyecto será algo parecido a esto:

site-folder/...
site-folder/wp-content/...
site-folder/wp-content/themes/mytheme
site-folder/wp-content/plugins/myplugin

1. En Studio, selecciona tu sitio local y haz clic en Abrir en el terminal. El directorio de trabajo actual será la carpeta de tu sitio. 
2. Ejecuta cd wp-content.
3. Ejecuta git init para crear tu repositorio de Git.
4. A continuación, ejecuta git add themes/mytheme plugins/myplugin para indicarle a Git que rastree tus archivos.
5. Para terminar, ejecuta git commit -m "Initial commit".

Tengo un proyecto de Local con Flywheel

Esta guía te muestra cómo tomar un proyecto de Local y crear un repositorio a partir de los archivos que has añadido. Los sitios creados con Local tienen una instalación completa de WordPress. Aunque puedes añadirlos todos a GitHub, se recomienda que crees el repositorio solo a partir de los archivos que tú has añadido. 

Supongamos que has creado un nuevo tema y un plugin en tu proyecto de Local. La estructura de archivos de tu proyecto será algo parecido a esto:

public/...
public/wp-content/...
public/wp-content/themes/mytheme
public/wp-content/plugins/myplugin

1. En Local, haz clic en Abrir shell del sitio. El directorio de trabajo actual será public, que es la carpeta raíz del sitio.
2. Ejecuta cd wp-content.
3. Ejecuta git init para crear tu repositorio de Git.
4. A continuación, ejecuta git add themes/mytheme plugins/myplugin para indicarle a Git que rastree tus archivos.
5. Finalmente, ejecuta git commit -m “Initial commit”. 

Ahora puedes saltar a la sección Añadir tus archivos a GitHub.

Tengo un proyecto wp-now

En esta guía podrás ver cómo tomar un proyecto wp-now y crear un repositorio de Git local a partir de él.

Supongamos que has creado un plugin con wp-now y tus archivos están en el directorio de trabajo actual:

index.php
style.css

1. Ejecuta git init para crear tu repositorio Git.
2. A continuación, ejecuta git add . para indicarle a Git que rastree tus archivos.
3. Finalmente, ejecuta git commit -m “Initial commit”. 

Ahora puedes saltar a la sección Añadir tus archivos a GitHub.

Tengo archivos en mi sitio de WordPress.com

En esta guía, utilizaremos el comando rsync. También puedes copiar tus archivos a tu sistema de archivos local usando un cliente FTP.

1. Ve a wordpress.com/hosting-config/:tu-sitio y activa el SSH si no está habilitado ya.

2. Copia la dirección SSH, por ejemplo, instantdiskette5.wordpress.com@sftp.wp.com.
3. Identifica la ruta al contenido que quieres descargar:
   • Cada tema está en su propia carpeta bajo /htdocs/wp-content/themes/.
   • Cada plugin está en su propia carpeta bajo /htdocs/wp-content/plugins/.
4. Crea una carpeta local ejecutando mkdir [PROJECT_NAME] && cd [PROJECT_NAME], donde [PROJECT_NAME] es el nombre de la carpeta de tu proyecto.
5. Descarga el tema o plugin de WordPress.com en tu carpeta de proyecto local ejecutando rsync -avzh [SFTP_USERNAME]@sftp.wp.com:[PATH_TO_CONTENT_FOLDER] ..
   • [SFTP_USERNAME] es tu nombre de usuario de las credenciales SFTP.
   • [PATH_TO_CONTENT_FOLDER] es la ruta absoluta al contenido (tema o plugin) que quieres descargar.
     • Supongamos que tienes un tema personalizado «mytheme» en tu sitio de WordPress.com y quieres crear un despliegue para él. Tu tema debería estar en /htdocs/wp-content/themes/mytheme/, y esa debería ser la ruta utilizada en el comando.

6. Se te pedirá que introduzcas tu contraseña, que puedes encontrar en credenciales SFTP de la configuración de tu servidor en wordpress.com/hosting-config/:tu-sitio.
7. Espera a que se complete la descarga y luego cambia de directorio a tu carpeta de contenido ejecutando cd [CONTENT_FOLDER_NAME].
8. Luego, ejecuta git init para crear un repositorio Git.
9. A continuación, ejecuta git add . para indicarle a Git que rastree tus archivos.
10. Finalmente, ejecuta git commit -m "Initial commit". 

Error habitual

Un error habitual que se encuentra al ejecutar el comando rsync es:

receiving file list ... unexpected tag 103 [receiver]rsync error: error in rsync protocol data stream (code 12)

Esto suele suceder cuando se proporciona la ruta incorrecta al comando rsync.

Añadiendo tus archivos a GitHub

Deberías tener un repositorio de Git local antes de empezar con este paso. Crearemos un repositorio en GitHub y subiremos el contenido del repositorio local allí.

1. Navega a https://github.com/new:
   • Introduce un nombre de repositorio.
   • Elige Público o Privado. Si es privado, tendrás que generar un token de acceso antes de subir tu repositorio local a GitHub.
   • Importante: Deja todas las demás opciones como aparecen por defecto. Puedes añadir un README y una licencia más tarde.
   • Haz clic en el botón Crear repositorio.
     

2. Toma nota de la URL de tu repositorio de GitHub, que será https://github.com/<account name>/<repository name>.
3. En la raíz de tu proyecto, ejecuta git remote add origin https://github.com/<account name>/<repository name>.git, lo que vinculará tu repositorio local a tu repositorio de GitHub. Localmente, tu repositorio remoto de GitHub se conocerá como origin.
4. A continuación, ejecuta git remote -v para verificar que ha funcionado.
   • Deberías ver algo como:

origin https://github.com/<account name>/<repository name> (fetch)
origin https://github.com/<account name>/<repository name> (push)

5. Ahora ejecuta git status y toma nota del nombre de la rama que estás usando.
6. Ejecuta git push -u origin BRANCH con el nombre de la rama del paso anterior.
7. Si tu repositorio es privado, crea un nuevo token de acceso aquí.
   • Introduce un valor de Nombre del Token, selecciona los repositorios en los que el token es válido y luego ve a los permisos de repositorio Contenido y selecciona Lectura y escritura.

8. Copia el token de acceso de GitHub en la línea de comandos cuando se te pida.
9. Verifícalo en GitHub y confirma que tus archivos locales ahora están en tu repositorio.

Ahora puedes saltar a la sección Configurar un despliegue en WordPress.com.

Enlaces:

• Documentación oficial de GitHub

Configurar un despliegue en WordPress.com

Una vez que tengas tus archivos en el repositorio de GitHub, puedes continuar con nuestra guía de Despliegues de GitHub.