-
Notifications
You must be signed in to change notification settings - Fork 119
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* New translations index.md (Spanish) * New translations installing-fabric.md (Spanish) * New translations installing-mods.md (Spanish) * New translations updating-fabric.md (Spanish) * New translations contributing.md (Spanish) * New translations sidebar_translations.json (Chinese Traditional) * New translations updating-fabric.md (French) * New translations index.md (Spanish) * New translations index.md (Chinese Traditional) --------- Co-authored-by: Calum H <[email protected]>
- Loading branch information
1 parent
2310c69
commit 7498989
Showing
9 changed files
with
460 additions
and
4 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,176 @@ | ||
# Pautas de Contribución para la Documentación de Fabric | ||
|
||
Esta página web utiliza [VitePress](https://vitepress.vuejs.org/) para generar HTML estático a partir de varios archivos markdown. Debes familiarizarte con las extensiones de markdown que VitePress soporta [aquí.](https://vitepress.vuejs.org/guide/markdown.html#features) | ||
|
||
## Índice de Contenido | ||
|
||
- [Pautas de Contribución para la Documentación de Fabric](#fabric-documentation-contribution-guidelines) | ||
- [Como Contribuir](#how-to-contribute) | ||
- [Estructura de Contribuciones](#contributing-framework) | ||
- [Contribuir Contenido](#contributing-content) | ||
- [Pautas de Estilo](#style-guidelines) | ||
- [Guias para Expansiones](#guidance-for-expansion) | ||
- [Verificación de Contenido](#content-verification) | ||
- [Limpieza](#cleanup) | ||
|
||
## Como Contribuir | ||
|
||
Es recomendado que crees una nueva rama en tu bifurcación del repositorio por cada solicitud de extracción que crees. Esto facilita el manejo de multiples solicitudes de extracción al mismo tiempo. | ||
|
||
**Si quieres tener una vista previa de tus cambios localmente, necesitarás instalar [Node.js 18+](https://nodejs.org/en/)** | ||
|
||
Antes de correr cualquiera de estos comandos, asegúrate de correr `npm install` para instalar todas las dependencias. | ||
|
||
**Ejecutar el servidor de desarrollo:** | ||
|
||
Esto te permitirá ver una vista previa de tus cambios localmente en `localhost:3000`. La página se autorrefrescará cada vez que realizes cambios. | ||
|
||
```bash | ||
npm run dev | ||
``` | ||
|
||
**Construyendo la página web:** | ||
|
||
Esto compilará todos los archivos markdown en archivos HTML estáticos, los cuales estarán en `.vitepress/dist` | ||
|
||
```bash | ||
npm run build | ||
``` | ||
|
||
**Viendo la vista previa de la página web:** | ||
|
||
Esto ejecutará un servidor local en el puerto 3000 usando el contenido encontrado en `.vitepress/dist` | ||
|
||
```bash | ||
npm run preview | ||
``` | ||
|
||
## Estructura de Contribuciones | ||
|
||
La estructura o "Framework" se refiere a la estructura interna de la página web. Cualquier solicitud de extracción que modifique la estructura interna de la página web debe ser etiquetada con la etiqueta `framework`. | ||
|
||
En realidad solo deberías realizar solicitudes de extracción para la estructura después de consultar con el equipo de documentación en el servidor de [Discord de Fabric](https://discord.gg/v6v4pMv) o mediante una propuesta. | ||
|
||
**Nota: Modificar la configuración de los archivos de la barra lateral o la barra de navegación no cuenta como una solicitud de extracción de estructura.** | ||
|
||
## Contribuir Contenido | ||
|
||
La contribución de contenido es la manera principal para contribuir a la Documentación de Fabric. | ||
|
||
Todo el contenido debe seguir nuestras pautas de estilo. | ||
|
||
### Pautas de Estilo | ||
|
||
Todas las páginas de la Documentación de Fabric deben seguir las pautas de estilo. Si no estás seguro sobre cualquier cosa, puedes preguntar en el servidor de [Discord de Fabric](https://discord.gg/v6v4pMv) o mediante las Discusiones de Github. | ||
|
||
La guía de estilo es la siguiente: | ||
|
||
1. Todas las páginas deben tener un título y una descripción como o en el asunto. | ||
|
||
```md | ||
--- | ||
title: Este es el título de la página | ||
description: Esta es la descripción de la página | ||
authors: | ||
- UsuarioDeGithubAquí | ||
--- | ||
|
||
# ... | ||
``` | ||
|
||
2. Si quieres crear o modificar páginas que contengan código, debes coloar el código en un lugar apropiado dentro del mod de referencia (localizado en el folder `/reference` del repositorio). Luego, utiliza la [funcionalidad de fragmentos de código ofrecida por VitePress](https://vitepress.dev/guide/markdown#import-code-snippets) para adjuntar el código, o si necesitas mayor control, puedes usar la [funcionalidad de transcluir de `markdown-it-vuepress-code-snippet-enhanced`](https://github.com/fabioaanthony/markdown-it-vuepress-code-snippet-enhanced). | ||
|
||
**Por ejemplo:** | ||
|
||
```md | ||
<<< @/reference/latest/src/main/java/com/example/docs/FabricDocsReference.java{15-21 java} | ||
``` | ||
|
||
Esto adjuntará las líneas 15-21 del archivo `FabricDocsReference.java` del mod de referencia. | ||
|
||
El fragmento de código resultante se verá así: | ||
|
||
```java | ||
@Override | ||
public void onInitialize() { | ||
// This code runs as soon as Minecraft is in a mod-load-ready state. | ||
// However, some things (like resources) may still be uninitialized. | ||
// Proceed with mild caution. | ||
|
||
LOGGER.info("Hello Fabric world!"); | ||
} | ||
``` | ||
|
||
**Ejemplo de translcuir:** | ||
|
||
```md | ||
@[code transcludeWith=#test_transclude](@/reference/.../blah.java) | ||
``` | ||
|
||
Esto adjuntará las secciones de `blah.java` marcadas con la etiqueta `#test_transclude`. | ||
|
||
Por ejemplo: | ||
|
||
```java | ||
public final String test = "Bye World!" | ||
|
||
// #test_transclude | ||
public void test() { | ||
System.out.println("Hello World!"); | ||
} | ||
// #test_transclude | ||
``` | ||
|
||
Solo se adjuntará el código entre las etiquetas de `#test_transclude`. | ||
|
||
```java | ||
public void test() { | ||
System.out.println("Hello World!"); | ||
} | ||
``` | ||
|
||
3. Seguimos las reglas gramáticas del Inglés Estadounidense. Aunque puedes usar [LanguageTool](https://languagetool.org/) para verificar tu gramática mientras que escribes, no te estreses mucho por ello. Nuestro equipo de documentación verificará y corregirá la gramática durante la etapa de limpieza. Sin embargo, puedes ahorrarnos tiempo tomando esfuerzo en escribir bien. | ||
|
||
4. Si estás creando una nueva sección, debes crear una nueva barra lateral en el folder de `.vitepress/sidebars` y agregarla en el archivo `config.mts`. Si necesitas ayuda con esto, puedes preguntar en el canal de `#wiki` en el servidor de [Discord de Fabric](https://discord.gg/v6v4pMv). | ||
|
||
5. Cuando crees una nueva página, debes agregarla a la barra lateral correspondiente en el folder de `.vitepress/sidebars`. De nuevo, si necesitas ayuda, pregunta en el servidor de Discord de Fabric, en el canal de `#wiki`. | ||
|
||
6. Cualquier imagen debe ser colocada en un lugar apropiado en el folder de `/assets`. | ||
|
||
7. ⚠️ **Cuando enlaces a otras páginas, usa links relativos.** ⚠️ | ||
|
||
Esto es debido al sistema de versiones presente, el cual procesará los links para agregar la versión antes. Si usas links absolutos, el número de versión no será agregado al link. | ||
|
||
Por ejemplo, para una página en el folder de `/players`, enlazar a la página de `installing-fabric` encontrada en `/players/installing-fabric.md` requerirá de lo siguiente: | ||
|
||
```md | ||
[Esto es un link a otra página](./installing-fabric.md) | ||
``` | ||
|
||
**NO** hagas lo siguiente: | ||
|
||
```md | ||
[Esto es un link a otra página](/player/installing-fabric) | ||
``` | ||
|
||
Todas las contribuciones de contenido pasa por tres etapas: | ||
|
||
1. Guías para expansiones (si es posible) | ||
2. Verificación de Contenido | ||
3. Limpieza (Gramática etc.) | ||
|
||
### Guías para Expansiones | ||
|
||
Si el equipo de documentación piensa que puedes expandir tu solicitud de extracción en cuanto al contenido, un miembro del equipo añadirá la etiqueta `expansion` a tu solicitud de extracción junto con un comentario explicando lo que el miembro de equipo piensa que puedes hacer para expandir tu solicitud. Si estás de acuerdo con la sugerencia, puedes expandir tu solicitud de extracción. | ||
|
||
**No te sientas presionado en expandir tu solicitud de extracción.** Si no quieres expandirla, simplemente puedes pedir que se te remueva la etiqueta de `expansion`. | ||
|
||
Si no quieres expandir tu solicitud de extracción, pero quisieras que otra persona lo expanda después, es mejor crear una propuesta en la [Página de Propuestas](https://github.com/FabricMC/fabric-docs/issues) y explicar lo que quisieras que se expanda. | ||
|
||
### Verificación de Contenido | ||
|
||
Todas las solicitudes de extracción pasan por verificación de contenido. Esta etapa es la más importante, ya que asegura que el contenido es correcto y sigue las Pautas de Estilo de Documentación de Fabric. | ||
|
||
### Limpieza | ||
|
||
¡En esta etapa, el equipo de documentación arreglará problemas con la gramática y hará cualquier otros cambios lingüísticos necesarios antes de aceptar la solicitud de extracción! |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,12 @@ | ||
--- | ||
title: Guías para Jugadores | ||
description: Una colección de guías para jugadores y administradores sobre la instalación y el uso de Fabric. | ||
--- | ||
|
||
# Guías para Jugadores | ||
|
||
Esta sección de la Documentación de Fabric está dedicada con jugadores y administradores de servidores que quieren aprender sobre como instalar, y usar, y solucionar problemas relacionados con Fabric. | ||
|
||
Puedes consultar la barra lateral para una lista de las guías disponibles. | ||
|
||
Si encuentras problemas, por favor repórtalos [en GitHub](https://github.com/FabricMC/fabric-docs) o pide ayuda en el servidor de [Discord de Fabric](https://discord.gg/v6v4pMv), en el canal de `#player-support` o `#server-admin-support`. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,55 @@ | ||
--- | ||
title: Instalar Fabric | ||
description: Una guía paso a paso sobre como instalar Fabric. | ||
authors: | ||
- IMB11 | ||
--- | ||
|
||
# Instalar Fabric | ||
|
||
Esta guía te enseñará sobre como instalar Fabric usando el launcher oficial de Minecraft. | ||
|
||
Para launchers o lanzadores de terceros, deberías consultar su documentación. | ||
|
||
## 1. Descarga el instalador de Fabric | ||
|
||
Puedes descargar el instalador de Fabric desde la [Página web de Fabric](https://fabricmc.net/use/). | ||
|
||
Si estás en Windows, descarga el archivo `.exe` (`Download For Windows`), ya que este no requiere que Java esté instalado en tu sistema. Este en cambio usa la instalación de Java que viene con el launcher oficial. | ||
|
||
Si estás en macOS o Linux, descarga la versión `.jar`. En algunas ocasiones, necesitarás instalar Java antes de este paso. | ||
|
||
## 2. Corre el instalador de Fabric | ||
|
||
:::warning | ||
Cierra Minecraft y el Launcher de Minecraft antes de la instalación. | ||
::: | ||
|
||
:::details Información para usuarios de MacOS | ||
|
||
En macOS, puede que tengas que hacer clic derecho en el archivo `.jar` en tu folder de descargas y hacer clic en `Abrir` para correrlo. | ||
|
||
![Instalador de Fabric con "Instalar" remarcado.](/assets/players/installing-fabric/macos-downloads.png) | ||
|
||
Cuando aparezca la pregunta "¿Estás seguro de que quieres abrirlo?", has clic en `Abrir` de nuevo. | ||
::: | ||
|
||
Una vez abierto el instalador, deberías ver una pantalla como la siguiente: | ||
|
||
![Instalador de Fabric con "Instalar" remarcado.](/assets/players/installing-fabric/installer-screen.png) | ||
|
||
Para instalar Fabric, simplemente escoge tu versión del juego desde el menú deslizador, y cliquea en `Instalar`. | ||
|
||
**Asegurate de que la opción 'Crear Perfil' esté escogida.** | ||
|
||
## 3. ¡Hemos terminado! | ||
|
||
¡Una vez que la instalación haya terminado, puedes abrir el Launcher de Minecraft y seleccionar el perfil de Fabric desde el menú deslizador en la esquina inferior izquierda y presionar Jugar! | ||
|
||
![Launcher de Minecraft con el perfil de Fabric seleccionado](/assets/players/installing-fabric/launcher-screen.png) | ||
|
||
## Siguientes Pasos | ||
|
||
¡Ahora que has instalado Fabric, puedes agregar mods a tu juego! Hecha un vistazo a la guía para [Encontrar Mods](./finding-mods.md) para más información. | ||
|
||
Si encuentras problemas tratando de seguir esta guía, puedes solicitar ayuda en el servidor de [Discord de Fabric](https://discord.gg/v6v4pMv), en el canal de `#player-support`. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,67 @@ | ||
--- | ||
title: Instalar Mods | ||
description: Una guía paso a paso sobre como instalar mods para Fabric. | ||
authors: | ||
- IMB11 | ||
--- | ||
|
||
# Instalar Mods | ||
|
||
Esta guía te enseñará sobre como instalar mods para Fabric usando el Launcher de Minecraft. | ||
|
||
Para launchers o lanzadores de terceros, consulta su documentación. | ||
|
||
## 1. Descarga el Mod | ||
|
||
:::warning | ||
Solo deberías descargar mods desde fuentes en las que confíes. Para más información sobre como encontrar mods, visita la guía sobre [Encontrar Mods](./finding-mods.md). | ||
::: | ||
|
||
La mayoría de los mods requieren Fabric API, el cual puede ser descargado desde [Modrinth](https://modrinth.com/mod/fabric-api) o [CurseForge](https://curseforge.com/minecraft/mc-mods/fabric-api) | ||
|
||
Cuando descargues mods, asegúrate que: | ||
|
||
- Son compatibles con la versión de Minecraft en la que juegues. Por ejemplo, un mod que funcione en la versión 1.20, puede que no funcione en la versión 1.20.2. | ||
- Son hechos para Fabric y no otro lanzador de mods (mod loader). | ||
- Finalmente, que sean compatibles con la edición de Minecraft correcta (Edición de Java). | ||
|
||
## 2. Mueve el archivo del mod al folder de `mods`. | ||
|
||
El folder de mods puede ser encontrado en las siguientes localizaciones dependiendo de tu sistema operativo. | ||
|
||
Usualmente puedes copiar y pegar estas direcciones de archivo en la barra de direcciones de tu explorador de archivos para encontrar el folder rápidamente. | ||
|
||
::: code-group | ||
|
||
```:no-line-numbers [Windows] | ||
%appdata%\.minecraft\mods | ||
``` | ||
|
||
```:no-line-numbers [macOS] | ||
~/Library/Application Support/minecraft/mods | ||
``` | ||
|
||
```:no-line-numbers [Linux] | ||
~/.minecraft/mods | ||
``` | ||
|
||
::: | ||
|
||
Una vez que hayas encontrado el folder de `mods`, puedes colocar el archivo `.jar` del mod ahí. | ||
|
||
![Mods instalados en el folder de mods.](/assets/players/installing-mods.png) | ||
|
||
## 3. ¡Hemos terminado! | ||
|
||
¡Una vez que hayas movido los mods al folder de `mods`, puedes abrir el Launcher de Minecraft, seleccionar el perfil de Fabric desde el menú deslizador en la esquina inferior izquierda y presionar Jugar! | ||
|
||
![Launcher de Minecraft con el perfil de Fabric seleccionado.](/assets/players/installing-fabric/launcher-screen.png) | ||
|
||
## Solucionar Problemas | ||
|
||
Si encuentras problemas tratando de seguir esta guía, puedes solicitar ayuda en el servidor de [Discord de Fabric](https://discord.gg/v6v4pMv), en el canal de `#player-support`. | ||
|
||
También puedes intentar solucionar el problema tu mismo leyendo las guías sobre como solucionar problemas: | ||
|
||
- [Reportes de Crasheo](./troubleshooting/crash-reports.md) | ||
- [Subir Logs](./troubleshooting/uploading-logs.md) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,41 @@ | ||
--- | ||
title: Actualizar Fabric | ||
description: Una guía paso a paso sobre como actualizar Fabric. | ||
authors: | ||
- IMB11 | ||
- modmuss50 | ||
--- | ||
|
||
# Actualizar Fabric | ||
|
||
Esta guía te enseñará como actualizar Fabric desde el Launcher de Minecraft. | ||
|
||
Para launchers o lanzadores de terceros, consulta su documentación. | ||
|
||
El proceso de actualizar Fabric es muy similar al proceso de la instalación de Fabric, por lo que parte de esta guía será la misma que la guía sobre como [Instalar Fabric](./installing-fabric.md). | ||
|
||
## ¿Porque debería actualizar mi lanzador Fabric? | ||
|
||
Mods más recientes pueden requerir una versión del Lanzador de Fabric más reciente, así que es importante que lo mantengas actualizado para que puedas usar los mods mas recientes. | ||
|
||
<!-- Include steps from installing guide, no need to repeat them. --> | ||
|
||
<!--@include: ./installing-fabric.md{12,41}--> | ||
|
||
Para actualizar Fabric, simplemente asegurate que la versión del juego y la versión del lanzador de Fabric sean las correctas, y haz click en `Instalar`. | ||
|
||
**Asegurate de no tener la opción `Crear Perfil` seleccionada en el instalador, de otro modo, se creará un nuevo perfil, cosa que no necesitamos en este caso.** | ||
|
||
## 3. Abre el Perfil en el Launcher de Minecraft | ||
|
||
Una vez que la instalación haya terminado, puedes abrir el Launcher de Minecraft e ir a la pestaña de `Instalaciones`. Debes ir a tu perfil de Fabric y abrir la pantalla de edición. | ||
|
||
Reemplaza la versión con la nueva versión del lanzador de Fabric que acabas de instalar, y presiona `Guardar`. | ||
|
||
![Actualizando la versión de Fabric en el Launcher de Minecraft.](/assets/players/updating-fabric.png) | ||
|
||
## 4. ¡Hemos terminado! | ||
|
||
¡Una vez completado los pasos, puedes regresar a la pestaña de `Jugar`, seleccionar el perfil de Fabric desde el menú deslizador en la esquina inferior izquierda y presionar Jugar! | ||
|
||
Si encuentras problemas tratando de seguir esta guía, puedes solicitar ayuda en el servidor de [Discord de Fabric](https://discord.gg/v6v4pMv), en el canal de `#player-support`. |
Oops, something went wrong.