From a8ec4b64a3837d5385a15304ae9656ed6236aea6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=81lvaro=20Mond=C3=A9jar?= Date: Fri, 7 May 2021 15:57:19 +0200 Subject: [PATCH] Add 'es' themes translations Document that, when a new translation is added for a theme, the documentation about the theme must be updated. --- docs/about/release-notes.md | 4 +- docs/dev-guide/translations.md | 10 +- docs/user-guide/choosing-your-theme.md | 2 + .../mkdocs/locales/es/LC_MESSAGES/messages.po | 98 +++++++++++++++++++ .../locales/es/LC_MESSAGES/messages.po | 98 +++++++++++++++++++ 5 files changed, 209 insertions(+), 3 deletions(-) create mode 100644 mkdocs/themes/mkdocs/locales/es/LC_MESSAGES/messages.po create mode 100644 mkdocs/themes/readthedocs/locales/es/LC_MESSAGES/messages.po diff --git a/docs/about/release-notes.md b/docs/about/release-notes.md index 0a62258677..d121b81c86 100644 --- a/docs/about/release-notes.md +++ b/docs/about/release-notes.md @@ -29,8 +29,8 @@ The current and past members of the MkDocs team. The `mkdocs` and `readthedocs` themes now support language localization using the `theme.locale` parameter, which defaults to `en` (English). The only other -supported language in this release is `fr` (French). For details on using the -provided translations, see the [user +supported languages in this release are `fr` (French) and `es` (Spanish). For +details on using the provided translations, see the [user guide](../user-guide/localizing-your-theme.md). Note that translation will not happen by default. Users must first install the necessary dependencies with the following command: diff --git a/docs/dev-guide/translations.md b/docs/dev-guide/translations.md index a09a8e1a8a..95ad8bd167 100644 --- a/docs/dev-guide/translations.md +++ b/docs/dev-guide/translations.md @@ -66,7 +66,9 @@ Here is a quick summary of what you'll need to do: placeholder in the localized catalogs. 3. [Locally serve and test](#testing-theme-translations) the translated themes for your language. -4. [Contribute your translation](#contributing-translations) through a +4. [Update the documentation](#updating-theme-documentation) about + supported translations for each translated theme. +5. [Contribute your translation](#contributing-translations) through a Pull Request. !!! note @@ -203,6 +205,12 @@ Finally, run `mkdocs serve` to check out your new localized version of the theme the `locale` setting in the `mkdocs.yml` file before submitting your changes. +## Updating theme documentation + +Update the lists of supported translations for each translated theme located at +[Choosing your theme](../user-guide/choosing-your-theme.md) +(`docs/user-guide/choosing-your-theme.md`), in their __`locale`__ options. + ## Contributing translations It is now time for you to [contribute](../about/contributing.md) your nice work diff --git a/docs/user-guide/choosing-your-theme.md b/docs/user-guide/choosing-your-theme.md index 2be247b501..e0b03ab1a7 100644 --- a/docs/user-guide/choosing-your-theme.md +++ b/docs/user-guide/choosing-your-theme.md @@ -85,6 +85,7 @@ supports the following options: * `en`: English (default) * `fr`: French + * `es`: Spanish See the guide on [localizing your theme] for more information. @@ -141,6 +142,7 @@ theme supports the following options: * `en`: English (default) * `fr`: French + * `es`: Spanish See the guide on [localizing your theme] for more information. diff --git a/mkdocs/themes/mkdocs/locales/es/LC_MESSAGES/messages.po b/mkdocs/themes/mkdocs/locales/es/LC_MESSAGES/messages.po new file mode 100644 index 0000000000..5743383f2f --- /dev/null +++ b/mkdocs/themes/mkdocs/locales/es/LC_MESSAGES/messages.po @@ -0,0 +1,98 @@ +# Spanish translations for MkDocs. +# Copyright (C) 2021 MkDocs +# This file is distributed under the same license as the MkDocs project. +# +msgid "" +msgstr "" +"Project-Id-Version: MkDocs 1.2\n" +"Report-Msgid-Bugs-To: https://github.com/mkdocs/mkdocs/issues\n" +"POT-Creation-Date: 2021-04-08 22:44+0200\n" +"PO-Revision-Date: 2021-05-07 12:06+0200\n" +"Last-Translator: Álvaro Mondéjar Rubio \n" +"Language: es\n" +"Language-Team: es\n" +"Plural-Forms: nplurals=2; plural=(n != 1)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.9.1\n" + +#: mkdocs/themes/mkdocs/404.html:8 +msgid "Page not found" +msgstr "Página no encontrada" + +#: mkdocs/themes/mkdocs/base.html:107 +#: mkdocs/themes/mkdocs/keyboard-modal.html:31 +#: mkdocs/themes/mkdocs/search-modal.html:5 +msgid "Search" +msgstr "Buscar" + +#: mkdocs/themes/mkdocs/base.html:117 +msgid "Previous" +msgstr "Anterior" + +#: mkdocs/themes/mkdocs/base.html:122 +msgid "Next" +msgstr "Siguiente" + +#: mkdocs/themes/mkdocs/base.html:133 mkdocs/themes/mkdocs/base.html:135 +#: mkdocs/themes/mkdocs/base.html:137 mkdocs/themes/mkdocs/base.html:139 +#, python-format +msgid "Edit on %(repo_name)s" +msgstr "Editar en %(repo_name)s" + +#: mkdocs/themes/mkdocs/base.html:179 +#, python-format +msgid "Documentation built with %(mkdocs_link)s." +msgstr "Documentación construida con %(mkdocs_link)s." + +#: mkdocs/themes/mkdocs/keyboard-modal.html:5 +msgid "Keyboard Shortcuts" +msgstr "Atajos de teclado" + +#: mkdocs/themes/mkdocs/keyboard-modal.html:6 +#: mkdocs/themes/mkdocs/search-modal.html:6 +msgid "Close" +msgstr "Cerrar" + +#: mkdocs/themes/mkdocs/keyboard-modal.html:12 +msgid "Keys" +msgstr "Teclas" + +#: mkdocs/themes/mkdocs/keyboard-modal.html:13 +msgid "Action" +msgstr "Acción" + +#: mkdocs/themes/mkdocs/keyboard-modal.html:19 +msgid "Open this help" +msgstr "Abrir esta ayuda" + +#: mkdocs/themes/mkdocs/keyboard-modal.html:23 +msgid "Next page" +msgstr "Página siguiente" + +#: mkdocs/themes/mkdocs/keyboard-modal.html:27 +msgid "Previous page" +msgstr "Página anterior" + +#: mkdocs/themes/mkdocs/search-modal.html:9 +msgid "From here you can search these documents. Enter your search terms below." +msgstr "" +"Desde aquí puede buscar estos documentos. Ingrese sus términos de búsqueda a " +"continuación." + +#: mkdocs/themes/mkdocs/search-modal.html:12 +msgid "Search..." +msgstr "Buscando..." + +#: mkdocs/themes/mkdocs/search-modal.html:12 +msgid "Type search term here" +msgstr "Escriba el término de búsqueda aquí" + +#: mkdocs/themes/mkdocs/search-modal.html:15 +msgid "No results found" +msgstr "No se encontraron resultados" + +#: mkdocs/themes/mkdocs/toc.html:3 +msgid "Table of Contents" +msgstr "Tabla de contenidos" diff --git a/mkdocs/themes/readthedocs/locales/es/LC_MESSAGES/messages.po b/mkdocs/themes/readthedocs/locales/es/LC_MESSAGES/messages.po new file mode 100644 index 0000000000..5743383f2f --- /dev/null +++ b/mkdocs/themes/readthedocs/locales/es/LC_MESSAGES/messages.po @@ -0,0 +1,98 @@ +# Spanish translations for MkDocs. +# Copyright (C) 2021 MkDocs +# This file is distributed under the same license as the MkDocs project. +# +msgid "" +msgstr "" +"Project-Id-Version: MkDocs 1.2\n" +"Report-Msgid-Bugs-To: https://github.com/mkdocs/mkdocs/issues\n" +"POT-Creation-Date: 2021-04-08 22:44+0200\n" +"PO-Revision-Date: 2021-05-07 12:06+0200\n" +"Last-Translator: Álvaro Mondéjar Rubio \n" +"Language: es\n" +"Language-Team: es\n" +"Plural-Forms: nplurals=2; plural=(n != 1)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.9.1\n" + +#: mkdocs/themes/mkdocs/404.html:8 +msgid "Page not found" +msgstr "Página no encontrada" + +#: mkdocs/themes/mkdocs/base.html:107 +#: mkdocs/themes/mkdocs/keyboard-modal.html:31 +#: mkdocs/themes/mkdocs/search-modal.html:5 +msgid "Search" +msgstr "Buscar" + +#: mkdocs/themes/mkdocs/base.html:117 +msgid "Previous" +msgstr "Anterior" + +#: mkdocs/themes/mkdocs/base.html:122 +msgid "Next" +msgstr "Siguiente" + +#: mkdocs/themes/mkdocs/base.html:133 mkdocs/themes/mkdocs/base.html:135 +#: mkdocs/themes/mkdocs/base.html:137 mkdocs/themes/mkdocs/base.html:139 +#, python-format +msgid "Edit on %(repo_name)s" +msgstr "Editar en %(repo_name)s" + +#: mkdocs/themes/mkdocs/base.html:179 +#, python-format +msgid "Documentation built with %(mkdocs_link)s." +msgstr "Documentación construida con %(mkdocs_link)s." + +#: mkdocs/themes/mkdocs/keyboard-modal.html:5 +msgid "Keyboard Shortcuts" +msgstr "Atajos de teclado" + +#: mkdocs/themes/mkdocs/keyboard-modal.html:6 +#: mkdocs/themes/mkdocs/search-modal.html:6 +msgid "Close" +msgstr "Cerrar" + +#: mkdocs/themes/mkdocs/keyboard-modal.html:12 +msgid "Keys" +msgstr "Teclas" + +#: mkdocs/themes/mkdocs/keyboard-modal.html:13 +msgid "Action" +msgstr "Acción" + +#: mkdocs/themes/mkdocs/keyboard-modal.html:19 +msgid "Open this help" +msgstr "Abrir esta ayuda" + +#: mkdocs/themes/mkdocs/keyboard-modal.html:23 +msgid "Next page" +msgstr "Página siguiente" + +#: mkdocs/themes/mkdocs/keyboard-modal.html:27 +msgid "Previous page" +msgstr "Página anterior" + +#: mkdocs/themes/mkdocs/search-modal.html:9 +msgid "From here you can search these documents. Enter your search terms below." +msgstr "" +"Desde aquí puede buscar estos documentos. Ingrese sus términos de búsqueda a " +"continuación." + +#: mkdocs/themes/mkdocs/search-modal.html:12 +msgid "Search..." +msgstr "Buscando..." + +#: mkdocs/themes/mkdocs/search-modal.html:12 +msgid "Type search term here" +msgstr "Escriba el término de búsqueda aquí" + +#: mkdocs/themes/mkdocs/search-modal.html:15 +msgid "No results found" +msgstr "No se encontraron resultados" + +#: mkdocs/themes/mkdocs/toc.html:3 +msgid "Table of Contents" +msgstr "Tabla de contenidos"