From 0b029676597e656dffa684f1e8d86f9251dd5831 Mon Sep 17 00:00:00 2001 From: "Julio A. Leyva Osorio" Date: Tue, 22 Feb 2022 03:07:15 -0500 Subject: Update and Create getting-started (#689) * Update server-setup.md * Update es/server-setup.md * Update * Update sidebar.html (es) Pr 619 * Update contribute.md (es - en) Pr 619 * Updating code getting-started Pr 619 * create es/getting-started Pr 619 * Updating code how-to-create-a-db-pr Pr 619 * Create es/how-to-create-a-db-pr Pr 619 * Update es/documentation-index.md * Create es/exitcodes.md * Update (es-en) windows-requirements.md * Update and create (es-en) how-to-use-gperftool.md * Update es/file-headers.md * Update VS2019 --- docs/contribute.md | 15 +-- docs/documentation-index.md | 1 - docs/es/contribute.md | 20 ++-- docs/es/documentation-index.md | 24 ++--- docs/es/exitcodes.md | 43 +++++++++ docs/es/file-headers.md | 25 +++-- docs/es/getting-started.md | 200 +++++++++++++++++++++++++++++++++++++++ docs/es/how-to-create-a-db-pr.md | 127 +++++++++++++++++++++++++ docs/es/how-to-use-gperftool.md | 27 ++++++ docs/es/windows-requirements.md | 43 ++++----- docs/getting-started.md | 28 ++---- docs/how-to-create-a-db-pr.md | 22 ++--- docs/how-to-use-gperftool.md | 4 +- docs/windows-requirements.md | 34 +++---- 14 files changed, 504 insertions(+), 109 deletions(-) create mode 100644 docs/es/exitcodes.md create mode 100644 docs/es/getting-started.md create mode 100644 docs/es/how-to-create-a-db-pr.md create mode 100644 docs/es/how-to-use-gperftool.md (limited to 'docs') diff --git a/docs/contribute.md b/docs/contribute.md index a7a9740..073d6d4 100644 --- a/docs/contribute.md +++ b/docs/contribute.md @@ -6,17 +6,18 @@ redirect_from: "/Contribute" You can contribute in several ways to AzerothCore: -- [commenting an open issue](#how-to-comment-an-issue) +- [Commenting an open issue](#how-to-comment-an-issue) -- [opening an issue](#how-to-open-an-issue) +- [Opening an issue](#how-to-open-an-issue) -- [testing a pull request](#how-to-test-a-pull-request) +- [Testing a pull request](#how-to-test-a-pull-request) -- [testing DB-only changes](How-to-test-DB-only-changes) +- [Testing DB-only changes](How-to-test-DB-only-changes) -- [creating a pull request](#how-to-create-a-pull-request) +- [Creating a pull request](#how-to-create-a-pull-request) + +- [Improving our wiki](#improve-the-wiki) -- [improving our wiki](#improve-the-wiki) ## General information To contribute, you obviously need a github account. @@ -48,7 +49,7 @@ If **(and only if)** the bug hasn't been reported yet, you can [open an issue](h ## How to create a Pull Request - Read [How to create a PR](How-to-create-a-PR). -- Alternatively, you can also check [this simpler tutorial](How-to-create-a-DB-PR) about opening PRs containing SQL code via GitHub +- Alternatively, you can also check [this simpler tutorial](How-to-create-a-DB-PR) about opening PRs containing SQL code via GitHub. ### Giving credit to the author of code diff --git a/docs/documentation-index.md b/docs/documentation-index.md index 1fdb5c9..0f86689 100644 --- a/docs/documentation-index.md +++ b/docs/documentation-index.md @@ -59,4 +59,3 @@ redirect_from: /documentation_index * Guides and Tips from our Forum * DBC Documentation - 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 * Guías y consejos de nuestro foro * Documentación de DBC - 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 , 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 . */ ``` **Con código anterior de fuentes externas o desarrolladores:** -```cpp -/* - * Copyright (C) 2016+ AzerothCore , 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 - */ -``` +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! + +![AzerothCore learning code](https://user-images.githubusercontent.com/75517/109369720-b6fa7d00-789d-11eb-86b4-5fe15d6ab834.png) + + +## 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. + +![AzerothCore supports GNU/Linux, macOS and Windows](https://user-images.githubusercontent.com/75517/109369213-e5775880-789b-11eb-8356-99a4ab842bfb.png) + +### 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. + +![AzerothCore server running on macOS](https://user-images.githubusercontent.com/75517/109369101-80236780-789b-11eb-900c-bcc17a3cf13c.png) + +## 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. + +![AzerothCore GM](https://user-images.githubusercontent.com/75517/109369940-ba423880-789e-11eb-88d6-e6d8f7b8a723.png) + +## 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/) + +![AzerothCore learning git](https://user-images.githubusercontent.com/75517/109370018-fb3a4d00-789e-11eb-8532-1ab1bf8fba60.png) + +## 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). + +![AzerothCore server info](https://user-images.githubusercontent.com/75517/109370296-00e46280-78a0-11eb-9ed0-b9df14f2008b.png) + +## 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) + +![image](https://user-images.githubusercontent.com/75517/109370244-d397b480-789f-11eb-9ac7-64d98ca0d33c.png) + +## 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. + +![AzerothCore Keira3](https://user-images.githubusercontent.com/75517/109370160-769bfe80-789f-11eb-9958-dc17ff48f39a.png) + +### 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) + +![Base de datos mundial de AzerothCore vista con sequel-ace](https://user-images.githubusercontent.com/75517/109370368-42750d80-78a0-11eb-946c-c0831a02b52b.png) + +### 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. + +![AzerothCore SmartAI con Keira3](https://user-images.githubusercontent.com/75517/109367698-1bfea480-7897-11eb-9cf0-f047b3dcdb85.png) + +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++. + +![SmartAI frente a C++](https://user-images.githubusercontent.com/75517/109369529-e78de700-789c-11eb-97d5-02ecc6c85a0a.png) + +### 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). + +![Contribuyendo a AzerothCore](https://user-images.githubusercontent.com/75517/109370461-b44d5700-78a0-11eb-916c-81c8500fa969.png) + +## 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: + +![Crear una Fork de AzerothCore](http://www.azerothcore.org/wiki/assets/images/pr-tutorial/1.png) + +## 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` + +![Fork de actualización de AzerothCore](http://www.azerothcore.org/wiki/assets/images/pr-tutorial/update-fork-1.png) + +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` + +![AzerothCore fork updated](http://www.azerothcore.org/wiki/assets/images/pr-tutorial/update-fork-2.png) + +### 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. + +![Fork de AzerothCore actualizada](http://www.azerothcore.org/wiki/assets/images/pr-tutorial/web-create-new-branch.png) + +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/). + +![Generador de actualización de SQL de AzerothCore](http://www.azerothcore.org/wiki/assets/images/pr-tutorial/web-rev-generator.png) + +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**: + +![AzerothCore crea un nuevo archivo SQL](http://www.azerothcore.org/wiki/assets/images/pr-tutorial/web-create-new-file-1.png) + +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. + +![Ejemplo de nuevo archivo SQL de AzerothCore](http://www.azerothcore.org/wiki/assets/images/pr-tutorial/web-create-new-file-2.png) + +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** + +![AzerothCore crea nueva confirmación](http://www.azerothcore.org/wiki/assets/images/pr-tutorial/web-create-commit.png) + +### 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: + +![AzerothCore - Comparar y solicitar extracción](http://www.azerothcore.org/wiki/assets/images/pr-tutorial/11.png) + +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: + +![AzerothCore - Comparar y solicitar extracción](http://www.azerothcore.org/wiki/assets/images/pr-tutorial/12.png) + +También es una buena práctica verificar la pestaña "Cambios de archivo" para ver que todo esté en su lugar como espera: + +![AzerothCore - Comparar y solicitar extracción](http://www.azerothcore.org/wiki/assets/images/pr-tutorial/13.png) + +**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 > 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): + +![kcachegrind](https://user-images.githubusercontent.com/147092/117697104-615a1f00-b1c2-11eb-8599-f5893a04de0c.png) 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) | diff --git a/docs/getting-started.md b/docs/getting-started.md index b465bf5..9a5f24e 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -37,14 +37,13 @@ Would you like to stick with **Windows** or **macOS**? That's absolutely fine. ![AzerothCore supports GNU/Linux, macOS and Windows](https://user-images.githubusercontent.com/75517/109369213-e5775880-789b-11eb-8356-99a4ab842bfb.png) - ### Different ways to install AzerothCore Basically, there are 3 main ways to install AC: -- the "**classic setup**": this is the traditional setup you would normally use to install a common WoW emulator. **All operating systems are supported.** Doing this setup also probably gives you a better overview of the components of the server. -- the "**docker setup**": this is a simplified setup that uses Docker to automate a lot of things for you. This setup is typically easier. **You can use this setup in all operating systems where you can install [Docker](https://www.docker.com/products/docker-desktop).** -- the "**dashboard setup**": this is an **EXTREMELY EASY** way of installing AzerothCore in your machine, based on a collection of bash scripts created by [Yehonal](https://github.com/Yehonal). However, **you can only use this setup in Ubuntu** or similar platforms. Windows is not supported, and probably we are not there yet with macOS as well. +- The "**classic setup**": this is the traditional setup you would normally use to install a common WoW emulator. **All operating systems are supported.** Doing this setup also probably gives you a better overview of the components of the server. +- The "**docker setup**": this is a simplified setup that uses Docker to automate a lot of things for you. This setup is typically easier. **You can use this setup in all operating systems where you can install [Docker](https://www.docker.com/products/docker-desktop).** +- The "**dashboard setup**": this is an **EXTREMELY EASY** way of installing AzerothCore in your machine, based on a collection of bash scripts created by [Yehonal](https://github.com/Yehonal). However, **you can only use this setup in Ubuntu** or similar platforms. Windows is not supported, and probably we are not there yet with macOS as well. You can choose one setup, or even try more than one. You can find all the instructions here: @@ -56,7 +55,6 @@ Got your WoW server installed? Congratulations! Now let's see what you can do ne ![AzerothCore server running on macOS](https://user-images.githubusercontent.com/75517/109369101-80236780-789b-11eb-900c-bcc17a3cf13c.png) - ## Access the game, learn the GM commands First of all, `set realmlist localhost` and join your own server using the `test1` account with password `a` (yes, one-letter password). This account is already `GM` so you can use the commands from this list: @@ -67,7 +65,6 @@ Get confident with the commands, you will need them for any administration, test ![AzerothCore GM](https://user-images.githubusercontent.com/75517/109369940-ba423880-789e-11eb-88d6-e6d8f7b8a723.png) - ## Consider learning git You can just blindly copy-paste the `git` commands that you'll see in the tutorials linked here, most likely you will not have issues with them. @@ -78,7 +75,6 @@ You can find plenty of resources online about learning `git`, for example [try.g ![AzerothCore learning git](https://user-images.githubusercontent.com/75517/109370018-fb3a4d00-789e-11eb-8532-1ab1bf8fba60.png) - ## Learn how to update your WoW server We release improvements to AzerothCore on a daily basis. You should learn how to update your server and keep updating it often. We recommend avoiding working on older versions of AzerothCore because they can have bugs that we already resolved and you don't want to stay behind. @@ -89,12 +85,11 @@ So it is **very important** that you update your AzerothCore server regularly. W After you follow the update procedure, it is important to **verify** that: -- your server application (core) has been properly updated, use the `server info` command to make sure of it -- your DB has been properly updated and aligned to your core version, [read this answer on stackoverflow](https://stackoverflow.com/a/55282168/3497671) +- Your server application (core) has been properly updated, use the `server info` command to make sure of it. +- Your DB has been properly updated and aligned to your core version, [read this answer on stackoverflow](https://stackoverflow.com/a/55282168/3497671). ![AzerothCore server info](https://user-images.githubusercontent.com/75517/109370296-00e46280-78a0-11eb-9ed0-b9df14f2008b.png) - ## Learn to check out PRs A great way to start contributing is by testing PRs made by other contributors. This is not only quite easy to do, but it is extremely helpful for the project and can help you to get into our development process. @@ -105,7 +100,6 @@ This topic is so important that there is a dedicated tutorial for it: ![image](https://user-images.githubusercontent.com/75517/109370244-d397b480-789f-11eb-9ac7-64d98ca0d33c.png) - ## Learning how to work with the Database The Database is the best place to start developing a WoW server. Because it's easier than the other components, and there are tools that are able to automatically generate the code for you. For example, Keira3. @@ -129,7 +123,6 @@ You'll need a generic database management tool too in order to manage tables and ![AzerothCore world database viewed with sequel-ace](https://user-images.githubusercontent.com/75517/109370368-42750d80-78a0-11eb-946c-c0831a02b52b.png) - ### The DB documentation is your friend Always read the documentation about every table that you deal with: @@ -158,7 +151,6 @@ The AI of most of the creatures you'll find in the world is done with SmartAI. W ![SmartAI vs C++](https://user-images.githubusercontent.com/75517/109369529-e78de700-789c-11eb-97d5-02ecc6c85a0a.png) - ### Learn the SQL language Usually, you'll need only the basics of the SQL language, and in most cases, you'll probably figure it out by yourself, however, it's not a bad idea to read about the SQL language. You can find a lot of resources online, for example: @@ -178,11 +170,11 @@ You can submit your improvement via PR. Read this guide: If you mastered some of the above parts, there is already **A LOT** you can do to help our project and becoming a contributor. For example: -- help the developers by testing PRs and giving your feedback -- do some bug triaging by confirming issues and helping us to identify and close the invalid reports -- you can also help by [triaging the bugs coming from the players of ChromieCraft](https://github.com/chromiecraft/chromiecraft) (our child-project) -- report any bug that you may find yourself -- try to fix bugs, a lot of them can just be fixed with some SQL and you can use Keira3 for that (e.g. using SmartAI or other embedded editors). Being this an open-source project, you can find plenty of examples on our main GitHub repository +- Help the developers by testing PRs and giving your feedback +- Do some bug triaging by confirming issues and helping us to identify and close the invalid reports +- You can also help by [triaging the bugs coming from the players of ChromieCraft](https://github.com/chromiecraft/chromiecraft) (our child-project) +- Report any bug that you may find yourself +- Try to fix bugs, a lot of them can just be fixed with some SQL and you can use Keira3 for that (e.g. using SmartAI or other embedded editors). Being this an open-source project, you can find plenty of examples on our main GitHub repository Would you like to talk to us? Join [the AzerothCore Discord server](https://discordapp.com/invite/gkt4y2x). diff --git a/docs/how-to-create-a-db-pr.md b/docs/how-to-create-a-db-pr.md index 34b99c6..dd788d5 100644 --- a/docs/how-to-create-a-db-pr.md +++ b/docs/how-to-create-a-db-pr.md @@ -39,7 +39,6 @@ As a result, your fork's `master` branch should say: ![AzerothCore fork updated](http://www.azerothcore.org/wiki/assets/images/pr-tutorial/update-fork-2.png) - ### 2. Create a new branch Make sure you have the `master` branch currently selected, click on the branches dropdown and create a new branch. @@ -67,13 +66,12 @@ You can either do it manually by clicking on the `data` folder, then `sql`, `upd In a new browser tab, open [azerothcore.org/pages/rev-generator](https://www.azerothcore.org/pages/rev-generator/). - ![AzerothCore SQL update rev generator](http://www.azerothcore.org/wiki/assets/images/pr-tutorial/web-rev-generator.png) This will give you: -- the name of the file you need to create which will contain your SQL code -- the *SQL version code* (an `INSERT INTO` query) which you will need to add at the top of the new SQL file that you will submit +- The name of the file you need to create which will contain your SQL code. +- The *SQL version code* (an `INSERT INTO` query) which you will need to add at the top of the new SQL file that you will submit. **Note**: they should always go together and you should always have a new rev for every PR you send. If you need to get a new rev, just refresh the page or click "Generate new". @@ -88,19 +86,19 @@ Back on GitHub, from the `pending_db_world` folder, click **Add file** and then Now you need to: -- set the file name as the one you generated in the step 4 -- add the SQL version code that you generated in the step 4 -- add a new line, then add your own SQL code below and then add a new empty line at the end of the file +- Set the file name as the one you generated in the step 4. +- Add the SQL version code that you generated in the step 4. +- Add a new line, then add your own SQL code below and then add a new empty line at the end of the file. ![AzerothCore new SQL file example](http://www.azerothcore.org/wiki/assets/images/pr-tutorial/web-create-new-file-2.png) Now scroll down the page, you'll need to: -1. fill out the commit message, we use the [Conventional Commits format](https://www.conventionalcommits.org/), - for example `fix(DB/Creature): some commit description here` -2. (optional) include some extra description -3. make sure that "Commit directly to the `your-new-branch-name`" is selected -4. Click **Commit new file** +1. Fill out the commit message, we use the [Conventional Commits format](https://www.conventionalcommits.org/), + for example `fix(DB/Creature): some commit description here`. +2. Include some extra description (optional). +3. Make sure that "Commit directly to the `your-new-branch-name`" is selected. +4. Click **Commit new file**. ![AzerothCore create new commit](http://www.azerothcore.org/wiki/assets/images/pr-tutorial/web-create-commit.png) diff --git a/docs/how-to-use-gperftool.md b/docs/how-to-use-gperftool.md index 83050ac..f699c02 100644 --- a/docs/how-to-use-gperftool.md +++ b/docs/how-to-use-gperftool.md @@ -20,8 +20,8 @@ Note: dependencies above are already installed in our docker file 4. run `sudo killall -12 worldserver` This command will start the monitoring process. 5. Run `sudo killall -12 worldserver` again to stop the process when you want. At this time you will have the .prof file ready in the folder configured below. 6. Run `google-pprof --callgrind > worldserver.callgrind` This will generate a callgrind file that can be read with -[QCacheGrind](https://sourceforge.net/projects/qcachegrindwin/), [KCacheGrind](http://kcachegrind.sourceforge.net/html/Home.html) or any other compatible tools +[QCacheGrind](https://sourceforge.net/projects/qcachegrindwin/), [KCacheGrind](http://kcachegrind.sourceforge.net/html/Home.html) or any other compatible tools. -This is what you will see (screenshot of KCacheGrind): +Esto es lo que verá (captura de pantalla de KCacheGrind): ![kcachegrind](https://user-images.githubusercontent.com/147092/117697104-615a1f00-b1c2-11eb-8599-f5893a04de0c.png) diff --git a/docs/windows-requirements.md b/docs/windows-requirements.md index d8f16ee..ae4394f 100644 --- a/docs/windows-requirements.md +++ b/docs/windows-requirements.md @@ -1,21 +1,21 @@ # Windows Requirements -| Installation Guide | | -| :- | :- | +| Installation Guide | | +| :- | :- | | This article is a part of the Installation Guide. You can read it alone or click on the previous link to easily move between the steps. | -| [<< Start: Installation Guide](installation.md) | [Step 2: Core Installation >>](core-installation.md) | +| [<< Start: Installation Guide](installation.md) | [Step 2: Core Installation >>](core-installation.md) | -| | -| :- | -| Boost ≥ 1.74 | -| MySQL ≥ 5.7.0 | -| OpenSLL ≥ 1.0.x (OpenSSL 3.0 is not supported)| -| CMake ≥ 3.16 | -| MS Visual Studio (Community) ≥ 16.10 (2019) (Desktop) (No preview) +| | +| :- | +| Boost ≥ 1.74 | +| MySQL ≥ 5.7.0 | +| OpenSLL ≥ 1.0.x (OpenSSL 3.0 is not supported) | +| CMake ≥ 3.16 | +| MS Visual Studio (Community) ≥ 16.11 (2019) (Desktop) (No preview) | 1. Git Extensions - 1. You will need Git installed. You can get the latest version here https://sourceforge.net/projects/gitextensions/ + 1. You will need Git installed. You can get the [latest version](https://sourceforge.net/projects/gitextensions/) 1. Install the compiler / IDE [Visual Studio (17) Community 2022](https://visualstudio.microsoft.com/downloads/) @@ -86,7 +86,7 @@ - Find the 32bit version by finding the latest 1.0.x or 1.1.x Win32 OpenSSL that is NOT the "light" version. (Example: Win32 OpenSSL v1.1.1g) - *Note #1: If you get a "Missing Microsoft Visual C++ .... Redistributable" error message while installing OpenSSL,* - *download the [Microsoft Visual C++ 2017/2019/2022 Redistributable Package (x64) (Direct Download)](https://aka.ms/vs/17/release/vc_redist.x64.exe) (1.7MB Installer) and install it.* + *Download the [Microsoft Visual C++ 2017/2019/2022 Redistributable Package (x64) (Direct Download)](https://aka.ms/vs/17/release/vc_redist.x64.exe) (1.7MB Installer) and install it.* *If you need 32bit support, download and install the [Microsoft Visual C++ 2017/2019/2022 Redistributable Package (x86) (Direct Download)](https://aka.ms/vs/17/release/vc_redist.x86.exe).* - *Note #2: While installing OpenSSL, choose The OpenSSL binaries (/bin) directory (NOT "The Windows system directory")* @@ -96,9 +96,9 @@ 1. Download the prebuilt Windows Binary for Visual Studio 2022 - 1. 64bit: https://sourceforge.net/projects/boost/files/boost-binaries/1.74.0/boost_1_74_0-msvc-14.2-64.exe/download + 1. [64bit](https://sourceforge.net/projects/boost/files/boost-binaries/1.74.0/boost_1_74_0-msvc-14.2-64.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. [32bit](https://sourceforge.net/projects/boost/files/boost-binaries/1.74.0/boost_1_74_0-msvc-14.2-32.exe/download) 1. Add an environment variable to "System" variable named "BOOST_ROOT" and as value your Boost installation directory, e.g `E:/Programs/boost_1_74_0`. Important is to use '**/**', not '**\\**' when pointing to directory. (Make sure that it does not have a trailing slash (end of path). If you still get problems, add the same variable in the `USER` variables section too, like shown in the image below.) @@ -122,7 +122,7 @@ If you are still having problems, check: * [Join our Discord Server](https://discord.gg/gkt4y2x), but it is not a 24/7 support channel. A staff member will answer you whenever they have time. -| Installation Guide | | -| :- | :- | +| Installation Guide | | +| :- | :- | | This article is a part of the Installation Guide. You can read it alone or click on the previous link to easily move between the steps. | -| [<< Start: Installation Guide](installation.md) | [Step 2: Core Installation >>](core-installation.md) | +| [<< Start: Installation Guide](installation.md) | [Step 2: Core Installation >>](core-installation.md) | -- cgit