Skip to content

Commit 5ec53db

Browse files
julesvanriegithub-actions
andauthored
Align Windows 11 and 10 WSL installation (#483)
* Align Windows 11 and 10 WSL installation Starting from Windows 10 2004 (May 2020 Update), WSL 2 is the default version of WSL. The instructions for installing WSL 2 are now the same for both Windows 10 and Windows 11. Adapted the instructions as such, to have a common installation process. This will: - make the setup easier for remaining Windows 10 users, - reduce the number of cases where Windows 11 users started following the Windows 10 instructions by mistake, - make it easier to maintain the instructions in the future, - make it easy to remove the Windows 10 instructions later. For this we now run `wsl --install` in the Windows Command Prompt (cmd) instead of Windows Terminal (wt, for Windows 11) or PowerShell (for Windows 10). For troubleshooting reasons, the instructions for Windows 10 < 2004 are kept in details, just in case. Adapted EN, FR, ES, PT. * GHA: Build guides on PR * GHA: Build guides on push on every branch * setup guides generated * Fine tune indentation for Windows 10 * setup guides generated * Revert changes to build workflow --------- Co-authored-by: github-actions <github-actions@github.com>
1 parent e438751 commit 5ec53db

20 files changed

+578
-536
lines changed

_partials/es/windows_terminal.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,10 @@
66

77
Si estás utilizando Windows 11, la terminal de Windows ya está instalada y puedes ir a la siguiente sección :point_down:
88

9+
Si tienes Windows 10, instala la terminal de Windows. Verás que es una terminal moderna.
910

10-
Si tienes Windows 10, instala la terminal de Windows. Verás que es una terminal moderna:
11+
<details>
12+
<summary>**Windows 10**: Instalar Windows Terminal</summary>
1113

1214
- Haz clic en `Start`
1315
- Escribe `Microsoft Store`
@@ -32,6 +34,8 @@ Si tienes Windows 10, instala la terminal de Windows. Verás que es una terminal
3234

3335
Cuando termine la instalación, el botón `Install` se transformará en un botón `Launch`: haz clic en él.
3436

37+
</details>
38+
3539
### Ubuntu como terminal predeterminada
3640

3741
Hagamos que Ubuntu sea la terminal predeterminada de tu aplicación Windows terminal.

_partials/es/windows_ubuntu.md

Lines changed: 24 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,13 @@
22

33
### Instalación
44

5-
:information_source: Las instrucciones que verás a continuación dependen de la versión de Windows que tengas. Por favor solo sigue las instrucciones que correspondan a tu versión de Windows :point_down:
5+
Después de reiniciar tu computadora, deberías ver una ventana de terminal diciendo WSL está retomando el proceso de instalación de Ubuntu. Cuando termine, iniciará Ubuntu.
66

7-
#### Windows 11
8-
9-
Si estás utilizando Windows 11, después de reiniciar tu computadora, deberías ver una ventana de terminal diciendo WSL está retomando el proceso de instalación de Ubuntu. Cuando termine, iniciará Ubuntu.
7+
<details>
8+
<summary>Solución de problemas para Windows 10 (solo si es necesario, consulta con un profesor)</summary>
109

11-
#### Windows 10
10+
Si la instalación de Ubuntu no se reanudó, primero intenta nuevamente: abre Powershell o el Símbolo del sistema y ejecuta `wsl --install` otra vez.
11+
</details>
1212

1313
Si tienes Windows 10, instala la terminal de Windows por medio de la Microsoft Store:
1414

@@ -34,6 +34,8 @@ Si tienes Windows 10, instala la terminal de Windows por medio de la Microsoft S
3434

3535
Cuando termine la instalación, el botón `Get` se transformará en un botón `Open`: Haz clic en él.
3636

37+
</details>
38+
3739
### Primer uso
3840

3941
La primera vez que lo abras, te pedirán que:
@@ -47,8 +49,6 @@ La primera vez que lo abras, te pedirán que:
4749

4850
:warning: Cuando escribas tu contraseña no verás nada en la pantalla. **Esto es normal**. Es una herramienta de seguridad para ocultar tanto el contenido de tu contraseña como su longitud. Simplemente escribe tu contraseña y presiona `Enter` al terminar.
4951

50-
Ahora puedes cerrar la ventana de Ubuntu ya que está instalado en tu computadora.
51-
5252
### Chequea la versión WSL de Ubuntu
5353

5454
- Presiona `Windows` + `R`
@@ -77,7 +77,6 @@ wsl -l -v
7777
:heavy_check_mark: Deberías obtener el siguiente mensaje en algunos segundos: `The conversion is complete`. Esto significa que la conversión ha sido completada.
7878

7979
:x: Si no funciona, tendremos que asegurarnos de que los archivos de Ubuntu no estén comprimidos.
80-
</details>
8180

8281
<details>
8382
<summary>Chequea si los archivos no están comprimidos</summary>
@@ -96,7 +95,23 @@ wsl -l -v
9695
:x: Si la conversión aún no funciona, por favor **contacta a un profesor**.
9796
</details>
9897

99-
### Compruebe la locale
98+
Ya puedes cerrar la ventana de la terminal.
99+
100+
</details>
101+
102+
### Comprueba tu nombre de usuario
103+
104+
Escribe esto en la terminal de Ubuntu:
105+
106+
```bash
107+
whoami
108+
```
109+
110+
Debería devolver el nombre de usuario que elegiste anteriormente.
111+
112+
:x: Si dice `root`, **contacta a un profesor** antes de continuar.
113+
114+
### Comprueba la configuración regional (locale)
100115

101116
La "locale" es un mecanismo que permite adaptar los programas a su idioma y país.
102117

@@ -125,5 +140,3 @@ sudo apt-get update
125140
sudo apt-get install language-pack-en language-pack-en-base manpages
126141
```
127142
</details>
128-
129-
Ya puedes cerrar la ventana de la terminal.

_partials/es/windows_version.md

Lines changed: 31 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -11,62 +11,51 @@ Para chequear la versión de tu Windows:
1111
- Escribe `winver`
1212
- Presiona `Enter`
1313

14-
:heavy_check_mark: Si las primeras palabras de esta ventana son **Windows 10 o Windows 11**, entonces todo está bien y puedes continuar trabajando en la configuración :+1:
14+
:heavy_check_mark: Si las primeras palabras de esta ventana son **Windows 11**, entonces todo está bien y puedes continuar trabajando en la configuración :+1:
1515

16-
:x: Si no es el caso, no puedes continuar. Primero debes actualizar tu versión a Windows 10 :point_down:
16+
:heavy_check_mark: Si las primeras palabras de esta ventana son **Windows 10**, verifica el **número de la versión**:
1717

18-
<details>
19-
<summary>Actualizar a Windows 10</summary>
18+
- :heavy_check_mark: Si dice al menos `2004`, entonces todo está bien :+1:
2019

21-
- Descarga Windows 10 desde [Microsoft](https://www.microsoft.com/software-download/windows10ISO)
22-
- Instálalo. Debería tomar como una hora pero realmente depende de tu computadora.
23-
- Cuando termine la instalación, ejecuta los comandos de aquí arriba :point_up: para chequear que tengas **Windows 10**.
24-
</details>
20+
- :x: Si es inferior a `2004`, debes actualizar tu versión.
2521

26-
:information_source: [La actualización de Windows 11 está en curso en este momento](https://www.microsoft.com/en-us/windows/get-windows-11). Esto significa que puede que esté o que aún no esté disponible para tu computadora.
22+
- <details>
23+
<summary>Cómo instalar las últimas actualizaciones?</summary>
2724

28-
:warning: **Si tienes Windows 10 instalado, no necesitas actualizarlo a Windows 11 para hacer esta configuración**.
29-
30-
### Últimas actualizaciones
25+
Abre Windows Update:
26+
- Presiona `Windows` + `R`
27+
- Escribe `ms-settings:windowsupdate`
28+
- Presiona `Enter`
29+
- Haz clic en `Check updates`
3130

32-
Una vez que estés seguro de que estés usando Windows 10 o 11, instala las siguientes actualizaciones.
31+
:heavy_check_mark: Si tienes una marca verde y el siguiente mensaje "You're up to date", entonces todo está bien :+1:
3332

34-
Abre Windows Update:
35-
- Presiona `Windows` + `R`
36-
- Escribe `ms-settings:windowsupdate`
37-
- Presiona `Enter`
38-
- Haz clic en `Check updates`
33+
:warning: Si obtienes una exclamación roja y el siguiente mensaje "Update available", por favor instala las actualizaciones y repite el proceso hasta que diga que todo está actualizado :loop:
3934

40-
:heavy_check_mark: Si tienes una marca verde y el siguiente mensaje "You're up to date", entonces todo está bien :+1:
35+
:x: Si obtienes un mensaje de error diciendo que Windows no puede aplicar las actualizaciones, por favor **contacta a un profesor**.
4136

42-
:warning: Si obtienes una exclamación roja y el siguiente mensaje "Update available", por favor instala las actualizaciones y repite el proceso hasta que diga que todo está actualizado :loop:
37+
<details>
38+
<summary>Activa Windows Update Service para resolver las Actualizaciones</summary>
4339

44-
:x: Si obtienes un mensaje de error diciendo que Windows no puede aplicar las actualizaciones, por favor **contacta a un profesor**.
40+
Algunos antivirus y programas deshabilitan las actualizaciones que necesitamos y luego se muestra un error. ¡Solucionemos esto!
41+
- Presiona `Windows` + `R`
42+
- Escribe `services.msc`
43+
- Presiona `Enter`
44+
- Haz doble clic en `Windows Update Service`
45+
- Coloca su `Startup` en `Automatic`
46+
- Haz clic en `Start`
47+
- Haz clic en `Ok`
48+
¡Ahora intenta instalar las actualizaciones nuevamente!
49+
</details>
4550

46-
<details>
47-
<summary>Activa Windows Update Service para resolver las Actualizaciones</summary>
51+
Verifica el número de la versión:
4852

49-
Algunos antivirus y programas deshabilitan las actualizaciones que necesitamos y luego se muestra un error. ¡Solucionemos esto!
5053
- Presiona `Windows` + `R`
51-
- Escribe `services.msc`
54+
- Escribe `winver`
5255
- Presiona `Enter`
53-
- Haz doble clic en `Windows Update Service`
54-
- Coloca su `Startup` en `Automatic`
55-
- Haz clic en `Start`
56-
- Haz clic en `Ok`
57-
¡Ahora intenta instalar las actualizaciones nuevamente!
58-
</details>
59-
60-
### Requisito mínimo para la versión
61-
62-
Algunas de las herramientas que necesitamos han salido con la versión `1903` **o superior** de Windows 10, así que necesitamos asegurarnos de que al menos tengamos esa.
63-
64-
- Presiona `Windows` + `R`
65-
- Escribe `winver`
66-
- Presiona `Enter`
6756

68-
Verifica el **número de la versión**:
57+
:heavy_check_mark: Si dice al menos `2004`, entonces todo está bien :+1:
6958

70-
:heavy_check_mark: Si dice al menos `1903`, entonces todo está bien :+1:
59+
:x: Si es inferior a `2004`, por favor **contacta a un profesor**.
7160

72-
:x: Si es inferior a `1903`, por favor **contacta a un profesor**.
61+
</details>

_partials/es/windows_wsl.md

Lines changed: 11 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -2,21 +2,17 @@
22

33
WSL es el ambiente de entorno que estamos usando para usar Ubuntu. Puedes aprender más sobre WSL [aquí](https://docs.microsoft.com/en-us/windows/wsl/faq).
44

5-
:information_source: Las instrucciones que verás a continuación dependen de la versión de Windows que tengas. Por favor ejecuta solamente las instrucciones que correspondan a tu versión :point_down:
5+
Instalaremos WSL 2 y Ubuntu con un comando a través de la Windows Command Prompt.
66

7-
### Windows 11
8-
9-
Si usas Windows 11, instalaremos WSL 2 y Ubuntu con un comando a través de la terminal de Windows.
10-
11-
:warning: en esta instrucción, utiliza el atajo `Ctrl` + `Shift` + `Enter` para usar la **terminal de Windows** con privilegios de administrador en lugar de simplemente hacer clic en `Ok` o presionar `Enter`.
7+
:warning: en esta instrucción, utiliza el atajo `Ctrl` + `Shift` + `Enter` para usar la **Windows Command Prompt** con privilegios de administrador en lugar de simplemente hacer clic en `Ok` o presionar `Enter`.
128

139
- Presiona `Windows` + `R`
14-
- Escribe `wt`
10+
- Escribe `cmd`
1511
- Presiona **`Ctrl` + `Shift` + `Enter`**
1612

1713
:warning: tal vez tengas que aceptar la confirmación UAC sobre el cambio en los privilegios.
1814

19-
Un ventana de terminal azul aparecerá:
15+
Un ventana de terminal aparecerá:
2016
- Copia el siguiente comando (`Ctrl` + `C`)
2117
- Pégalo en la ventana de la terminal (`Ctrl` + `V` o haciendo clic derecho en la ventana)
2218
- Ejecútalo presionado `Enter`
@@ -29,11 +25,10 @@ wsl --install
2925

3026
:x: Si obtienes un mensaje de error (o si ves algún texto en rojo en la ventana), por favor **contacta a un profesor**
3127

32-
### Windows 10
33-
34-
#### Instalación de WSL 1
28+
<details>
29+
<summary>Solución de problemas para Windows 10 (solo si es necesario, consulta con un profesor)</summary>
3530

36-
Si tienes Windows 10, primero instalaremos WSL 1 por medio de la Terminal de PowerShell.
31+
#### Para Windows 10 < 2004: instala primero WSL 1
3732

3833
:warning: en esta instrucción, utiliza el atajo `Ctrl` + `Shift` + `Enter` para usar **Windows PowerShell** con privilegios de administrador en lugar de hacer clic en `Ok` o presionar `Enter`.
3934

@@ -64,7 +59,7 @@ dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /nores
6459

6560
:x: Si obtienes un mensaje de error (o si ves algún texto en rojo en la ventada), por favor **contacta a un profesor**
6661

67-
#### Actualización a WSL 2
62+
#### Para Windows 10 con WSL 1: Actualización a WSL 2
6863

6964
Si tienes Windows 10, actualizaremos WSL a la versión 2.
7065

@@ -82,7 +77,7 @@ Cuando se reinicie tu computadora, descarga el instalador de WSL2.
8277

8378
:x: Si obtienes el siguiente error "This update only applies to machines with the Windows Subsystem for Linux", **haz clic derecho** en el programa y selecciona `uninstall`; esta vez deberías poder instalarlo sin problemas.
8479

85-
#### Coloca WSL 2 como el Subsistema Windows por defecto para Linux
80+
#### Para Windows 10 con WSL 1: Coloca WSL 2 como el Subsistema Windows por defecto para Linux
8681

8782
Si tienes Windows 10, pondremos la versión predeterminada de WSL en 2.
8883

@@ -114,3 +109,5 @@ wsl --set-default-version 2
114109

115110
:information_source: Si tienes Windows 10 **Home edition**, la feature Hyper-V no está disponible para su sistema operativo. No es un bloqueo y puedes continuar con las siguientes instrucciones aquí abajo :ok_hand:
116111
</details>
112+
113+
</details>

_partials/fr/windows_terminal.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,10 @@
66

77
Si tu as Windows 11, le Windows Terminal est déjà installé et tu peux passer à la section suivante :point_down:
88

9-
Si tu as Windows 10, nous allons installer le Windows Terminal, un terminal vraiment moderne :
9+
Si tu as Windows 10, nous allons installer le Windows Terminal, un terminal vraiment moderne.
10+
11+
<details>
12+
<summary><strong>Windows 10</strong>: Installer le Windows Terminal</summary>
1013

1114
- Clique sur `Démarrer`
1215
- Saisis `Microsoft Store`
@@ -31,6 +34,8 @@ Si tu as Windows 10, nous allons installer le Windows Terminal, un terminal vrai
3134

3235
Une fois l’installation terminée, le bouton « Installer » se transforme en bouton « Lancer » ; clique dessus.
3336

37+
</details>
38+
3439
### Définir Ubuntu comme terminal par défaut
3540

3641
On va définir Ubuntu comme terminal par défaut de ton application Windows Terminal.

_partials/fr/windows_ubuntu.md

Lines changed: 24 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,12 @@
22

33
### Installation
44

5-
:information_source: Les instructions suivantes dépendent de ta version de Windows. N'exécute que les instructions qui correspondent à ta version :point_down:
6-
7-
#### Windows 11
8-
95
Si tu as Windows 11, après avoir redémarré ton ordinateur, tu devrais voir une fenêtre de terminal indiquant que WSL poursuit le processus d'installation d'Ubuntu. Lorsque c'est terminé, Ubuntu va se lancer.
106

11-
#### Windows 10
7+
<details>
8+
<summary>Résolution des problèmes pour Windows 10 (uniquement si nécessaire, vérifie avec un TA)</summary>
9+
10+
Si l'installation d'Ubuntu ne reprend pas, essaye d'abord à nouveau : relance Powershell ou l'Invite de commandes et exécute la commande `wsl --install` une nouvelle fois.
1211

1312
Si tu as Windows 10, installons Ubuntu via le Microsoft Store :
1413

@@ -34,6 +33,8 @@ Si tu as Windows 10, installons Ubuntu via le Microsoft Store :
3433

3534
Une fois l’installation terminée, le bouton « Installer » se transforme en bouton « Lancer » ; clique dessus.
3635

36+
</details>
37+
3738
### Premier lancement
3839

3940
Au premier lancement, on te demandera de fournir des informations :
@@ -77,7 +78,6 @@ wsl -l -v
7778
:heavy_check_mark: Au bout de quelques secondes, tu devrais voir apparaître le message suivant : `The conversion is complete`.
7879

7980
:x: Si ce n’est pas le cas, il faut vérifier que les fichiers Ubuntu ne sont pas compressés.
80-
</details>
8181

8282
<details>
8383
<summary>Vérifier que les fichiers sont décompressés</summary>
@@ -96,11 +96,28 @@ wsl -l -v
9696
:x: Si la conversion ne fonctionne pas, **demande au prof**.
9797
</details>
9898

99+
Tu peux maintenant fermer cette fenêtre de terminal.
100+
101+
</details>
102+
103+
### Vérifier ton nom d'utilisateur
104+
105+
Tape cette commande dans le terminal Ubuntu :
106+
107+
```bash
108+
whoami
109+
```
110+
111+
Cela devrait renvoyer le nom d'utilisateur que tu as choisi précédemment.
112+
113+
:x: Si cela affiche `root`, **contacte un TA** avant de continuer !
114+
115+
99116
### Vérifier la locale
100117

101118
Le concept e "locale" permert de personnaliser les programms en fonction de ta langue et ton pays.
102119

103-
Vérifions que la locale est bien en **anglais** ans le terminal :
120+
Vérifions que la locale est bien en **anglais** dans le terminal :
104121

105122
```bash
106123
locale
@@ -125,5 +142,3 @@ sudo apt-get update
125142
sudo apt-get install language-pack-en language-pack-en-base manpages
126143
```
127144
</details>
128-
129-
Tu peux maintenant fermer cette fenêtre de terminal.

0 commit comments

Comments
 (0)