Search the Community

¡Vaya! Parece que hay gente deseosa de colaborar directamente con Hercules pero que no sabe cómo. Me parece estupendo. Además, a petición de los administradores, esta guía también tendrá una versión en inglés porque nuestros compañeros anglosajones así lo necesitan. ¿Recuerdan cuando en mi guía de cómo obtener Hercules les comenté que una gran ventaja de usar Git frente a usar Subversion (SVN) es que existe la posibilidad de participar de forma activa en la comunidad enviando pull requests? Pues aquí les traigo una guía detallada para que puedan hacer cuantos pull request quieran sin problema. Ante todo, ¿qué es un pull request? Se trata de un envío de un cambio o mejora de un determinado proyecto a los desarrolladores del mismo, junto a la petición (request) de tal forma que ellos mismos puedan determinar y valorar si es conveniente para el proyecto y "tirar" (pull) de dicho cambio para que aparezca en el repositorio, o simplemente declinar la petición. Git ofrece sus propias herramientas para hacer pull requests (más información), pero no serán estas herramientas las que usaremos (porque tampoco son compatibles), sino las que nos ofrece GitHub, que sirven para algo parecido pero es más visual y puede hacerse también desde cualquier plataforma. ¿Qué pasos hay que realizar para hacer un pull request a Hercules? Pues, a grandes rasgos, son los siguientes: [*]Registrar un usuario en GitHub, si aún no tienes. [*]Hacer un fork (una "bifurcación" en la línea de desarrollo: generalmente se hacen para contribuir al proyecto original o decidir tomarlo como base para un futuro proyecto) de Hercules en GitHub, si aún no la hiciste. [*]Clonar el nuevo repositorio en nuestra máquina, si aún no lo tienes (no sirve trabajar en el repositorio original de HerculesWS). [*]Trabajar en el nuevo repositorio local. [*]"Enviar" (Commit) los cambios a nuestro repositorio local en el fork. [*]"Empujar" (Push) los cambios recién enviados a nuestro repositorio remoto en GitHub. [*]Hacer el propio pull request al repositorio original de Hercules, desde la web de GitHub. Los pasos 3 y 5 se han visto en mi anterior guía sobre la obtención de Hercules (el paso 5 en la sección Preguntas Frecuentes), y el resto de pasos son suficientemente sencillos aunque se detallará exhaustivamente su realización. Se juntarán algunos apartados de la guía bajo un mismo epígrafe (3, 4, 5 y 6) para trabajar más cómodamente. GitHub también provee sus propias guías paso a paso (en inglés) para casos generales sobre cómo hacer un fork y posteriormente hacer un pull request, aunque en la presente guía nos centraremos en hacer todo paso a paso para poder hacer pull requests a Hercules. Para esta guía se usará la interfaz de TortoiseGit en inglés. Ya comenté en mi anterior guía lo poco adecuada que era la traducción de la interfaz al español, y además podré reutilizar las imágenes para la traducción de la presente guía al idioma anglosajón. Bueno, comencemos ya con la propia guía. He decidido cubrir con spoilers cada paso de la guía, dado que además de su explicación vienen con sus buenas imágenes informativas. Paso 1: Registrar un usuario en GitHub Paso 2: Hacer un fork de Hercules Pasos 3 a 6: Trabajo en la máquina local Paso 7: Hacer (por fin) el pull request Y ya está. No es tan complicado todo, ¿verdad? Esta pregunta parece irónica, pero es un proceso realmente simple. Una vez hayas hecho un par de pull requests verás que es un proceso increíblemente simple.

Hola a todos. En esta ocasión os traigo una guía sobre cómo obtener el emulador Hercules. Dado que en Hercules el repositorio del código fuente (es decir, el Sistema de Control de Versiones) no es Subversion como ha sido "normal" en emuladores de Ragnarok Online hasta ahora sino que es Git, por lo que la forma de obtenerlo varía sensiblemente. No obstante, varias de las virtudes de tener un repositorio en Git es que admite soporte básico de Subversion, entre otros la descarga y actualización del código fuente desde clientes de Subversion como TortoiseSVN (no mucho más) o que facilita mucho la colaboración de gente externa ya que permite a gente externa al Staff de la aplicación hacer Pull Requests (enviar código y solicitar su inclusión en el proyecto sin tener que hacer ningún trámite extra, pero este procedimiento no está previsto en la guía). También una gran desventaja (en comodidad más que nada) es que las revisiones dejan de ser identificadas por un número para ser identificadas por el hash SHA-1 de la propia revisión al completo. Bueno, acabemos ya con esta introducción y vayamos al grano, que es lo que nos interesa al fin y al cabo: ¿cómo obtener Hercules? Pero no cómo obtenerlo a través de otra persona, sino cómo obtenerlo de primera mano. Pues es muy fácil: podemos obtenerlo de cualquiera de las siguientes formas: [*]En un archivo comprimido en zip a través del repositorio del proyecto en Github; [*]A través de algún cliente de subversion, tanto desde Windows (por ejemplo TortoiseSVN) como desde Linux; [*]A través de algún cliente Git, tanto desde Windows (como por ejemplo TortoiseGit) como desde Linux; [*]Otras formas que no se detallarán en esta guía como SSH. Obtener Hercules en un archivo zip desde la web Obtener Hercules a través de un cliente Subversion Obtener Hercules a través de un cliente Git ¡Y ya está! Ya tienes tu copia de Hercules en tu máquina local. ¿Qué se te apetece hacer ahora? ¿Compilarlo y ponerlo en servicio? ¿Hacer algún Pull Request y contribuir a la comunidad? En esto, ¡tú tienes ahora el poder!