Merge pull request #14 from Salomon-Mazatlan/patch-4

Update 2.1.-Installation.md

Author: ccbogel

docs/doc/es/2.1.-Installation.md

@@ -2,79 +2,95 @@
 path: 2.1.-Installation
 ---
 
-# QualCoder Installation and running instructions
+# Instrucciones de Instalación y ejecución de QualCoder
 
-## INSTALLATION 
+## INSTALACIÓN
 
-For the manual installations (using the command line or terminal) I mention a specific release version, for example version 3.7. Please check on the [releases page](https://github.com/ccbogel/QualCoder/releases) for the most current version, as it may be newer. 
+Para las instalaciones manuales (mediante la línea de comandos o terminal), se hace referencia a una versión específica de lanzamiento (por ejemplo, la versión 3.7). Le recomendamos consultar la [página de lanzamientos (releases)](https://github.com/ccbogel/QualCoder/releases) para obtener la versión más reciente, ya que podría existir una actualización posterior. 
 
-### Prerequisites
-VLC is optional, but you will need it installed if you need to do any audio/video coding. Occasionally on some operating systems (e.g. Fedora) QualCoder cannot find VLC to use it. Optionally, install ffmpeg for waveform display, see https://phoenixnap.com/kb/ffmpeg-windows
+### Requisitos Previos
+VLC es opcional; no obstante, su instalación es importante si requiere realizar codificación de archivos de audio o video. En ciertos sistemas operativos (por ejemplo, Fedora), es posible que _QualCoder_ presente dificultades para localizar la ruta de instalación de VLC. De manera opcional, se recomienda instalar FFmpeg para habilitar la visualización de formas de onda (waveform); para mayor información sobre este procedimiento, consulte: https://phoenixnap.com/kb/ffmpeg-windows.
 
 ### Windows
 
-See [https://github.com/ccbogel/QualCoder/releases/3.7](https://github.com/ccbogel/QualCoder/releases/3.7)
+Véase [https://github.com/ccbogel/QualCoder/releases/3.7](https://github.com/ccbogel/QualCoder/releases/3.7)
 
-You have two options for executables created on Windows 11:
+Para los archivos ejecutables generados en Windows 11, se dispone de las siguientes dos opciones:
 
-Option 1: There is a Windows installer on the release page called: **QualCoder.Win.3.7.exe**
+_Opción 1_: En la página de lanzamientos (releases) se encuentra disponible un instalador para Windows denominado: **QualCoder.Win.3.7.exe** (Véase imagen 1), descárgalo y ejecútalo. En caso de que emerja la ventana de Microsoft Defender SmartScreen, sigue los pasos de la imagen 3.
 
-Option 2: There is a standalone, non-installable exe folder called: **QualCoder.Win.3.7.Portable.zip** Download and unzip. It is in a folder alongside an internal folder. These both must be together or the exe will not run. Double-click the QualCoder exe to run, it takes up to 20 seconds to start. 
+**Versión instalable (Imagen 1):**
 
-Standalone, portable version: <img width="100" height="60" alt="QualCoder portable" src="https://github.com/user-attachments/assets/6be1de98-8b47-4d57-b4b5-c34375e44959" />
+<img width="1364" height="288" alt="image" src="https://github.com/user-attachments/assets/032ae0a9-3d1e-4d47-b919-33ed0ff3c77a" />
 
-On first use of the exe, Windows will ask you to allow to run QualCoder. This is because it is from an unknown publisher. It costs a lot of money to get a trusted publisher certificate - so that will not be possible for the foreseeable future. If you are uncomfortable with these warnings install from the source as detailed next.
 
-Alternatively, install from source code:
+_Opción 2_: Existe una carpeta con un ejecutable portable (que no requiere instalación), denominada: **QualCoder.Win.3.7.Portable.zip** Descargue y descomprima el archivo. El ejecutable se encuentra dentro de un directorio junto a una carpeta nobrada __internal_ (Véase imagen 2). Ambos elementos deben permanecer en la misma ubicación; de lo contrario, el archivo .exe no se ejecutará. Para iniciar la aplicación, haga doble clic en el ejecutable de _QualCoder_; tenga en cuenta que el proceso de inicio puede demorar hasta 20 segundos.
 
-Download the source code. Read and apply the section for Windows source code installation in the **Readme.md** file.
-Remove the back-ticks that surround the command line instructions ` as these are used for display only.
+**Versión portable (Imagen 2):** 
 
-### MacOS
+<img width="947" height="356" alt="image" src="https://github.com/user-attachments/assets/f669cde2-0dc1-4864-8839-3d09ceb4ccb8" />
+
+Al ejecutar el archivo .exe por primera vez (Véase imagen 3), el sistema operativo Windows solicitará su autorización para iniciar _QualCoder_. Esta advertencia (Microsoft Defender SmartScreen) se genera debido a que el software proviene de un desarrollador no registrado. La obtención de un certificado de "editor de confianza" conlleva costos elevados, por lo cual no se prevé su adquisición en el futuro cercano. 
 
-**Install from App bundles:**
+**Autorizar instalación/ejecución (Imagen 3):**
 
-Make sure you have installed any macOS updates before starting the installation. Go to the System Settings app on your Mac. Click General in the sidebar (you may need to scroll down), then click Software Update.
+<img width="1410" height="399" alt="image" src="https://github.com/user-attachments/assets/d24b4661-57e8-463c-b8cd-03efb2cea502" />
 
-Install QualCoder:  Double-click the downloaded dmg-file. Drag QualCoder into the link to your applications.
 
-Start QualCoder from your Launchpad or by double-clicking the app within your applications folder.
-We are currently not able to sign the app bundles, so when you first try to run the program, you may get a pop-up warning that QualCoder is from an unregistered developer or "QualCoder can't be opened because Apple cannot check it for malicious software." Depending on your processor, you may see one of these:
+Si estas advertencias de seguridad le generan inquietud, se recomienda realizar la instalación desde el código fuente, tal como se detalla en la siguiente sección.
 
-If you see "Show in Finder" or OK.  Click Ok.
+Como alternativa, realice la instalación desde el código fuente (source code):
 
-If you see "Done" or "Move to trash". Click Done.
+Descargue el código fuente desde la [página de lanzamientos (releases)](https://github.com/ccbogel/QualCoder/releases) (Véase imagen 4). Lea y aplique las instrucciones correspondientes a la instalación desde el código fuente para Windows, detalladas en el archivo **Readme.md**. Asegúrese de omitir las comillas invertidas ( ` ) que delimitan las instrucciones de la línea de comandos, dado que estas se utilizan exclusivamente con fines de formato y visualización.
 
-Next, go to Settings and select Privacy and Security.  Scroll down until you see a message stating QualCoder was prevented from starting. Click on "open anyway". You may be prompted to enter your password and may need to click "Open" again.  After entering your password, just wait for the program to open up. It may take several seconds.
+**Descargar Código fuente (Imagen 4):** 
+<img width="962" height="342" alt="image" src="https://github.com/user-attachments/assets/ad3f022b-089a-43a6-a430-a6a8a172aaf4" />
 
-From now on, QualCoder should start without issues.
 
-**Install from source code:**
 
-Download the source code. Read and apply the section for macOS source code usage in the **Readme.md** file.
-Remove the back ticks that surround the command line instructions ` as these are used for display only.
+### MacOS
 
+**Instalación desde paquetes de aplicación (App bundles):**
 
-### Debian / Ubuntu / Lubuntu / ZorinOS Linux
+Asegúrese de haber instalado todas las actualizaciones disponibles de macOS antes de iniciar el proceso de instalación. Diríjase a la aplicación Ajustes del Sistema en su Mac. En la barra lateral, haga clic en General (es posible que deba desplazarse hacia abajo) y, posteriormente, seleccione Actualización de software.
+
+Instalación de _QualCoder_: Haga doble clic en el archivo .dmg descargado. Posteriormente, arrastre el icono de _QualCoder_ hacia el acceso directo de la carpeta de Aplicaciones.
+
+Inicie _QualCoder_ desde el Launchpad o haciendo doble clic en la aplicación dentro de su carpeta de Aplicaciones.
+Actualmente, no disponemos de la capacidad para firmar los paquetes de aplicación (app bundles). Por lo tanto, al intentar ejecutar el programa por primera vez, es posible que el sistema muestre una advertencia emergente indicando que _QualCoder_ proviene de un desarrollador no registrado, o bien el mensaje: "_QualCoder_ no se puede abrir porque Apple no puede realizar un análisis en busca de software malicioso". Dependiendo del tipo de procesador de su equipo, podría visualizar una de las siguientes opciones:
+
+Si visualiza las opciones "Mostrar en el Finder" o "Aceptar", haga clic en Aceptar.
 
-There is an executable file in the releases page for Ubuntu 24.04 for the 3.6 release. Download and double click to run.
+Si visualiza las opciones "Listo" o "Trasladar a la papelera", haga clic en Listo.
 
-Alternatively, run QualCoder from the source code:
+Posteriormente, diríjase a Ajustes y seleccione la sección Privacidad y seguridad. Desplácese hacia abajo hasta localizar un mensaje indicando que se impidió la ejecución de _QualCoder_. Haga clic en el botón "Abrir de todos modos". Es posible que el sistema le solicite ingresar su contraseña y que deba confirmar la acción haciendo clic nuevamente en "Abrir". Tras validar su identidad, espere a que el programa se inicie; este proceso puede demorar varios segundos.
+
+A partir de este momento, _QualCoder_ debería ejecutarse sin inconvenientes.
+
+**Instalación desde el código fuente (source code):**
+
+Descargue el código fuente. Lea y aplique las instrucciones correspondientes al uso del código fuente en macOS, detalladas en el archivo **Readme.md**.
+Omita las comillas invertidas ( ` ) que delimitan las instrucciones de la línea de comandos, dado que estas se emplean únicamente con fines de formato y visualización.
+
+
+### Debian / Ubuntu / Lubuntu / ZorinOS Linux
 
-Download the source code. Read and apply the section for Ubuntu source code usage in the **Readme.md** file.
-Remove the back ticks that surround the command line instructions ` as these are used for display only.
+Existe un archivo ejecutable disponible en la página de lanzamientos (releases) para Ubuntu 24.04 correspondiente a la versión 3.6. Descargue el archivo y haga doble clic en él para iniciar la ejecución.
+Como alternativa, ejecute _QualCoder_ desde el código fuente:
 
+Descargue el código fuente. Lea y aplique las instrucciones correspondientes al uso del código fuente en Ubuntu, detalladas en el archivo **Readme.md**.
+Asegúrese de omitir las comillas invertidas ( ` ) que delimitan las instrucciones de la línea de comandos, dado que estas se utilizan exclusivamente con fines de formato y visualización.
 ### Fedora Linux
 
-These instructions download the current source code directly from GitHub. Note: Fedora uses Wayland which may not work well with the Qt graphical interface. It is suggested you also install Xwayland.
+Estas instrucciones descargan el código fuente actual directamente desde GitHub. Nota: La distribución Fedora utiliza Wayland, el cual podría presentar problemas de compatibilidad con la interfaz gráfica de Qt. Se recomienda instalar adicionalmente Xwayland para asegurar un funcionamiento óptimo.
 
-Download the source code. Read and apply the section for Fedora source code usage in the **Readme.md** file.
-Remove the back ticks that surround the command line instructions ` as these are used for display only.
+Descargue el código fuente. Lea y aplique las instrucciones correspondientes al uso del código fuente en Fedora, detalladas en el archivo **Readme.md**.
+Asegúrese de omitir las comillas invertidas ( ` ) que delimitan las instrucciones de la línea de comandos, dado que estas se utilizan exclusivamente con fines de formato y visualización.
 
-There may be problems with QualCoder working with audio / video in Fedora.
+Es posible que se presenten problemas de compatibilidad en _QualCoder_ al trabajar con archivos de audio o video en la distribución Fedora.
 
 ### Arch/Manjaro Linux
 
-Download the source code. Read and apply the section for Arch source code usage in the **Readme.md** file.
-Remove the back ticks that surround the command line instructions ` as these are used for display only.
+Descargue el código fuente. Lea y aplique las instrucciones correspondientes al uso del código fuente en Arch Linux, detalladas en el archivo Readme.md.
+Asegúrese de omitir las comillas invertidas ( ` ) que delimitan las instrucciones de la línea de comandos, dado que estas se utilizan exclusivamente con fines de formato y visualización.