diff options
Diffstat (limited to 'docs/es')
| -rw-r--r-- | docs/es/contribute.md | 20 | ||||
| -rw-r--r-- | docs/es/documentation-index.md | 24 | ||||
| -rw-r--r-- | docs/es/exitcodes.md | 43 | ||||
| -rw-r--r-- | docs/es/file-headers.md | 25 | ||||
| -rw-r--r-- | docs/es/getting-started.md | 200 | ||||
| -rw-r--r-- | docs/es/how-to-create-a-db-pr.md | 127 | ||||
| -rw-r--r-- | docs/es/how-to-use-gperftool.md | 27 | ||||
| -rw-r--r-- | docs/es/windows-requirements.md | 43 |
8 files changed, 457 insertions, 52 deletions
diff --git a/docs/es/contribute.md b/docs/es/contribute.md index 130dfd7..a90006f 100644 --- a/docs/es/contribute.md +++ b/docs/es/contribute.md @@ -1,18 +1,23 @@ -# Contribuir +--- +redirect_from: "/Contribute" +--- + +# Contribuir Puedes contribuir de varias formas a AzerothCore: -- [comentando un problema abierto](Contribute#how-to-comment-an-issue) +- [Comentando un problema abierto](Contribute#how-to-comment-an-issue) + +- [Abriendo un problema](Contribute#how-to-open-an-issue) -- [abriendo un problema](Contribute#how-to-open-an-issue) +- [Prueba de una solicitud de extracción](How-to-test-a-PR) -- [prueba de una solicitud de extracción](How-to-test-a-PR) +- [Prueba de cambios solo de base de datos](How-to-test-DB-only-changes) -- [prueba de cambios solo de base de datos](How-to-test-DB-only-changes) +- [Creando una solicitud de extracción](Contribute#how-to-create-a-pull-request) -- [creando una solicitud de extracción](Contribute#how-to-create-a-pull-request) +- [Mejorando nuestra wiki](Contribute#improve-the-wiki) -- [mejorando nuestra wiki](Contribute#improve-the-wiki) ## Información general Para contribuir, obviamente necesitas una cuenta de github. @@ -44,6 +49,7 @@ Si **(y solo si)** el error aún no se ha informado, puede [abrir un problema](h ## Cómo crear una solicitud de extracción - Lea [Cómo crear un PR](How-to-create-a-PR). +- Alternativamente, también puede consultar [este tutorial más simple](How-to-create-a-DB-PR) sobre cómo abrir PR que contienen código SQL a través de GitHub. ### Dando crédito al autor del código diff --git a/docs/es/documentation-index.md b/docs/es/documentation-index.md index 53308da..1bdef0a 100644 --- a/docs/es/documentation-index.md +++ b/docs/es/documentation-index.md @@ -15,6 +15,12 @@ redirect_from: /documentation_index * [Errores comunes](common-errors) * [Procedimiento Operativo Estándar (SOP)](standard-operating-procedure) +## Base de Datos + +* [Base de datos: auth](database-auth.md) +* [Base de datos: characters](database-characters.md) +* [Base de datos: world](database-world.md) + ## Documentación * [Sistema Bash ](bash_system.md) @@ -34,11 +40,13 @@ redirect_from: /documentation_index * [Directorio SQL](sql-directory.md) * [Versionado de SQL](sql-versioning.md) -## Base de Datos +## Modelos y técnicas -* [Base de datos: auth](database-auth.md) -* [Base de datos: characters](database-characters.md) -* [Base de datos: world](database-world.md) +* [Herramientas útiles](useful-tools.md) +* [Cómo importar información de DBC hacia SQL](how-to-import-dbc-data-in-db.md) +* [Iniciar Worldserver y Authserver en Visual Studio](run-worldserver-and-authserver-in-visual-studio.md) +* [Snippets de SQL útiles](useful-sql.md) +* [Cómo usar gperftool para analizar tu aplicación](how-to-use-gperftool.md) ## AzerothCore extendido @@ -47,15 +55,7 @@ redirect_from: /documentation_index * [Hooks Cmake](hooks-cmake.md) * [Hooks C++](hooks-script.md) -## Modelos y técnicas - -* [Cómo importar información de DBC hacia SQL](how-to-import-dbc-data-in-db.md) -* [Iniciar Worldserver y Authserver en Visual Studio](run-worldserver-and-authserver-in-visual-studio.md) -* [Snippets de SQL útiles](useful-sql.md) -* [Cómo usar gperftool para analizar tu aplicación](how-to-use-gperftool.md) - ## Recursos externos * <a href="https://github.com/azerothcore/azerothcore-wotlk/discussions/categories/guides-tips" target="_blank">GuÃas y consejos de nuestro foro</a> * <a href="https://wowdev.wiki/Category:DBC_WotLK" target="_blank">Documentación de DBC</a> - diff --git a/docs/es/exitcodes.md b/docs/es/exitcodes.md new file mode 100644 index 0000000..e6bef35 --- /dev/null +++ b/docs/es/exitcodes.md @@ -0,0 +1,43 @@ +# Códigos de salida + +AzerothCore tiene 3 códigos de salida predeterminados que se activan si apaga, reinicia o bloquea el servidor. + +```cpp +enum ShutdownExitCode +{ + SHUTDOWN_EXIT_CODE = 0, + ERROR_EXIT_CODE = 1, + RESTART_EXIT_CODE = 2, +}; +``` + +SHUTDOWN_EXIT_CODE se llama cuando usa los comandos **.server shutdown**, **.server idleshutdown**, **.server exit** o si [m_serviceStatus == 0](https://github.com/azerothcore /azerothcore-wotlk/blob/a594bf5b290e5476c61bab29809a079e93c5daa2/src/server/worldserver/Main.cpp#L575-L581) para Windows. + +RESTART_EXIT_CODE se llama cuando usa los comandos **.server restart** y **.server idlerestart**. + +ERROR_EXIT_CODE se llama a cuando el servidor falla. Esto puede deberse a un desbordamiento de guid/id/entry, [Network.Threads](https://github.com/azerothcore/azerothcore-wotlk/blob/a594bf5b290e5476c61bab29809a079e93c5daa2/src/server/worldserver/worldserver.conf.dist# L2909-L2913) siendo <= 0 o si el servidor no puede inicializar la red. + +La mejor manera de saber dónde se llaman todos los códigos de salida es buscándolos en el código fuente. + +## Comandos + +``` +.server idleshutdown #delay [#exit_code] +.server idlerestart #delay [#exit_code] +.server shutdown #delay [#exit_code] +.server restart #delay [#exit_code] +``` + +Los comandos **.server shutdown/restart**, **.server idleshutdown/restart** tienen un argumento para **[#exit_code]**. + +El código de salida predeterminado para apagar siempre es 0 y el código de salida predeterminado para reiniciar siempre es 2 si el argumento se deja en blanco. + +El argumento puede tomar un valor entre 0 y 125, lo que le permite generar un código de salida personalizado que no sea el predeterminado. + +## Scripts que incluyen códigos de salida + +Hacer que Worldserver envíe códigos de salida le permite crear un script externo que puede actuar cuando lee un código de salida específico que se muestra. + +Por ejemplo, es posible escribir un script para que se reinicie automáticamente si Worldserver envía RESTART_EXIT_CODE. + +Puede ver [este](https://github.com/azerothcore/azerothcore-exitcode-script) script por lotes para Windows sobre cómo se pueden usar los códigos de salida. diff --git a/docs/es/file-headers.md b/docs/es/file-headers.md index 2478693..a8d8980 100644 --- a/docs/es/file-headers.md +++ b/docs/es/file-headers.md @@ -2,22 +2,27 @@ Para limpiar los archivos, usamos un formato estándar para los nuevos encabezados de archivos. -XXXX = año de inicio -YYYY = año activo - **Código independiente de AzerothCore (sin código anterior de nadie):** ```cpp /* - * Copyright (C) 2016+ AzerothCore <www.azerothcore.org>, released under GNU AGPL v3 license, you may redistribute it and/or modify it under version 3 of the License, or (at your option), any later version. + * This file is part of the AzerothCore Project. See AUTHORS file for Copyright information + * + * This program is free software; you can redistribute it and/or modify it + * under the terms of the GNU Affero General Public License as published by the + * Free Software Foundation; either version 3 of the License, or (at your + * option) any later version. + * + * This program is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for + * more details. + * + * You should have received a copy of the GNU General Public License along + * with this program. If not, see <http://www.gnu.org/licenses/>. */ ``` **Con código anterior de fuentes externas o desarrolladores:** -```cpp -/* - * Copyright (C) 2016+ AzerothCore <www.azerothcore.org>, released under GNU GPL v3 license, you may redistribute it and/or modify it under version 3 of the License, or (at your option), any later version. - * Copyright (C) XXXX-YYYY external-teamname <url> - */ -``` +Asegúrese de que el autor original esté presente en el archivo [AUTHORS](https://github.com/azerothcore/azerothcore-wotlk/blob/master/AUTHORS), de lo contrario, ese autor debe agregarse aquÃ. Si el código proviene de otra organización, solo debe asegurarse de que el nombre de la organización exista. diff --git a/docs/es/getting-started.md b/docs/es/getting-started.md new file mode 100644 index 0000000..1e126de --- /dev/null +++ b/docs/es/getting-started.md @@ -0,0 +1,200 @@ +# Primeros pasos con AzerothCore + +## Introducción + +¿Le gustaría aprender sobre AzerothCore (AC), configurar su servidor de WoW por primera vez, entender cómo modificarlo y poder contribuir? ¡Usted vino al lugar correcto! + +Comenzar con la emulación de WoW puede ser complicado al principio, pero no se preocupe, estaremos allí para ayudarlo en caso de que tenga algún problema o tenga alguna pregunta que hacer. Solo lea [esta página](https://www.azerothcore.org/wiki/How-to-ask-for-help) antes de pedir ayuda. + +Si mientras lees alguno de los tutoriales enlazados en esta página encuentras algo que no te queda claro: háznoslo saber. Haremos todo lo posible para reformularlo y hacerlo más fácil de entender para los principiantes. ¡Mejorar los documentos también es una forma de contribuir! + + + + +## Requisitos de conocimientos + +Esto **NO** reqiere requisitos técnicos. Solo necesitas ser paciente y estar dispuesto a aprender. + +Si ya tienes algunos conocimientos de programación seguro que sería una ventaja para ti. Sin embargo, créame, no necesita ningún conocimiento previo para aprender sobre los servidores de WoW. + +*Nota personal del autor de este tutorial: cuando instalé por primera vez mi primer servidor de WoW tenía 15 años, no tenía ningún conocimiento de programación, usaba Windows XP y apenas entendía inglés. Estoy seguro de que si está leyendo esto, ya tiene más habilidades que las que tenía cuando intentaba instalar MaNGOS+UDB+ScriptDev2 y obtener un servidor WoW decente para ejecutarlo en mi máquina local. +Inicialmente, pasé horas tratando de leer y comprender los tutoriales de diferentes personas escritos en diferentes sitios web, pero finalmente lo logré. AzerothCore es un proyecto todo en uno, por lo que va a ser más fácil que eso, ¡tenga paciencia conmigo y lo logrará!* + +¿Tentado a usar un repack en su lugar? [No lo hagas](https://www.mangosrumors.org/why-you-should-not-use-repacks-to-run-your-wow-server/). + +## Instalación de AzerothCore en su computadora + +El primer paso siempre es instalar un servidor WoW local en tu propia máquina. Y hay varias formas de hacerlo, que pueden variar según el sistema operativo. + +### Tu sistema operativo + +Permítanme ser claro sobre una cosa: **TODOS los sistemas operativos son compatibles con AzerothCore**. +Por lo tanto, puede instalar correctamente AzerothCore GNU/Linux, macOS o Windows sin ningún problema. + +Sin embargo, puedo decirle que si usa una distribución de Linux como **Ubuntu 20.04**, el proceso será más fácil. Si desea instalar Ubuntu, puede descargarlo desde [aquí] (https://ubuntu.com/download/desktop) y puede encontrar muchos tutoriales en línea sobre cómo hacerlo. Hay un buen tutorial sobre cómo ejecutar WoW en Linux [aquí] (https://www.mangosrumors.org/how-to-run-wow-on-linux/). + +¿Te gustaría quedarte con **Windows** o **macOS**? Eso está absolutamente bien. + + + +### Diferentes formas de instalar AzerothCore + +Básicamente, hay 3 formas principales de instalar AC: + +- La "**configuración clásica**": esta es la configuración tradicional que normalmente usarías para instalar un emulador común de WoW. **Todos los sistemas operativos son compatibles.** Hacer esta configuración probablemente también le brinde una mejor visión general de los componentes del servidor. +- La "**configuración de Docker**": esta es una configuración simplificada que usa Docker para automatizar muchas cosas para usted. Esta configuración suele ser más fácil. **Puede usar esta configuración en todos los sistemas operativos donde puede instalar [Docker](https://www.docker.com/products/docker-desktop).** +- La "**configuración del tablero**": esta es una forma **EXTREMADAMENTE FÁCIL** de instalar AzerothCore en su máquina, basada en una colección de scripts bash creados por [Yehonal](https://github.com/Yehonal ). Sin embargo, **solo puede usar esta configuración en Ubuntu** o plataformas similares. Windows no es compatible, y probablemente todavía no estemos allí con macOS también. + +Puede elegir una configuración o incluso probar más de una. Puedes encontrar todas las instrucciones aquí: + +- [azerothcore.org/wiki/Installation](https://www.azerothcore.org/wiki/Installation) + +Si encuentra algún problema o duda al intentar instalar su servidor AC, [pídanos ayuda](https://github.com/azerothcore/wiki/blob/master/docs/how-to-ask-for-help.md). + +¿Tienes tu servidor WoW instalado? ¡Felicidades! Ahora veamos qué puedes hacer a continuación. + + + +## Accede al juego, aprende los comandos de GM + +En primer lugar, `establezca realmlist localhost` y únase a su propio servidor usando la cuenta `test1` con la contraseña `a` (sí, contraseña de una letra). Esta cuenta ya es `GM` por lo que puede usar los comandos de esta lista: + +- [azerothcore.org/wiki/GM-Commands](https://www.azerothcore.org/wiki/GM-Commands) + +Confíe en los comandos, los necesitará para cualquier actividad de administración, prueba o desarrollo. + + + +## Considere aprender git + +Puede simplemente copiar y pegar a ciegas los comandos `git` que verá en los tutoriales vinculados aquí, lo más probable es que no tenga problemas con ellos. +Sin embargo, aprender correctamente `git` te hará realmente consciente de lo que estás haciendo, y este conocimiento puede ayudarte con cualquier otro proyecto de desarrollo de software con el que puedas trabajar. +Sí, porque `git` es una de las herramientas más importantes utilizadas en muchos proyectos de ingeniería de software. Aprender sus conceptos básicos no solo te ayudará mucho con AzerothCore, sino que también es algo muy bueno para poner en tu CV. + +Puede encontrar muchos recursos en línea sobre cómo aprender `git`, por ejemplo [try.github.io](https://try.github.io/) + + + +## Aprende a actualizar tu servidor de WoW + +Publicamos mejoras en AzerothCore a diario. Debe aprender a actualizar su servidor y seguir actualizándolo con frecuencia. Recomendamos evitar trabajar en versiones anteriores de AzerothCore porque pueden tener errores que ya resolvimos y no querrás quedarte atrás. + +Por lo tanto, es **muy importante** que actualice su servidor AzerothCore periódicamente. Te recomendamos hacerlo al menos una vez a la semana. Lea esta guía: + +- [azerothcore.org/wiki/Update](https://www.azerothcore.org/wiki/Update) + +Después de seguir el procedimiento de actualización, es importante **verificar** que: + +- La aplicación de su servidor (núcleo) se ha actualizado correctamente, utilice el comando `información del servidor` para asegurarse de ello. +- Su base de datos se actualizó correctamente y se alineó con su versión principal, [lea esta respuesta en stackoverflow] (https://stackoverflow.com/a/55282168/3497671). + + + +## Aprende a revisar las relaciones públicas + +Una excelente manera de comenzar a contribuir es probando las relaciones públicas realizadas por otros colaboradores. Esto no solo es bastante fácil de hacer, sino que es extremadamente útil para el proyecto y puede ayudarlo a ingresar a nuestro proceso de desarrollo. + +Este tema es tan importante que hay un tutorial dedicado a él: + +- [azerothcore.org/wiki/How-to-test-a-PR](https://www.azerothcore.org/wiki/How-to-test-a-PR) + + + +## Aprendiendo a trabajar con la base de datos + +La base de datos es el mejor lugar para comenzar a desarrollar un servidor de WoW. Porque es más fácil que los otros componentes y hay herramientas que pueden generar automáticamente el código para usted. Por ejemplo, Keira3. + +### Descargar Keira3 + +Keira3 es un editor de base de datos para AzerothCore que te permite editar o agregar contenidos al mundo muy fácilmente, te recomendamos instalarlo y jugar con él: + +- [azerothcore.org/Keira3](https://www.azerothcore.org/Keira3) + +Keira3 genera automáticamente el código SQL necesario para crear o cambiar cosas en la base de datos. +¿Suena complicado? Pruébalo y verás cómo funciona. + + + +### Descargar un cliente MySQL + +También necesitará una herramienta de administración de base de datos genérica para administrar tablas y su contenido. + +- [Herramienta de administración de base de datos](database-management-tool) + + + +### La documentación de DB es tu amiga + +Lea siempre la documentación de cada tabla con la que trabaje: + +- [azerothcore.org/wiki/database-world](https://www.azerothcore.org/wiki/database-world) + +### SmartAI + +Con SmartAI puedes hacer muchas cosas. Puedes agregar un comportamiento especial a un elemento del juego, como una criatura, sin siquiera tocar una sola línea de C++. + +En pocas palabras, con SmartAI puedes hacer que una entidad (por ejemplo, una Criatura) realice una determinada **acción** cuando ocurre un determinado **evento**, especificando opcionalmente un **objetivo**. En otras palabras, puede hacer que las entidades reaccionen a los eventos con un comportamiento definido por usted. + +Por ejemplo, puedes hacer que una criatura lance un hechizo (acción), cuando su salud esté por debajo del 50 % de su salud total (evento), contra un miembro aleatorio del grupo del grupo (objetivo). + +Técnicamente, `smart_script` es solo una tabla dentro de la base de datos mundial (y su documentación se puede encontrar [aquí](https://www.azerothcore.org/wiki/smart_scripts)). Herramientas como Keira3 te ayudan a trabajar con SmartAI mediante una práctica interfaz gráfica. + +Intenta abrir Keira3, busca cualquier criatura que tenga "SmartAI" como "AIName", ábrelo y haz clic en "SmartAI" en el menú de la derecha. +Aparecerá un editor visual que lo ayudará cuando trabaje con SmartAI. + + + +Experimente con SmartAI y confíe en él. Es una herramienta simple pero muy poderosa. +Después de conocerlo un poco, podrás hacer muchas cosas. Muchos errores se pueden corregir simplemente usando SmartAI. + +La IA de la mayoría de las criaturas que encontrarás en el mundo se realiza con SmartAI. Mientras que las criaturas más complejas (típicamente jefes de raid) están escritas en C++. + + + +### Aprenda el lenguaje SQL + +Por lo general, solo necesitará los conceptos básicos del lenguaje SQL y, en la mayoría de los casos, probablemente lo resolverá por sí mismo; sin embargo, no es una mala idea leer sobre el lenguaje SQL. Puede encontrar muchos recursos en línea, por ejemplo: + +- [https://www.w3schools.com/sql/sql_intro.asp](https://www.w3schools.com/sql/sql_intro.asp) + +si comprende cómo funcionan las declaraciones básicas como `SELECT`, `UPDATE`, `INSERT` y `DELETE`, eso suele ser suficiente. No necesita profundizar demasiado en SQL para poder contribuir. + +## ¡Comparte tu código! + +Puede enviar su mejora a través de PR. Lea esta guía: + +- [Cómo crear una Pull Request (PR)](https://www.azerothcore.org/wiki/how-to-create-a-pr) + +## ¡Empieza a contribuir! + +Si dominaste algunas de las partes anteriores, ya hay **MUCHO** que puedes hacer para ayudar a nuestro proyecto y convertirte en colaborador. +Por ejemplo: + +- Ayude a los desarrolladores probando PRs y dando su opinión +- Realice una clasificación de errores confirmando problemas y ayudándonos a identificar y cerrar los informes no válidos +- También puede ayudar [clasificando los errores que provienen de los jugadores de ChromieCraft] (https://github.com/chromiecraft/chromiecraft) (nuestro proyecto secundario) +- Informe de cualquier error que pueda encontrar usted mismo +- Intente corregir errores, muchos de ellos pueden corregirse con algo de SQL y puede usar Keira3 para eso (por ejemplo, usando SmartAI u otros editores integrados). Siendo este un proyecto de código abierto, puede encontrar muchos ejemplos en nuestro repositorio principal de GitHub + +¿Te gustaría hablar con nosotros? Únase al [servidor AzerothCore Discord](https://discordapp.com/invite/gkt4y2x). + + + +## Conclusión y próximos pasos + +Nunca dejes de aprender. Vaya a aprender los conceptos básicos detrás de la Programación Orientada a Objetos (POO). +Obtenga un tutorial de C++, comience a experimentar con el código fuente principal. Mira las PRs de otras personas como ejemplos. + +Estudie los mecanismos básicos del servidor de juegos (lea artículos como [este](https://stackoverflow.com/questions/62249204/how-does-the-update-diff-work-in-azerothcore)). Intente [crear módulos](https://stackoverflow.com/questions/66340549/is-it-possible-to-turn-a-core-patch-into-a-module-for-azerothcore). + +O aprenda otro lenguaje de programación, hay muchas herramientas que puede crear para los usuarios o desarrolladores de AzerothCore usando su lenguaje de programación favorito. + +Hagas lo que hagas, recuerda siempre: **StackOverflow es tu amigo**. + +------------------------------------------------- + +En este tutorial, quería ayudar a los principiantes y demostrarles cuánto pueden aprender y contribuir sin siquiera saber C++. Todo lo que necesitas es algo de tiempo y paciencia. + +¡Feliz codificación! + +-- Shin aka Francesco diff --git a/docs/es/how-to-create-a-db-pr.md b/docs/es/how-to-create-a-db-pr.md new file mode 100644 index 0000000..3aae4f8 --- /dev/null +++ b/docs/es/how-to-create-a-db-pr.md @@ -0,0 +1,127 @@ +--- +redirect_from: "/How-to-create-a-DB-PR" +--- + +# Cómo crear una DB PR a través de GitHub + +Esta es una guía simplificada para crear fácilmente PR que contengan correcciones de base de datos (código SQL) sin molestarse con la terminal. +una alternativa más fácil a la [forma tradicional de crear PR] (https://www.azerothcore.org/wiki/how-to-create-a-pr). +Si desea enviar correcciones de C++ u otro tipo que no sea SQL, siga la otra guía. + +## Haz solo UNA VEZ: crea tu fork de AzerothCore + +Debe iniciar sesión en [github.com](https://github.com/). Si aún no tienes una cuenta, crea una. + +Abra el [repositorio de AzerothCore](https://github.com/azerothcore/azerothcore-wotlk) +y cree una fork haciendo clic en el botón "Fork" de la parte superior derecha: + + + +## Creando un nuevo PR + +### 1. Actualiza tu kork en GitHub + +Abra su navegador y navegue hasta su fork en GitHub (cambie `Su nombre de usuario` con su nombre de usuario actual de GitHub): + +**https://github.com/Tunombredeusuario/azerothcore-wotlk** + +Si su rama `master` no está actualizada con el último AzerothCore, verá algo como: + +`Esta rama tiene XX confirmaciones detrás de azerothcore:master` + + + +para actualizarlo, haga clic en **Fetch upstream** y luego en **Fetch and merge**. + +Como resultado, la rama `master` de tu Fork debería decir: + +`Esta rama está a la par con azerothcore:master` + + + +### 2. Crear una nueva branch + +Asegúrese de tener la rama `master` actualmente seleccionada, haga clic en el menú desplegable de ramas y cree una nueva rama. + + + +Puede nombrar su nueva rama de la forma que desee (generalmente algo relacionado con su arreglo), +solo asegúrese de no haber usado ese nombre antes y de que está creando la nueva rama copiando la rama principal. + +Debería ver un mensaje como **Crear rama my-new-branch-123 desde master**. + +Después de crear la nueva rama, asegúrese de **mantenerla seleccionada**. + +### 3. Navegue a la carpetaending_db_world + +Ahora necesita navegar dentro de la carpeta `data/sql/updates/pending_db_world` de su fork. + +Puede hacerlo manualmente haciendo clic en la carpeta `data`, luego `sql`, `updates`, `pending_db_world`; + +... o simplemente puede abrir esta URL (cambie `Su nombre de usuario` con su nombre de usuario real de GitHub): + +**https://github.com/YourUsername/azerothcore-wotlk/tree/my-new-branch-123/data/sql/updates/pending_db_world** + +### 4. Generar un nuevo archivo de actualización de la versión + +En una nueva pestaña del navegador, abra [azerothcore.org/pages/rev-generator](https://www.azerothcore.org/pages/rev-generator/). + + + +Esto te dará: + +- El nombre del archivo que necesita crear que contendrá su código SQL +- El *código de versión SQL* (una consulta `INSERT INTO`) que deberá agregar en la parte superior del nuevo archivo SQL que enviará + +**Nota**: siempre deben ir juntos y siempre debes tener una nueva rev para cada PR que envíes. +Si necesita obtener una nueva versión, simplemente actualice la página o haga clic en "Generar nuevo". + +Cópielos en algún lugar o mantenga abierta la pestaña del navegador. + +### 5. Crear y confirmar un nuevo archivo + +De vuelta en GitHub, desde la carpeta `pending_db_world`, haga clic en **Agregar archivo** y luego en **Crear nuevo archivo**: + + + +Ahora necesitas: + +- Establezca el nombre del archivo como el que generó en el paso 4. +- Agregue el código de versión de SQL que generó en el paso 4. +- Agregue una nueva línea, luego agregue su propio código SQL a continuación y luego agregue una nueva línea vacía al final del archivo. + + + +Ahora desplácese hacia abajo en la página, deberá: + +1. Complete el mensaje de compromiso, usamos el [formato de compromisos convencionales] (https://www.conventionalcommits.org/), + por ejemplo `fix(DB/Creature): alguna descripción de confirmación aquí`. +2. Incluye alguna descripción extra opcional) . +3. Asegúrese de que esté seleccionado "Comentar directamente con `your-new-branch-name`". +4. Haga clic en **Confirmar archivo nuevo** + + + +### 6. Abre el PR + +Vuelva al [repositorio principal de AzerothCore](https://github.com/azerothcore/azerothcore-wotlk), +notarás que GitHub es lo suficientemente inteligente como para darse cuenta de que estás a punto de abrir un PR +y muestra este bonito cuadro amarillo claro: + + + +haga clic en el botón verde "Comparar y extraer solicitud" (ubicado a la derecha). + +Ahora complete la plantilla de PR siguiendo las instrucciones que aparecerán en la pantalla, +no olvide agregar las **instrucciones de prueba** para que las personas puedan probar su PR y se pueda fusionar: + + + +También es una buena práctica verificar la pestaña "Cambios de archivo" para ver que todo esté en su lugar como espera: + + + +**NOTA:** ¡No respondemos bien a las sanguijuelas! Si su solución proviene de otra organización o persona +SIEMPRE debes dar crédito al autor original y comprometerte. + +¡Eso es! diff --git a/docs/es/how-to-use-gperftool.md b/docs/es/how-to-use-gperftool.md new file mode 100644 index 0000000..d97cb12 --- /dev/null +++ b/docs/es/how-to-use-gperftool.md @@ -0,0 +1,27 @@ +# Cómo usar GPERFTool + +AzerothCore integra la biblioteca de herramientas de rendimiento de Google que le permite analizar la ejecución del código de su aplicación en lo que respecta a la CPU y la memoria. +En resumen: thread-friendly heap-checker, heap-profiler, y cpu-profiler. + +* [Repositorio](https://github.com/gperftools/gperftools#readme) +* [Documentación](https://gperftools.github.io/gperftools/) + +## Instalar (Ubuntu): + +Ejecutar en una terminal: `sudo apt-get install google-perftools libgoogle-perftools-dev` + +Nota: las dependencias anteriores ya están instaladas en nuestro archivo docker + +## Usando (con el tablero AzerothCore): + +1. Para habilitar gperftools debe compilar con el indicador del compilador `-DWITH_PERFTOOLS=ON -DNOJEM=ON -DWITH_DYNAMIC_LINKING=0`. Puede usar CUSTOMOPTIONS en `config.sh` para configurarlo para el compilador del tablero. También debe establecer la configuración de `CTYPE` en al menos `RelWithDebInfo` (más rápido pero con menos información) o `Debug` (más lento pero con más información). +2. Configure las variables dentro de `config.sh`, en la sección ` GOOGLE PERF TOOLS` según sus necesidades +3. Ejecute el worldserver con `sudo ./acore.sh run-worldserver` +4. Ejecute `sudo killall -12 worldserver` Este comando iniciará el proceso de monitoreo. +5. Ejecute `sudo killall -12 worldserver` nuevamente para detener el proceso cuando lo desee. En este momento tendrás listo el archivo .prof en la carpeta configurada a continuación. +6. Ejecute `google-pprof --callgrind <path/of/worldserver/bin> </path/of/prof/file> > worldserver.callgrind` Esto generará un archivo callgrind que se puede leer con +[QCacheGrind](https://sourceforge.net/projects/qcachegrindwin/), [KCacheGrind](http://kcachegrind.sourceforge.net/html/Home.html) o cualquier otra herramienta compatible. + +This is what you will see (screenshot of KCacheGrind): + + diff --git a/docs/es/windows-requirements.md b/docs/es/windows-requirements.md index 9c4c73b..9092d73 100644 --- a/docs/es/windows-requirements.md +++ b/docs/es/windows-requirements.md @@ -1,23 +1,23 @@ # Windows: Requisitos -| GuÃa de Instalación | | -| :- | :- | +| GuÃa de Instalación | | +| :- | :- | | Este artÃculo es parte de la GuÃa de Instalación. Puede leerlo solo o hacer click en los links previos para navegar con facilidad entre los pasos. | -| [<< Inicio: GuÃa de Instalación](installation.md) | [Paso 2: Instalación del Core >>](core-installation.md) | +| [<< Inicio: GuÃa de Instalación](installation.md) | [Paso 2: Instalación del Core >>](core-installation.md) | -| | -| :- | -| Boost ≥ 1.70 - 1.74 | -| MySQL ≥ 5.7.0 | -| OpenSLL ≥ 1.0.x (OpenSSL 3.0 no es soportado)| -| CMake ≥ 3.16 | -| MS Visual Studio (Community) ≥ 16.4 (2019) (Escritorio) (Sin vista previa) +| | +| :- | +| Boost ≥ 1.74 | +| MySQL ≥ 5.7.0 | +| OpenSLL ≥ 1.0.x (OpenSSL 3.0 no es soportado) | +| CMake ≥ 3.16 | +| MS Visual Studio (Community) ≥ 16.11 (2019) (Escritorio) (Sin vista previa) | 1. Extensiones de Git 1. Necesitará tener Git instalado. Puede obtener la [versión más reciente](https://sourceforge.net/projects/gitextensions/). -1. Instale el compilador / IDE [Visual Studio (16) Community 2019](https://visualstudio.microsoft.com/downloads/) +1. Instale el compilador / IDE [Visual Studio (17) Community 2020](https://visualstudio.microsoft.com/downloads/) Necesitará instalar el compilador de C++. @@ -85,22 +85,20 @@ - Encuentre la versión de 32 bits buscando el último 1.0.x o 1.1.x Win32 OpenSSL que no sea la versión "light". (Ejemplo: Win32 OpenSSL v1.1.1g) - - *Nota #1: Si aparece un error como: "Missing Microsoft Visual C++ 2008 Redistributable" mientras está instalanod OpenSSL:* - *Descargue [Microsoft Visual C++ 2008 Redistributable Package (x64)](http://www.microsoft.com/en-us/download/details.aspx?id=29) (1.7MB Instalador) e instalelo* - *Si necesita soporte para 32 bits, descargue e instale [Microsoft Visual C++ 2008 Redistributable Package (x86)](http://www.microsoft.com/en-us/download/details.aspx?id=15336).* + - *Nota #1: Si aparece un error como: "Missing Microsoft Visual C++ ... Redistributable" mientras está instalanod OpenSSL:* + *Descargue [Microsoft Visual C++ 2017/2019/2022 Redistributable Package (x64)](https://aka.ms/vs/17/release/vc_redist.x64.exe) (1.7MB Instalador) e instalelo* + *Si necesita soporte para 32 bits, descargue e instale [Microsoft Visual C++ 2017/2019/2022 Redistributable Package (x86)](https://aka.ms/vs/17/release/vc_redist.x86.exe).* - *Nota #2: Mientras esté instalando OpenSSL, seleccione el directiorio de los binarios de OpenSSL (/bin) (NO "The Windows system directory")* *Cuando deba elegir dónde ubicar los DLLs de OpenSSL. Estos deben ubicarse en donde sean encontrados con facilidad para la [Instalación del Core](windows-core-installation).* 1. [Boost](https://www.boost.org/). - 1. Descargue la versión precompilada de Windows Binary for Visual Studio 2019 + 1. Descargue la versión precompilada de Windows Binary for Visual Studio 2022 - 1. `1.70.0` es la versión mÃnima requerida para Visual Studio 2019, pero la versión `1.74.0` es la recomendada. + 1. [64bit](https://sourceforge.net/projects/boost/files/boost-binaries/1.74.0/boost_1_74_0-msvc-14.2-64.exe/download) - 1. 64 bits: https://sourceforge.net/projects/boost/files/boost-binaries/1.74.0/boost_1_74_0-msvc-14.2-64.exe/download - - 1. 32 bits: https://sourceforge.net/projects/boost/files/boost-binaries/1.74.0/boost_1_74_0-msvc-14.2-32.exe/download + 1. [32bit](https://sourceforge.net/projects/boost/files/boost-binaries/1.74.0/boost_1_74_0-msvc-14.2-32.exe/download) 1. Añada una variable de entorno "System", llamada "BOOST_ROOT" y como valor, ingrese el directorio de instalación de Boost. Por ejemplo: `E:/Programs/boost_1_74_0`. Es importante usar '**/**' y no '**\\**' al momento de señalar el directorio. (Asegurese de no quede un slash al final. (final de la ruta). Si sigue presentado inconvenientes, añada la misma variable de entorno en la sección de variables `USER`, tal como la siguiente imagen) @@ -124,8 +122,7 @@ Si sigue teniendo inconvenientes, revise: * [Unase a nuestro discord](https://discord.gg/gkt4y2x). Aunque no es un canal de soporte 24/7, un miembro del staff le responderá siempre que tenga tiempo. - -| GuÃa de Instalación | | -| :- | :- | +| GuÃa de Instalación | | +| :- | :- | | Este artÃculo es parte de la GuÃa de Instalación. Puede leerlo solo o hacer click en los links previos para navegar con facilidad entre los pasos. | -| [<< Inicio: GuÃa de Instalación](installation.md) | [Paso 2: Instalación del Core >>](core-installation.md) | +| [<< Inicio: GuÃa de Instalación](installation.md) | [Paso 2: Instalación del Core >>](core-installation.md) | |