diff --git a/l10n/po/es_ES/README.md.po b/l10n/po/es_ES/README.md.po
new file mode 100644
index 0000000000..00a1285a69
--- /dev/null
+++ b/l10n/po/es_ES/README.md.po
@@ -0,0 +1,420 @@
+# SOME DESCRIPTIVE TITLE
+# Copyright (C) YEAR Free Software Foundation, Inc.
+# This file is distributed under the same license as the PACKAGE package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"POT-Creation-Date: 2024-02-21 15:26+0900\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"Language: es_ES\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. type: Title #
+#: upstream/README.md:1
+#, no-wrap
+msgid "Quarkus.io Website Based on Jekyll"
+msgstr ""
+
+#. type: Title ##
+#: upstream/README.md:3
+#, no-wrap
+msgid "Getting Started"
+msgstr ""
+
+#. type: Plain text
+#: upstream/README.md:6
+#, no-wrap
+msgid "These instructions will get you a copy of the Quarkus.io website up and running on your local machine for development and testing purposes.\n"
+msgstr ""
+
+#. type: Title ###
+#: upstream/README.md:7
+#, no-wrap
+msgid "Installation"
+msgstr ""
+
+#. type: Title ####
+#: upstream/README.md:9
+#, no-wrap
+msgid "Using Docker"
+msgstr ""
+
+#. type: Bullet: '1. '
+#: upstream/README.md:13
+#, no-wrap
+msgid "Install [Docker Desktop](https://docs.docker.com/install/).\n"
+msgstr ""
+
+#. type: Bullet: '3. '
+#: upstream/README.md:13 upstream/README.md:33
+#, no-wrap
+msgid "Fork the [project repository](https://github.com/quarkusio/quarkusio.github.io), then clone your fork.\n"
+msgstr ""
+
+#. type: Plain text
+#: upstream/README.md:15 upstream/README.md:35
+#, no-wrap
+msgid "        git clone git@github.com:YOUR_USER_NAME/quarkusio.github.io.git\n"
+msgstr ""
+
+#. type: Bullet: '4. '
+#: upstream/README.md:17 upstream/README.md:37
+#, no-wrap
+msgid "Change into the project directory:\n"
+msgstr ""
+
+#. type: Plain text
+#: upstream/README.md:20
+#, no-wrap
+msgid ""
+"        cd quarkusio.github.io\n"
+"4. Run Docker Composer\n"
+msgstr ""
+
+#. type: Plain text
+#: upstream/README.md:22
+#, no-wrap
+msgid "        docker-compose up\n"
+msgstr ""
+
+#. type: Bullet: '7. '
+#: upstream/README.md:24 upstream/README.md:54
+#, no-wrap
+msgid "Now browse to http://localhost:4000\n"
+msgstr ""
+
+#. type: Title ####
+#: upstream/README.md:24
+#, no-wrap
+msgid "Using a local Ruby environment"
+msgstr ""
+
+#. type: Plain text
+#: upstream/README.md:26
+#, no-wrap
+msgid "[Jekyll static site generator docs](https://jekyllrb.com/docs/).\n"
+msgstr ""
+
+#. type: Bullet: '1. '
+#: upstream/README.md:29
+#, no-wrap
+msgid "Install a full [Ruby development environment](https://jekyllrb.com/docs/installation/). If you use `rvm`, run: `rvm use 2.7.1`.\n"
+msgstr ""
+
+#. type: Bullet: '2. '
+#: upstream/README.md:29
+#, no-wrap
+msgid "Install [bundler](https://jekyllrb.com/docs/ruby-101/#bundler)  [gems](https://jekyllrb.com/docs/ruby-101/#gems)\n"
+msgstr ""
+
+#. type: Plain text
+#: upstream/README.md:31
+#, no-wrap
+msgid "        gem install bundler\n"
+msgstr ""
+
+#. type: Plain text
+#: upstream/README.md:39
+#, no-wrap
+msgid "        cd quarkusio.github.io\n"
+msgstr ""
+
+#. type: Bullet: '5. '
+#: upstream/README.md:41
+#, no-wrap
+msgid "Use bundler to fetch all required gems in their respective versions\n"
+msgstr ""
+
+#. type: Plain text
+#: upstream/README.md:43
+#, no-wrap
+msgid "        bundle install\n"
+msgstr ""
+
+#. type: Bullet: '6. '
+#: upstream/README.md:45
+#, no-wrap
+msgid "Build the site and make it available on a local server\n"
+msgstr ""
+
+#. type: Plain text
+#: upstream/README.md:47
+#, no-wrap
+msgid "        ./serve.sh\n"
+msgstr ""
+
+#. type: Plain text
+#: upstream/README.md:49
+#, no-wrap
+msgid "   Or if you want it faster and okay to not have guides included use the following:\n"
+msgstr ""
+
+#. type: Plain text
+#: upstream/README.md:51
+#, no-wrap
+msgid "        ./serve-noguides.sh\n"
+msgstr ""
+
+#. type: Plain text
+#: upstream/README.md:56
+#, no-wrap
+msgid "> If you encounter any unexpected errors during the above, please refer to the [troubleshooting](https://jekyllrb.com/docs/troubleshooting/#configuration-problems) page or the [requirements](https://jekyllrb.com/docs/installation/#requirements) page, as you might be missing development headers or other prerequisites.\n"
+msgstr ""
+
+#. type: Plain text
+#: upstream/README.md:58
+#, no-wrap
+msgid "**For more regarding the use of Jekyll, please refer to the [Jekyll Step by Step Tutorial](https://jekyllrb.com/docs/step-by-step/01-setup/).**\n"
+msgstr ""
+
+#. type: Title ###
+#: upstream/README.md:59
+#, no-wrap
+msgid "Deploying to GitHub Pages"
+msgstr ""
+
+#. type: Plain text
+#: upstream/README.md:63
+#, no-wrap
+msgid ""
+"The website deployment is automatically performed by GitHub Actions (when commits are pushed to the `develop` branch).\n"
+"If for some reason you need to deploy from your local machine, follow these instructions:\n"
+msgstr ""
+
+#. type: Bullet: '1. '
+#: upstream/README.md:66
+#, no-wrap
+msgid "Install the [act](https://github.com/nektos/act#installation) executable to run GitHub Actions locally\n"
+msgstr ""
+
+#. type: Bullet: '2. '
+#: upstream/README.md:66
+#, no-wrap
+msgid "Run `act -s GITHUB_TOKEN=<GITHUB_TOKEN>`, where *<GITHUB_TOKEN>* needs to be replaced with a token that allows you to push to the https://github.com/quarkusio/quarkusio.github.io repository.\n"
+msgstr ""
+
+#. type: Title ##
+#: upstream/README.md:67
+#, no-wrap
+msgid "Writing a blog"
+msgstr ""
+
+#. type: Plain text
+#: upstream/README.md:70
+#, no-wrap
+msgid "To write a blog:\n"
+msgstr ""
+
+#. type: Bullet: '- '
+#: upstream/README.md:73
+#, no-wrap
+msgid "create an author entry in [_data/authors.yaml](https://github.com/quarkusio/quarkusio.github.io/blob/develop/_data/authors.yaml)\n"
+msgstr ""
+
+#. type: Bullet: '  - '
+#: upstream/README.md:73
+#, no-wrap
+msgid "`emailhash` you can get by running `echo -n your@email.org | md5sum` on Linux or `echo -n your@email.org | md5` on macOS using an email you have registered from the [Gravatar service](https://gravatar.com),\n"
+msgstr ""
+
+#. type: Bullet: '- '
+#: upstream/README.md:88
+#, no-wrap
+msgid "create an blog entry under [_posts](https://github.com/quarkusio/quarkusio.github.io/tree/develop/_posts)\n"
+msgstr ""
+
+#. type: Bullet: '  - '
+#: upstream/README.md:88
+#, no-wrap
+msgid "the file name is `yyyy-mm-dd-slug.adoc` Set the date to the same value in the asciidoc preamble.\n"
+msgstr ""
+
+#. type: Bullet: '- '
+#: upstream/README.md:88
+#, no-wrap
+msgid "`tags` should be used with some care as an archive page is created for of them. Below are some basic rules to try follow:\n"
+msgstr ""
+
+#. type: Bullet: '  - '
+#: upstream/README.md:88
+#, no-wrap
+msgid "`quarkus-release` used for Quarkus release blogs\n"
+msgstr ""
+
+#. type: Bullet: '  - '
+#: upstream/README.md:88
+#, no-wrap
+msgid "`announcement` used for general announcement with some impact.\n"
+msgstr ""
+
+#. type: Bullet: '  - '
+#: upstream/README.md:88
+#, no-wrap
+msgid "`extension` used for blogs related to a specific extension.\n"
+msgstr ""
+
+#. type: Bullet: '  - '
+#: upstream/README.md:88
+#, no-wrap
+msgid "`user-story` used for stories from users/companies adopting Quarkus.\n"
+msgstr ""
+
+#. type: Bullet: '  - '
+#: upstream/README.md:88
+#, no-wrap
+msgid "`development-tips` used for blogs with tips to develop using Quarkus or Quarkus itself. \n"
+msgstr ""
+
+#. type: Bullet: '  - '
+#: upstream/README.md:88
+#, no-wrap
+msgid "add a tech specific, like `kafka`, if your post has a significant mention/relevance to that technology.\n"
+msgstr ""
+
+#. type: Bullet: '  - '
+#: upstream/README.md:88
+#, no-wrap
+msgid "tags is space separated list `tags:extension grpc`\n"
+msgstr ""
+
+#. type: Bullet: '  - '
+#: upstream/README.md:88
+#, no-wrap
+msgid "tags must be in lowercase\n"
+msgstr ""
+
+#. type: Bullet: '- '
+#: upstream/README.md:88
+#, no-wrap
+msgid "it's in asciidoc format, there is an example as shown with [2019-06-05-quarkus-and-web-ui-development-mode.adoc](https://github.com/quarkusio/quarkusio.github.io/blob/develop/_posts/2019-06-05-quarkus-and-web-ui-development-mode.adoc)\n"
+msgstr ""
+
+#. type: Bullet: '  - '
+#: upstream/README.md:88
+#, no-wrap
+msgid "Be aware that the `date` attribute in the asciidoc preamble defines when the article will be published. Add a `--future` flag when testing locally to ensure the article is included in the generated site. \n"
+msgstr ""
+
+#. type: Bullet: '- '
+#: upstream/README.md:88
+#, no-wrap
+msgid "send a pull request against the develop branch and voilà\n"
+msgstr ""
+
+#. type: Title ##
+#: upstream/README.md:89
+#, no-wrap
+msgid "Translations/Localization (l10n)"
+msgstr ""
+
+#. type: Plain text
+#: upstream/README.md:92
+#, no-wrap
+msgid "The primary site (quarkus.io) is written in English. \n"
+msgstr ""
+
+#. type: Plain text
+#: upstream/README.md:94
+#, no-wrap
+msgid "There are separate repositories for community driven localized versions of quarkus.io:\n"
+msgstr ""
+
+#. type: Bullet: '- '
+#: upstream/README.md:99
+#, no-wrap
+msgid "[ja.quarkus.io](https://github.com/quarkusio/ja.quarkus.io) for Japanese\n"
+msgstr ""
+
+#. type: Bullet: '- '
+#: upstream/README.md:99
+#, no-wrap
+msgid "[cn.quarkus.io](https://github.com/quarkusio/cn.quarkus.io) for Chinese (simplified)\n"
+msgstr ""
+
+#. type: Bullet: '- '
+#: upstream/README.md:99
+#, no-wrap
+msgid "[es.quarkus.io](https://github.com/quarkusio/es.quarkus.io) for Spanish\n"
+msgstr ""
+
+#. type: Bullet: '- '
+#: upstream/README.md:99
+#, no-wrap
+msgid "[pt.quarkus.io](https://github.com/quarkusio/pt.quarkus.io) for Brazilian Portuguese\n"
+msgstr ""
+
+#. type: Plain text
+#: upstream/README.md:102
+#, no-wrap
+msgid ""
+"If you want to contribute to those efforts read the README in those projects. If you would like to\n"
+"start another translation, please open an issue in this main repo.\n"
+msgstr ""
+
+#. type: Title ####
+#: upstream/README.md:103
+#, no-wrap
+msgid "Enable DNS for l10n site"
+msgstr ""
+
+#. type: Plain text
+#: upstream/README.md:107
+#, no-wrap
+msgid ""
+"Once a localized site has enough of its content translated, DNS needs to be enabled. To do that get one of the Red Hat admins to submit\n"
+"a ticket to IT asking for XX domain:\n"
+msgstr ""
+
+#. type: Fenced code block
+#: upstream/README.md:108
+#, no-wrap
+msgid ""
+"We need a CNAME record set up for XX.quarkus.io to have it serve out GitHub pages. \n"
+"\n"
+"The CNAME record for XX.quarkus.io should point to \"quarkusio.github.io.\".\n"
+msgstr ""
+
+#. type: Plain text
+#: upstream/README.md:115
+#, no-wrap
+msgid "See Step 5 on https://docs.github.com/en/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site for more information.\n"
+msgstr ""
+
+#. type: Title ##
+#: upstream/README.md:116
+#, no-wrap
+msgid "Contributing"
+msgstr ""
+
+#. type: Plain text
+#: upstream/README.md:119
+#, no-wrap
+msgid "Please read [CONTRIBUTING.md](https://github.com/quarkusio/quarkusio.github.io/blob/master/CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.\n"
+msgstr ""
+
+#. type: Plain text
+#: upstream/README.md:122
+#, no-wrap
+msgid ""
+"**Important:** the guides are maintained in the main Quarkus repository and pull requests should be submitted there:\n"
+"https://github.com/quarkusio/quarkus/tree/main/docs/src/main/asciidoc.\n"
+msgstr ""
+
+#. type: Title ##
+#: upstream/README.md:123
+#, no-wrap
+msgid "License"
+msgstr ""
+
+#. type: Plain text
+#: upstream/README.md:125
+#, no-wrap
+msgid "This website is licensed under the [Creative Commons Attribution 3.0](https://creativecommons.org/licenses/by/3.0/).\n"
+msgstr ""