Line 1:
Line 1:
+
<!-- BEGIN interlang links -->
+
<!-- Do NOT edit this section
+
Links below are automatically managed by PolyglotBot
+
You can edit links on the English source page : Developer_FAQ -->
+
[[en:Developer_FAQ]]
+
[[fr:FAQ_Développeur]]
+
[[de:Entwickler_FAQ]]
+
[[zh:开发者常见问题解答]]
+
<!-- END interlang links -->
+
[[Category:FAQ ES]]
[[Category:FAQ ES]]
{{TemplateDocDesarrollo}}
{{TemplateDocDesarrollo}}
Line 5:
Line 15:
= Cómo convertirse en desarrollador oficial =
= Cómo convertirse en desarrollador oficial =
−
En la galaxia del proyecto Dolibarr, hay varias partes interesadas distribuidas en diferentes niveles o grados. El número de desarrolladores y las contribuciones son importantes y, cualquier proyecto que desee tener cierto nivel de calidad, debe de estar bajo una gestión controlada y de unas modificaciones validadas para su evolución, tanto en las necesidades funcionales como en su código. Por esta razón, el acceso en escritura a los fuentes (Servidor CVS) está limitado y regido por una organización que se describe en las líneas siguientes. Cada desarrollador tiene un '''grado''' que depende de su antigüedad y de sus contribuciones. El nivel de autorización de una persona en el proyecto aumenta con las etapas de promoción de grado.
+
En la galaxia del proyecto Dolibarr, hay varias partes interesadas distribuidas en diferentes niveles o grados. El número de desarrolladores y las contribuciones son importantes y, cualquier proyecto que desee tener cierto nivel de calidad, debe de estar bajo una gestión controlada y de unas modificaciones validadas para su evolución, tanto en las necesidades funcionales como en su código. Por esta razón, el acceso en escritura a los fuentes (Servidor GIT) está limitado y regido por una organización que se describe en las líneas siguientes. Cada desarrollador tiene un '''grado''' que depende de su antigüedad y de sus contribuciones. El nivel de autorización de una persona en el proyecto aumenta con las etapas de promoción de grado.
−
El curso de un desarrollador Dolibarr pasa a través de estas etapas, que hemos clasificado como un título familiar para los adeptos a la ciencia ficción. Estas son las etapas. Es importante comprender que esta organización tiene el único propósito de mejorar la calidad de Dolibarr y que es necesario que se respete estrictamente a fin de lograrlo. Así que no se ofenda si, como desarrollador, no dispone de un acceso CVS en escritura, antes de un cierto plazo.
+
El curso de un desarrollador Dolibarr pasa a través de estas etapas, que hemos clasificado como un título familiar para los adeptos a la ciencia ficción. Estas son las etapas. Es importante comprender que esta organización tiene el único propósito de mejorar la calidad de Dolibarr y que es necesario que se respete estrictamente a fin de lograrlo. Así que no se ofenda si, como desarrollador, no dispone de un acceso GIT en escritura, antes de un cierto plazo.
<span id="Soldado">'''* Soldado'''</span>
<span id="Soldado">'''* Soldado'''</span>
Line 14:
Line 24:
Leyendo toda la [[Documentación Desarrolladores]], demostrará tener voluntad suficiente para convertirse automáticamente en '''Soldado''' de la alianza Dolibarr (Su grado será un nivel de '''Soldado'''). La mayoría de los desarrolladores interesados en el desarrollo de Dolibarr se clasifican en esta categoría.
Leyendo toda la [[Documentación Desarrolladores]], demostrará tener voluntad suficiente para convertirse automáticamente en '''Soldado''' de la alianza Dolibarr (Su grado será un nivel de '''Soldado'''). La mayoría de los desarrolladores interesados en el desarrollo de Dolibarr se clasifican en esta categoría.
−
−
Este grado se obtiene sin validación superior. Es un grado de inicio.
−
−
Dada la naturaleza de este grado, no es posible establecer una lista de todos los interesados en el proyecto Dolibarr con este grado (lista en contínua evolución y muy larga).
−
−
<span id="Cazador">'''* Cazador'''</span>
El grado siguiente consiste en enviar parches, empezando por los simples, a la Lista de Correo de desarrollo (ver [[FAQ_Desarrolladores#Enviar un parche, mejora o participar en el desarrollo |FAQ Desarrolladores]] para el procedimiento), preferiblemente al foro (Lista de Correo preferida).
El grado siguiente consiste en enviar parches, empezando por los simples, a la Lista de Correo de desarrollo (ver [[FAQ_Desarrolladores#Enviar un parche, mejora o participar en el desarrollo |FAQ Desarrolladores]] para el procedimiento), preferiblemente al foro (Lista de Correo preferida).
−
Puede encontrar las tareas en espera de parche en el gestor de tareas a realizar: http://savannah.nongnu.org/task/?group=dolibarr
+
Puede encontrar las tareas en espera de parche en el gestor de tareas a realizar: {{TemplateURLTasks}}
Las tareas disponibles son las tareas que tienen la propiedad "Task opened to external developers" a "si". Si el valor es "no", olvídela, ya que será tratada por un desarrollador de grado Jedi.
Las tareas disponibles son las tareas que tienen la propiedad "Task opened to external developers" a "si". Si el valor es "no", olvídela, ya que será tratada por un desarrollador de grado Jedi.
−
En su primer envío aceptado (incluido en el CVS por un almirante, Jedi o Yoda), automáticamente entrará en la familia de '''Cazadores''' de la alizanda Dolibarr.
+
El número de soldado no está limitado. Además, cuantos más tengamos, más fuertes seremos.
−
+
Los soldados son la principal fuerza de la alianza Dolibarr.
−
El número de cazadores no está limitado. Además, cuantos más tengamos, más fuertes seremos.
−
Los cazadores son la principal fuerza de la alianza Dolibarr.
−
Una lista de los colaboradores de Dolibarr con este grado se encuentra disponible en la página [[:Category:Chasseur]]
+
Dada la naturaleza de este grado, no es posible establecer una lista de todos los interesados en el proyecto Dolibarr con este grado (lista en continua evolución y muy larga).
<span id="Z-6PO">'''* Z-6PO'''</span>
<span id="Z-6PO">'''* Z-6PO'''</span>
−
Si habla correctamente un idioma que no está presente o está mal traducido en Dolibarr, un '''Jedi''' o '''Yoda''' le dará a su login de Savannah los derechos de escritura en los fuentes CVS del proyecto.
+
Si habla correctamente un idioma que no está presente o está mal traducido en Dolibarr y conoce GIT, use el sistema de push para publicar sus correcciones y ajustes.
−
+
El equipo seguramente le añadirá a la página oficial de traductores ([[:Category:Z-6PO]]) después de varios push
−
Dirígase al sitio http://savannah.nongnu.org para crear una cuenta y pedir la inclusión al proyecto como Z-6PO para su idioma.
−
Vea [[FAQ_Desarrolladores#Recuperar.2Factualizar_una_versi.C3.B3n_CVS_de_desarrollo|Recuperar/actualizar una versión CVS de desarrollo]] para saber como usar el servidor CVS que contiene los fuentes de los archivos de idiomas a actualizar. Este derecho de escritura en los fuentes solamente puede ser usado con la condición de limitarse únicamente al objetivo de realizar traducciones. Este grado puede obtenerse con rapidez.
+
Si no conoce el sistema GIT, envíe sus correcciones sobre la última versión por e-mail a la lista de correo '''dolibarr-dev''' (Inscripción desde la página {{TemplateURLMLDev}}). Sin embargo, es preferible la primera solución basada en los push de GIT.
−
−
Una lista de los colaboradores de Dolibarr con este grado se encuentra disponible en la página [[:Category:Z-6PO]]
<span id="Almirante">'''* Almirante'''</span>
<span id="Almirante">'''* Almirante'''</span>
−
Sólamente después de un tiempo variable (que puede ser muy largo) en la categoría de Cazador, y si la calidad de los parches envíados son satisfactorios, un Yoda le ofrecerá acceso directo a CVS. Se habrá convertido en un '''Almirante''' de la alianza Dolibarr.
+
Sólamente después de un tiempo variable (que puede ser muy largo) en la categoría de Cazador, y si la calidad de los parches envíados son satisfactorios, un Yoda le ofrecerá acceso directo a GIT. Se habrá convertido en un '''Almirante''' de la alianza Dolibarr.
−
Este título no se pide, se obtiene por decisión o proposición de un '''Jedi''' ó '''Yoda''' que ha estimado que ha enviado suficientes parches como para ser un '''Almirante''' serio. El acceso a CVS de un '''Almirante''' debe de ser utilizado para confirmar traducciones, correcciones de bugs declarados en Savannah (BUG Tracker http://savannah.nongnu.org/bugs/?group=dolibarr)
+
Este título no se pide, se obtiene por decisión o proposición de un '''Jedi''' ó '''Yoda''' que ha estimado que ha enviado suficientes parches como para ser un '''Almirante''' serio. El acceso a GIT de un '''Almirante''' debe de ser utilizado para confirmar traducciones, correcciones de bugs declarados (BUG Tracker {{TemplateURLBugs}})
−
o en el foro (tanto correcciones personales como parches enviados por un '''Cazador'''). Toda confirmación CVS debe incluir obligatoriamente en la descripción (el campo log de la confirmación), el número de bug de Savannah corregido o el título del mensaje del foro que indica el problema. Sólo una traducción escapa a esta limitación (no hay restricciones para las traducciones). El incumplimiento de esta limitación, puede dar lugar a la degradación a la categoría de '''Cazador'''. Para el envío de nuevas funcionalidades, debe seguir obligatoriamente los principios indicados acerca de los parches enviados a la Lista de Correo (Mailing List).
+
o en el foro (tanto correcciones personales como parches enviados por un '''Cazador'''). Toda confirmación GIT debe incluir obligatoriamente en la descripción (el campo log de la confirmación), el número de bug de corregido o el título del mensaje del foro que indica el problema. Sólo una traducción escapa a esta limitación (no hay restricciones para las traducciones). El incumplimiento de esta limitación, puede dar lugar a la degradación a la categoría de '''Soldado'''.
−
la obtención del grado de Almirante es rara porque está limitada. La calidad de Dolibarr sólamente puede ser mantenida con un número de Almirantes controlado, ello no implica el tener un número de desarrolladores (Cazadores) importante (gracias al sistema de parches)
+
la obtención del grado de Almirante es rara porque está limitada. La calidad de Dolibarr solamente puede ser mantenida con un número de Almirantes controlado, ello no implica el tener un número de desarrolladores (Cazadores) importante (gracias al sistema de parches)
Una lista de los colaboradores de Dolibarr con este grado se encuentra disponible en la página [[:Category:Admiral]]
Una lista de los colaboradores de Dolibarr con este grado se encuentra disponible en la página [[:Category:Admiral]]
Line 61:
Line 60:
Ese título no se pide, se obtiene de otro Jedi o de un Yoda.
Ese título no se pide, se obtiene de otro Jedi o de un Yoda.
−
Este privilegio, sin embargo, es excepcional. La calidad de Dolibarr sólamente puede ser mantenida con un número de Jedis controlado, ello no implica el tener un número de desarrolladores (Cazadores) importante (gracias al sistema de parches)
+
Este privilegio, sin embargo, es excepcional. La calidad de Dolibarr solamente puede ser mantenida con un número de Jedis controlado, ello no implica el tener un número de desarrolladores (Cazadores) importante (gracias al sistema de parches)
Una lista de los colaboradores de Dolibarr con este grado se encuentra disponible en la página [[:Category:Jedi]]
Una lista de los colaboradores de Dolibarr con este grado se encuentra disponible en la página [[:Category:Jedi]]
Line 83:
Line 82:
También puede consular los siguientes FAQ.
También puede consular los siguientes FAQ.
−
= Recuperar/actualizar una versión CVS de desarrollo =
+
= Recuperar/actualizar una versión de desarrollo =
−
===Recuperación de la última versión de los fuentes con acceso CVS anónimo===
+
Ve la pagina [[Recuperar, actualizar GIT fuentes del proyecto]].
−
Sin cuenta Savannah o sin autorización de acceso CVS en escritura, puede utilizar un cliente CVS (como pueda ser [http://www.wincvs.org WinCVS] o [http://www.tortoisecvs.org TortoiseCVS] en windows, el cliente CVS de Eclipse o la línea de comandos CVS en Linux) para recuperar los fuentes del proyecto.
−
−
El comando que permite recuperar la totalidad de los archivos de un directorio es:
−
<source lang="bash">
−
CVSROOT=:pserver:anonymous@cvs.savannah.nongnu.org:/cvsroot/dolibarr
−
export CVSROOT
−
cvs -q checkout -r HEAD dolibarr
−
</source>
−
HEAD significa que queremos la última versión en curso de desarrollo.
−
−
===Recuperación de la última versión de los fuentes con acceso CVS completo===
−
Otro método para recuperar la versión CVS es el uso de las utilidades CVS. Debe de tener una cuenta Savannah con acceso CVS en escritura (Tiene que indicar su llave pública en la página https://savannah.gnu.org/my/admin/editsshkeys.php) y un cliente CVS (comandos CVS bajo Linux, WinCVS o TortoiseCVS bajo Windows, o el cliente CVS en Eclipse...).
−
−
El comando que permite recuperar la totalidad de los archivos de un directorio es:
−
<source lang="bash">
−
CVSROOT=:ext:yoursavannahlogin@cvs.savannah.nongnu.org:/cvsroot/dolibarr
−
export CVSROOT
−
cvs -q checkout -r HEAD dolibarr
−
</source>
−
HEAD significa que queremos la última versión en curso de desarrollo.
−
−
===Recuperar los módulos complementarios===
−
−
Se encuentra disponible un segundo repositorio CVS para los módulos no oficiales o especiíficos, se encuentra disponible en el módulo CVS dolibarrmod
−
<source lang="bash">
−
CVSROOT=:ext:yoursavannahlogin@cvs.savannah.nongnu.org:/cvsroot/dolibarr
−
export CVSROOT
−
cvs -q checkout -r HEAD dolibarrmod
−
</source>
−
−
===Usar Eclipse para recuperar la versión CVS CVS===
−
El proceso se detalla en la página
−
[[Herramientas_de_Desarrollo#Configurar_Eclipse_para_recuperar_la_versi.C3.B3n_CVS|Configurar Eclipse para recuerar la versión CVS]]
−
−
===Actualizar su repositorio CVS===
−
El comando que permite actualizar localmente una copia de trabajo CVS (repositorio), que ya ha sido tratada por un checkout CVS, es la siguiente:
−
−
''Bajo linux:''
−
<source lang="bash">
−
cvs -q update -P -d
−
</source>
−
''Bajo Windows con Tortoise cvs''
−
<source lang="bash">
−
"C:\Program Files\CVSNT\cvs.exe" -q update -P -d
−
</source>
−
Y para actualizar su copia local anulando las modificaciones realizadas en sus fuentes locales, añadir la opción -C:
−
−
''Bajo linux:''
−
<source lang="bash">
−
cvs -q update -P -C -d
−
</source>
−
''Bajo Windows con Tortoise cvs''
−
<source lang="bash">
−
"C:\Program Files\CVSNT\cvs.exe" -q update -P -C -d
−
</source>
−
Si es necesario, cambie los permisoss de propiedad en los directorios, para que el servidor tenga acceso.
−
−
===Recuperación de otra rama por CVS===
−
−
Si desea obtener una versión particular (con sus parches), deberá seguir el mismo proceso, reemplazando HEAD por el nombre de la rama.
−
Por ejemplo DOLIBARR_2_2_BRANCH para obtener la rama 2.2 o DOLIBARR_2_4_BRANCH para la rama 2.4.
−
−
===Recuperación de la última version de los fuentes mediante descarga===
−
Este método le permite recuperar el snapshot diario de la versión CVS del desarrollo principal (llamado HEAD) sin utilizar un software cliente CVS. La operación consiste en descargar la última versión de los archivos de Dolibarr que se montan todas las noches en un zip.
−
Para ello, vaya a la página [http://www.dolibarr.org/downloads/cat_view/64-development-version versión CVS del día].
−
−
Los nuevos archivos remplazarán a los antiguros.
−
−
El inconveniente de este método consiste en que deberá descargar todo cada vez para actualizarse.
−
−
===Actualización de la base de datos===
−
Si acaba de realizar una actualización, el próximo paso consiste en migrar la base de datos para coordinarla con los nuevos fuentes. Para ello, simplemente vaya a
−
http://midolibarr/install/
−
y escoja la opción "Actualizar".
−
−
Este proceso de migración/actualización está diseñado para funcionar independientemente del estado de inicio y puede ser realizado varias veces sin riesgo.
= Cómo crear un nuevo Tema =
= Cómo crear un nuevo Tema =
Para ello consulte la página [[Temas]]
Para ello consulte la página [[Temas]]
−
−
= Cómo desarrollar mi própio sistema de menús =
−
Para ello consulte la página [[Sistema de menús]]
= Cómo desarrollar mi propio módulo =
= Cómo desarrollar mi propio módulo =
Line 198:
Line 118:
Convertirse en desarrollador oficial]]. Si su parche ya está listo y desea distribuirlo, este capítulo es el indicado.
Convertirse en desarrollador oficial]]. Si su parche ya está listo y desea distribuirlo, este capítulo es el indicado.
−
== Con acceso CVS en modo escritura ==
+
== Con acceso GIT ==
−
A día de hoy, los accesos en escritura a CVS están restringidas (el número de confirmaciones és bastante dinámico). Si usted posee en la actualidad de un acceso en escritura CVS, utilícelo con la condición de que sus confirmaciones corresponden a su grado de desarrollador Dolibarr (Ver [[FAQ_Desarrolladores#Cómo convertirse en desarrollador oficial|FAQ Desarrolladores -
+
A día de hoy, los accesos en escritura a GIT están restringidas (el número de confirmaciones és bastante dinámico). Si usted posee en la actualidad de un acceso en escritura GIT, utilícelo con la condición de que sus confirmaciones corresponden a su grado de desarrollador Dolibarr (Ver [[FAQ_Desarrolladores#Cómo convertirse en desarrollador oficial|FAQ Desarrolladores -
Convertirse en desarrollador oficial]] para los diferentes grados).
Convertirse en desarrollador oficial]] para los diferentes grados).
−
Si no dispone de acceso a CVS (usted está en el grado de miembro o cazador de la alianza Dolibarr), deberá seguir el procedimento que sigue a continuación..
+
Si no dispone de acceso a GIT (usted está en el grado de miembro o cazador de la alianza Dolibarr), deberá seguir el procedimento que sigue a continuación..
−
== Sin acceso CVS en escritura ==
+
== Sin acceso GIT ==
−
Sin acceso CVS en escritura (sin cuenta desarrollador savannah), será necesario generar y enviar un parche a la Lista de Correo (Mailing List dolibarr-dev https://savannah.nongnu.org/mail/?group=dolibarr). A continuación le explicamos como generar un parche:
+
Sin acceso GIT en escritura, será necesario generar y enviar un parche a la Lista de Correo (Mailing List dolibarr-dev {{TemplateURLMLDev}}). A continuación le explicamos como generar un parche:
''En todos los SO'': [[Image:Logo_windows.png|20px]] [[Image:Logo_ubuntu.png|20px]] [[Image:Logo_apple.png|20px]]
''En todos los SO'': [[Image:Logo_windows.png|20px]] [[Image:Logo_ubuntu.png|20px]] [[Image:Logo_apple.png|20px]]
Line 210:
Line 130:
He aquí el ''método Pro'' de como trabajar para poder generar un fichero patch:
He aquí el ''método Pro'' de como trabajar para poder generar un fichero patch:
−
- Tener un directorio con la versión de referencia Dolibarr (resultante de la actualización desde CVS o bien el resultante de la descompresión de un snapshot tgz de Dolibarr). Llamaremos a este directorio '''viejo_rep'''. Puede recuperar el snapshot de la versión de desarrollo en curso en [http://www.dolibarr.org/component/option,com_docman/task,cat_view/gid,50/Itemid,36/lang,en/ web ofical de Dolibarr].
+
- Tener un directorio con la versión de referencia Dolibarr (resultante de la actualización desde GIT o bien el resultante de la descompresión de un snapshot tgz de Dolibarr). Llamaremos a este directorio '''viejo_rep'''. Puede recuperar el snapshot de la versión de desarrollo en curso en [https://www.dolibarr.org/downloads/ web ofical de Dolibarr].
- Tener otro directorio que contiene Dolibarr pero en la que realiza o ha realizado sus modificaciones. Llamará a este directorio '''nuevo_rep'''.
- Tener otro directorio que contiene Dolibarr pero en la que realiza o ha realizado sus modificaciones. Llamará a este directorio '''nuevo_rep'''.
−
para generar el fichero patch, deberá ejecutar el comando '''diff''' (estándard de Linux, en windows [http://www.cygwin.org/cygwin cygwin]) de la siguiente manera:
+
para generar el fichero patch, deberá ejecutar el comando '''diff''' (estándard de Linux, en windows [https://www.cygwin.org/cygwin cygwin]) de la siguiente manera:
<source lang="bash">
<source lang="bash">
diff -BNaur --exclude=CVS --exclude="*.patch" --exclude=".#*" --exclude="*~" --exclude="*.rej"
diff -BNaur --exclude=CVS --exclude="*.patch" --exclude=".#*" --exclude="*~" --exclude="*.rej"
Line 229:
Line 149:
Repetir el proceso para cada fichero modificado.
Repetir el proceso para cada fichero modificado.
Finalmente, obtendremos un bonito fichero que contiene todas las modificaciones en el formato correcto.
Finalmente, obtendremos un bonito fichero que contiene todas las modificaciones en el formato correcto.
−
−
En lugar de buscar manualmente los archivos, si ha instalado conjuntamente TortoiseCVS y WinMerge, puede disponer de su versión modificada en el equipo, y la versión CVS en línea. En el explorador de Windows, haga clic derecho en el archivo que debe ser parchado, y seleccione "CVS comparar" (no WinMerge, que se encuentra unas pocas líneas más abajo). Tortoise pondrá en marcha WinMerge. Luego repita el procedimiento descrito anteriormente.
''Testear/Aplicar un patch''
''Testear/Aplicar un patch''
Line 245:
Line 163:
''Enviar un patch por mail''
''Enviar un patch por mail''
−
Una vez el archivo del parche se ha creado y testeado correctamente, debe enviar el archivo a la lista de correo '''dolibarr-dev''' (Mire aquí para ello https://savannah.nongnu.org/mail/?group=dolibarr).
+
Una vez el archivo del parche se ha creado y testeado correctamente, debe enviar el archivo a la lista de correo '''dolibarr-dev''' (Mire aquí para ello {{TemplateURLMLDev}}).
Esta lista de correo es leída por la mayoría de los desarrolladores de Dolibarr, sin embargo no podemos decir si el parche será procesado ni si se incluirá. Depende de la calidad del parche y las prioridades del momento.
Esta lista de correo es leída por la mayoría de los desarrolladores de Dolibarr, sin embargo no podemos decir si el parche será procesado ni si se incluirá. Depende de la calidad del parche y las prioridades del momento.
Line 251:
Line 169:
= Cómo empaquetar/liberar un módulo =
= Cómo empaquetar/liberar un módulo =
Para ello consulte la página [[Desarrollo_de_un_módulo#Crear_un_paquete_para_liberar_e_instalar_tu_m.C3.B3dulo|Crear un paquete para liberar e instalar su módulo ]]
Para ello consulte la página [[Desarrollo_de_un_módulo#Crear_un_paquete_para_liberar_e_instalar_tu_m.C3.B3dulo|Crear un paquete para liberar e instalar su módulo ]]
+
El proceso es igualmente válido para generar un fichero para www.dolistore.com.
El proceso es igualmente válido para generar un fichero para www.dolistore.com.