Creating a patch/es: Difference between revisions

From Joomla! Documentation

< Creating a patch
Created page with "Crear un parche"
 
 
(13 intermediate revisions by the same user not shown)
Line 1: Line 1:
<noinclude><languages /></noinclude>
<noinclude><languages /></noinclude>
An important part of creating a patch for Joomla! is ensuring that you're managed to create everything properly. As a standard all patches should be created in the root of your Joomla! instance. This way when we come to test it we don't need to work out what directory the file you're trying to change is in or modify your patch file to work properly on our local system. This can be a problem because if your patch only changes one file, there may be one file with that name. For example we recently received a patch for a file called <tt>banner.php</tt>. There are five different files in Joomla! called <tt>banner.php</tt>, so we then need to try and work out which file is being referenced in this particular case.
Una parte importante de la creación de un parche para Joomla! es asegurarse que has conseguido crear todo correctamente. Como un estándar todos los parches deben ser creados en la raíz de tu sitio Joomla!. De esta manera, cuando llegamos a probarlo, no necesitamos averiguar en qué directorio debe estar el archivo que se está tratando de cambiar o modificar tu fichero de parche para que funcione correctamente en nuestro sistema local. Esto puede ser un problema, porque si el parche sólo cambia un archivo, puede haber un archivo con ese nombre. Por ejemplo, recientemente hemos recibido un parche para un archivo llamado <tt>banner.php</tt>. Hay cinco diferentes archivos de Joomla! que se llaman <tt>banner.php</tt>, así que tenemos que adivinar a que archivo es al que se hace referencia en este caso en particular.


= Creating a patch on the command line =  
= Crear un parche en la línea de comandos =  
For Linux/Mac users, using the command line is often the quickest way of creating a patch. Depending on how many changes you've made to your local install you might have a few different changes. The best method for avoiding this is to have a clean Joomla! check out from SVN and then make your changes to this. Then in the root of the Joomla! instance, execute the following command:
Para los usuarios de Linux/Mac, el uso de la línea de comandos es a menudo la manera más rápida de crear un parche. Dependiendo de cuantos cambios se hayan realizado en tu instalación local podrías tener un par de cambios diferentes. El mejor método para evitar esto es tener una instalación limpia de Joomla! obtenidad desde el SVN y, a continuación, realiza los cambios en este. A continuación, en la raíz del Joomla!, ejecuta el siguiente comando:
  svn diff > file.patch
  svn diff > file.patch
You need to ensure that only changes you have made are in the file and not any other irrelevant changes. If you can't do this you should specify the files that you changed to be part of the patch:
Necesitas asegurarte que sólo los cambios se han hecho en el archivo y no cualquier otro cambio irrelevante. Si no puedes hacer esto, debes especificar que archivos ha cambiado como parte del parche:
  svn diff libraries/joomla/database/table.php > jtable.patch
  svn diff libraries/joomla/database/table.php > jtable.patch


Make sure you are in the Joomla! root directory, not in the directory of the files (you will see folders like libraries, administrator, plugins, components, modules, etc).
Asegúrate que estás en el directorio raíz de Joomla!, no en el directorio de los archivos (podrás ver las carpetas como libraries, administrator, plugins, components, modules, etc).


= Creating a patch using Eclipse =
= Crear un parche utilizando Eclipse =
If you've got Subclipse and Eclipse you can check out a new project from the Joomla! SVN (which ever branch/release is relevant to your bug) and then use this to create a patch file. Keep in mind that by default Eclipse creates patches that includes the entire path to the files, which isn't what we want. Presuming you created a new project using the checkout from SVN and used the root of a Joomla! instance, you should be able to create a valid patch easily.
Si tienes Subclipse y Eclipse puedes comprobar un nuevo proyecto desde Joomla! SVN (cuya rama/liberación es relevante para el fallo) y, a continuación, utiliza esta opción para crear un archivo del parche. Ten en cuenta que, de forma predeterminada, Eclipse crea parches que incluyen la ruta completa a los archivos, que no es lo que queremos. Suponiendo que has creado un nuevo proyecto mediante el uso de SVN y utilizas la raíz de un sitio Joomla!, deberías ser capaz de crear un parche válido fácilmente.


To create a patch, select the files you have changed and then right click on one of them and select "Team > Create Patch". The first screen asks you where you want to put the file: the clipboard, into the filesystem or in the workspace. Typically you'll want to create it somewhere in the filesystem. I personally use a patch folder where I keep all of the patches that I make. You should also notice at the bottom of this screen the list of files that will be included in this patch. If you have included files you didn't want to, you can deselect them here. If you are missing a file from this list you will need to reselect your files and add them.
Para crear un parche, selecciona los archivos que han cambiado y, a continuación, has clic en uno de ellos y selecciona "Equipo > Crear el Parche". La primera pantalla te preguntará dónde deseas colocar el archivo: en el portapapeles, en el sistema de archivos o en el área de trabajo. Normalmente, querrás crear un lugar en el sistema de ficheros. Yo personalmente uso una carpeta parche donde tengo todos los parches que puedo hacer. Además debes tener en cuenta, en la parte inferior de esta pantalla, la lista de archivos que se incluyen en este parche. Si se han incluido archivos que no deseas, puedes anular la selección de ellos aquí. Si te falta algún archivo de esta lista deberás volver a seleccionar tus archivos y agregarlos.


Once you have worked out where you are going to put the patch and that you've selected the right files, click "Next" to continue. If you click "Finish" here your patch will be created incorrect so it is important that you click "Next" here. In this area select "Project" and then click "Finish" to create the patch. Doing this will ensure that your patch file is created properly.
Una vez que has resuelto donde vas a poner el parche y que has seleccionado los archivos correctos, has clic en "Siguiente" para continuar. Si haces clic en "Finalizar" el parche será creado incorrectamente, entonces es importante que aquí hagas clic en "Siguiente". En esta área, selecciona "Proyecto" y a continuación, has clic en "Finalizar" para crear el parche. Hacer esto te asegurará que el archivo del parche se crea correctamente.


= Creating a patch using NetBeans =
= Crear un parche usando NetBeans =
You can use [[S:MyLanguage/NetBeans overview|NetBeans]] IDE to create patch files too. There's a video that explains how to create a patch for Joomla! with SVN: http://www.vimeo.com/11981229.
Puedes utilizar el IDE [[S:MyLanguage/NetBeans overview|NetBeans]] para crear archivos de parche. Hay un video que explica cómo crear un parche para Joomla! con SVN: http://www.vimeo.com/11981229.


= Line endings and encodings =
= Finales de línea y codificaciones =
It is important that with anything you add that you are using the correct line endings. The line ending style for Joomla! is just line feeds or Unix style, and all files should use the UTF-8 encoding. If you are using Eclipse you can change your settings in Window -> Preferences -> General -> Workspace. Select your text file encoding as UTF-8 and your line delimiter as "Unix".
Es importante, con  o que estes usando, añadir los finales de línea correctos. El final de línea de estilo para Joomla! son sólo saltos de línea o estilo Unix y todos los archivos deben utilizar la codificación UTF-8. Si estás usando Eclipse puedes cambiar la configuración en la Ventana -> Preferencias -> General -> espacio de trabajo. Selecciona el archivo de texto con codificación UTF-8 y delimitador de línea como "Unix".


<noinclude>
<noinclude>
[[Category:Bug Squad]]
[[Category:Bug Squad/es]]
[[Category:Core Contributions]]
[[Category:Core Contributions/es]]
</noinclude>
</noinclude>

Latest revision as of 21:20, 26 October 2015

Una parte importante de la creación de un parche para Joomla! es asegurarse que has conseguido crear todo correctamente. Como un estándar todos los parches deben ser creados en la raíz de tu sitio Joomla!. De esta manera, cuando llegamos a probarlo, no necesitamos averiguar en qué directorio debe estar el archivo que se está tratando de cambiar o modificar tu fichero de parche para que funcione correctamente en nuestro sistema local. Esto puede ser un problema, porque si el parche sólo cambia un archivo, puede haber un archivo con ese nombre. Por ejemplo, recientemente hemos recibido un parche para un archivo llamado banner.php. Hay cinco diferentes archivos de Joomla! que se llaman banner.php, así que tenemos que adivinar a que archivo es al que se hace referencia en este caso en particular.

Crear un parche en la línea de comandos

Para los usuarios de Linux/Mac, el uso de la línea de comandos es a menudo la manera más rápida de crear un parche. Dependiendo de cuantos cambios se hayan realizado en tu instalación local podrías tener un par de cambios diferentes. El mejor método para evitar esto es tener una instalación limpia de Joomla! obtenidad desde el SVN y, a continuación, realiza los cambios en este. A continuación, en la raíz del Joomla!, ejecuta el siguiente comando: 

svn diff > file.patch

Necesitas asegurarte que sólo los cambios se han hecho en el archivo y no cualquier otro cambio irrelevante. Si no puedes hacer esto, debes especificar que archivos ha cambiado como parte del parche: 

svn diff libraries/joomla/database/table.php > jtable.patch

Asegúrate que estás en el directorio raíz de Joomla!, no en el directorio de los archivos (podrás ver las carpetas como libraries, administrator, plugins, components, modules, etc).

Crear un parche utilizando Eclipse

Si tienes Subclipse y Eclipse puedes comprobar un nuevo proyecto desde Joomla! SVN (cuya rama/liberación es relevante para el fallo) y, a continuación, utiliza esta opción para crear un archivo del parche. Ten en cuenta que, de forma predeterminada, Eclipse crea parches que incluyen la ruta completa a los archivos, que no es lo que queremos. Suponiendo que has creado un nuevo proyecto mediante el uso de SVN y utilizas la raíz de un sitio Joomla!, deberías ser capaz de crear un parche válido fácilmente.

Para crear un parche, selecciona los archivos que han cambiado y, a continuación, has clic en uno de ellos y selecciona "Equipo > Crear el Parche". La primera pantalla te preguntará dónde deseas colocar el archivo: en el portapapeles, en el sistema de archivos o en el área de trabajo. Normalmente, querrás crear un lugar en el sistema de ficheros. Yo personalmente uso una carpeta parche donde tengo todos los parches que puedo hacer. Además debes tener en cuenta, en la parte inferior de esta pantalla, la lista de archivos que se incluyen en este parche. Si se han incluido archivos que no deseas, puedes anular la selección de ellos aquí. Si te falta algún archivo de esta lista deberás volver a seleccionar tus archivos y agregarlos.

Una vez que has resuelto donde vas a poner el parche y que has seleccionado los archivos correctos, has clic en "Siguiente" para continuar. Si haces clic en "Finalizar" el parche será creado incorrectamente, entonces es importante que aquí hagas clic en "Siguiente". En esta área, selecciona "Proyecto" y a continuación, has clic en "Finalizar" para crear el parche. Hacer esto te asegurará que el archivo del parche se crea correctamente.

Crear un parche usando NetBeans

Puedes utilizar el IDE NetBeans para crear archivos de parche. Hay un video que explica cómo crear un parche para Joomla! con SVN: http://www.vimeo.com/11981229.

Finales de línea y codificaciones

Es importante, con o que estes usando, añadir los finales de línea correctos. El final de línea de estilo para Joomla! son sólo saltos de línea o estilo Unix y todos los archivos deben utilizar la codificación UTF-8. Si estás usando Eclipse puedes cambiar la configuración en la Ventana -> Preferencias -> General -> espacio de trabajo. Selecciona el archivo de texto con codificación UTF-8 y delimitador de línea como "Unix".

Retrieved from "https://docs.sandbox.joomla.org/index.php?title=Creating_a_patch/es&oldid=246715"