Internet

= Internet =

== Español ==

'''Internet''' es una extensión que permite abrir enlaces web, realizar búsquedas en Internet, preparar direcciones para usar en URLs y comprobar si una dirección tiene un formato válido. Está pensada para proyectos que necesiten interactuar con páginas web o generar enlaces de forma sencilla.

=== Funciones principales ===

Esta extensión permite:

• abrir una URL en la ventana actual
• abrir una URL en una pestaña nueva
• abrir una búsqueda web a partir de un texto
• abrir un enlace de correo electrónico
• codificar texto para usarlo dentro de una URL
• decodificar texto codificado en formato URL
• comprobar si una URL es válida

=== Funcionamiento ===

La extensión actúa usando las funciones del navegador para abrir direcciones web o enlaces especiales.

Los bloques de apertura permiten:

• cargar una dirección web en la ventana actual
• abrir una dirección web en una nueva pestaña
• lanzar una búsqueda en Google con el texto indicado
• abrir el cliente de correo predeterminado mediante un enlace ''mailto''

Además, incluye bloques de transformación de texto para preparar cadenas que van a formar parte de una URL, así como un bloque de validación para comprobar si una dirección tiene un formato correcto.

=== Bloques principales ===

• '''abrir URL [URL]''': abre la dirección indicada en la ventana actual
• '''abrir URL [URL] en nueva pestaña''': abre la dirección en otra pestaña
• '''abrir búsqueda web de [TEXT]''': realiza una búsqueda en Google con el texto dado
• '''abrir correo a [EMAIL]''': abre un enlace de correo para la dirección indicada
• '''codificar URL [TEXT]''': convierte el texto a un formato seguro para URLs
• '''decodificar URL [TEXT]''': recupera el texto original desde una cadena codificada
• '''¿es válida la URL [URL]?''': devuelve si la dirección tiene un formato válido

=== Usos habituales ===

Internet resulta útil para:

• abrir páginas web desde un proyecto
• enviar al usuario a una documentación o recurso externo
• lanzar búsquedas rápidas desde la interfaz del proyecto
• preparar textos para añadirlos a enlaces
• validar direcciones antes de abrirlas
• crear botones que abran correo electrónico

=== Ejemplo ===

Un proyecto puede:

• usar '''abrir URL''' para llevar al usuario a la web oficial de BloKes
• usar '''abrir URL en nueva pestaña''' para no abandonar la página actual
• usar '''abrir búsqueda web de''' para buscar automáticamente un término escrito por el usuario
• usar '''codificar URL''' antes de construir una dirección con texto variable

Por ejemplo, si el usuario escribe ''hola mundo'', el proyecto puede codificarlo y obtener ''hola%20mundo'' para incluirlo dentro de una URL.

=== Notas ===

• El bloque de búsqueda web utiliza Google como buscador.
• El bloque de correo abre un enlace del tipo ''mailto:'' con la dirección indicada.
• El bloque de validación comprueba si la URL puede interpretarse correctamente como una dirección web.
• Si la decodificación falla porque el texto no está correctamente codificado, el bloque devuelve texto vacío.
• Esta extensión está pensada para abrir enlaces y preparar texto relacionado con URLs dentro del proyecto.

---

== English ==

'''Internet''' is an extension that allows you to open web links, perform Internet searches, prepare addresses for use in URLs, and check whether an address has a valid format. It is designed for projects that need to interact with web pages or generate links easily.

=== Main features ===

This extension allows you to:

• open a URL in the current window
• open a URL in a new tab
• open a web search from a text string
• open an email link
• encode text for use inside a URL
• decode text encoded in URL format
• check whether a URL is valid

=== How it works ===

The extension uses browser functions to open web addresses or special links.

The opening blocks allow you to:

• load a web address in the current window
• open a web address in a new tab
• launch a Google search with the given text
• open the default email client through a ''mailto'' link

It also includes text transformation blocks to prepare strings that will become part of a URL, along with a validation block to check whether an address has a correct format.

=== Main blocks ===

• '''open URL [URL]''': opens the given address in the current window
• '''open URL [URL] in new tab''': opens the address in another tab
• '''open web search for [TEXT]''': performs a Google search using the given text
• '''open email to [EMAIL]''': opens an email link for the given address
• '''encode URL [TEXT]''': converts the text to a URL-safe format
• '''decode URL [TEXT]''': restores the original text from an encoded string
• '''is URL [URL] valid?''': reports whether the address has a valid format

=== Common uses ===

Internet is useful for:

• opening web pages from a project
• sending the user to documentation or an external resource
• launching quick searches from the project interface
• preparing text to include in links
• validating addresses before opening them
• creating buttons that open email links

=== Example ===

A project can:

• use '''open URL''' to take the user to the official BloKes website
• use '''open URL in new tab''' to avoid leaving the current page
• use '''open web search for''' to automatically search for a term typed by the user
• use '''encode URL''' before building an address with variable text

For example, if the user types ''hello world'', the project can encode it and get ''hello%20world'' to include it inside a URL.

=== Notes ===

• The web search block uses Google as the search engine.
• The email block opens a ''mailto:'' link with the given address.
• The validation block checks whether the URL can be correctly interpreted as a web address.
• If decoding fails because the text is not properly encoded, the block returns an empty string.
• This extension is designed to open links and prepare URL-related text inside the project.