From 9be3449acfdaff24c3555352a248039476d3be1a Mon Sep 17 00:00:00 2001 From: Matthew Rathbone Date: Mon, 12 Jan 2026 11:59:12 -0600 Subject: [PATCH] feat(docs): add i18n support with Spanish translations - Add mkdocs-static-i18n plugin for multi-language support - Configure 10 language support (en, es, pt-BR, de, fr, el, ja, it, ko, id) - Add Spanish translations for index.md and getting-started-guide.md - Update mkdocs-material to 9.7.1 Co-Authored-By: Claude Opus 4.5 --- docs/getting-started-guide.es.md | 104 +++++++++++++++++++++++++++++++ docs/index.es.md | 25 ++++++++ mkdocs.yml | 16 ++++- requirements.txt | 5 +- 4 files changed, 147 insertions(+), 3 deletions(-) create mode 100644 docs/getting-started-guide.es.md create mode 100644 docs/index.es.md diff --git a/docs/getting-started-guide.es.md b/docs/getting-started-guide.es.md new file mode 100644 index 000000000..aac10f122 --- /dev/null +++ b/docs/getting-started-guide.es.md @@ -0,0 +1,104 @@ +--- +title: Guia para principiantes +summary: "Esta guia te ayudara a configurar y usar Beekeeper Studio por primera vez. No te preocupes, es bastante sencillo. :-)" +old_url: "https://docs.beekeeperstudio.io/docs/getting-started-guide" +--- + +Hola y bienvenido a la comunidad de Beekeeper Studio. Creo que te va a gustar estar aqui. + +Beekeeper Studio es mas que una aplicacion, ven a saludar: + +- [Unete al grupo de Slack de la comunidad](https://beekeeperstudio.io/slack) +- [Explora las solicitudes de funciones en Github](https://github.com/beekeeper-studio/beekeeper-studio) + + + +!!! note "Hola!" + Esta pagina te ayudara a familiarizarte con Beekeeper Studio. Si has usado aplicaciones similares en el pasado, sientete libre de explorar el resto del sitio de documentacion, o simplemente comienza a usar Beekeeper Studio (es bastante intuitivo!) + + +Si eres nuevo en las aplicaciones de gestion de bases de datos en general, puede ser util ver este recorrido por Beekeeper Studio, donde repaso varias funciones importantes + + + +[Ver el recorrido de Beekeeper Studio en YouTube](https://www.youtube.com/watch?v=id37-ZRZNkQ) + +## Primer paso - instalar Beekeeper Studio + + +Beekeeper Studio es una aplicacion de escritorio, asi que el primer paso es [Instalar Beekeeper Studio](./installation/index.md) + + + +## Exploremos Beekeeper Studio con una base de datos de demostracion + +Una forma rapida y facil de explorar la funcionalidad de Beekeeper Studio es con la base de datos de demostracion `Sakila` -- es una base de datos de ejemplo que modela una antigua tienda de alquiler de DVD, como un Blockbuster. + + +!!! tip "Los expertos pueden saltar al final" + Si ya tienes una base de datos que quieres ver, editar y consultar, adelante! + + Estos temas te ayudaran a comenzar con las funciones mas utilizadas de Beekeeper Studio + + - [Conectarse a una base de datos](./user_guide/connecting/connecting.md) + - [Escribir SQL](./user_guide/sql_editor/editor.md) + - [Explorar y editar datos de tablas](./user_guide/editing-data.md) + - [Crear y modificar tablas](./user_guide/modify-tables.md) + + +### Comenzando con Sakila y Beekeeper Studio + +1. Asegurate de tener Beekeeper Studio [descargado e instalado](./installation/index.md) +1. [Descarga la base de datos Sakila](https://github.com/ivanceras/sakila/raw/master/sqlite-sakila-db/sakila.db) - este es un archivo `.db` - un archivo de base de datos SQLite autocontenido. +2. Haz doble clic en el archivo `sakila.db` que acabas de descargar. + +Beekeeper se abrira, mostrandote el contenido de la base de datos: + +![Abriendo la base de datos de demostracion en Beekeeper Studio](./assets/images/getting-started-guide-60.gif) + +### Abre una tabla y cambia algunos datos + +Haz doble clic en la tabla `film` en la barra lateral izquierda. Esto abrira la vista de datos para esa tabla. + +Recuerda - esta es solo una base de datos de demostracion, puedes hacer lo que quieras con ella sin ningun riesgo. Intenta hacer clic en la celda `title` de una pelicula y cambiar el nombre de la pelicula. Puedes guardar tus cambios haciendo clic en el boton `apply` en el pie de pagina. + + +![Haz clic en apply para guardar los cambios](./assets/images/getting-started-guide-61.gif) + +### Escribe tu primera consulta SQL + +Ahora que sabes como ver y editar datos de tablas, por que no escribir algo de SQL personalizado para extraer datos interesantes de la base de datos. + +Aqui hay una consulta de ejemplo para contar el numero de peliculas en la base de datos agrupadas por clasificacion (como PG-13): + +```sql +SELECT + film.rating, COUNT(DISTINCT inventory.film_id) AS film_count + FROM film JOIN inventory + ON film.film_id = inventory.film_id + GROUP BY film.rating + ORDER BY COUNT(inventory.film_id) DESC +``` + +Ejecutar esto produce el siguiente resultado: + +| rating | film_count | +|--------|------------| +| PG-13 | 213 | +| NC-17 | 202 | +| PG | 183 | +| R | 189 | +| G | 171 | + +### Explora otras funciones de Beekeeper Studio + +Es hora de volar del nido y explorar Beekeeper Studio por tu cuenta. + +- Intenta [crear una nueva tabla](./user_guide/modify-tables.md) +- Quizas [exportar algunos datos a Excel](./user_guide/data-export.md) +- Tambien revisa [embellecer tus resultados con Query Magics](./user_guide/query-magics.md) + + +## Contactanos si necesitas ayuda + +Atascado? Confundido? Envianos un correo y te ayudaremos - [support@beekeeperstudio.io](mailto:support@beekeeperstudio.io) diff --git a/docs/index.es.md b/docs/index.es.md new file mode 100644 index 000000000..4d73273e6 --- /dev/null +++ b/docs/index.es.md @@ -0,0 +1,25 @@ +--- +title: Introduccion a Beekeeper Studio +summary: "Beekeeper Studio es una interfaz grafica SQL moderna y facil de usar, y un gestor de bases de datos disponible para MacOS, Windows y Linux." +old_url: "https://docs.beekeeperstudio.io/docs/introduction" +--- + +## Que es Beekeeper Studio? + +Beekeeper Studio es un gestor de bases de datos e interfaz grafica SQL. Es una aplicacion de escritorio facil de usar. Es una alternativa visual a las herramientas de linea de comandos como `psql` o `mysql`, y ademas proporciona muchas funciones adicionales utiles. + + +![Vista previa de Beekeeper Studio](./assets/images/introduction-1.png) + +### Bases de datos compatibles con Beekeeper Studio + +{% include-markdown "./includes/supported_databases.md" %} + +### Plataformas compatibles con Beekeeper Studio + +Beekeeper Studio esta disponible para computadoras portatiles y de escritorio con [MacOS](./installation/macos-m1-intel.md), [Windows](./installation/windows.md) y [Linux](./installation/linux.md). + +Es importante destacar que Beekeeper Studio ofrece **paridad total de funciones** en todos los sistemas operativos compatibles. + +Lamentablemente, actualmente no tenemos planes de portar Beekeeper Studio a dispositivos iOS o Android. + diff --git a/mkdocs.yml b/mkdocs.yml index 61b807d8d..1d46b8046 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -15,6 +15,7 @@ extra: name: Beekeeper Studio on GitHub generator: false theme: + language: en logo: assets/bks.svg favicon: assets/favicon-96x96.png name: material @@ -23,7 +24,7 @@ theme: font: text: Rubik features: - - navigation.instant + # - navigation.instant - broken with i18n # - navigation.tabs - navigation.tabs.sticky - navigation.tracking @@ -50,6 +51,19 @@ extra_javascript: plugins: - search - include-markdown + - i18n: + docs_structure: suffix + fallback_to_default: true + reconfigure_material: true + reconfigure_search: true + languages: + - locale: en + default: true + name: English + build: true + - locale: es + name: Espanol + build: true # - social: # cards_layout_options: # background_color: "#2c2c2c" diff --git a/requirements.txt b/requirements.txt index 49fc2b6ba..6fd667e22 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,4 +1,5 @@ -mkdocs-material==9.6.14 +mkdocs-material==9.7.1 mkdocs-material[imaging] mkdocs-include-markdown-plugin -mkdocs-ini-includer >= 1.1.0 \ No newline at end of file +mkdocs-ini-includer >= 1.1.0 +mkdocs-static-i18n>=1.2.0 \ No newline at end of file