diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index ef8eeef0..231dd313 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -1,6 +1,8 @@ name: Build setup guides on: push: + branches: + - master jobs: build: runs-on: ubuntu-latest diff --git a/.ruby-version b/.ruby-version index ef538c28..fa7adc7a 100644 --- a/.ruby-version +++ b/.ruby-version @@ -1 +1 @@ -3.1.2 +3.3.5 diff --git a/LICENSE b/LICENSE new file mode 100644 index 00000000..e51d9070 --- /dev/null +++ b/LICENSE @@ -0,0 +1 @@ +© 2023 La Loco SAS, head of Le Wagon Group - All rights reserved diff --git a/README.es.md b/README.es.md index 7be869f3..f83608e4 100644 --- a/README.es.md +++ b/README.es.md @@ -1,6 +1,6 @@ ## ¿En Español? -Guías de configuración para el curso de desarrollo web [Wagon](https://www.lewagon.com). Elige tu sistema operativo (OS): +Guías de configuración para el curso de AI Software Development de [Le Wagon](https://www.lewagon.com). Elige tu sistema operativo (OS): diff --git a/README.fr.md b/README.fr.md index e29ca0c3..7c7c3045 100644 --- a/README.fr.md +++ b/README.fr.md @@ -1,6 +1,6 @@ ## En Français -Guides de configuration pour la formation Développement Web du [Wagon](https://www.lewagon.com). Choisis ton système d’exploitation (OS): +Guides de configuration pour la formation AI Software Development du [Wagon](https://www.lewagon.com). Choisis ton système d’exploitation (OS):
diff --git a/README.md b/README.md index c8f26085..91c3aec1 100644 --- a/README.md +++ b/README.md @@ -6,13 +6,17 @@ Haga clic en este enlace para acceder a la versión en español de la configuración. +## Em Português? + +Clique neste link para acessar a versão em português da configuração. + ## En Français ? Clique sur ce lien pour accéder à la version française du setup. ## In English -Setup guides for [Le Wagon](https://www.lewagon.com) Web Development course. Please choose your operating system (OS): +Setup guides for [Le Wagon](https://www.lewagon.com) AI Software Development course. Please choose your operating system (OS):
diff --git a/README.pt.md b/README.pt.md new file mode 100644 index 00000000..2baeae6e --- /dev/null +++ b/README.pt.md @@ -0,0 +1,23 @@ +## Em Português? + +Guias de configuração para o curso de AI Software Development [Le Wagon](https://www.lewagon.com). Escolha seu sistema operacional (SO): + +
+ + + + + +
+ + macOS + + + + Windows + + + + Ubuntu + +
diff --git a/_partials/cli_tools.md b/_partials/cli_tools.md index 67e149ce..0fb198f2 100644 --- a/_partials/cli_tools.md +++ b/_partials/cli_tools.md @@ -1,5 +1,35 @@ ## Command line tools +### Check the locale + +The locale is a mechanism allowing to customize programs to your language and country. + +Let's verify that the default locale is set to English, please type this in the Ubuntu terminal: + +```bash +locale +``` + +If the output does not contain `LANG=en_US.UTF-8`, run the following command in a Ubuntu terminal to install the english locale: + +```bash +sudo locale-gen en_US.UTF-8 +``` + +If after, you receive a warning (`bash: warning: setlocale: LC_ALL: cannot change locale (en_US.utf-8)`) in your terminal, please do the following: + +
+ Generate locale + +Please, run this lines in your terminal. + +```bash +sudo update-locale LANG=en_US.UTF8 +sudo apt-get update +sudo apt-get install language-pack-en language-pack-en-base manpages +``` +
+ ### Zsh & Git Instead of using the default `bash` [shell](https://en.wikipedia.org/wiki/Shell_(computing)), we will use `zsh`. diff --git a/_partials/cn/dotfiles.md b/_partials/cn/dotfiles.md index 7b178a76..d820504c 100644 --- a/_partials/cn/dotfiles.md +++ b/_partials/cn/dotfiles.md @@ -54,7 +54,7 @@ cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh :point_up: 这会**提示**填写你的全名（`FirstName LastName`）和你的邮箱。 -:warning: 注意啦，你**需要**填`gh api ...`命令列出的其中一个电子邮箱。不然，Kitt就没办法跟进你的学习进程。 +:warning: 注意啦，你**需要**填`gh api ...`命令列出的其中一个电子邮箱。不然，Kitt就没办法跟进你的学习进程。 你选择的电子邮件将**公开**显示在互联网上。💡 如果您不希望您的电子邮件出现在您可能会贡献的公共存储库中，请选择 `@users.noreply.github.com` 地址。 现在运行下面的命令来**重置**你的终端： diff --git a/_partials/cn/gh_cli.md b/_partials/cn/gh_cli.md index 0b27a519..6953ed25 100644 --- a/_partials/cn/gh_cli.md +++ b/_partials/cn/gh_cli.md @@ -11,20 +11,18 @@ CLI是[Command-line Interface（命令行界面）](https://baike.baidu.com/item :warning: **不要更改下面指令中的`email`** ```bash -gh auth login -s 'user:email' -w +gh auth login -s 'user:email' -w --git-protocol ssh ``` -gh会问你几个问题： +`gh`会问你几个问题： -`What is your preferred protocol for Git operations?（你要用什么协议来执行Git操作？）` 让箭头`>`停在`SSH`前面，然后敲击回车。SSH使用SSH密钥来登陆用户，而不是用用户名和密码。 +- `Generate a new SSH key to add to your GitHub account?（生成新的SSH密钥，然后添加到Github账号上？）` 敲击回车，让gh帮你生成。 -`Generate a new SSH key to add to your GitHub account?（生成新的SSH密钥，然后添加到Github账号上？）` 敲击回车，让gh帮你生成。 + 如果你以前生成过SSH密钥，那你就会看到这个问题`Upload your SSH public key to your GitHub account?（上传公共密钥到Github账户上上吗？）` 上下移动箭头`>`，让它停在你想选的SSH公钥前面，然后敲击回车。 -如果你以前生成过SSH密钥，那你就会看到这个问题`Upload your SSH public key to your GitHub account?（上传公共密钥到Github账户上上吗？）` 上下移动箭头`>`，让它停在你想选的SSH公钥前面，然后敲击回车。 +- `Enter a passphrase for your new SSH key (Optional)（输入新的SSH密钥的密码（非必填））`. 输入一个密码，然后写下来或者记住它。这是保护你本地私钥的密码。然后敲击回车。 -`Enter a passphrase for your new SSH key (Optional)（输入新的SSH密钥的密码（非必填））`. 输入一个密码，然后写下来或者记住它。这是保护你本地私钥的密码。然后敲击回车。 - -:warning: 当你输入你的密码的时候，屏幕上不会有任何的显示，**这是正常的**。这是一个安全保护的设置，来隐藏你整个密码，包括它的长度。你可以放心的输入你的密码，结束后按下`Enter`就可以了。 +- `Title for your SSH key`。你可以把它留在建议的 "GitHub CLI"，按`Enter`。 然后你会看到下面的文字输出： diff --git a/_partials/cn/github.md b/_partials/cn/github.md index 122d6f09..ea53ec68 100644 --- a/_partials/cn/github.md +++ b/_partials/cn/github.md @@ -5,3 +5,5 @@ :point_right: **[上传一张照片](https://github.com/settings/profile)** 并在你的GitHub账户中设置你的名称。这一步很重要，因为我们将使用一个带有你头像的内部dashboard。请**现在**立即做这一步，然后再去继续下面的步骤。 ![](images/github_upload_picture.png) + +**[启用双因素认证（2FA）](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-text-messages)**。当您尝试登录时，GitHub将向您发送带有代码的短信。这对于安全性很重要，也很快将成为贡献GitHub上的代码的必要条件。 diff --git a/_partials/cn/intro.md b/_partials/cn/intro.md index deb57cc9..50582b3c 100644 --- a/_partials/cn/intro.md +++ b/_partials/cn/intro.md @@ -1,7 +1,7 @@ # 电脑设置教程 -以下的教程将会帮助你为接下来在[Le Wagon Web Development course](https://www.lewagon.com/web-development-course/full-time)全栈开发训练营中做好准备： +以下的教程将会帮助你为接下来在[Le Wagon AI Software Development course](https://www.lewagon.com/web-development-course/full-time)全栈开发训练营中做好准备： 请**仔细阅读并按顺序执行指令**。如果你在哪一步卡住了，不用犹豫，可以举手咨询老师:raising_hand: -让我们开始吧 :rocket: \ No newline at end of file +让我们开始吧 :rocket: diff --git a/_partials/cn/macos_postgresql.md b/_partials/cn/macos_postgresql.md index e8d3034f..0dd5623f 100644 --- a/_partials/cn/macos_postgresql.md +++ b/_partials/cn/macos_postgresql.md @@ -7,8 +7,12 @@ 运行下方指令： ```bash -brew install postgresql -brew services start postgresql +brew install postgresql@15 libpq +brew link --force libpq +``` + +```bash +brew services start postgresql@15 ``` 当你结束了上方的指令之后，让我们一起来核查一下它是否安装成功了： @@ -20,7 +24,7 @@ psql -d postgres 如果你进入到了一个像下方这个，一个新的输入框的话，那么说明你的PostgreSQL已经安装好啦！ ```bash -psql (14.4) +psql (15.2) Type "help" for help. postgres=# diff --git a/_partials/cn/macos_rbenv.md b/_partials/cn/macos_rbenv.md index 7108dc7d..491cd676 100644 --- a/_partials/cn/macos_rbenv.md +++ b/_partials/cn/macos_rbenv.md @@ -26,5 +26,5 @@ brew uninstall --force rbenv ruby-build ```bash exec zsh -brew install rbenv +brew install rbenv libyaml ``` diff --git a/_partials/cn/macos_settings.md b/_partials/cn/macos_settings.md index ae84ab98..dc209d71 100644 --- a/_partials/cn/macos_settings.md +++ b/_partials/cn/macos_settings.md @@ -44,4 +44,3 @@ defaults write com.apple.screencapture location "${HOME}/Desktop" - VS Code - 你的浏览器 - Slack -- Zoom diff --git a/_partials/cn/macos_zoom.md b/_partials/cn/macos_zoom.md deleted file mode 100644 index 9c5a1c8f..00000000 --- a/_partials/cn/macos_zoom.md +++ /dev/null @@ -1,33 +0,0 @@ -## Zoom - -为了让我们能够线上的交流，我们将会使用[Zoom](https://zoom.us/)，一个视频会议工具。 - -:warning: 如果你已经安装了Zoom，请确保它的版本至少是**5.6**。 - -打开[zoom.us/download](https://zoom.us/download). - -在**Zoom会议客户端（Zoom Client）**下方点击**下载（Download）**按钮。 - -打开你刚刚下载的文件并安装应用程序。 - -打开Zoom。 - -如果你的Mac使用Apple silicon的话, [你必须安装Rosetta](https://support.apple.com/en-us/HT211861)。点击安装（install），然后输入你的用户名和密码来允许安装。 - -![Install Rosetta](https://support.apple.com/library/content/dam/edam/applecare/images/en_US/macos/Big-Sur/macos-big-sur-software-update-rosetta-alert.jpg) - -如果你已经有Zoom账号了，那就用你的账号密码登陆吧。 - -如果没有账号的话，点击**Sign Up Free**链接： - -![Sign Up Free to Zoom](images/zoom_sign_up_free.png) - -接下来，它会跳转到Zoom的网站让你填一个表。 - -完成这个表之后，回到Zoom软件，然后用你的账号密码登陆吧。 - -你应该会看到下面这个界面： - -![Zoom Home Screen](images/zoom_home_screen.png) - -现在你可以关掉Zoom了。 diff --git a/_partials/cn/rbenv.md b/_partials/cn/rbenv.md index 35e53bf8..8177cc4f 100644 --- a/_partials/cn/rbenv.md +++ b/_partials/cn/rbenv.md @@ -14,7 +14,7 @@ rm -rf ~/.rbenv 然后在终端里运行: ```bash -sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev +sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev libyaml-dev ``` ```bash diff --git a/_partials/cn/ruby.md b/_partials/cn/ruby.md index ea41ff58..e0671a29 100644 --- a/_partials/cn/ruby.md +++ b/_partials/cn/ruby.md @@ -23,7 +23,7 @@ exec zsh ruby -v ``` -:heavy_check_mark: 如果你有看到`ruby p`，那么你可以继续下一步+1: +:heavy_check_mark: 如果你有看到`ruby `，那么你可以继续下一步+1: :x: 如果没有的话，**询问一下老师**。 @@ -47,6 +47,12 @@ gem sources -l 在ruby的世界里，我们将外部的库称之为`gems`：他们是一些你可以下载并在你的电脑上运行的ruby代码。让我们一起安装一些! +首先，我们将更新`bundler`，它是用于安装 gem 的工具： + +```bash +gem update bundler +``` + 在你的终端里，复制粘贴下面的指令： ```bash diff --git a/_partials/cn/slack_settings.md b/_partials/cn/slack_settings.md index 70626883..11567347 100644 --- a/_partials/cn/slack_settings.md +++ b/_partials/cn/slack_settings.md @@ -9,9 +9,12 @@ 之后你可以全天开着Slack，这样你可以在上面分享有用的链接/寻求帮助/决定去那儿吃饭/... 为了确保视频电话可以正常工作，让我们一起测试摄像头和麦克风： -- 打开Slack应用程序 -- 在任意群组的消息编辑框里输入`/call --test`并按下`Enter` -- 按下"Start test"绿色按钮 +- 打开Slack应用程序。 +- 点击右上方的个人照片。 +- 从菜单中选择 `首选项(Preferences)`。 +- 点击左侧栏中的 `音频和视频(Audio & video)`。 +- 在 `故障排除(Troubleshooting)`下面，点击 `运行音频、视频和屏幕共享测试(Run an audio, video and screensharing test)`。该测试将在一个新窗口中打开。 +- 检查你使用的扬声器、麦克风和摄像机设备是否出现在选项中，然后点击 `开始测试(Start test)`。 ![在Slack检查麦克风和摄像头](images/slack_call_test.png) diff --git a/_partials/cn/sqlite.md b/_partials/cn/sqlite.md index 6154418f..8364feae 100644 --- a/_partials/cn/sqlite.md +++ b/_partials/cn/sqlite.md @@ -5,7 +5,7 @@ 在终端，执行下面的命令： ```bash -sudo apt-get install sqlite3 libsqlite3-dev +sudo apt-get install sqlite3 libsqlite3-dev pkg-config ``` 然后执行下面的命令： diff --git a/_partials/cn/ubuntu_settings.md b/_partials/cn/ubuntu_settings.md index d2027869..305c3d4f 100644 --- a/_partials/cn/ubuntu_settings.md +++ b/_partials/cn/ubuntu_settings.md @@ -48,4 +48,3 @@ You must pin: - VS Code - Your Internet browser - Slack -- Zoom diff --git a/_partials/cn/vscode_extensions.md b/_partials/cn/vscode_extensions.md index aa0ccc05..b32ed835 100644 --- a/_partials/cn/vscode_extensions.md +++ b/_partials/cn/vscode_extensions.md @@ -1,8 +1,8 @@ -## VS Code插件 +## VS Code 插件 ### 安装 -现在我们来给VS Code安装一些有用的插件吧。 +现在我们来给 VS Code 安装一些有用的插件吧。 复制粘贴下面的命令到终端： @@ -10,17 +10,21 @@ code --install-extension ms-vscode.sublime-keybindings code --install-extension emmanuelbeziat.vscode-great-icons code --install-extension MS-vsliveshare.vsliveshare -code --install-extension rebornix.ruby +code --install-extension shopify.ruby-lsp code --install-extension dbaeumer.vscode-eslint code --install-extension Rubymaniac.vscode-paste-and-indent code --install-extension alexcvzz.vscode-sqlite +code --install-extension anteprimorac.html-end-tag-labels +code --install-extension marcoroth.herb-lsp +code --install-extension rayhanw.erb-helpers ``` 你安装的就是下面这些插件： + - [Sublime Text Keymap and Settings Importer](https://marketplace.visualstudio.com/items?itemName=ms-vscode.sublime-keybindings) - [VSCode Great Icons](https://marketplace.visualstudio.com/items?itemName=emmanuelbeziat.vscode-great-icons) - [Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare) -- [Ruby](https://marketplace.visualstudio.com/items?itemName=rebornix.Ruby) +- [Ruby](https://marketplace.visualstudio.com/items?itemName=shopify.ruby-lsp) - [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) - [Paste and Indent](https://marketplace.visualstudio.com/items?itemName=Rubymaniac.vscode-paste-and-indent) - [SQLite](https://marketplace.visualstudio.com/items?itemName=alexcvzz.vscode-sqlite) diff --git a/_partials/cn/windows_browser.md b/_partials/cn/windows_browser.md index 987c6105..6d6faca8 100644 --- a/_partials/cn/windows_browser.md +++ b/_partials/cn/windows_browser.md @@ -71,6 +71,7 @@ ```bash + echo "export BROWSER=\"/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe\"" >> ~/.zshrc echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'\"" >> ~/.zshrc ``` diff --git a/_partials/cn/windows_postgresql.md b/_partials/cn/windows_postgresql.md index 734330ee..568255d2 100644 --- a/_partials/cn/windows_postgresql.md +++ b/_partials/cn/windows_postgresql.md @@ -34,6 +34,6 @@ echo "sudo /etc/init.d/postgresql start" >> ~/.zshrc 打开一个新的终端。 -:heavy_check_mark: 如果你看到一行字说`* Starting PostgreSQL 12 database server`，那你就可以进行下一步了 :+1: +:heavy_check_mark: 如果你看到一行字说`* Starting postgresql (via systemctl): postgresql.service`还是`* Starting PostgreSQL 14 database server`，那你就可以进行下一步了 :+1: :x: 如果没有的话， **请让老师来帮助你**。 diff --git a/_partials/cn/windows_terminal.md b/_partials/cn/windows_terminal.md index be22686a..dbdfb625 100644 --- a/_partials/cn/windows_terminal.md +++ b/_partials/cn/windows_terminal.md @@ -64,7 +64,7 @@ - 在它后面加上这行： ```bash -"multiLinePasteWarning": false, +"warning.multiLinePaste": false, ``` :warning: 别忘了这行最后有个逗号哟！ diff --git a/_partials/cn/yarn.md b/_partials/cn/yarn.md index 5fb3d887..2564ad06 100644 --- a/_partials/cn/yarn.md +++ b/_partials/cn/yarn.md @@ -3,9 +3,16 @@ 让我们一起来安装[`yarn`](https://classic.yarnpkg.com/en/docs/install): ```bash -npm install --global yarn +corepack enable +yarn set version stable ``` +```bash +exec zsh +``` + +⚠️ 如果你看到任何错误信息，请尝试运行 `npm install -g corepack` 然后再次运行上面的命令。 + 重启终端并运行： ```bash diff --git a/_partials/cn/zoom.md b/_partials/cn/zoom.md deleted file mode 100644 index 6a6d9add..00000000 --- a/_partials/cn/zoom.md +++ /dev/null @@ -1,29 +0,0 @@ -## Zoom - -为了让我们能够线上的交流，我们将会使用[Zoom](https://zoom.us/)，一个视频会议工具。 - -:warning: 如果你已经安装了Zoom，请确保它的版本至少是**5.6**。 - -打开[https://zoom.us/download](https://zoom.us/download)。 - -在**Zoom会议客户端（Zoom Client）**下方点击**下载（Download）**按钮。 - -打开你刚刚下载的文件并安装应用程序。 - -打开Zoom。 - -如果你已经有Zoom账号了，那就用你的账号密码登陆吧。 - -如果没有账号的话，点击**Sign Up Free**链接： - -![Sign Up Free to Zoom](images/zoom_sign_up_free.png) - -接下来，它会跳转到Zoom的网站让你填一个表。 - -完成这个表之后，回到Zoom软件，然后用你的账号密码登陆吧。 - -你应该会看到下面这个界面： - -![Zoom Home Screen](images/zoom_home_screen.png) - -现在你可以关掉Zoom了。 diff --git a/_partials/conclusion.md b/_partials/conclusion.md index 56f70436..4c3896ee 100644 --- a/_partials/conclusion.md +++ b/_partials/conclusion.md @@ -1,5 +1,5 @@ ## Setup completed! -Your computer is now all set for [Le Wagon Web Development course](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: +Your computer is now all set for [Le Wagon AI Software Development course](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: Enjoy the bootcamp, you will nail it :rocket: diff --git a/_partials/dotfiles.md b/_partials/dotfiles.md index 5d2da6b6..56f1ebd0 100644 --- a/_partials/dotfiles.md +++ b/_partials/dotfiles.md @@ -67,7 +67,8 @@ cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh :point_up: This will **prompt** you for your name (`FirstName LastName`) and your email. -:warning: You **need** to put one of the email listed above thanks to the previous `gh api ...` command. If you don't do that, Kitt won't be able to track your progress. +:warning: You **need** to put one of the emails listed above thanks to the previous `gh api ...` command. If you don't do that, Kitt won't be able to track your progress. 💡 Select the `@users.noreply.github.com` address if you don't want your email to appear in public repositories you may contribute to. + Please now **reset** your terminal by running: diff --git a/_partials/es/cli_tools.md b/_partials/es/cli_tools.md index 2544dcf5..7808ca7b 100644 --- a/_partials/es/cli_tools.md +++ b/_partials/es/cli_tools.md @@ -1,5 +1,35 @@ ## Herramientas de línea de comando +### Comprueba la configuración regional (locale) + +La "locale" es un mecanismo que permite adaptar los programas a su idioma y país. + +Comprobemos que la configuración regional por defecto es el inglés: + +```bash +locale +``` + +Si la salida no contiene `LANG=en_US.UTF-8`, ejecute el siguiente comando en un Ubuntu terminal para instalar la locale inglesa: + +```bash +sudo locale-gen en_US.UTF-8 +``` + +Si después, recibes una advertencia (`bash: warning: setlocale: LC_ALL: cannot change locale (en_US.utf-8)`) en tu terminal, por favor haz lo siguiente: + +
+ Generar la configuración regional<>/summary> + +Por favor, ejecuta estas líneas en tu terminal. + +```bash +sudo update-locale LANG=en_US.UTF8 +sudo apt-get update +sudo apt-get install language-pack-en language-pack-en-base manpages +``` +
+ ### Zsh & Git En lugar de usar el `bash` [shell](https://en.wikipedia.org/wiki/Shell_(computing)) predeterminado, usaremos `zsh`. diff --git a/_partials/es/conclusion.md b/_partials/es/conclusion.md index 4fbb06a4..1563848a 100644 --- a/_partials/es/conclusion.md +++ b/_partials/es/conclusion.md @@ -1,5 +1,5 @@ ## ¡Fin de la configuración! -Tu computadora está lista para el [curso de Desarrollo Web de Le Wagon](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: +Tu computadora está lista para el [curso de AI Software Development de Le Wagon](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: Disfrútalo, sabemos que te va a ir genial :rocket: diff --git a/_partials/es/dotfiles.md b/_partials/es/dotfiles.md index 9bf3fd55..b0c7155a 100644 --- a/_partials/es/dotfiles.md +++ b/_partials/es/dotfiles.md @@ -53,7 +53,7 @@ Ejecuta el instalador de `git`: cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh ``` -:point_up: Esto te **pedirá** tu nombre (`FirstName LastName`) y tu email. +:point_up: Esto te **pedirá** tu nombre (`FirstName LastName`) y tu email. Cualquier correo que elijas se mostrará **públicamente** en internet. 💡 Selecciona la dirección `@users.noreply.github.com` si no quieres que tu correo electrónico aparezca en los repositorios públicos a los que puedas contribuir. :warning: **Necesitas** poner uno de los emails que aparecen arriba gracias al comando anterior `gh api ...`. De lo contrario, Kitt no podrá hacerle seguimiento a tu progreso. diff --git a/_partials/es/gh_cli.md b/_partials/es/gh_cli.md index 67e75253..73f28e78 100644 --- a/_partials/es/gh_cli.md +++ b/_partials/es/gh_cli.md @@ -4,6 +4,8 @@ CLI es una abreviación de [Command-line Interface](https://en.wikipedia.org/wik En esta sección usaremos [GitHub CLI](https://cli.github.com/) para interactuar directamente con GitHub desde la terminal. +Usaremos la GitHub CLI (`gh`) para conectarnos a GitHub utilizando *SSH*, un protocolo para iniciar la sesión utilizando claves SSH en lugar de la famosa pareja nombre de usuario y contraseña. + Ya debería haberse instalado en tu computadora con los comandos que ejecutaste anteriormente. Lo primero que hay que hacer para **iniciar sesión** es copiar y pegar el comando siguiente en tu terminal: @@ -11,20 +13,18 @@ Lo primero que hay que hacer para **iniciar sesión** es copiar y pegar el coman :warning: **NO edites el `email`** ```bash -gh auth login -s 'user:email' -w +gh auth login -s 'user:email' -w --git-protocol ssh ``` -gh le hará algunas preguntas: - -`What is your preferred protocol for Git operations?` Con las flechas, elige `SSH` y presiona `Enter`. SSH es un protocolo para iniciar la sesión utilizando claves SSH en lugar de la famosa pareja nombre de usuario y contraseña. +`gh` le hará algunas preguntas: -`Generate a new SSH key to add to your GitHub account?` Presiona `Enter` para pedirle a gh que genere las claves SSH por ti. +- `Generate a new SSH key to add to your GitHub account?` Presiona `Enter` para pedirle a gh que genere las claves SSH por ti. -Si ya tienes claves SSH, verás en su lugar `Upload your SSH public key to your GitHub account?`Con las flechas, selecciona la ruta de tu archivo de clave pública y pulsa `Intro`. + Si ya tienes claves SSH, verás en su lugar `Upload your SSH public key to your GitHub account?`Con las flechas, selecciona la ruta de tu archivo de clave pública y pulsa `Intro`. -`Enter a passphrase for your new SSH key (Optional)`. Pon algo que quieras y que recuerdes. Es una contraseña para proteger tu private key que está almacenada en tu disco duro. Luego presiona `Enter`. +- `Enter a passphrase for your new SSH key (Optional)`. Pon algo que quieras y que recuerdes. Es una contraseña para proteger tu private key que está almacenada en tu disco duro. Luego presiona `Enter`. -:warning: Cuando escribas tu passphrase, no verás nada en la pantalla. **Esto es normal**. Es una herramienta de seguridad para ocultar tanto el contenido de tu passphrase como su longitud. Simplemente escribe tu passphrase y presiona `Enter` al terminar. +- `Title for your SSH key`. Puede dejarlo en la propuesta "GitHub CLI", presiona `Enter`. Obtendrás el siguiente resultado: diff --git a/_partials/es/github.md b/_partials/es/github.md index fc0f5f1e..cd45b7b0 100644 --- a/_partials/es/github.md +++ b/_partials/es/github.md @@ -5,3 +5,5 @@ :point_right: **[Sube una foto](https://github.com/settings/profile)** y escribe tu nombre correctamente en tu cuenta GitHub. Esto es importante porque nosotros usaremos un tablero de comando interno con tu avatar. Por favor hazlo **ahora** antes de dar un paso más en esta guía. ![Foto GitHub](images/github_picture.png) + +:point_right: **[Habilita la Autenticación de Dos Factores (2FA)](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-text-messages)**. GitHub te enviará mensajes de texto con un código cuando intentes iniciar sesión. Esto es importante para la seguridad y también pronto será necesario para contribuir código en GitHub. diff --git a/_partials/es/intro.md b/_partials/es/intro.md index 7dc118ed..bdd99f21 100644 --- a/_partials/es/intro.md +++ b/_partials/es/intro.md @@ -1,6 +1,6 @@ # Instrucciones de la configuración -Aquí abajo encontrarás las instrucciones para la configuración que tu computadora necesita para el [curso de Desarrollo Web de Le Wagon](https://www.lewagon.com/web-development-course/full-time). +Aquí abajo encontrarás las instrucciones para la configuración que tu computadora necesita para el [curso de AI Software Development de Le Wagon](https://www.lewagon.com/web-development-course/full-time). Por favor, **léelas cuidadosamente y ejecuta todos los comandos en el orden indicado**. Si tienes algún problema, no dudes en pedirle ayuda a tu profesor :raising_hand: diff --git a/_partials/es/macos_postgresql.md b/_partials/es/macos_postgresql.md index 97f98afe..5da0d401 100644 --- a/_partials/es/macos_postgresql.md +++ b/_partials/es/macos_postgresql.md @@ -7,8 +7,12 @@ Vamos a instalarlo ahora. Ejecuta los siguientes comandos: ```bash -brew install postgresql -brew services start postgresql +brew install postgresql@15 libpq +brew link --force libpq +``` + +```bash +brew services start postgresql@15 ``` Cuando termines, verifica que funcione: @@ -20,7 +24,7 @@ psql -d postgres Deberías ver un nuevo mensaje como este :point_down: ```bash -psql (14.4) +psql (15.2) Type "help" for help. postgres=# diff --git a/_partials/es/macos_rbenv.md b/_partials/es/macos_rbenv.md index 03197a66..397cf17a 100644 --- a/_partials/es/macos_rbenv.md +++ b/_partials/es/macos_rbenv.md @@ -26,5 +26,5 @@ exec zsh Luego ejecuta esto: ```bash -brew install rbenv +brew install rbenv libyaml ``` diff --git a/_partials/es/macos_settings.md b/_partials/es/macos_settings.md index a7c2e863..2b923c2a 100644 --- a/_partials/es/macos_settings.md +++ b/_partials/es/macos_settings.md @@ -2,9 +2,9 @@ ### Seguridad -Es imperativo proteger tu sesión con una contraseña. Si todavía no es el caso, ve a ` > System Preferences > Users & Groups` y cambia la contraseña de tu computadora. Luego ve a ` > System Preferences > Security > General`. Configura el sistema para que pida la contraseña cada `5 seconds` después de regresar de la opción suspender y cuando se active el protector de pantalla. +Es imperativo proteger tu sesión con una contraseña. Si todavía no es el caso, ve a ` > System Settings... > Users & Groups` y cambia la contraseña de tu computadora. Luego ve a ` > System Settings... > Lock Screen`. Configura el sistema para que pida la contraseña cada `5 seconds` después de regresar de la opción suspender y cuando se active el protector de pantalla. -También puedes ir a ` > System Preferences > Mission Control` y haz clic en el botón `Hot Corners` abajo a la izquierda. Selecciona la opción donde al hacer clic en la esquina inferior derecha se active el protector de pantalla. De esa manera al dejar tu escritorio podrás bloquear tu pantalla rápidamente poniendo el cursor del ratón en la esquina inferior derecha. En 5 segundos tu Macbook se bloqueará y te pedirá la contraseña para volver a tu sesión. +También puedes ir a ` > System Settings... > Desktop & Dock` y hacer clic en el botón `Hot Corners...` abajo a la izquierda. Selecciona la opción donde al hacer clic en la esquina inferior derecha se active el protector de pantalla. De esa manera al dejar tu escritorio podrás bloquear tu pantalla rápidamente poniendo el cursor del ratón en la esquina inferior derecha. En 5 segundos tu Macbook se bloqueará y te pedirá la contraseña para volver a tu sesión. ### Teclado @@ -12,7 +12,7 @@ A medida que te vayas convirtiendo en programador, entenderás que pierdes tiemp #### Velocidad del teclado -Ve a ` > System Preferences > Keyboard`. Coloca a `Key Repeat` en la posición más rápida (a la derecha) y a `Delay Until Repeat` en la posición más corta (a la derecha). +Ve a ` > System Settings... > Keyboard`. Coloca a `Key repeat rate` en la posición más rápida (a la derecha) y a `Delay until repeat` en la posición más corta (a la derecha). #### macOS para hackers @@ -44,4 +44,3 @@ Ancla lo siguiente: - VS Code - Tu navegador de Internet - Slack -- Zoom diff --git a/_partials/es/macos_zoom.md b/_partials/es/macos_zoom.md deleted file mode 100644 index b4b8185a..00000000 --- a/_partials/es/macos_zoom.md +++ /dev/null @@ -1,33 +0,0 @@ -## Zoom - -Para poder interactuar cuando no estemos en el mismo lugar físico, usaremos [Zoom](https://zoom.us/), una herramienta de videoconferencia. - -:warning: Si ya tienes Zoom instalado, por favor asegúrate de que por lo menos tienes la versión **5.6**. - -Ve a [zoom.us/download](https://zoom.us/download). - -Haz clic en el botón **Download** debajo de **Zoom Client**. - -Abre el archivo que acabas de descargar para instalar la aplicación. - -Abre la aplicación Zoom. - -Si tienes una Mac con Apple silicon, [te pedirán instalar Rosetta](https://support.apple.com/en-us/HT211861). Haz clic en instalar. Luego escribe tu nombre y contraseña para que corra la instalación. - -![Instala Rosetta](https://support.apple.com/library/content/dam/edam/applecare/images/en_US/macos/Big-Sur/macos-big-sur-software-update-rosetta-alert.jpg) - -Si ya tienes una cuenta Zoom, inicia sesión con tus credenciales. - -Si no, haz clic en el enlace **Sign Up Free**, que significa registrarse gratuitamente: - -![Registrarse gratuitamente en Zoom](images/zoom_sign_up_free.png) - -Te redireccionarán a la página de Zoom para que completes un formulario. - -Cuando termines, regresa a la aplicación Zoom e inicia sesión usando tus credenciales. - -Deberías ver una pantalla como la siguiente: - -![Pantalla de inicio de Zoom](images/zoom_home_screen.png) - -Ya puedes cerrar la aplicación Zoom. diff --git a/_partials/es/rbenv.md b/_partials/es/rbenv.md index 713fa681..85519dea 100644 --- a/_partials/es/rbenv.md +++ b/_partials/es/rbenv.md @@ -14,7 +14,7 @@ rm -rf ~/.rbenv Luego ejecuta lo siguiente en tu terminal: ```bash -sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev +sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev libyaml-dev ``` ```bash diff --git a/_partials/es/ruby.md b/_partials/es/ruby.md index 674f04f1..537a93cd 100644 --- a/_partials/es/ruby.md +++ b/_partials/es/ruby.md @@ -28,7 +28,7 @@ Luego ejecuta esto: ruby -v ``` -:heavy_check_mark: Si ves algo que comience por `ruby p`, entonces puedes continuar +1: +:heavy_check_mark: Si ves algo que comience por `ruby `, entonces puedes continuar +1: :x: Si no es el caso, **pídele ayuda a un profesor**. @@ -54,6 +54,12 @@ gem sources -l En el universo de ruby, a las librerías externas se les llama `gems`: son pedazos de código ruby que puedes descargar y ejecutar en tu computadora. ¡Instalemos algunas! +Primero, vamos a actualizar `bundler`, que es lo que nos permite instalar gemas: + +```bash +gem update bundler +``` + En tu terminal, copia y pega el siguiente comando: ```bash diff --git a/_partials/es/slack_settings.md b/_partials/es/slack_settings.md index 84e8acdd..9ad5ed6b 100644 --- a/_partials/es/slack_settings.md +++ b/_partials/es/slack_settings.md @@ -10,7 +10,11 @@ La idea es tener Slack abierto todo el día para compartir enlaces útiles / ped Para asegurarte de que todo lo relacionado a videollamadas funcione bien, prueba tu cámara y tu micrófono: - Abre la aplicación Slack -- Escribe `/call --test` en la barra de mensaje de cualquier canal y presiona `Enter` +- Haz clic en tu foto de perfil en la esquina superior derecha +- Selecciona "Preferencias" en el menú. +- Haz clic en "Audio y vídeo" en la columna de la izquierda. +- Debajo de "Solución de problemas", haz clic en "Ejecutar una prueba de audio, vídeo y pantalla compartida". La prueba se abrirá en una nueva ventana. +- Comprueba que tus dispositivos preferidos de altavoz, micrófono y cámara aparecen en los menús desplegables y haz clic en "Iniciar prueba" - Haz clic en el botón verde "Start test" ![Chequea el micrófono y la cámara con Slack](images/slack_call_test.png) diff --git a/_partials/es/sqlite.md b/_partials/es/sqlite.md index 02829ba9..ade98655 100644 --- a/_partials/es/sqlite.md +++ b/_partials/es/sqlite.md @@ -5,7 +5,7 @@ En algunas semanas hablaremos de bases de datos y de SQL. [SQLite](https://sqlit En un terminal, ejecuta los siguientes comandos: ```bash -sudo apt-get install sqlite3 libsqlite3-dev +sudo apt-get install sqlite3 libsqlite3-dev pkg-config ``` A continuación, ejecuta el siguiente comando: diff --git a/_partials/es/ubuntu_settings.md b/_partials/es/ubuntu_settings.md index eead3876..50901d79 100644 --- a/_partials/es/ubuntu_settings.md +++ b/_partials/es/ubuntu_settings.md @@ -48,4 +48,3 @@ Ancla lo siguiente: - VS Code - Tu navegador de Internet - Slack -- Zoom diff --git a/_partials/es/vscode_aifeatures.md b/_partials/es/vscode_aifeatures.md new file mode 100644 index 00000000..db45b329 --- /dev/null +++ b/_partials/es/vscode_aifeatures.md @@ -0,0 +1,17 @@ +### Funciones de IA en VS Code + +VS Code incluye muchas y potentes **funciones de IA**, que son una gran herramienta una vez que ya sabes programar. + +Dicho esto, depender de la IA demasiado pronto puede ocultar conceptos importantes y dificultar la comprensión de la depuración. Una vez que estés cómodo con los fundamentos, sabrás cuándo y cómo usar la IA de forma eficaz —sin dejar que haga el trabajo por ti. + +Para el inicio del bootcamp, desactivaremos estas funciones. Llegado el momento apropiado en el curso, las volveremos a habilitar para que puedas utilizarlas bien. + +En **VS Code**: + +1. Abramos la "Paleta de comandos" de VS Code: escribe `Ctrl-Shift-P` (Windows / Linux) o `Cmd-Shift-P` (macOS). +1. Se abrirá la Paleta de comandos: una pequeña caja de texto en la parte superior de la pantalla. Empieza a escribir `aifeatures` hasta que veas "Chat: Learn How to Hide AI features". Haz clic en ella. + ![The Command Palette at the top of the screen](images/vscode_find_aifeatures.png) +1. Esto abrirá la configuración y te mostrará la opción "Disable and hide built-in AI features ...". Marca la casilla delante de esa opción. + ![Check the disable option](images/vscode_disable_aifeatures.png) + +Más adelante, si quieres **volver a habilitar** las funciones de IA, puedes seguir las mismas instrucciones para desmarcar la casilla. diff --git a/_partials/es/vscode_extensions.md b/_partials/es/vscode_extensions.md index 0451ada1..7c571186 100644 --- a/_partials/es/vscode_extensions.md +++ b/_partials/es/vscode_extensions.md @@ -11,17 +11,20 @@ code --install-extension ms-vscode.sublime-keybindings code --install-extension emmanuelbeziat.vscode-great-icons code --install-extension github.github-vscode-theme code --install-extension MS-vsliveshare.vsliveshare -code --install-extension rebornix.ruby +code --install-extension shopify.ruby-lsp code --install-extension dbaeumer.vscode-eslint code --install-extension Rubymaniac.vscode-paste-and-indent code --install-extension alexcvzz.vscode-sqlite +code --install-extension anteprimorac.html-end-tag-labels +code --install-extension marcoroth.herb-lsp +code --install-extension rayhanw.erb-helpers ``` Aquí está la lista de las extensiones que estás instalando: - [Sublime Text Keymap and Settings Importer](https://marketplace.visualstudio.com/items?itemName=ms-vscode.sublime-keybindings) - [VSCode Great Icons](https://marketplace.visualstudio.com/items?itemName=emmanuelbeziat.vscode-great-icons) - [Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare) -- [Ruby](https://marketplace.visualstudio.com/items?itemName=rebornix.Ruby) +- [Ruby](https://marketplace.visualstudio.com/items?itemName=shopify.ruby-lsp) - [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) - [Paste and Indent](https://marketplace.visualstudio.com/items?itemName=Rubymaniac.vscode-paste-and-indent) - [SQLite](https://marketplace.visualstudio.com/items?itemName=alexcvzz.vscode-sqlite) diff --git a/_partials/es/windows_browser.md b/_partials/es/windows_browser.md index 3e55b081..ea228fee 100644 --- a/_partials/es/windows_browser.md +++ b/_partials/es/windows_browser.md @@ -58,6 +58,7 @@ Para asegurarnos de que puedas interactuar desde la terminal de Ubuntu con el na Ejecuta el siguiente comandos: ```bash + echo "export BROWSER=\"/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe\"" >> ~/.zshrc echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'\"" >> ~/.zshrc ``` diff --git a/_partials/es/windows_postgresql.md b/_partials/es/windows_postgresql.md index 72e24554..ebf8d15d 100644 --- a/_partials/es/windows_postgresql.md +++ b/_partials/es/windows_postgresql.md @@ -34,6 +34,6 @@ echo "sudo /etc/init.d/postgresql start" >> ~/.zshrc Abre una nueva terminal. -:heavy_check_mark: Si ves un mensaje `* Starting PostgreSQL 12 database server`, entonces todo está bien y puedes continuar :+1: +:heavy_check_mark: Si ves un mensaje `* Starting postgresql (via systemctl): postgresql.service` O `* Starting PostgreSQL 14 database server`, entonces todo está bien y puedes continuar :+1: :x: Si no es el caso, **contacta a un profesor**. diff --git a/_partials/es/windows_settings.md b/_partials/es/windows_settings.md index 5fb353d2..090527e3 100644 --- a/_partials/es/windows_settings.md +++ b/_partials/es/windows_settings.md @@ -49,4 +49,3 @@ Ancla lo siguiente: - VS Code - Tu navegador de Internet - Slack -- Zoom diff --git a/_partials/es/windows_terminal.md b/_partials/es/windows_terminal.md index b521e912..4de29ca0 100644 --- a/_partials/es/windows_terminal.md +++ b/_partials/es/windows_terminal.md @@ -6,8 +6,10 @@ Si estás utilizando Windows 11, la terminal de Windows ya está instalada y puedes ir a la siguiente sección :point_down: +Si tienes Windows 10, instala la terminal de Windows. Verás que es una terminal moderna. -Si tienes Windows 10, instala la terminal de Windows. Verás que es una terminal moderna: +
+**Windows 10**: Instalar Windows Terminal - Haz clic en `Start` - Escribe `Microsoft Store` @@ -32,6 +34,8 @@ Si tienes Windows 10, instala la terminal de Windows. Verás que es una terminal Cuando termine la instalación, el botón `Install` se transformará en un botón `Launch`: haz clic en él. +
+ ### Ubuntu como terminal predeterminada Hagamos que Ubuntu sea la terminal predeterminada de tu aplicación Windows terminal. @@ -65,7 +69,7 @@ Luego deshabilita el warning para copiar y pegar comandos entre Windows y Ubuntu - Agrega la siguiente línea debajo de eso: ```bash -"multiLinePasteWarning": false, +"warning.multiLinePaste": false, ``` :warning: ¡No olvides la coma al final de la línea! diff --git a/_partials/es/windows_ubuntu.md b/_partials/es/windows_ubuntu.md index 0a33160e..22d77bff 100644 --- a/_partials/es/windows_ubuntu.md +++ b/_partials/es/windows_ubuntu.md @@ -2,13 +2,13 @@ ### Instalación -: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: +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. -#### Windows 11 - -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. +
+Solución de problemas para Windows 10 (solo si es necesario, consulta con un profesor) -#### Windows 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. +
Si tienes Windows 10, instala la terminal de Windows por medio de la Microsoft Store: @@ -34,6 +34,8 @@ Si tienes Windows 10, instala la terminal de Windows por medio de la Microsoft S Cuando termine la instalación, el botón `Get` se transformará en un botón `Open`: Haz clic en él. + + ### Primer uso La primera vez que lo abras, te pedirán que: @@ -47,8 +49,6 @@ La primera vez que lo abras, te pedirán que: :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. -Ahora puedes cerrar la ventana de Ubuntu ya que está instalado en tu computadora. - ### Chequea la versión WSL de Ubuntu - Presiona `Windows` + `R` @@ -77,7 +77,6 @@ wsl -l -v :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. :x: Si no funciona, tendremos que asegurarnos de que los archivos de Ubuntu no estén comprimidos. -
Chequea si los archivos no están comprimidos @@ -97,3 +96,17 @@ wsl -l -v
Ya puedes cerrar la ventana de la terminal. + + + +### Comprueba tu nombre de usuario + +Escribe esto en la terminal de Ubuntu: + +```bash +whoami +``` + +Debería devolver el nombre de usuario que elegiste anteriormente. + +:x: Si dice `root`, **contacta a un profesor** antes de continuar. diff --git a/_partials/es/windows_version.md b/_partials/es/windows_version.md index 8103fe96..63ca4f55 100644 --- a/_partials/es/windows_version.md +++ b/_partials/es/windows_version.md @@ -4,6 +4,10 @@ Antes de comenzar, necesitamos verificar que la versión de Windows instalada en ### Windows 10 o Windows 11 +> :warning: **Nota sobre Windows 10 y seguridad** +> +> La configuración del bootcamp de Le Wagon funciona en Windows 10. Dicho esto, recomendamos encarecidamente actualizar a Windows 11. Desde el 14 de octubre de 2025 Microsoft finalizó el soporte para Windows 10, lo que significa que ya no recibirá actualizaciones de seguridad y podría poner tu equipo en riesgo. Para más detalles, consulta la [guía de Microsoft](https://support.microsoft.com/en-us/windows/windows-10-support-has-ended-on-october-14-2025-2ca8b313-1946-43d3-b55c-2b95b107f281). Si tu equipo no puede ejecutar Windows 11, considera cambiar a Ubuntu. + Para poder configurar tu computadora, necesitas tener **Windows 10 o Windows 11** instalado. Para chequear la versión de tu Windows: @@ -11,62 +15,51 @@ Para chequear la versión de tu Windows: - Escribe `winver` - Presiona `Enter` -: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: - -:x: Si no es el caso, no puedes continuar. Primero debes actualizar tu versión a Windows 10 :point_down: +: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: -
- Actualizar a Windows 10 +:heavy_check_mark: Si las primeras palabras de esta ventana son **Windows 10**, verifica el **número de la versión**: - - Descarga Windows 10 desde [Microsoft](https://www.microsoft.com/software-download/windows10ISO) - - Instálalo. Debería tomar como una hora pero realmente depende de tu computadora. - - Cuando termine la instalación, ejecuta los comandos de aquí arriba :point_up: para chequear que tengas **Windows 10**. -
+- :heavy_check_mark: Si dice al menos `2004`, entonces todo está bien :+1: -: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. +- :x: Si es inferior a `2004`, debes actualizar tu versión. -:warning: **Si tienes Windows 10 instalado, no necesitas actualizarlo a Windows 11 para hacer esta configuración**. +-
+ Cómo instalar las últimas actualizaciones? -### Últimas actualizaciones + Abre Windows Update: + - Presiona `Windows` + `R` + - Escribe `ms-settings:windowsupdate` + - Presiona `Enter` + - Haz clic en `Check updates` -Una vez que estés seguro de que estés usando Windows 10 o 11, instala las siguientes actualizaciones. + :heavy_check_mark: Si tienes una marca verde y el siguiente mensaje "You're up to date", entonces todo está bien :+1: -Abre Windows Update: -- Presiona `Windows` + `R` -- Escribe `ms-settings:windowsupdate` -- Presiona `Enter` -- Haz clic en `Check updates` + :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: -:heavy_check_mark: Si tienes una marca verde y el siguiente mensaje "You're up to date", entonces todo está bien :+1: + :x: Si obtienes un mensaje de error diciendo que Windows no puede aplicar las actualizaciones, por favor **contacta a un profesor**. -: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: +
+ Activa Windows Update Service para resolver las Actualizaciones -:x: Si obtienes un mensaje de error diciendo que Windows no puede aplicar las actualizaciones, por favor **contacta a un profesor**. + Algunos antivirus y programas deshabilitan las actualizaciones que necesitamos y luego se muestra un error. ¡Solucionemos esto! + - Presiona `Windows` + `R` + - Escribe `services.msc` + - Presiona `Enter` + - Haz doble clic en `Windows Update Service` + - Coloca su `Startup` en `Automatic` + - Haz clic en `Start` + - Haz clic en `Ok` + ¡Ahora intenta instalar las actualizaciones nuevamente! +
-
- Activa Windows Update Service para resolver las Actualizaciones + Verifica el número de la versión: - Algunos antivirus y programas deshabilitan las actualizaciones que necesitamos y luego se muestra un error. ¡Solucionemos esto! - Presiona `Windows` + `R` - - Escribe `services.msc` + - Escribe `winver` - Presiona `Enter` - - Haz doble clic en `Windows Update Service` - - Coloca su `Startup` en `Automatic` - - Haz clic en `Start` - - Haz clic en `Ok` - ¡Ahora intenta instalar las actualizaciones nuevamente! -
- -### Requisito mínimo para la versión - -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. - -- Presiona `Windows` + `R` -- Escribe `winver` -- Presiona `Enter` -Verifica el **número de la versión**: + :heavy_check_mark: Si dice al menos `2004`, entonces todo está bien :+1: -:heavy_check_mark: Si dice al menos `1903`, entonces todo está bien :+1: + :x: Si es inferior a `2004`, por favor **contacta a un profesor**. -:x: Si es inferior a `1903`, por favor **contacta a un profesor**. +
diff --git a/_partials/es/windows_vscode.md b/_partials/es/windows_vscode.md index 717f9d47..bd45987b 100644 --- a/_partials/es/windows_vscode.md +++ b/_partials/es/windows_vscode.md @@ -31,7 +31,7 @@ Luego abre VS Code desde la terminal: code . ``` -:heavy_check_mark: Si ves `WSL: Ubuntu` en una caja verde en la esquina inferior izquierda de la ventana de VS Code, entonces todo está bien y puedes continuar :+1: +:heavy_check_mark: Si ves `WSL: Ubuntu` en la esquina inferior izquierda de la ventana de VS Code, entonces todo está bien y puedes continuar :+1: ![WSL Ubuntu Remote](images/windows_remote_wsl.png) diff --git a/_partials/es/windows_wsl.md b/_partials/es/windows_wsl.md index 2c938a20..c5230f2f 100644 --- a/_partials/es/windows_wsl.md +++ b/_partials/es/windows_wsl.md @@ -2,21 +2,17 @@ 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). -: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: +Instalaremos WSL 2 y Ubuntu con un comando a través de la Windows Command Prompt. -### Windows 11 - -Si usas Windows 11, instalaremos WSL 2 y Ubuntu con un comando a través de la terminal de Windows. - -: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`. +: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`. - Presiona `Windows` + `R` -- Escribe `wt` +- Escribe `cmd` - Presiona **`Ctrl` + `Shift` + `Enter`** :warning: tal vez tengas que aceptar la confirmación UAC sobre el cambio en los privilegios. -Un ventana de terminal azul aparecerá: +Un ventana de terminal aparecerá: - Copia el siguiente comando (`Ctrl` + `C`) - Pégalo en la ventana de la terminal (`Ctrl` + `V` o haciendo clic derecho en la ventana) - Ejecútalo presionado `Enter` @@ -29,11 +25,10 @@ wsl --install :x: Si obtienes un mensaje de error (o si ves algún texto en rojo en la ventana), por favor **contacta a un profesor** -### Windows 10 - -#### Instalación de WSL 1 +
+Solución de problemas para Windows 10 (solo si es necesario, consulta con un profesor) -Si tienes Windows 10, primero instalaremos WSL 1 por medio de la Terminal de PowerShell. +#### Para Windows 10 < 2004: instala primero WSL 1 :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`. @@ -64,7 +59,7 @@ dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /nores :x: Si obtienes un mensaje de error (o si ves algún texto en rojo en la ventada), por favor **contacta a un profesor** -#### Actualización a WSL 2 +#### Para Windows 10 con WSL 1: Actualización a WSL 2 Si tienes Windows 10, actualizaremos WSL a la versión 2. @@ -82,7 +77,7 @@ Cuando se reinicie tu computadora, descarga el instalador de WSL2. :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. -#### Coloca WSL 2 como el Subsistema Windows por defecto para Linux +#### Para Windows 10 con WSL 1: Coloca WSL 2 como el Subsistema Windows por defecto para Linux Si tienes Windows 10, pondremos la versión predeterminada de WSL en 2. @@ -114,3 +109,5 @@ wsl --set-default-version 2 :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:
+ + diff --git a/_partials/es/yarn.md b/_partials/es/yarn.md index 71ccaa1f..b96faeb4 100644 --- a/_partials/es/yarn.md +++ b/_partials/es/yarn.md @@ -5,10 +5,16 @@ En una terminal, ejecuta los siguientes comandos: ```bash -npm install --global yarn +corepack enable +yarn set version stable +``` + +```bash exec zsh ``` +⚠️ Si ves algún mensaje de error, intenta ejecutar `npm install -g corepack` y luego vuelve a ejecutar los comandos anteriores. + Luego ejecuta este comando: ```bash diff --git a/_partials/es/zoom.md b/_partials/es/zoom.md deleted file mode 100644 index 2b5a2733..00000000 --- a/_partials/es/zoom.md +++ /dev/null @@ -1,29 +0,0 @@ -## Zoom - -Para poder interactuar cuando no estemos en el mismo lugar físico, usaremos [Zoom](https://zoom.us/), una herramienta de videoconferencia. - -:warning: Si ya tienes Zoom instalado, por favor asegúrate de que por lo menos tienes versión **5.6**. - -Ve a [zoom.us/download](https://zoom.us/download). - -Haz clic en el botón **Download** debajo de **Zoom Client**. - -Abre el archivo que acabas de descargar para instalar la aplicación. - -Abre la aplicación Zoom. - -Si ya tienes una cuenta Zoom, inicia sesión con tus credenciales. - -Si no, haz clic en el enlace **Sign Up Free**, que significa registrarse gratuitamente: - -![Registrarse gratuitamente en Zoom](images/zoom_sign_up_free.png) - -Te redireccionarán a la página de Zoom para que completes un formulario. - -Cuando termines, regresa a la aplicación Zoom e inicia sesión usando tus credenciales. - -Deberías ver una pantalla como la siguiente: - -![Pantalla de inicio de Zoom](images/zoom_home_screen.png) - -Ya puedes cerrar la aplicación Zoom. diff --git a/_partials/fr/cli_tools.md b/_partials/fr/cli_tools.md index 18b15ab2..1fbb3d2b 100644 --- a/_partials/fr/cli_tools.md +++ b/_partials/fr/cli_tools.md @@ -1,5 +1,35 @@ ## Outils en ligne de commande +### Vérifier la locale + +Le concept de "locale" permet de personnaliser les programms en fonction de ta langue et ton pays. + +Vérifions que la locale est bien en **anglais** dans le terminal : + +```bash +locale +``` + +Si la commande ne renvoie pas quelque chose qui contient `LANG=en_US.UTF-8`, lance ceci dans un terminal Ubuntu : + +```bash +sudo locale-gen en_US.UTF-8 +``` + +Si après, tu reçois un avertissement (`bash: warning: setlocale: LC_ALL: cannot change locale (en_US.utf-8)`) dans ton terminal, veuillez faire ce qui suit : + +
+ Générer la localisation + +Veuillez exécuter ces lignes dans ton terminal. + +```bash +sudo update-locale LANG=en_US.UTF8 +sudo apt-get update +sudo apt-get install language-pack-en language-pack-en-base manpages +``` +
+ ### Zsh & Git Au lieu d’utiliser le [shell](https://fr.wikipedia.org/wiki/Interface_syst%C3%A8me) `bash` par défaut, nous utiliserons `zsh`. diff --git a/_partials/fr/conclusion.md b/_partials/fr/conclusion.md index 25e17c64..24152545 100644 --- a/_partials/fr/conclusion.md +++ b/_partials/fr/conclusion.md @@ -1,5 +1,5 @@ ## La configuration est terminée ! -Ton ordinateur est prêt pour [la formation Développement Web du Wagon](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: +Ton ordinateur est prêt pour [la formation AI Software Development du Wagon](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: Profite du bootcamp, tu vas assurer :rocket: diff --git a/_partials/fr/dotfiles.md b/_partials/fr/dotfiles.md index 827a4b45..9ce8d5fa 100644 --- a/_partials/fr/dotfiles.md +++ b/_partials/fr/dotfiles.md @@ -55,7 +55,7 @@ cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh :point_up: On te **demandera** de fournir ton nom (`FirstName LastName`) et ton adresse e-mail. -:warning: Tu **dois** saisir l’une des adresses e-mail indiquées ci-dessus avec la commande `gh api ...` précédente. Sinon, Kitt ne pourra pas suivre tes progrès. +:warning: Tu **dois** saisir l’une des adresses e-mail indiquées ci-dessus avec la commande `gh api ...` précédente. Sinon, Kitt ne pourra pas suivre tes progrès. 💡 Sélectionnez l'adresse `@users.noreply.github.com` si vous ne souhaitez pas que votre adresse e-mail apparaisse dans les dépôts publics auxquels vous pourriez contribuer. **Réinitialise** ton terminal en exécutant : diff --git a/_partials/fr/gh_cli.md b/_partials/fr/gh_cli.md index 7b549341..36d4988e 100644 --- a/_partials/fr/gh_cli.md +++ b/_partials/fr/gh_cli.md @@ -4,6 +4,8 @@ CLI est l’acronyme de [Command-line Interface](https://en.wikipedia.org/wiki/C Dans cette section, tu vas installer [GitHub CLI](https://cli.github.com/) pour interagir avec GitHub directement depuis le terminal. +Nous allons utiliser GitHub CLI (`gh`) pour nous connecter à GitHub en utilisant *SSH*, un protocole pour s'authentifier en utilisant des clés SSH au lieu de la fameuse paire nom d'utilisateur et mot de passe. + Elle doit déjà être installée sur ton ordinateur grâce aux commandes précédentes. Pour **te connecter**, commence par copier-coller la commande suivante dans ton terminal : @@ -11,20 +13,18 @@ Pour **te connecter**, commence par copier-coller la commande suivante dans ton :warning: **NE modifie PAS `email`** ```bash -gh auth login -s 'user:email' -w +gh auth login -s 'user:email' -w --git-protocol ssh ``` -gh va te poser quelques questions : - -`What is your preferred protocol for Git operations?` Avec les flèches, choisis `SSH` et appuie sur `Enter`. SSH est un protocole pour s'authentifier en utilisant des clés SSH au lieu de la fameuse paire nom d'utilisateur et mot de passe. +`gh` va te poser quelques questions : -`Generate a new SSH key to add to your GitHub account?` Appuie sur `Enter` pour demander à gh de générer les clés SSH pour toi. +- `Generate a new SSH key to add to your GitHub account?` Appuie sur `Enter` pour demander à gh de générer les clés SSH pour toi. -Si tu as déjà des clés SSH, tu verras à la place `Upload your SSH public key to your GitHub account?` Avec les flèches, sélectionne le chemain de ta clé publique et appuie sur `Enter`. + Si tu as déjà des clés SSH, tu verras à la place `Upload your SSH public key to your GitHub account?` Avec les flèches, sélectionne le chemain de ta clé publique et appuie sur `Enter`. -`Enter a passphrase for your new SSH key (Optional)`. Saisis un mot de passe dont tu te souviendras. Ce mot de passe sert à protéger ta clé privée enregistrée sur ton disque sur. Ensuite, appuie sur `Enter`. +- `Enter a passphrase for your new SSH key (Optional)`. Saisis un mot de passe dont tu te souviendras. Ce mot de passe sert à protéger ta clé privée enregistrée sur ton disque sur. Ensuite, appuie sur `Enter`. -:warning: Lorsque tu saisiras ton mot de passe, rien ne s’affichera à l’écran ; **c’est normal**. Il s’agit d’une mesure de sécurité permettant de masquer non seulement les caractères de ton mot de passe, mais aussi sa longueur. Saisis simplement ton mot de passe, puis appuie sur `Enter`. +- `Title for your SSH key`. Tu peux laisser ce qui est proposé par défaut, à savoir "GitHub CLI", appuie sur `Enter`. Tu obtiendras le résultat suivant : diff --git a/_partials/fr/github.md b/_partials/fr/github.md index 845f80a7..ea5021e7 100644 --- a/_partials/fr/github.md +++ b/_partials/fr/github.md @@ -5,3 +5,5 @@ Est-ce que tu as déjà un compte GitHub ? Si ce n’est pas le cas, [inscris-t :point_right: **[Télécharge une photo](https://github.com/settings/profile)** et indique correctement ton nom sur ton compte GitHub. C’est important, car notre tableau de bord interne utilise ton avatar. Fais-le **maintenant** avant de poursuivre la configuration de ton ordinateur. ![image de GitHub](images/github_picture.png) + +:point_right: **[Activez l'authentification à deux facteurs (2FA)](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-text-messages)**. GitHub vous enverra des messages texte avec un code lorsque vous essayez de vous connecter. C'est important pour la sécurité et cela sera bientôt obligatoire pour contribuer du code sur GitHub. diff --git a/_partials/fr/intro.md b/_partials/fr/intro.md index f641bd3d..91f7f138 100644 --- a/_partials/fr/intro.md +++ b/_partials/fr/intro.md @@ -1,6 +1,6 @@ # Instructions de configuration -Les instructions ci-dessous vont te permettre de configurer ton ordinateur pour [la formation Développement Web du Wagon](https://www.lewagon.com/web-development-course/full-time). +Les instructions ci-dessous vont te permettre de configurer ton ordinateur pour [la formation AI Software Development du Wagon](https://www.lewagon.com/web-development-course/full-time). **Lis-les attentivement et exécute toutes les commandes dans l’ordre suivant**. En cas de blocage, n’hésite pas à demander au prof :raising_hand: diff --git a/_partials/fr/macos_postgresql.md b/_partials/fr/macos_postgresql.md index 2a8d420f..9e7c441d 100644 --- a/_partials/fr/macos_postgresql.md +++ b/_partials/fr/macos_postgresql.md @@ -4,14 +4,18 @@ Parfois, SQLite n'est pas suffisant et nous aurons besoin d'un outil plus avanc Installons-le maintenant. -Exécute les commandes suivantes : +Exécute les commandes suivantes : ```bash -brew install postgresql -brew services start postgresql +brew install postgresql@15 libpq +brew link --force libpq ``` -Une fois que c’est fait, on va vérifier que tout a bien fonctionné : +```bash +brew services start postgresql@15 +``` + +Une fois que c’est fait, on va vérifier que tout a bien fonctionné : ```bash psql -d postgres @@ -20,7 +24,7 @@ psql -d postgres Tu devrais voir apparaître un nouveau message comme celui-ci :point_down: ```bash -psql (14.4) +psql (15.2) Type "help" for help. postgres=# diff --git a/_partials/fr/macos_rbenv.md b/_partials/fr/macos_rbenv.md index ce706df2..a6297fe8 100644 --- a/_partials/fr/macos_rbenv.md +++ b/_partials/fr/macos_rbenv.md @@ -26,5 +26,5 @@ exec zsh Puis exécute ensuite : ```bash -brew install rbenv +brew install rbenv libyaml ``` diff --git a/_partials/fr/macos_settings.md b/_partials/fr/macos_settings.md index 022ecd61..59277722 100644 --- a/_partials/fr/macos_settings.md +++ b/_partials/fr/macos_settings.md @@ -2,9 +2,9 @@ ### Sécurité -Tu dois obligatoirement protéger ta session avec un mot de passe. Si ce n’est pas déjà le cas, va dans ` > Préférences système > Utilisateurs & groupes` et modifie le mot de passe de ton compte. Va aussi dans ` > Préférences système > Sécurité > Général` et configure la sécurité de façon à ce que ton mot de passe te soit demandé `5 secondes` après la mise en veille ou le démarrage de l’économiseur d’écran. +Tu dois obligatoirement protéger ta session avec un mot de passe. Si ce n’est pas déjà le cas, va dans ` > Réglages Système > Utilisateurs & groupes` et modifie le mot de passe de ton compte. Va aussi dans ` > Réglages Système > Sécurité > Général` et configure la sécurité de façon à ce que ton mot de passe te soit demandé `5 secondes` après la mise en veille ou le démarrage de l’économiseur d’écran. -Tu peux également aller dans ` > Préférences système > Mission Control` et cliquer sur le bouton `Hot Corners` en bas à gauche. Choisis le coin inférieur droit pour démarrer l’économiseur d’écran. De cette façon, lorsque tu quitteras ton bureau, tu pourras rapidement verrouiller ton écran en plaçant ta souris dans le coin inférieur droit. Cinq secondes plus tard, ton Mac sera verrouillé et tu devras fournir ton mot de passe pour accéder à ta session. +Tu peux également aller dans ` > Réglages Système > Bureau et Dock` et cliquer sur le bouton `coins actifs (Hot Corners)` en bas à gauche. Choisis le coin inférieur droit pour démarrer l’économiseur d’écran. De cette façon, lorsque tu quitteras ton bureau, tu pourras rapidement verrouiller ton écran en plaçant ta souris dans le coin inférieur droit. Cinq secondes plus tard, ton Mac sera verrouillé et tu devras fournir ton mot de passe pour accéder à ta session. ### Clavier @@ -12,7 +12,7 @@ Au fur et à mesure de ta formation de programmeur, tu comprendras que quitter l #### Vitesse du clavier -Va dans ` > Préférences système > Clavier`. Définis `Répétition de touches` sur la position la plus rapide (à droite) et `Pause avant répétition` sur la position la plus courte (à droite). +Va dans ` > Réglages Système > Clavier`. Définis `Vitesse de répétition des touches` sur la position la plus rapide (à droite) et `Pause avant répétition` sur la position la plus courte (à droite). #### macOS pour les hackers @@ -44,4 +44,3 @@ Tu dois épingler : - VS Code - ton navigateur Internet - Slack -- Zoom diff --git a/_partials/fr/macos_zoom.md b/_partials/fr/macos_zoom.md deleted file mode 100644 index acf51776..00000000 --- a/_partials/fr/macos_zoom.md +++ /dev/null @@ -1,33 +0,0 @@ -## Zoom - -Pour interagir quand on ne sera pas dans la même pièce, on utilisera [Zoom](https://zoom.us), un outil de visioconférence. - -:warning: Si Zoom est déjà installé sur ton ordinateur, vérifie qu’il s’agit au moins de la version **5.6**. - -Va sur [zoom.us/download](https://zoom.us/download). - -Sous **Client Zoom**, clique sur le bouton **Télécharger**. - -Ouvre le fichier que tu viens de télécharger pour installer l’application. - -Ouvre l’application Zoom. - -Si tu as un Mac avec un processeur Apple Silicon, [on te demande d'installer Rosetta](https://support.apple.com/en-us/HT211861). Clique sur installer, puis tape ton nom d'utilisateur et ton mot de passe pour autoriser l'installation. - -![Installer Rosetta](https://support.apple.com/library/content/dam/edam/applecare/images/en_US/macos/Big-Sur/macos-big-sur-software-update-rosetta-alert.jpg) - -Si tu as déjà un compte Zoom, connecte-toi avec tes identifiants. - -Sinon, clique sur le lien **Inscrivez-vous, c’est gratuit** : - -![Inscrivez-vous à Zoom, c’est gratuit](images/zoom_sign_up_free.png) - -Sur le site Web de Zoom, remplis le formulaire. - -Une fois que tu as terminé, retourne sur l’application Zoom et connecte-toi avec tes identifiants. - -Tu devrais voir apparaître un écran ressemblant à ça : - -![Écran d’accueil Zoom](images/zoom_home_screen.png) - -Tu peux fermer l’application Zoom. diff --git a/_partials/fr/rbenv.md b/_partials/fr/rbenv.md index 89f285bc..c52c84f0 100644 --- a/_partials/fr/rbenv.md +++ b/_partials/fr/rbenv.md @@ -14,7 +14,7 @@ rm -rf ~/.rbenv Puis dans le terminal, exécute : ```bash -sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev +sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev libyaml-dev ``` ```bash diff --git a/_partials/fr/ruby.md b/_partials/fr/ruby.md index ccc92f37..98a5a915 100644 --- a/_partials/fr/ruby.md +++ b/_partials/fr/ruby.md @@ -29,7 +29,7 @@ Puis exécute : ruby -v ``` -:heavy_check_mark: Si tu vois apparaître un message commençant par `ruby p`, tu peux continuer :+1: +:heavy_check_mark: Si tu vois apparaître un message commençant par `ruby `, tu peux continuer :+1: :x: Sinon, **demande au prof** @@ -55,6 +55,12 @@ gem sources -l Dans l’environnement ruby, les bibliothèques externes sont appelées des `gems` : ce sont des bouts de code ruby, que tu peux télécharger et exécuter sur ton ordinateur. On va en installer quelques-unes. +Tout d'abord, nous allons mettre à jour `bundler`, ce qui nous permet d'installer des gemmes : + +```bash +gem update bundler +``` + Copie-colle la commande suivante dans ton terminal : ```bash diff --git a/_partials/fr/slack_settings.md b/_partials/fr/slack_settings.md index fe20facb..29afc70d 100644 --- a/_partials/fr/slack_settings.md +++ b/_partials/fr/slack_settings.md @@ -10,8 +10,11 @@ L’idée est de laisser Slack ouvert toute la journée pour partager des liens On va vérifier que tout fonctionne correctement ; pour cela, on va tester ta caméra et ton microphone : - Ouvre l’application Slack -- Dans la barre de message de n’importe quel channel, saisis `/call --test` et appuie sur `Enter` -- Clique sur le bouton vert « Démarrer le test » +- Clique sur ta photo de profil en haut à droite +- Clique sur `Preferences` depuis le menu +- Séléctionne `Audio & video` dans la colonne de gauche +- En dessous de `Troubleshooting`, clique sur `Run an audio, video and screensharing test`. Le test va s’ouvrir dans une nouvelle fenêtre +- Vérifie que ton microphone, caméra, et enceintes soient bien séléctionnés, puis clique sur `Start test` ![Vérifier le fonctionnement du microphone et de la webcam avec Slack](images/slack_call_test.png) diff --git a/_partials/fr/sqlite.md b/_partials/fr/sqlite.md index 40038028..aa8d13f7 100644 --- a/_partials/fr/sqlite.md +++ b/_partials/fr/sqlite.md @@ -5,7 +5,7 @@ Dans quelques semaines, on abordera les bases de données et le SQL. [SQLite](ht Dans un terminal, exécute la commande suivante : ```bash -sudo apt-get install sqlite3 libsqlite3-dev +sudo apt-get install sqlite3 libsqlite3-dev pkg-config ``` Puis exécute celle-ci : diff --git a/_partials/fr/ubuntu_settings.md b/_partials/fr/ubuntu_settings.md index ba8e737c..bcf5dd53 100644 --- a/_partials/fr/ubuntu_settings.md +++ b/_partials/fr/ubuntu_settings.md @@ -48,4 +48,3 @@ Tu dois épingler : - VS Code - ton navigateur Internet - Slack -- Zoom diff --git a/_partials/fr/vscode_aifeatures.md b/_partials/fr/vscode_aifeatures.md new file mode 100644 index 00000000..0be35b53 --- /dev/null +++ b/_partials/fr/vscode_aifeatures.md @@ -0,0 +1,17 @@ +### Fonctionnalités IA de VS Code + +VS Code inclut de nombreuses **fonctionnalités d'IA** puissantes, qui sont un excellent outil une fois que vous savez déjà coder. + +Cela dit, s'appuyer sur l'IA trop tôt peut masquer des concepts importants et rendre le débogage plus difficile à comprendre. Une fois à l'aise avec les fondamentaux, vous saurez quand et comment utiliser l'IA efficacement — sans lui laisser faire la réflexion à votre place. + +Pour le début du bootcamp, nous allons désactiver ces fonctionnalités. Au bon moment du cours, nous les réactiverons afin que vous puissiez les utiliser à bon escient. + +Dans **VS Code** : + +1. Ouvrez la "Palette de commandes" de VS Code : tapez `Ctrl-Shift-P` (Windows / Linux) ou `Cmd-Shift-P` (macOS). +1. La Palette de commandes s'ouvrira : une petite zone de texte en haut de l'écran. Commencez à taper `aifeatures` jusqu'à voir "Chat: Learn How to Hide AI features". Cliquez dessus. + ![La palette de commandes en haut de l'écran](images/vscode_find_aifeatures.png) +1. Cela ouvrira les paramètres et affichera l'option "Disable and hide built-in AI features ...". Cochez la case devant cette option. + ![Cochez l'option de désactivation](images/vscode_disable_aifeatures.png) + +Plus tard, si vous souhaitez **réactiver** les fonctionnalités d'IA, vous pouvez suivre les mêmes instructions pour décocher la case. diff --git a/_partials/fr/vscode_extensions.md b/_partials/fr/vscode_extensions.md index e0888842..227c493e 100644 --- a/_partials/fr/vscode_extensions.md +++ b/_partials/fr/vscode_extensions.md @@ -10,17 +10,20 @@ Copie-colle les commandes suivantes dans le terminal : code --install-extension ms-vscode.sublime-keybindings code --install-extension emmanuelbeziat.vscode-great-icons code --install-extension MS-vsliveshare.vsliveshare -code --install-extension rebornix.ruby +code --install-extension shopify.ruby-lsp code --install-extension dbaeumer.vscode-eslint code --install-extension Rubymaniac.vscode-paste-and-indent code --install-extension alexcvzz.vscode-sqlite +code --install-extension anteprimorac.html-end-tag-labels +code --install-extension marcoroth.herb-lsp +code --install-extension rayhanw.erb-helpers ``` Voici la liste des extensions que tu es en train d'installer : - [Sublime Text Keymap and Settings Importer](https://marketplace.visualstudio.com/items?itemName=ms-vscode.sublime-keybindings) - [VSCode Great Icons](https://marketplace.visualstudio.com/items?itemName=emmanuelbeziat.vscode-great-icons) - [Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare) -- [Ruby](https://marketplace.visualstudio.com/items?itemName=rebornix.Ruby) +- [Ruby](https://marketplace.visualstudio.com/items?itemName=shopify.ruby-lsp) - [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) - [Paste and Indent](https://marketplace.visualstudio.com/items?itemName=Rubymaniac.vscode-paste-and-indent) - [SQLite](https://marketplace.visualstudio.com/items?itemName=alexcvzz.vscode-sqlite) diff --git a/_partials/fr/windows_browser.md b/_partials/fr/windows_browser.md index ca9f0a31..d6e3e173 100644 --- a/_partials/fr/windows_browser.md +++ b/_partials/fr/windows_browser.md @@ -58,7 +58,8 @@ Si tu obtiens une erreur du type `ls: cannot access...`, exécute la commande su Exécute la commandes : ```bash - echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'\"" + echo "export BROWSER=\"/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe\"" >> ~/.zshrc + echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'\"" >> ~/.zshrc ``` diff --git a/_partials/fr/windows_postgresql.md b/_partials/fr/windows_postgresql.md index 639cc7a6..560e1453 100644 --- a/_partials/fr/windows_postgresql.md +++ b/_partials/fr/windows_postgresql.md @@ -34,6 +34,6 @@ echo "sudo /etc/init.d/postgresql start" >> ~/.zshrc Ouvre un nouveau terminal. -:heavy_check_mark: Si tu vois apparaître le message `* Starting PostgreSQL 12 database server`, c’est bon :+1: +:heavy_check_mark: Si tu vois apparaître le message `* Starting postgresql (via systemctl): postgresql.service` OU `* Starting PostgreSQL 14 database server`, c’est bon :+1: :x: Sinon, **demande au prof**. diff --git a/_partials/fr/windows_settings.md b/_partials/fr/windows_settings.md index 62fd4c77..aaf93163 100644 --- a/_partials/fr/windows_settings.md +++ b/_partials/fr/windows_settings.md @@ -49,4 +49,3 @@ Tu dois épingler : - VS Code - ton navigateur Internet - Slack -- Zoom diff --git a/_partials/fr/windows_terminal.md b/_partials/fr/windows_terminal.md index 47342319..6ff3b26e 100644 --- a/_partials/fr/windows_terminal.md +++ b/_partials/fr/windows_terminal.md @@ -6,7 +6,10 @@ Si tu as Windows 11, le Windows Terminal est déjà installé et tu peux passer à la section suivante :point_down: -Si tu as Windows 10, nous allons installer le Windows Terminal, un terminal vraiment moderne : +Si tu as Windows 10, nous allons installer le Windows Terminal, un terminal vraiment moderne. + +
+Windows 10: Installer le Windows Terminal - Clique sur `Démarrer` - Saisis `Microsoft Store` @@ -31,6 +34,8 @@ Si tu as Windows 10, nous allons installer le Windows Terminal, un terminal vrai Une fois l’installation terminée, le bouton « Installer » se transforme en bouton « Lancer » ; clique dessus. +
+ ### Définir Ubuntu comme terminal par défaut On va définir Ubuntu comme terminal par défaut de ton application Windows Terminal. @@ -64,7 +69,7 @@ On va ensuite désactiver les avertissements pour les commandes de copier-coller - Ajoute la ligne suivante après : ```bash -"multiLinePasteWarning": false, +"warning.multiLinePaste": false, ``` :warning: N’oublie pas la virgule à la fin de la ligne ! diff --git a/_partials/fr/windows_ubuntu.md b/_partials/fr/windows_ubuntu.md index 32da424a..00ee9ec4 100644 --- a/_partials/fr/windows_ubuntu.md +++ b/_partials/fr/windows_ubuntu.md @@ -2,13 +2,12 @@ ### Installation -:information_source: Les instructions suivantes dépendent de ta version de Windows. N'exécute que les instructions qui correspondent à ta version :point_down: - -#### Windows 11 - 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. -#### Windows 10 +
+Résolution des problèmes pour Windows 10 (uniquement si nécessaire, vérifie avec un TA) + +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. Si tu as Windows 10, installons Ubuntu via le Microsoft Store : @@ -34,6 +33,8 @@ Si tu as Windows 10, installons Ubuntu via le Microsoft Store : Une fois l’installation terminée, le bouton « Installer » se transforme en bouton « Lancer » ; clique dessus. +
+ ### Premier lancement Au premier lancement, on te demandera de fournir des informations : @@ -77,7 +78,6 @@ wsl -l -v :heavy_check_mark: Au bout de quelques secondes, tu devrais voir apparaître le message suivant : `The conversion is complete`. :x: Si ce n’est pas le cas, il faut vérifier que les fichiers Ubuntu ne sont pas compressés. -
Vérifier que les fichiers sont décompressés @@ -97,3 +97,17 @@ wsl -l -v
Tu peux maintenant fermer cette fenêtre de terminal. + + + +### Vérifier ton nom d'utilisateur + +Tape cette commande dans le terminal Ubuntu : + +```bash +whoami +``` + +Cela devrait renvoyer le nom d'utilisateur que tu as choisi précédemment. + +:x: Si cela affiche `root`, **contacte un TA** avant de continuer ! diff --git a/_partials/fr/windows_version.md b/_partials/fr/windows_version.md index a26ad2ad..13d21e49 100644 --- a/_partials/fr/windows_version.md +++ b/_partials/fr/windows_version.md @@ -4,6 +4,10 @@ Avant de commencer, on va vérifier que la version de Windows installée sur ton ### Windows 10 ou Windows 11 +> :warning: **Note sur Windows 10 et la sécurité** +> +> La configuration du bootcamp Le Wagon fonctionne sur Windows 10. Cela dit, on recommande fortement de passer à Windows 11. Depuis le 14 octobre 2025, Microsoft a mis fin au support de Windows 10 : il ne reçoit plus de mises à jour de sécurité, ce qui peut exposer ta machine. Pour plus de détails, consulte le [guide de Microsoft](https://support.microsoft.com/en-us/windows/windows-10-support-has-ended-on-october-14-2025-2ca8b313-1946-43d3-b55c-2b95b107f281). Si ton ordinateur ne peut pas exécuter Windows 11, envisage de passer à Ubuntu. + Pour pouvoir configurer ton ordinateur, **Windows 10 ou Windows 11** doit être installé dessus. Pour connaître ta version de Windows : @@ -11,62 +15,52 @@ Pour connaître ta version de Windows : - Saisis `winver` - Appuie sur `Enter` -:heavy_check_mark: Si les premiers mots qui apparaissent dans cette fenêtre sont **Windows 10 ou Windows 11**, c’est bon :+1: - -:x: Sinon, tu ne pourras pas utiliser cette configuration. Il faut que tu mettes à jour ton Windows à la version 10 :point_down: +:heavy_check_mark: Si les premiers mots qui apparaissent dans cette fenêtre sont **Windows 11**, c’est bon :+1: -
- Mise à niveau vers Windows 10 +Si les premiers mots qui apparaissent dans cette fenêtre sont **Windows 10**, vérifie le numéro de version: - - Télécharge Windows 10 depuis [Microsoft](https://www.microsoft.com/fr-fr/software-download/windows10) - - Installe-le. L’installation devrait prendre une heure environ, mais cela dépend de ton ordinateur - - Une fois l’installation terminée, exécute les commandes ci-dessus pour vérifier que tu es sous **Windows 10** -
+- :heavy_check_mark: Si la version indique au moins `2004`, c’est bon :+1: -:information_source: [La mise à jour Windows 11 est toujours en cours de déploiement](https://www.microsoft.com/en-us/windows/get-windows-11), ce qui signifie qu'elle peut être disponible, ou pas, pour ton ordinateur. +- :x: Sinon, il faut que tu mettes à jour ton Windows. -:warning: **Si tu as Windows 10 installé, tu n'as pas besoin de faire la mise à jour Windows 11 pour continuer cette configuration**. +-
+ Comment installer les dernières mises à jour -### Dernières mises à jour + Ouvre Windows Update : + - Appuie sur `Windows` + `R` + - Saisis `ms-settings:windowsupdate` + - Appuie sur `Enter` + - Clique sur « Rechercher les mises à jour » -Une fois que tu as vérifié que tu utilises Windows 10 ou 11, tu vas devoir installer les dernières mises à jour. + :heavy_check_mark: Si tu vois apparaître une coche verte et le message « Vous êtes à jour », c’est bon :+1: -Ouvre Windows Update : -- Appuie sur `Windows` + `R` -- Saisis `ms-settings:windowsupdate` -- Appuie sur `Enter` -- Clique sur « Rechercher les mises à jour » + :warning: Si tu vois apparaître un point d’exclamation rouge et le message « Mise à jour disponible », installe-la et recommence jusqu’à ce que le message « Vous êtes à jour » apparaisse :loop: -:heavy_check_mark: Si tu vois apparaître une coche verte et le message « Vous êtes à jour », c’est bon :+1: + :x: Si tu vois apparaître un message d’erreur indiquant que Windows ne peut pas appliquer les mises à jour, **demande au prof**. -:warning: Si tu vois apparaître un point d’exclamation rouge et le message « Mise à jour disponible », installe-la et recommence jusqu’à ce que le message « Vous êtes à jour » apparaisse :loop: +
+ Activer le service Windows Update pour corriger les mises à jour -:x: Si tu vois apparaître un message d’erreur indiquant que Windows ne peut pas appliquer les mises à jour, **demande au prof**. + Certains antivirus et logiciels désactivent le service de mise à jour dont on a besoin, entraînant l’erreur que tu vois apparaître. On va corriger ça ! + - Appuie sur `Windows` + `R` + - Saisis `services.msc` + - Appuie sur `Enter` + - Double-clique sur `Windows Update Service` + - Définis `Startup` sur `Automatic` + - Clique sur `Start` + - Clique sur `Ok` + On va maintenant réessayer d’effectuer les mises à jour. +
-
- Activer le service Windows Update pour corriger les mises à jour + Vérifie le numéro de version : - Certains antivirus et logiciels désactivent le service de mise à jour dont on a besoin, entraînant l’erreur que tu vois apparaître. On va corriger ça ! - Appuie sur `Windows` + `R` - - Saisis `services.msc` + - Saisis `winver` - Appuie sur `Enter` - - Double-clique sur `Windows Update Service` - - Définis `Startup` sur `Automatic` - - Clique sur `Start` - - Clique sur `Ok` - On va maintenant réessayer d’effectuer les mises à jour. -
-### Version minimum - -Certains des outils qu’on doit installer sont compatibles avec la version `1903` **ou une version ultérieure** de Windows 10 ; on doit donc vérifier que tu as bien cette version au minimum. - -- Appuie sur `Windows` + `R` -- Saisis `winver` -- Appuie sur `Enter` -Vérifie le **numéro de version** : + :heavy_check_mark: Si la version indique au moins `1903`, c’est bon :+1: -:heavy_check_mark: Si la version indique au moins `1903`, c’est bon :+1: + :x: S’il s’agit d’une version antérieure, **demande au prof**. -:x: S’il s’agit d’une version antérieure, **demande au prof**. +
diff --git a/_partials/fr/windows_vscode.md b/_partials/fr/windows_vscode.md index f49ab3ed..b126c629 100644 --- a/_partials/fr/windows_vscode.md +++ b/_partials/fr/windows_vscode.md @@ -29,7 +29,7 @@ Then open VS Code from your terminal: code . ``` -:heavy_check_mark: Si tu vois `WSL: Ubuntu` dans une case verte dans le coin inférieur gauche de la fenêtre VS Code, c'est tout bon :+1: +:heavy_check_mark: Si tu vois `WSL: Ubuntu` dans le coin inférieur gauche de la fenêtre VS Code, c'est tout bon :+1: ![WSL Ubuntu Remote](images/windows_remote_wsl.png) diff --git a/_partials/fr/windows_wsl.md b/_partials/fr/windows_wsl.md index 691b8934..b6a1ab73 100644 --- a/_partials/fr/windows_wsl.md +++ b/_partials/fr/windows_wsl.md @@ -2,21 +2,17 @@ WSL est l’environnement de développement que l’on utilise pour exécuter Ubuntu. Pour en savoir plus sur WSL, [consulte cette page](https://docs.microsoft.com/fr-fr/windows/wsl/faq). -:information_source: Les instructions suivantes dépendent de ta version de Windows. Exécute uniquement les instructions qui correspondent à ta version :point_down: +Nous allons installer WSL 2 et Ubuntu en une seule commande via le Windows Command Prompt. -### Windows 11 - -Si tu as Windows 11, nous allons installer WSL 2 et Ubuntu en une seule commande via le Windows Terminal. - -:warning: Dans les instructions suivantes, utilise la combinaison de touches `Ctrl` + `Shift` + `Enter` pour exécuter **Windows Terminal** en tant qu’administrateur au lieu de cliquer simplement sur `Ok` ou d’appuyer sur `Enter`. +:warning: Dans les instructions suivantes, utilise la combinaison de touches `Ctrl` + `Shift` + `Enter` pour exécuter **Windows Command Prompt** en tant qu’administrateur au lieu de cliquer simplement sur `Ok` ou d’appuyer sur `Enter`. - Appuie sur `Windows` + `R` -- Saisis `wt` +- Saisis `cmd` - Appuie sur **`Ctrl` + `Shift` + `Enter`** :warning: Tu devras peut-être accepter la confirmation UAC concernant l’octroi des droits d’administrateur. -Une fenêtre de terminal bleue apparaîtra : +Une fenêtre de terminal apparaîtra : - Copie la commande suivante (`Ctrl` + `C`) - Colle-la dans la fenêtre du terminal (`Ctrl` + `V` ou en faisant un clic droit dans la fenêtre) - Exécute-les en appuyant sur `Enter` @@ -27,13 +23,12 @@ wsl --install :heavy_check_mark: Si la commande s’exécute sans erreur, redémarre ton ordinateur et suis les instructions ci-dessous :+1: -:x: Si tu obtiens un message d’erreur (ou si tu vois apparaître du texte en rouge dans la fenêtre), **demande au prof** +:x: Si tu obtiens un message d’erreur (ou si tu vois apparaître du texte en rouge dans la fenêtre), **demande au prof**. -### Windows 10 - -#### Installer WSL 1 +
+Dépannage pour Windows 10 (uniquement si nécessaire, vérifie avec un professeur) -Si tu as Windows 10, on va d'abord installer WSL 1 à partir du terminal PowerShell. +#### Pour Windows 10 < 2004 : installer d'abord WSL 1 :warning: Dans les instructions suivantes, utilise la combinaison de touches `Ctrl` + `Shift` + `Enter` pour exécuter **Windows PowerShell** en tant qu’administrateur au lieu de cliquer simplement sur `Ok` ou d’appuyer sur `Enter`. @@ -64,7 +59,7 @@ dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /nores :x: Si tu obtiens un message d’erreur (ou si tu vois apparaître du texte en rouge dans la fenêtre), **demande au prof** -#### Mise à niveau vers WSL 2 +#### Pour Windows 10 avec WSL 1 : Mise à niveau vers WSL 2 Si tu as Windows 10, on va maintenant mettre à jour WSL à la version 2. @@ -82,7 +77,7 @@ Une fois que ton ordinateur a redémarré, on doit télécharger le programme d :x: Si tu obtiens l’erreur « Cette mise à jour s’applique seulement aux machines avec le sous-système Windows pour Linux », **fais un clic droit** sur le programme et sélectionne `uninstall` ; tu devrais pouvoir l’installer normalement cette fois-ci. -#### Définir WSL 2 comme sous-système Windows pour Linux par défaut +#### Pour Windows 10 avec WSL 1 : Définir WSL 2 comme sous-système Windows pour Linux par défaut Si tu as Windows 10, on va enfin définir la version 2 de WSL comme étant la version par défaut. @@ -114,3 +109,5 @@ wsl --set-default-version 2 :information_source: Si tu as Windows 10 **Home edition**, la fonction Hyper-V n'est pas disponible sur ton système d'exploitation. Ce n'est pas bloquant et tu peux continuer à suivre les instructions ci-dessous :ok_hand:
+ + diff --git a/_partials/fr/yarn.md b/_partials/fr/yarn.md index e1a06066..fffde7dd 100644 --- a/_partials/fr/yarn.md +++ b/_partials/fr/yarn.md @@ -5,10 +5,16 @@ Exécute les commandes suivantes dans le terminal : ```bash -npm install --global yarn +corepack enable +yarn set version stable +``` + +```bash exec zsh ``` +⚠️ Si tu rencontres des messages d'erreur, essaye d'exécuter `npm install -g corepack` puis exécute à nouveau les commandes ci-dessus. + Puis exécute la commande suivante : ```bash diff --git a/_partials/fr/zoom.md b/_partials/fr/zoom.md deleted file mode 100644 index f04b3652..00000000 --- a/_partials/fr/zoom.md +++ /dev/null @@ -1,29 +0,0 @@ -## Zoom - -Pour interagir quand on ne sera pas dans la même pièce, on utilisera [Zoom](https://zoom.us), un outil de visioconférence. - -:warning: Si Zoom est déjà installé sur ton ordinateur, vérifie qu’il s’agit au moins de la version **5.6**. - -Va sur [zoom.us/download](https://zoom.us/download). - -Sous **Client Zoom**, clique sur le bouton **Télécharger**. - -Ouvre le fichier que tu viens de télécharger pour installer l’application. - -Ouvre l’application Zoom. - -Si tu as déjà un compte Zoom, connecte-toi avec tes identifiants. - -Sinon, clique sur le lien **Inscrivez-vous, c’est gratuit** : - -![Inscrivez-vous à Zoom, c’est gratuit](images/zoom_sign_up_free.png) - -Sur le site Web de Zoom, remplis le formulaire. - -Une fois que tu as terminé, retourne sur l’application Zoom et connecte-toi avec tes identifiants. - -Tu devrais voir apparaître un écran ressemblant à ça : - -![Écran d’accueil Zoom](images/zoom_home_screen.png) - -Tu peux fermer l’application Zoom. diff --git a/_partials/gh_cli.md b/_partials/gh_cli.md index 98decd6d..0322b84d 100644 --- a/_partials/gh_cli.md +++ b/_partials/gh_cli.md @@ -6,25 +6,25 @@ In this section, we will use [GitHub CLI](https://cli.github.com/) to interact w It should already be installed on your computer from the previous commands. +We will use the GitHub CLI (`gh`) to connect to GitHub using *SSH*, a protocol to log in using SSH keys instead of the well known username/password pair. + First in order to **login**, copy-paste the following command in your terminal: :warning: **DO NOT edit the `email`** ```bash -gh auth login -s 'user:email' -w +gh auth login -s 'user:email' -w --git-protocol ssh ``` -gh will ask you few questions: - -`What is your preferred protocol for Git operations?` With the arrows, choose `SSH` and press `Enter`. SSH is a protocol to log in using SSH keys instead of the well known username/password pair. +`gh` will ask you few questions: -`Generate a new SSH key to add to your GitHub account?` Press `Enter` to ask gh to generate the SSH keys for you. +- `Generate a new SSH key to add to your GitHub account?` Press `Enter` to ask gh to generate the SSH keys for you. -If you already have SSH keys, you will see instead `Upload your SSH public key to your GitHub account?` With the arrows, select your public key file path and press `Enter`. + If you already have SSH keys, you will see instead `Upload your SSH public key to your GitHub account?` With the arrows, select your public key file path and press `Enter`. -`Enter a passphrase for your new SSH key (Optional)`. Type something you want and that you'll remember. It's a password to protect your private key stored on your hard drive. Then press `Enter`. +- `Enter a passphrase for your new SSH key (Optional)`. Type something you want and that you'll remember. It's a password to protect your private key stored on your hard drive. Then press `Enter`. -:warning: When you type your passphrase, nothing will show up on the screen, **that's normal**. This is a security feature to mask not only your passphrase as a whole but also its length. Just type your passphrase and when you're done, press `Enter`. +- `Title for your SSH key`. You can leave it at the proposed "GitHub CLI", press `Enter`. You will then get the following output: diff --git a/_partials/github.md b/_partials/github.md index 4cb76d1a..58208e16 100644 --- a/_partials/github.md +++ b/_partials/github.md @@ -5,3 +5,5 @@ Have you signed up to GitHub? If not, [do it right away](https://github.com/join :point_right: **[Upload a picture](https://github.com/settings/profile)** and put your name correctly on your GitHub account. This is important as we'll use an internal dashboard with your avatar. Please do this **now**, before you continue with this guide. ![GitHub picture](images/github_picture.png) + +:point_right: **[Enable Two-Factor Authentication (2FA)](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-text-messages)**. GitHub will send you text messages with a code when you try to log in. This is important for security and also will soon be required in order to contribute code on GitHub. diff --git a/_partials/intro.md b/_partials/intro.md index 7d52e49c..8e48185e 100644 --- a/_partials/intro.md +++ b/_partials/intro.md @@ -1,6 +1,6 @@ # Setup instructions -You will find below the instructions to set up your computer for [Le Wagon Web Development course](https://www.lewagon.com/web-development-course/full-time). +You will find below the instructions to set up your computer for [Le Wagon AI Software Development course](https://www.lewagon.com/web-development-course/full-time). Please **read them carefully and execute all commands in the following order**. diff --git a/_partials/kitt.md b/_partials/kitt.md index a1a154b2..39908173 100644 --- a/_partials/kitt.md +++ b/_partials/kitt.md @@ -1,14 +1,8 @@ ## Kitt -:warning: If you have received an email from Le Wagon inviting you to sign up on Kitt (our learning platform), you can safely skip this step. Instead, please follow the instructions in the email you received if you haven't done so already. - -If you are unsure about what to do, you can follow [this link](https://kitt.lewagon.com/). If you are already logged in, you can safely skip this section. If you are not logged in, click on `Enter Kitt as a Student`. If you manage to login, you can safely skip this step. Otherwise ask a teacher whether you should have received an email or follow the instructions below. - -Register as a Wagon alumni by going to [kitt.lewagon.com/onboarding](http://kitt.lewagon.com/onboarding). Select your batch, sign in with GitHub and enter all your information. - -Your teacher will then validate that you are indeed part of the batch. You can ask them to do it as soon as you completed the registration form. - -Once the teacher has approved your profile, go to your email inbox. You should have 2 emails: +You should have received an email from Le Wagon inviting you to sign up on [Kitt](https://kitt.lewagon.com) (our learning platform). When submitting your onboarding form on Kitt, you should have received two additional invitations: - One from Slack, inviting you to the Le Wagon Alumni slack community (where you'll chat with your buddies and all the previous alumni). Click on **Join** and fill the information. - One from GitHub, inviting you to `lewagon` team. **Accept it** otherwise you won't be able to access the lecture slides. + +If you haven't, please contact your teaching team. diff --git a/_partials/macos_postgresql.md b/_partials/macos_postgresql.md index 14f562e0..4edb9bd3 100644 --- a/_partials/macos_postgresql.md +++ b/_partials/macos_postgresql.md @@ -7,11 +7,12 @@ Let's install it now. Run the following commands: ```bash -brew install postgresql +brew install postgresql@15 libpq +brew link --force libpq ``` ```bash -brew services start postgresql +brew services start postgresql@15 ``` Once you've done that, let's check that it worked: @@ -23,7 +24,7 @@ psql -d postgres You should you see a new prompt like this one :point_down: ```bash -psql (14.4) +psql (15.2) Type "help" for help. postgres=# diff --git a/_partials/macos_rbenv.md b/_partials/macos_rbenv.md index 64764273..80fdbb5d 100644 --- a/_partials/macos_rbenv.md +++ b/_partials/macos_rbenv.md @@ -29,5 +29,5 @@ exec zsh Then run: ```bash -brew install rbenv +brew install rbenv libyaml ``` diff --git a/_partials/macos_settings.md b/_partials/macos_settings.md index 6860c007..73593d35 100644 --- a/_partials/macos_settings.md +++ b/_partials/macos_settings.md @@ -2,9 +2,9 @@ ### Security -It is mandatory that you protect your session behind a password.If it is not already the case, go to ` > System Preferences > Users & Groups` and change your account password. You should also go to ` > System Preferences > Security > General`. You should require a password `5 seconds` after sleep or screen saver begins. +It is mandatory that you protect your session behind a password. If it is not already the case, go to ` > System Settings... > Users & Groups` and change your account password. You should also go to ` > System Settings... > Lock Screen`. You should require a password `5 seconds` after screen saver begins or display is turned off. -You can also go to ` > System Preferences > Mission Control` and click on the `Hot Corners` button at the bottom left. Choose for the bottom right corner to start the screen saver. That way, when you leave your desk, you can quickly lock you screen by putting your mouse in the bottom right corner. 5 seconds after, your Macbook will be locked and will ask for a password to get back on the session. +You can also go to ` > System Settings... > Desktop & Dock` and click on the `Hot Corners...` button at the bottom left. Choose for the bottom right corner to start the screen saver. That way, when you leave your desk, you can quickly lock you screen by putting your mouse in the bottom right corner. 5 seconds after, your MacBook will be locked and will ask for a password to get back on the session. ### Keyboard @@ -12,7 +12,7 @@ As you become a programmer, you'll understand that leaving the keyboard takes a #### Keyboard speed -Go to ` > System Preferences > Keyboard`. Set `Key Repeat` to the fastest position (to the right) and `Delay Until Repeat` to the shortest position (to the right). +Go to ` > System Settings... > Keyboard`. Set `Key repeat rate` to the fastest position (to the right) and `Delay until repeat` to the shortest position (also to the right). #### macOS For hackers @@ -44,4 +44,3 @@ You must pin: - VS Code - Your Internet browser - Slack -- Zoom diff --git a/_partials/macos_slack.md b/_partials/macos_slack.md index b3dd736e..740f7bc9 100644 --- a/_partials/macos_slack.md +++ b/_partials/macos_slack.md @@ -1,6 +1,6 @@ ## Slack -[Slack](https://slack.com/) is a communcation platform pretty popular in the tech industry. +[Slack](https://slack.com/) is a communication platform pretty popular in the tech industry. ### Installation diff --git a/_partials/macos_zoom.md b/_partials/macos_zoom.md deleted file mode 100644 index 2fdc36a2..00000000 --- a/_partials/macos_zoom.md +++ /dev/null @@ -1,33 +0,0 @@ -## Zoom - -To be able to interact when we are not in the same physical room, we will be using [Zoom](https://zoom.us/), a video conferencing tool. - -:warning: If you already have Zoom installed, please make sure that the version is at least **5.6**. - -Go to [zoom.us/download](https://zoom.us/download). - -Under **Zoom Client** click the **Download** button. - -Open the file you have just downloaded to install the app. - -Open the Zoom app. - -If you have a Mac with Apple silicon, [you are asked to install Rosetta](https://support.apple.com/en-us/HT211861). Click Install, then enter your user name and password to allow installation to proceed. - -![Install Rosetta](https://support.apple.com/library/content/dam/edam/applecare/images/en_US/macos/Big-Sur/macos-big-sur-software-update-rosetta-alert.jpg) - -If you already have a Zoom account, sign in using your credentials. - -If not, click on the **Sign Up Free** link: - -![Sign Up Free to Zoom](images/zoom_sign_up_free.png) - -You will be redirected to Zoom's website to complete a form. - -When it's done, go back to the Zoom app and sign in using your credentials. - -You should then see a screen like this: - -![Zoom Home Screen](images/zoom_home_screen.png) - -You can now close the Zoom app. diff --git a/_partials/pt/checkup.md b/_partials/pt/checkup.md new file mode 100644 index 00000000..66e8201e --- /dev/null +++ b/_partials/pt/checkup.md @@ -0,0 +1,19 @@ +## Checagem + +Vamos verificar se você instalou tudo com sucesso. + +No seu terminal, execute o seguinte comando: + +```bash +exec zsh +``` + +Então corra: + +```bash +curl -Ls https://raw.githubusercontent.com/lewagon/setup/master/check.rb > _.rb && ruby _.rb && rm _.rb || rm _.rb +``` + +:heavy_check_mark: Se você receber uma mensagem verde `Awesome! Your computer is now ready!`, então você está bem :+1: + +:x: Caso contrário, **entre em contato com um professor**. diff --git a/_partials/pt/cli_tools.md b/_partials/pt/cli_tools.md new file mode 100644 index 00000000..a4cffe91 --- /dev/null +++ b/_partials/pt/cli_tools.md @@ -0,0 +1,86 @@ +## Ferramentas de linha de comando + +### Verifique a localidade + +A localidade é um mecanismo que permite personalizar programas de acordo com seu idioma e país. + +Vamos verificar se a localidade padrão está definida como inglês, digite isto no terminal do Ubuntu: + +```bash +locale +``` + +Se a saída não contiver `LANG=en_US.UTF-8`, execute o seguinte comando em um terminal Ubuntu para instalar a localidade em inglês: + +```bash +sudo locale-gen en_US.UTF-8 +``` + +Se, depois, receberes um aviso (`bash: warning: setlocale: LC_ALL: cannot change locale (en_US.utf-8)`) no teu terminal, por favor faz o seguinte: + +
+ Gerar localidade + +Por favor, executa estas linhas no teu terminal. + +```bash +sudo update-locale LANG=en_US.UTF8 +sudo apt-get update +sudo apt-get install language-pack-en language-pack-en-base manpages +``` +
+ +### Zsh e Git + +Em vez de usar o `bash` [shell](https://en.wikipedia.org/wiki/Shell_(computing)), usaremos `zsh`. + +Também usaremos [`git`](https://git-scm.com/), um software de linha de comando usado para controle de versão. + +Vamos instalá-los, juntamente com outras ferramentas úteis: +- Abra um **terminal Ubuntu** +- Copie e cole os seguintes comandos: + +```bash +sudo apt update +``` + +```bash +sudo apt install -y curl git imagemagick jq unzip vim zsh tree +``` + +Esses comandos solicitarão sua senha: digite-a. + +:warning: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`. + +### Instalação da CLI do GitHub + +Vamos agora instalar a [CLI oficial do GitHub](https://cli.github.com) (interface de linha de comando). É um software usado para interagir com sua conta GitHub através da linha de comando. + +Em seu terminal, copie e cole os seguintes comandos e digite sua senha, se solicitado: + +```bash +sudo apt remove -y gitsome # gh command can conflict with gitsome if already installed +curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg +``` + +```bash +echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null +``` + +```bash +sudo apt update +``` + +```bash +sudo apt install -y gh +``` + +Para verificar se `gh` foi instalado com sucesso em sua máquina, você pode executar: + +```bash +gh --version +``` + +:heavy_check_mark: Se você vir `gh versão X.Y.Z (AAAA-MM-DD)`, está pronto para prosseguir :+1: + +:x: Caso contrário, por favor **entre em contato com um professor** diff --git a/_partials/pt/conclusion.md b/_partials/pt/conclusion.md new file mode 100644 index 00000000..085b0565 --- /dev/null +++ b/_partials/pt/conclusion.md @@ -0,0 +1,5 @@ +## Configuração concluída! + +Seu computador agora está pronto para o [curso de AI Software Development Le Wagon](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: + +Aproveite o bootcamp, você vai acertar :rocket: diff --git a/_partials/pt/dotfiles.md b/_partials/pt/dotfiles.md new file mode 100644 index 00000000..4981b3e2 --- /dev/null +++ b/_partials/pt/dotfiles.md @@ -0,0 +1,76 @@ +## Dotfiles (configuração padrão) + +Os hackers adoram refinar e aprimorar sua estrutura e ferramentas. + +Começaremos com uma ótima configuração padrão fornecida pelo Le Wagon: [`lewagon/dotfiles`](https://github.com/lewagon/dotfiles). + +Como sua configuração é pessoal, você precisa de seu próprio repositório para armazená-la. Então você irá fazer o **fork** do repositório Le Wagon. + +Bifurcar significa que você criará um novo repositório em sua própria conta GitHub `$GITHUB_USERNAME/dotfiles`, idêntico ao original do Le Wagon que você poderá modificar à vontade. + +Abra seu terminal e defina uma variável para seu nome de usuário GitHub: + +```bash +export GITHUB_USERNAME=`gh api user | jq -r '.login'` +``` + +```bash +echo $GITHUB_USERNAME +``` + +:heavy_check_mark: Você deverá ver seu nome de usuário do GitHub impresso. + +:x: Se não, **pare aqui** e peça ajuda. Pode haver um problema com a etapa anterior (`gh auth`). + +:warning: Por favor note que esta variável só é definida para o tempo em que seu terminal está aberto. Se você fechá-lo antes ou durante as próximas etapas, será necessário configurá-lo novamente com as duas etapas acima! + + +É hora de fazer um fork do repositório e cloná-lo em seu computador: + +```bash +mkdir -p ~/code/$GITHUB_USERNAME && cd $_ +``` + +```bash +gh repo fork lewagon/dotfiles --clone +``` + +### Instalador do Dotfiles + +Execute o instalador `dotfiles`: + +```bash +cd ~/code/$GITHUB_USERNAME/dotfiles +``` + +```bash +zsh install.sh +``` + +Verifique os e-mails registrados em sua conta GitHub. Você precisará escolher um na próxima etapa: + +```bash +gh api user/emails | jq -r '.[].email' +``` + +:heavy_check_mark: Se você vir a lista de seus e-mails registrados, você pode prosseguir :+1: + +:x: Caso contrário, [reautentique no GitHub](https://github.com/lewagon/setup/blob/master/#github-cli) antes de executar este comando :point_up: novamente. + +### Instalador git + +Execute o instalador `git`: + +```bash +cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh +``` + +:point_up: Isso **solicitará** seu nome (`Nome Sobrenome`) e seu e-mail. O email que você escolher será exibido **publicamente** na internet. 💡 Selecione o endereço `@users.noreply.github.com` se você não deseja que seu e-mail apareça em repositórios públicos aos quais você possa contribuir. + +:warning: Você **precisa** colocar um dos e-mails listados acima graças ao comando anterior `gh api ...`. Se você não fizer isso, Kitt não conseguirá acompanhar seu progresso. + +Agora **reinicie** seu terminal executando: + +```bash +exec zsh +``` diff --git a/_partials/pt/gh_cli.md b/_partials/pt/gh_cli.md new file mode 100644 index 00000000..ed592419 --- /dev/null +++ b/_partials/pt/gh_cli.md @@ -0,0 +1,51 @@ +## CLI do GitHub + +CLI é o acrônimo de [Interface de linha de comando](https://en.wikipedia.org/wiki/Command-line_interface). + +Nesta seção, usaremos [GitHub CLI](https://cli.github.com/) para interagir com o GitHub diretamente do terminal. + +Usaremos o GitHub CLI (`gh`) para conectar ao GitHub usando *SSH*, um protocolo para fazer login usando chaves SSH em vez do conhecido par nome de usuário/senha. + + +Ele já deve estar instalado no seu computador a partir dos comandos anteriores. + +Primeiro, para **fazer login**, copie e cole o seguinte comando em seu terminal: + +:warning: **NÃO edite o `email`** + +```bash +gh auth login -s 'user:email' -w --git-protocol ssh +``` + +`gh` fará algumas perguntas: + +- `Generate a new SSH key to add to your GitHub account?` Pressione `Enter` para pedir ao gh para gerar as chaves SSH para você. + + Se você já possui chaves SSH, verá `Upload your SSH public key to your GitHub account?` Com as setas, selecione o caminho do arquivo de sua chave pública e pressione `Enter`. + +- `Enter a passphrase for your new SSH key (Optional)`. Digite algo que você deseja e que você lembrará. É uma senha para proteger sua chave privada armazenada no disco rígido. Em seguida, pressione `Enter`. + +- `Title for your SSH key`. Você pode deixá-lo no "GitHub CLI" proposto, pressione `Enter`. + +Você obterá então a seguinte saída: + +```bash +! First copy your one-time code: 0EF9-D015 +- Press Enter to open github.com in your browser... +``` + +Selecione e copie o código (`0EF9-D015` no exemplo) e pressione `Enter`. + +Seu navegador será aberto e solicitará que você autorize o GitHub CLI a usar sua conta GitHub. Aceite e espere um pouco. + +Volte ao terminal, pressione `Enter` novamente e pronto. + +Para verificar se você está conectado corretamente, digite: + +```bash +gh auth status +``` + +:heavy_check_mark: Se você estiver `Logado no github.com como `, então tudo bem :+1: + +:x: Caso contrário, **entre em contato com um professor**. diff --git a/_partials/pt/github.md b/_partials/pt/github.md new file mode 100644 index 00000000..9fc80adf --- /dev/null +++ b/_partials/pt/github.md @@ -0,0 +1,9 @@ +## Conta GitHub + +Você se inscreveu no GitHub? Caso contrário, [faça isso imediatamente](https://github.com/join). + +:point_right: **[Carregue uma imagem](https://github.com/settings/profile)** e coloque seu nome corretamente em sua conta GitHub. Isso é importante porque usaremos um painel interno com seu avatar. Faça isso **agora**, antes de continuar com este guia. + +![Imagem do GitHub](images/github_picture.png) + +:point_right: [Ative a Autenticação em Duas Etapas (2FA)](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-text-messages). O GitHub enviará mensagens de texto com um código quando você tentar fazer login. Isso é importante para a segurança e em breve será necessário para contribuir com código no GitHub. diff --git a/_partials/pt/intro.md b/_partials/pt/intro.md new file mode 100644 index 00000000..27ea334a --- /dev/null +++ b/_partials/pt/intro.md @@ -0,0 +1,11 @@ +# Instruções de configuração + +Você encontrará abaixo as instruções para configurar seu computador para o [curso de AI Software Development Le Wagon](https://www.lewagon.com/web-development-course/full-time). + +Por favor **leia-os com atenção e execute todos os comandos na seguinte ordem**. + +Se você tiver dúvidas, não hesite em pedir ajuda a um professor :raising_hand: + +Você também pode dar uma olhada em [nossas cheatsheets](https://github.com/lewagon/setup/tree/master/docs) para soluções e dicas de problemas comuns :heavy_check_mark: + +Vamos começar :rocket: diff --git a/_partials/pt/kitt.md b/_partials/pt/kitt.md new file mode 100644 index 00000000..c42b8ff4 --- /dev/null +++ b/_partials/pt/kitt.md @@ -0,0 +1,14 @@ +## Kitt + +:warning: Se você recebeu um e-mail do Le Wagon convidando você a se inscrever no Kitt (nossa plataforma de aprendizagem), você pode pular esta etapa com segurança. Em vez disso, siga as instruções no e-mail que você recebeu, caso ainda não tenha feito isso. + +Se não tiver certeza sobre o que fazer, siga [este link](https://kitt.lewagon.com/). Se você já estiver logado, pode pular esta seção com segurança. Se você não estiver logado, clique em `Enter Kitt as a Student`. Se você conseguir fazer login, poderá pular esta etapa com segurança. Caso contrário, pergunte a um professor se você deveria ter recebido um e-mail ou siga as instruções abaixo. + +Registre-se como Alumni da Le Wagon acessando [kitt.lewagon.com/onboarding](http://kitt.lewagon.com/onboarding). Selecione seu batch, faça login no GitHub e insira todas as suas informações. + +Seu professor irá então validar que você realmente faz parte do batch. Você pode pedir que eles façam isso assim que preencher o formulário de registro. + +Assim que o professor aprovar seu perfil, acesse sua caixa de entrada de e-mail. Você deve ter 2 e-mails: + +- Um do Slack, convidando você para a comunidade Le Wagon Alumni do Slack (onde você conversará com seus amigos e todos os ex-alunos anteriores). Clique em **Inscreva-se** e preencha os dados. +- Um do GitHub, convidando você para a equipe `lewagon`. **Aceite** caso contrário você não conseguirá acessar os slides da aula. diff --git a/_partials/pt/macos_apple_silicon.md b/_partials/pt/macos_apple_silicon.md new file mode 100644 index 00000000..df825837 --- /dev/null +++ b/_partials/pt/macos_apple_silicon.md @@ -0,0 +1,46 @@ +## Chips Apple Silicon + +Se você comprou seu computador depois do final de 2020, é provável que ele tenha um novo chip de silício da Apple em vez de um processador Intel: vamos descobrir. + +Abra uma nova janela de terminal em Aplicativos > Utilitários ou pesquise-a com [Spotlight](https://support.apple.com/en-gb/HT204014): + +![Abra Terminal no macOS](images/macos_open_terminal.png) + +Copie e cole o seguinte comando no terminal e pressione `Enter` para executar. + +``` bash +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/lewagon/setup/master/utils/macos_list_processor_type.sh)" +``` + +☝️ O resultado do comando deve indicar se o seu computador usa Apple Silicon. + +Se o seu computador usa Apple Silicon, expanda o parágrafo abaixo e leia-o. Caso contrário, ignore-o. + +
+ 👉Configuração para Apple Silicon 👈 + +### Desinstalar o Homebrew + +Precisamos desinstalar o Homebrew caso uma versão nativa tenha sido instalada. + +Execute o seguinte comando no terminal: + +``` bash +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)" +``` + +Se o brew não estiver instalado, você receberá a mensagem `brew: comando não encontrado!` + +### Configurar Terminal para Rosetta + +Abra o aplicativo Finder (ou pesquise-o com o [Spotlight](https://support.apple.com/en-gb/HT204014)). + +Vá para Aplicativos > Utilitários. + +Duplique o aplicativo de terminal (selecione-o e, em seguida, `Cmd` + `C`, `Cmd` + `V`) e renomeie uma cópia como Terminal Rosetta. + +Pressione `Cmd` + `I` no aplicativo Terminal Rosetta e marque a caixa "Abrir usando Rosetta". + +⚠️ A partir de agora durante o bootcamp, sempre que for solicitado a abrir um Terminal, você usará o aplicativo **Terminal Rosetta**. + +
diff --git a/_partials/pt/macos_command_line_tools.md b/_partials/pt/macos_command_line_tools.md new file mode 100644 index 00000000..8a5fbf45 --- /dev/null +++ b/_partials/pt/macos_command_line_tools.md @@ -0,0 +1,38 @@ +## Uma observação sobre como encerrar aplicativos em um Mac + +Clicar na pequena cruz vermelha no canto superior esquerdo da janela do aplicativo em um Mac **não o encerra**, apenas fecha uma janela ativa. Para sair do aplicativo _de verdade_ pressione `Cmd + Q` quando o aplicativo estiver ativo ou navegue até `APP_NAME` -> `Quit` na barra de menu. + +![Sair do Terminal no macOS](images/macos_quit.png) + +Durante esta configuração, você será solicitado a **sair e reabrir** os aplicativos várias vezes. Certifique-se de fazer isso corretamente :pray: + +## Ferramentas de linha de comando + +Abra um novo terminal, copie e cole o seguinte comando e pressione `Enter`: + +```bash +xcode-select --install +``` + +Se você receber a mensagem a seguir, basta pular esta etapa e ir para a próxima. + +```bash +# ferramentas de linha de comando já estão instaladas, use "Atualização de Software" para instalar atualizações +``` + +Caso contrário, abrirá uma janela perguntando se deseja instalar algum software: clique em “Instalar” e aguarde. + + +![Instale o xcode-select no macOS](images/macos_xcode_select_install.png) + +:heavy_check_mark: Se você vir a mensagem "O software foi instalado", tudo bem :+1: + +:x: Se o comando `xcode-select --install` falhar, tente novamente: às vezes os servidores Apple ficam sobrecarregados. + +:x: Se você vir a mensagem "O Xcode não está disponível no servidor de atualização de software", será necessário atualizar o catálogo de atualização de software: + +```bash +sudo softwareupdate --clear-catalog +``` + +Feito isso, você pode tentar instalar novamente. diff --git a/_partials/pt/macos_homebrew.md b/_partials/pt/macos_homebrew.md new file mode 100644 index 00000000..b59dd14c --- /dev/null +++ b/_partials/pt/macos_homebrew.md @@ -0,0 +1,67 @@ +## Homebrew + +[Homebrew](http://brew.sh/) é um gerenciador de pacotes: é um software usado para instalar outros softwares a partir da linha de comando. Vamos instalá-lo! + +Abra um terminal e execute: + +```bash +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" +``` + +Isso solicitará sua confirmação (pressione `Enter`) e sua **senha da conta de usuário do macOS** (aquela que você usa para [fazer login](https://support.apple.com/en-gb/HT202860) quando você reinicia seu Macbook). + +:warning: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`. + +:warning: Se você vir este aviso :point_down:, execute os dois comandos na seção `Próximas etapas` para adicionar o Homebrew ao seu PATH: + +![Aviso de instalação do macOS Homebrew](images/macos_homebrew_warning.png) + +```bash +# ⚠️ Execute esses comandos apenas se você viu este aviso ☝ +echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile +eval "$(/opt/homebrew/bin/brew shellenv)" +``` + +Se você já tem o Homebrew, ele lhe dirá, tudo bem, vá em frente. + +Em seguida, instale algum software útil: + +```bash +brew update +``` + +Se você receber um erro `/usr/local deve ser gravável`, basta executar isto: + +```bash +sudo chown -R $USER:admin /usr/local +``` + +```bash +brew update +``` + +Continue executando o seguinte no terminal (você pode copiar/colar todas as linhas de uma vez). + +```bash +brew upgrade git || brew install git +``` + +```bash +brew upgrade gh || brew install gh +``` + +```bash +brew upgrade wget || brew install wget +``` + +```bash +brew upgrade imagemagick || brew install imagemagick +``` + +```bash +brew upgrade jq || brew install jq +``` + +```bash +brew upgrade openssl || brew install openssl +``` diff --git a/_partials/pt/macos_postgresql.md b/_partials/pt/macos_postgresql.md new file mode 100644 index 00000000..54e32a4f --- /dev/null +++ b/_partials/pt/macos_postgresql.md @@ -0,0 +1,35 @@ +## PostgreSQL + +Às vezes, o SQLite não é suficiente e precisaremos de uma ferramenta mais avançada chamada [PostgreSQL](https://www.postgresql.org/), um sistema de banco de dados de código aberto, robusto e pronto para produção. + +Vamos instalá-lo agora. + +Execute os seguintes comandos: + +```bash +brew install postgresql@15 libpq +brew link --force libpq +``` + +```bash +brew services start postgresql@15 +``` + +Depois de fazer isso, vamos verificar se funcionou: + +```bash +psql -d postgres +``` + +Você deverá ver um novo prompt como este :point_down: + +```bash +psql (15.2) +Type "help" for help. + +postgres=# +``` + +:heavy_check_mark: Se for esse o caso, digite `\q` e depois `Enter` para sair deste prompt. Você está pronto para ir :+1: + +:x: Se não, por favor **entre em contato com um professor** diff --git a/_partials/pt/macos_rbenv.md b/_partials/pt/macos_rbenv.md new file mode 100644 index 00000000..bbebe544 --- /dev/null +++ b/_partials/pt/macos_rbenv.md @@ -0,0 +1,33 @@ +## rbenv + +Vamos instalar o [`rbenv`](https://github.com/sstephenson/rbenv), um software para instalar e gerenciar ambientes `ruby`. + +Primeiro, precisamos limpar qualquer instalação anterior do Ruby que você possa ter: + +```bash +rvm implode && sudo rm -rf ~/.rvm +# If you got "zsh: command not found: rvm", carry on. It means `rvm` is not +# on your computer, that's what we want! + +sudo rm -rf $HOME/.rbenv /usr/local/rbenv /opt/rbenv /usr/local/opt/rbenv +``` + +:warning: Este comando pode solicitar sua senha. + +:warning: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`. + +No terminal, execute: + +```bash +brew uninstall --force rbenv ruby-build +``` + +```bash +exec zsh +``` + +Então rode: + +```bash +brew install rbenv libyaml +``` diff --git a/_partials/pt/macos_settings.md b/_partials/pt/macos_settings.md new file mode 100644 index 00000000..87003c54 --- /dev/null +++ b/_partials/pt/macos_settings.md @@ -0,0 +1,46 @@ +## Configurações do MacOS + +### Segurança + +É obrigatório que você proteja sua sessão com uma senha. Se ainda não for o caso, vá para ` > Ajustes do Sistema > Usuários e Grupos` e altere a senha da sua conta. Você também deve ir para ` > Ajustes do Sistema > Segurança > Geral`. Você deve exigir uma senha `5 segundos` após o início da suspensão ou da proteção de tela. + +Você também pode ir para ` > Ajustes do Sistema > Controle daVelocidade de repetição de teclaVelocidade de repetição de Escritorio y Dock` e clicar no botão `cantos de acesso rápido (Hot Corners)` no canto inferior esquerdo. Escolha no canto inferior direito para iniciar o protetor de tela. Dessa forma, ao sair da mesa, você pode bloquear rapidamente a tela colocando o mouse no canto inferior direito. 5 segundos depois, seu MacBook estará bloqueado e solicitará uma senha para voltar à sessão. + +### Teclado + +Ao se tornar um programador, você entenderá que deixar o teclado leva muito tempo, então você vai querer minimizar o uso do trackpad ou do mouse. Aqui estão alguns truques no macOS para ajudá-lo a fazer isso. + +#### Velocidade do teclado + +Vá para ` > Preferências do Sistema > Teclado`. Defina `Velocidade de repetição de tecla` para a posição mais rápida (à direita) e `Atraso da repetição` para a posição mais curta (à direita). + +#### macOS Para hackers + +[Leia este script](https://github.com/mathiasbynens/dotfiles/blob/master/.macos) e escolha algumas coisas que você acha que combinam com você. Por exemplo, você pode digitar no terminal este: + +```bash +# Expanding the save panel by default +defaults write NSGlobalDomain NSNavPanelExpandedStateForSaveMode -bool true +defaults write NSGlobalDomain PMPrintingExpandedStateForPrint -bool true +defaults write NSGlobalDomain PMPrintingExpandedStateForPrint2 -bool true + +# Save screenshots to the Desktop (or elsewhere) +defaults write com.apple.screencapture location "${HOME}/Desktop" + +# etc.. +``` + +### Fixe aplicativos no seu dock + +Você usará a maioria dos aplicativos que instalou hoje com muita frequência. Vamos fixá-los no seu dock para que fiquem a apenas um clique de distância! + +Para fixar um aplicativo no seu dock, inicie o aplicativo, clique com o botão direito no ícone na barra de tarefas para abrir o menu de contexto e escolha "Opções" e depois "Manter no Dock". + +![Como fixar um aplicativo na barra de tarefas do macOS](images/macos_dock.png) + +Você deve fixar: +- Seu terminal +- Seu explorador de arquivos +- VS Code +- Seu navegador de Internet +- Slack diff --git a/_partials/pt/macos_slack.md b/_partials/pt/macos_slack.md new file mode 100644 index 00000000..471ea674 --- /dev/null +++ b/_partials/pt/macos_slack.md @@ -0,0 +1,9 @@ +## Slack + +[Slack](https://slack.com/) é uma plataforma de comunicação bastante popular na indústria de tecnologia. + +### Instalação + +[Baixe o aplicativo Slack](https://itunes.apple.com/us/app/slack/id803453959?mt=12) e instale-o. + +:warning: Se você já usa o Slack em seu navegador, baixe e instale **o aplicativo para desktop** que vem com todos os recursos. diff --git a/_partials/pt/macos_sqlite.md b/_partials/pt/macos_sqlite.md new file mode 100644 index 00000000..6322e913 --- /dev/null +++ b/_partials/pt/macos_sqlite.md @@ -0,0 +1,19 @@ +## SQLite + +Em algumas semanas falaremos sobre bancos de dados e SQL. [SQLite](https://sqlite.org/index.html) é um mecanismo de banco de dados usado para executar consultas SQL em bancos de dados de arquivo único. Vamos instalá-lo: + +Em um terminal, execute os seguintes comandos: + +```bash +brew install sqlite +``` + +Em seguida, execute o seguinte comando: + +```bash +sqlite3 -version +``` + +:heavy_check_mark: Se você vir uma versão, você está bem :+1: + +:x: Se não, **peça um professor** diff --git a/_partials/pt/macos_terminal.md b/_partials/pt/macos_terminal.md new file mode 100644 index 00000000..f8de03ce --- /dev/null +++ b/_partials/pt/macos_terminal.md @@ -0,0 +1,9 @@ +## Tema do Terminal macOS + +Inicie um terminal, clique em `Terminal > Preferências` e defina o tema "Pro" como perfil padrão. + +![Definir tema Pro para terminal macOS](images/macos_terminal_pro.png) + +Na guia Janela, defina também seu **Tamanho da janela** para Colunas: 200, Linhas: 50 + +**Saia e reinicie** seu terminal: agora ele deve ter um belo fundo preto, mais agradável aos olhos. diff --git a/_partials/pt/macos_vscode.md b/_partials/pt/macos_vscode.md new file mode 100644 index 00000000..8f5e16f7 --- /dev/null +++ b/_partials/pt/macos_vscode.md @@ -0,0 +1,21 @@ +## Visual Studio Code + +### Instalação + +Vamos instalar o editor de texto [Visual Studio Code](https://code.visualstudio.com). + +Copie (`Cmd` + `C`) o comando abaixo e cole-o em seu terminal (`Cmd` + `V`): + +```bash +brew install --cask visual-studio-code +``` + +Em seguida, inicie o VS Code executando o seguinte comando em seu terminal: + +```bash +code +``` + +:heavy_check_mark: Se uma janela do VS Code acabou de abrir, você está pronto :+1: + +:x: Caso contrário, por favor **entre em contato com um professor** diff --git a/_partials/pt/nvm.md b/_partials/pt/nvm.md new file mode 100644 index 00000000..97ed3293 --- /dev/null +++ b/_partials/pt/nvm.md @@ -0,0 +1,41 @@ +## Node.js + +[Node.js](https://nodejs.org/en/) é um tempo de execução JavaScript para executar código JavaScript no terminal. Vamos instalá-lo com [nvm](https://github.com/nvm-sh/nvm), um gerenciador de versões para Node.js. + +Em um terminal, execute os seguintes comandos: + +```bash +curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v/install.sh | zsh +``` + +```bash +exec zsh +``` + +Em seguida, execute o seguinte comando: + +```bash +nvm -v +``` + +Você deverá ver uma versão. Se não, pergunte a um professor. + +Agora vamos instalar o Node.js: + +```bash +nvm install +``` + +Quando a instalação terminar, execute: + +```bash +node -v +``` + +Se você vir `v`, a instalação foi bem-sucedida :heavy_check_mark: Você pode então executar: + +```bash +nvm cache clear +``` + +:x: Caso contrário, **entre em contato com um professor** diff --git a/_partials/pt/oh_my_zsh.md b/_partials/pt/oh_my_zsh.md new file mode 100644 index 00000000..2ee27ab9 --- /dev/null +++ b/_partials/pt/oh_my_zsh.md @@ -0,0 +1,19 @@ +## Oh-My-Zsh + +Vamos instalar o plugin `zsh` [Oh My Zsh](https://ohmyz.sh/). + +Em um terminal execute o seguinte comando: + +```bash +sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" +``` + +Se for perguntado "Deseja alterar seu shell padrão para zsh?", pressione `Y` + +No final seu terminal deverá ficar assim: + +![Terminal Ubuntu com OhMyZsh](images/oh_my_zsh.png) + +:heavy_check_mark: Se isso acontecer, você pode continuar :+1: + +:x: Caso contrário, por favor **entre em contato com um professor** diff --git a/_partials/pt/rbenv.md b/_partials/pt/rbenv.md new file mode 100644 index 00000000..d3135514 --- /dev/null +++ b/_partials/pt/rbenv.md @@ -0,0 +1,30 @@ +## rbenv + +Vamos instalar o [`rbenv`](https://github.com/sstephenson/rbenv), um software para instalar e gerenciar ambientes `ruby`. + +Primeiro, precisamos limpar qualquer instalação anterior do Ruby que você possa ter: + +```bash +rvm implode && sudo rm -rf ~/.rvm +# Se você obteve "zsh: comando não encontrado: rvm", continue. +# Significa que `rvm` não está no seu computador, é isso que queremos! +rm -rf ~/.rbenv +``` + +Então no terminal, execute: + +```bash +sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev libyaml-dev +``` + +```bash +git clone https://github.com/rbenv/rbenv.git ~/.rbenv +``` + +```bash +git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build +``` + +```bash +exec zsh +``` diff --git a/_partials/pt/ruby.md b/_partials/pt/ruby.md new file mode 100644 index 00000000..26aecbb5 --- /dev/null +++ b/_partials/pt/ruby.md @@ -0,0 +1,81 @@ +## Ruby + +### Instalação + +Agora, você está pronto para instalar a versão mais recente do [ruby](https://www.ruby-lang.org/en/) e defini-la como a versão padrão. + +Execute este comando, **demorará um pouco (5 a 10 minutos)** + +```bash +rbenv install +``` + +Assim que a instalação do Ruby estiver concluída, execute este comando para informar ao sistema +para usar a versão por padrão. + +```bash +rbenv global +``` + +**Reinicialize** seu terminal e verifique sua versão do Ruby: + +```bash +exec zsh +``` + +Então corra: + +```bash +ruby -v +``` + +:heavy_check_mark: Se você vir algo começando com `ruby ` então você pode prosseguir :+1: + +:x: Se não, **pergunte a um professor** + +### Instalando algumas gems + +
+ Se você estiver na China 🇨🇳 clique aqui + + :warning: Se você estiver na China, você deve atualizar a forma como instalaremos o gem com os seguintes comandos. + +```bash +# Somente China! +fontes de gemas --remove https://rubygems.org/ +fontes de gemas -a https://gems.ruby-china.com/ +fontes de gemas -l +#***FONTES ATUAIS*** +# https://gems.ruby-china.com/ +# Ruby-china.com deve estar na lista agora +``` +
+ +**Todos, na China ou não**, continuem aqui para instalar gems. + +No mundo Ruby, chamamos bibliotecas externas de `gems`: são pedaços de código Ruby que você pode baixar e executar em seu computador. Vamos instalar alguns! + +No seu terminal, copie e cole o seguinte comando: + +```bash +gem install +``` + +:heavy_check_mark: Se você tiver `xx gems installed`, então tudo bem :+1: + +:x: Se você encontrar o seguinte erro: + +```bash +ERROR: While executing gem ... (TypeError) +incompatible marshal file format (can't be read) +format version 4.8 required; 60.33 given +``` + +Execute o seguinte comando: +```bash +rm -rf ~/.gemrc +``` + +Execute novamente o comando para instalar as gemas. + +:warning: **NUNCA** instale uma gem com `sudo gem install`! Mesmo se você encontrar uma resposta do Stackoverflow (ou o terminal) solicitando que você faça isso. diff --git a/_partials/pt/slack_settings.md b/_partials/pt/slack_settings.md new file mode 100644 index 00000000..6d2019be --- /dev/null +++ b/_partials/pt/slack_settings.md @@ -0,0 +1,25 @@ +### Configurações + +Inicie o aplicativo e faça login na organização `lewagon-alumni`. + +Certifique-se de **fazer upload de uma foto de perfil** :point_down: + +![Como fazer upload de uma foto de perfil no Slack](images/slack_profile_picture.gif) + +A ideia é que você tenha o Slack aberto o dia todo, para que você possa compartilhar links úteis/pedir ajuda/decidir onde ir almoçar/etc. + +Para garantir que tudo está funcionando bem nas videochamadas, vamos testar sua câmera e microfone: +- Abra o aplicativo Slack +- Clique na foto do seu perfil no canto superior direito. +- Selecione `Preferências` no menu. +- Clique em `Áudio e vídeo` na coluna do lado esquerdo. +- Abaixo de `Solução de problemas`, clique em `Executar um teste de áudio, vídeo e compartilhamento de tela`. O teste será aberto em uma nova janela. +- Verifique se seus dispositivos preferidos de alto-falante, microfone e câmera aparecem nos menus suspensos e clique em `Iniciar teste`. + +![Verifique o microfone e a webcam com o Slack](images/slack_call_test.png) + +:heavy_check_mark: Quando o teste terminar, você deverá ver mensagens verdes de "Sucesso" pelo menos para seu microfone e câmera. :+1: + +:x: Caso contrário, **entre em contato com um professor**. + +Você também pode instalar o aplicativo Slack no seu telefone e entrar em `lewagon-alumni`! diff --git a/_partials/pt/sqlite.md b/_partials/pt/sqlite.md new file mode 100644 index 00000000..ede9ff20 --- /dev/null +++ b/_partials/pt/sqlite.md @@ -0,0 +1,19 @@ +## SQLite + +Em algumas semanas falaremos sobre bancos de dados e SQL. [SQLite](https://sqlite.org/index.html) é um mecanismo de banco de dados usado para executar consultas SQL em bancos de dados de arquivo único. Vamos instalá-lo: + +Em um terminal, execute os seguintes comandos: + +```bash +sudo apt-get install sqlite3 libsqlite3-dev pkg-config +``` + +Em seguida, execute o seguinte comando: + +```bash +sqlite3 -version +``` + +:heavy_check_mark: Se você vir uma versão, você está bem :+1: + +:x: Se não, **peça um professor** diff --git a/_partials/pt/ssh_agent.md b/_partials/pt/ssh_agent.md new file mode 100644 index 00000000..58355198 --- /dev/null +++ b/_partials/pt/ssh_agent.md @@ -0,0 +1,15 @@ +## Desativar prompt de senha SSH + +Você não quer que sua senha seja solicitada sempre que se comunicar com um repositório distante. Então, você precisa adicionar o plugin `ssh-agent` ao `oh my zsh`: + +Primeiro, abra o arquivo `.zshrc`: + +```bash +code ~/.zshrc +``` + +Então: +- Identifique a linha que começa com `plugins=` +- Adicione `ssh-agent` no final da lista de plugins + +:heavy_check_mark: Salve o arquivo `.zshrc` com `Ctrl` + `S` e feche seu editor de texto. diff --git a/_partials/pt/ubuntu_postgresql.md b/_partials/pt/ubuntu_postgresql.md new file mode 100644 index 00000000..0b46434b --- /dev/null +++ b/_partials/pt/ubuntu_postgresql.md @@ -0,0 +1,15 @@ +## PostgreSQL + +Às vezes, o SQLite não é suficiente e precisaremos de uma ferramenta mais avançada chamada [PostgreSQL](https://www.postgresql.org/), um sistema de banco de dados de código aberto, robusto e pronto para produção. + +Vamos instalá-lo agora. + +Execute os seguintes comandos: + +```bash +sudo apt install -y postgresql postgresql-contrib libpq-dev build-essential +``` + +```bash +sudo -u postgres psql --command "CREATE ROLE \"`whoami`\" LOGIN createdb superuser;" +``` diff --git a/_partials/pt/ubuntu_settings.md b/_partials/pt/ubuntu_settings.md new file mode 100644 index 00000000..1dce8026 --- /dev/null +++ b/_partials/pt/ubuntu_settings.md @@ -0,0 +1,50 @@ +## Configurações do Ubuntu + +### Instale o codec de vídeo H264 + +Na nossa plataforma pedagógica (Kitt, você vai descobrir em breve!), temos alguns vídeos. Por padrão, o Firefox no Linux não pode reproduzi-los porque eles usam um codec não suportado (H264). Para que esses vídeos funcionem para você, você precisa executar o seguinte: + +```bash +sudo apt install libavcodec-extra -y +``` + +### Instale ferramentas de terminal úteis + +`tree` é uma boa ferramenta para visualizar uma árvore de diretórios dentro do terminal: + +`ncdu` é um utilitário de disco de interface baseado em texto. + +`htop` é um visualizador de processos interativo. + +`tig` é uma interface em modo texto para `git`. + +```bash +sudo apt install tree ncdu htop tig +``` + +### Ubuntu inotify + +O Ubuntu está sempre rastreando alterações em suas pastas e para isso usa o inotify. +Por padrão, o limite do Ubuntu é definido para 8.192 arquivos monitorados. + +Como a programação envolve muitos arquivos, precisamos aumentar esse limite. +Em seu terminal, execute: + +```bash +echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p +``` + +### Fixe aplicativos no seu dock + +Você usará a maioria dos aplicativos que instalou hoje com muita frequência. Então, vamos fixá-los no seu dock para que fiquem a apenas um clique de distância! + +Para fixar um aplicativo no seu dock, inicie o aplicativo, clique com o botão direito no ícone do dock para abrir o menu de contexto e escolha "Adicionar aos Favoritos". + +![Como fixar um aplicativo no dock no Ubuntu](images/ubuntu_dock.png) + +Você deve fixar: +- Seu terminal +- Seu explorador de arquivos +- VS Code +- Seu navegador de Internet +- Slack diff --git a/_partials/pt/ubuntu_slack.md b/_partials/pt/ubuntu_slack.md new file mode 100644 index 00000000..9a912a4e --- /dev/null +++ b/_partials/pt/ubuntu_slack.md @@ -0,0 +1,9 @@ +## Slack + +[Slack](https://slack.com/) é uma plataforma de comunicação bastante popular na indústria de tecnologia. + +### Instalação + +[Baixe o aplicativo Slack](https://get.slack.help/hc/en-us/articles/212924728-Slack-for-Linux-beta-) e instale-o. + +:warning: Se você já usa o Slack em seu navegador, baixe e instale **o aplicativo para desktop** que vem com todos os recursos. diff --git a/_partials/pt/ubuntu_vscode.md b/_partials/pt/ubuntu_vscode.md new file mode 100644 index 00000000..5d3f1c73 --- /dev/null +++ b/_partials/pt/ubuntu_vscode.md @@ -0,0 +1,47 @@ +## Visual Studio Code + +### Instalação + +Vamos instalar o editor de texto [Visual Studio Code](https://code.visualstudio.com). + +Copie (`Ctrl` + `C`) os comandos abaixo e cole-os em seu terminal (`Ctrl` + `Shift` + `v`): + +```bash +wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg +``` + +```bash +sudo install -o root -g root -m 644 packages.microsoft.gpg /etc/apt/trusted.gpg.d/ +``` + +```bash +sudo sh -c 'echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/trusted.gpg.d/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list' +``` + +```bash +rm -f packages.microsoft.gpg +``` + +```bash +sudo apt update +``` + +```bash +sudo apt install -y code +``` + +Esses comandos solicitarão sua senha: digite-a. + +:warning: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`. + +### Iniciando a partir do terminal + +Agora vamos iniciar o VS Code no **terminal**: + +```bash +code +``` + +:heavy_check_mark: Se uma janela do VS Code acabou de abrir, você está pronto: +1: + +:x: Caso contrário, por favor **entre em contato com um professor** diff --git a/_partials/pt/vscode_aifeatures.md b/_partials/pt/vscode_aifeatures.md new file mode 100644 index 00000000..ffd89d63 --- /dev/null +++ b/_partials/pt/vscode_aifeatures.md @@ -0,0 +1,17 @@ +### Recursos de IA no VS Code + +O VS Code inclui muitos **recursos poderosos de IA**, que são ótimas ferramentas quando você já sabe programar. + +Dito isso, confiar na IA muito cedo pode ocultar conceitos importantes e dificultar o entendimento da depuração. Quando você estiver confortável com os fundamentos, saberá quando e como usar a IA de forma eficaz — sem deixar que ela faça o raciocínio por você. + +Para o início do bootcamp, vamos desativar esses recursos. No momento certo do curso, os reativaremos para que você possa usá-los bem. + +Em **VS Code**: + +1. Vamos abrir a "Paleta de Comandos" do VS Code: digite `Ctrl-Shift-P` (Windows / Linux) ou `Cmd-Shift-P` (macOS). +1. Isso abrirá a Paleta de Comandos: uma pequena caixa de texto no topo da tela. Comece a digitar `aifeatures` até ver "Chat: Learn How to Hide AI features". Clique nela. + ![A Paleta de Comandos no topo da tela](images/vscode_find_aifeatures.png) +1. Isso abrirá as configurações e mostrará a opção "Disable and hide built-in AI features ...". Marque a caixa de seleção à frente dessa opção. + ![Marcar a opção para desativar](images/vscode_disable_aifeatures.png) + +Mais tarde, se quiser **reativar** os recursos de IA, você pode seguir as mesmas instruções para desmarcar a caixa. diff --git a/_partials/pt/vscode_extensions.md b/_partials/pt/vscode_extensions.md new file mode 100644 index 00000000..c11e6262 --- /dev/null +++ b/_partials/pt/vscode_extensions.md @@ -0,0 +1,31 @@ +## Extensões do VS Code + +### Instalação + +Vamos instalar algumas extensões úteis no VS Code. + +Copie e cole os seguintes comandos em seu terminal: + +```bash +code --install-extension ms-vscode.sublime-keybindings +code --install-extension emmanuelbeziat.vscode-great-icons +code --install-extension github.github-vscode-theme +code --install-extension MS-vsliveshare.vsliveshare +code --install-extension shopify.ruby-lsp +code --install-extension dbaeumer.vscode-eslint +code --install-extension Rubymaniac.vscode-paste-and-indent +code --install-extension alexcvzz.vscode-sqlite +code --install-extension anteprimorac.html-end-tag-labels +code --install-extension marcoroth.herb-lsp +code --install-extension rayhanw.erb-helpers +``` + +Aqui está uma lista das extensões que você está instalando: + +- [Sublime Text Keymap and Settings Importer](https://marketplace.visualstudio.com/items?itemName=ms-vscode.sublime-keybindings) +- [VSCode Great Icons](https://marketplace.visualstudio.com/items?itemName=emmanuelbeziat.vscode-great-icons) +- [Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare) +- [Ruby](https://marketplace.visualstudio.com/items?itemName=shopify.ruby-lsp) +- [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) +- [Paste and Indent](https://marketplace.visualstudio.com/items?itemName=Rubymaniac.vscode-paste-and-indent) +- [SQLite](https://marketplace.visualstudio.com/items?itemName=alexcvzz.vscode-sqlite) diff --git a/_partials/pt/vscode_liveshare.md b/_partials/pt/vscode_liveshare.md new file mode 100644 index 00000000..c5008940 --- /dev/null +++ b/_partials/pt/vscode_liveshare.md @@ -0,0 +1,16 @@ +### Configuração do Live Share + +[Visual Studio Live Share](https://visualstudio.microsoft.com/services/live-share/) é uma extensão do VS Code que permite compartilhar o código em seu editor de texto para depuração e programação em pares: vamos configurá-lo acima! + +Inicie o VS Code em seu terminal digitando `code` e pressionando `Enter`. + +Clique na pequena seta na parte inferior da barra esquerda :point_down: + +![VS Code Live Share](images/vscode_live_share.png) + +- Clique no botão "Compartilhar" e depois em "GitHub (faça login usando a conta GitHub)". +- Um pop-up aparece solicitando que você faça login no GitHub: clique em “Permitir”. +- Você é redirecionado para uma página do GitHub em seu navegador solicitando autorização do Visual Studio Code: clique em "Continuar" e depois em "Autorizar github". +- O VS Code pode exibir pop-ups adicionais: feche-os clicando em "OK". + +É isso, você está pronto para continuar! diff --git a/_partials/pt/windows_browser.md b/_partials/pt/windows_browser.md new file mode 100644 index 00000000..a0a3f8dc --- /dev/null +++ b/_partials/pt/windows_browser.md @@ -0,0 +1,114 @@ +## Vinculando seu navegador padrão ao Ubuntu + +Para ter certeza de que você pode interagir com seu navegador instalado no Windows a partir do terminal Ubuntu, precisamos defini-lo como navegador padrão. + +:warning: Você precisa executar pelo menos um dos seguintes comandos abaixo: + +
+ Google Chrome como navegador padrão + + Execute o comando: + + ```bash + ls /mnt/c/Program\ Files\ \(x86\)/Google/Chrome/Application/chrome.exe + ``` + + Você recebeu um erro como `ls: não é possível acessar...`? + +
+ Sim, ocorreu um erro + +Execute os seguintes comandos: + + ```bash + echo "export BROWSER=\"/mnt/c/Program Files/Google/Chrome/Application/chrome.exe\"" >> ~/.zshrc + echo "export GH_BROWSER=\"'/mnt/c/Program Files/Google/Chrome/Application/chrome.exe'\"" >> ~/.zshrc + ``` +
+ +
+ Não, estava tudo bem + + Execute os seguintes comandos: + + ```bash + echo "export BROWSER=\"/mnt/c/Program Files (x86)/Google/Chrome/Application/chrome.exe\"" >> ~/.zshrc + echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Google/Chrome/Application/chrome.exe'\"" >> ~/.zshrc + ``` +
+ +--- + +
+ +
+ Mozilla Firefox como seu navegador padrão + + Execute o comando: + + ```bash + ls /mnt/c/Program\ Files\ \(x86\)/Mozilla\ Firefox/firefox.exe + ``` + + Você recebeu um erro como `ls: não é possível acessar...`? + +
+ Sim, ocorreu um erro + + Execute os seguintes comandos: + + ```bash + echo "export BROWSER=\"/mnt/c/Program Files/Mozilla Firefox/firefox.exe\"" >> ~/.zshrc + echo "export GH_BROWSER=\"'/mnt/c/Program Files/Mozilla Firefox/firefox.exe'\"" >> ~/.zshrc + ``` + +
+ +
+ Não, estava tudo bem + + Execute os seguintes comandos: + + ```bash + echo "export BROWSER=\"/mnt/c/Program Files (x86)/Mozilla Firefox/firefox.exe\"" >> ~/.zshrc + echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Mozilla Firefox/firefox.exe'\"" >> ~/.zshrc + ``` +
+ +--- + +
+ +
+ Microsoft Edge como navegador padrão + + Execute os comandos: + + ```bash + echo "export BROWSER=\"/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe\"" >> ~/.zshrc + echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'\"" >> ~/.zshrc + ``` + +--- + +
+ +Reinicie seu terminal. + +Em seguida, certifique-se de que o seguinte comando retorne "Browser Defined 👌": + +```bash +[ -z "$BROWSER" ] && echo "ERROR: please define a BROWSER environment variable ⚠️" || echo "Browser defined 👌" +``` + +Se isso não acontecer, + +:heavy_check_mark: Se você recebeu esta mensagem, pode continuar :+1: + +:x: Caso contrário, escolha um navegador na lista acima e execute o comando correspondente. Então não se esqueça de redefinir seu terminal: + +```bash +exec zsh +``` + +Não hesite em **entrar em contato com um professor**. diff --git a/_partials/pt/windows_postgresql.md b/_partials/pt/windows_postgresql.md new file mode 100644 index 00000000..aa34eb5e --- /dev/null +++ b/_partials/pt/windows_postgresql.md @@ -0,0 +1,39 @@ +## PostgreSQL + +Às vezes, o SQLite não é suficiente e precisaremos de uma ferramenta mais avançada chamada [PostgreSQL](https://www.postgresql.org/), um sistema de banco de dados de código aberto, robusto e pronto para produção. + +Vamos instalá-lo agora. + +Execute os seguintes comandos: + +```bash +sudo apt install -y postgresql postgresql-contrib libpq-dev build-essential +``` + +```bash +sudo /etc/init.d/postgresql start +``` + +```bash +sudo -u postgres psql --command "CREATE ROLE \"`whoami`\" LOGIN createdb superuser;" +``` + +Você pode configurar o PostgreSQL para inicialização automática, para que não precise executar `sudo /etc/init.d/postgresql start` cada vez que abrir um novo terminal: + +```bash +sudo echo "`whoami` ALL=NOPASSWD:/etc/init.d/postgresql start" | sudo tee /etc/sudoers.d/postgresql +``` + +```bash +sudo chmod 440 /etc/sudoers.d/postgresql +``` + +```bash +echo "sudo /etc/init.d/postgresql start" >> ~/.zshrc +``` + +Abra um novo terminal. + +:heavy_check_mark: Se você vir uma mensagem `* Starting postgresql (via systemctl): postgresql.service` OU `* Starting PostgreSQL 14 database server`, você está pronto para prosseguir :+1: + +:x: Caso contrário, **entre em contato com um professor**. diff --git a/_partials/pt/windows_settings.md b/_partials/pt/windows_settings.md new file mode 100644 index 00000000..c73f03b1 --- /dev/null +++ b/_partials/pt/windows_settings.md @@ -0,0 +1,51 @@ +## Configurações do Windows + +### Troque arquivos entre Windows e Ubuntu + +Precisamos de uma maneira fácil de transferir arquivos do Windows para o Ubuntu e vice-versa. + +Para fazer isso, vamos criar atalhos para diretórios do Ubuntu no **File Explorer** do Windows: +- Abra o Windows File Explorer (ou use o atalho `WIN` + `E`) +- Na barra de endereços, digite `\\wsl$\` (ou `\\wsl$\Ubuntu` se não funcionar) +- Agora você tem acesso ao sistema de arquivos Ubuntu +- Mergulhe no sistema de arquivos Ubuntu para procurar diretórios de interesse +- Arraste as pastas desejadas para a barra de endereços para criar atalhos + +![Como adicionar um atalho ao sistema de arquivos Ubuntu no Windows](images/windows_ubuntu_file_system_shortcut.gif) + +### Abra o Windows File Explorer no terminal Ubuntu + +Outra opção para mover arquivos é abrir o Windows **File Explorer** no terminal Ubuntu: +- Abra um terminal Ubuntu +- Vá para o diretório que deseja explorar +- Execute o comando `explorer.exe .` (alternativamente, use `wslview .`) +- Se você receber uma mensagem de erro de entrada e saída, execute `wsl --shutdown` em um Windows PowerShell e reabra um terminal Ubuntu + +![Como iniciar o Windows Explorer a partir do terminal Ubuntu](images/windows_explorer_from_terminal.png) + +### Encontre o seu caminho no sistema de arquivos Ubuntu + +Você pode querer descobrir a localização exata de um diretório do Windows no sistema de arquivos Ubuntu ou vice-versa. + +Para converter um caminho do Windows de e para um caminho do Ubuntu: +- Abra um terminal Ubuntu +- Use o comando `wslpath "C:\Program Files"` para traduzir um caminho do Windows em um caminho do Ubuntu +- Use o comando `wslpath -w "/home"` para traduzir um caminho do Ubuntu em um caminho do Windows +- Em particular, o comando `wslpath -w $(pwd)` retorna o caminho do Windows do diretório atual do Ubuntu + +![Como acessar um caminho do Windows a partir do terminal Ubuntu](images/windows_path_from_terminal.png) + +### Fixe aplicativos na sua barra de tarefas + +Você usará a maioria dos aplicativos que instalou hoje com muita frequência. Vamos fixá-los na barra de tarefas para que estejam a apenas um clique de distância! + +Para fixar um aplicativo na barra de tarefas, inicie o aplicativo, clique com o botão direito no ícone da barra de tarefas para abrir o menu de contexto e escolha “Fixar na barra de tarefas”. + +![Como fixar um aplicativo na barra de tarefas do Windows](images/windows_taskbar.png) + +Você deve fixar: +- Seu terminal +- Seu explorador de arquivos +- VS Code +- Seu navegador de Internet +- Slack diff --git a/_partials/pt/windows_slack.md b/_partials/pt/windows_slack.md new file mode 100644 index 00000000..525bfabb --- /dev/null +++ b/_partials/pt/windows_slack.md @@ -0,0 +1,9 @@ +## Slack + +[Slack](https://slack.com/) é uma plataforma de comunicação bastante popular na indústria de tecnologia. + +### Instalação + +[Baixe o aplicativo Slack](https://slack.com/downloads/windows) e instale-o. + +:warning: Se você já usa o Slack em seu navegador, baixe e instale **o aplicativo para desktop** que vem com todos os recursos. diff --git a/_partials/pt/windows_terminal.md b/_partials/pt/windows_terminal.md new file mode 100644 index 00000000..9161c63f --- /dev/null +++ b/_partials/pt/windows_terminal.md @@ -0,0 +1,85 @@ +## Terminal do Windows + +### Instalação + +:information_source: As instruções a seguir dependem da sua versão do Windows. + +Se você estiver executando o Windows 11, o Terminal do Windows já está instalado e você pode prosseguir para a próxima seção :point_down: + +Se você estiver executando o Windows 10, vamos instalar o Windows Terminal, um terminal realmente moderno. + +
+Windows 10: Instalar Windows Terminal + +- Clique em `Iniciar` +- Digite `Microsoft Store` +- Clique em `Microsoft Store` na lista +- Procure por `Windows Terminal` na barra de pesquisa +- **Selecione Terminal do Windows"** +- Clique em `Instalar` + +:warning: NÃO instale o **Windows Terminal Preview**, apenas o **Windows Terminal**! + +
+ Desinstale a versão errada do Terminal do Windows + + Para desinstalar uma versão errada do Terminal Windows, basta ir até a Lista de Programas Instalados do Windows 10: + + - Pressione `Windows` + `R` + - Digite `ms-settings:appsfeatures` + - Pressione `Enter` + + Encontre o software para desinstalar e clique no botão desinstalar. +
+ +Assim que a instalação for concluída, o botão `Instalar` se torna um botão `Iniciar`: clique nele. + +
+ +### Ubuntu como terminal padrão + +Vamos tornar o Ubuntu o terminal padrão do seu aplicativo Windows Terminal. + +Pressione `Ctrl` + `,` + +Deve abrir as configurações do terminal: + +![Configurações do Terminal do Windows](images/windows_terminal_settings.png) + +- Altere o perfil padrão para "Ubuntu" +- Clique em "Salvar" +- Clique em "Abrir arquivo JSON" + +Você pode ver um círculo laranja em vez de um pinguim como logotipo do Ubuntu. + +Temos um círculo em vermelho na parte que você irá alterar: + +![Arquivo de configurações JSON do Terminal do Windows](images/windows_terminal_settings_json.png) + +Primeiro, vamos pedir ao Ubuntu para iniciar diretamente dentro do diretório inicial do Ubuntu, em vez do diretório do Windows: +- Localize a entrada com `"name": "Ubuntu",` e `"hidden": false,` +- Adicione a seguinte linha depois dela: + +```bash +"commandline": "wsl.exe ~", +``` + +:warning: Não esqueça a vírgula no final da linha! + +Então, vamos desabilitar o aviso para comandos de copiar e colar entre o Windows e o Ubuntu: +- Localize a linha `"defaultProfile": "{2c4de342-...}"` +- Adicione a seguinte linha depois dela: + +```bash +"warning.multiLinePaste": false, +``` + +:warning: Não esqueça a vírgula no final da linha! + +Você pode salvar essas alterações pressionando `Ctrl` + `S` + +:heavy_check_mark: Seu **Terminal Windows** agora está configurado :+1: + +Este terminal possui abas: você pode optar por abrir uma nova aba do terminal clicando em **+** ao lado da atual. + +**De agora em diante, toda vez que nos referirmos ao terminal ou ao console será este.** NÃO utilize mais nenhum outro terminal. diff --git a/_partials/pt/windows_ubuntu.md b/_partials/pt/windows_ubuntu.md new file mode 100644 index 00000000..cb9e6854 --- /dev/null +++ b/_partials/pt/windows_ubuntu.md @@ -0,0 +1,112 @@ +## Ubuntu + +### Instalação + +Após reiniciar o computador, você deverá ver uma janela de terminal informando que o WSL está retomando o processo de instalação do Ubuntu. Quando terminar, o Ubuntu será lançado. + +
+Solução de problemas para Windows 10 (apenas se necessário, consulte um TA) + +Se a instalação do Ubuntu não foi retomada, tente novamente: abra o Powershell ou o Prompt de Comando e execute `wsl --install` novamente. + +Se você estiver executando o Windows 10, vamos instalar o Ubuntu através da Microsoft Store: + +- Clique em `Iniciar` +- Digite `Microsoft Store` +- Clique em `Microsoft Store` na lista +- Procure por `Ubuntu` na barra de pesquisa +- **Selecione a versão sem nenhum número, simplesmente "Ubuntu"** +- Clique em `Obter` + +:warning: Não instale **Ubuntu 18.04 LTS** nem **Ubuntu 20.04**! + +
+ Desinstale versões erradas do Ubuntu + + Para desinstalar uma versão errada do Ubuntu, basta ir até a Lista de Programas Instalados do Windows 10: + - Pressione `Windows` + `R` + - Digite `ms-settings:appsfeatures` + - Pressione `Enter` + + Encontre o software para desinstalar e clique no botão desinstalar. +
+ +Assim que a instalação for concluída, o botão `Get` se torna um botão `Open`: clique nele. + +### Executando pela primeira vez + +Na primeira execução, serão solicitadas algumas informações: +- Escolha um nome de **usuário**: + - uma palavra + - minúsculas + - sem caracteres especiais + - por exemplo: `lewagon` ou seu `nome` +- Escolha uma **senha** +- Confirme sua senha + +:warning: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`. + +Você pode fechar a janela do Ubuntu agora que ele está instalado no seu computador. + +### Verifique a versão WSL do Ubuntu + +- Pressione `Windows` + `R` +- Digite `cmd` +- Pressione `Enter` + +Digite o seguinte comando: + +```bash +wsl -l -v +``` + +:heavy_check_mark: Se a versão do Ubuntu WSL for 2, você está pronto :+1: + +:x: Se a versão do Ubuntu WSL for 1, precisaremos convertê-lo para a versão 2. + +
+ Converter Ubuntu WSL V1 em V2 + + Na janela do prompt de comando, digite: + + ```bash + wsl --set-version Ubuntu 2 + ``` + + :heavy_check_mark: Após alguns segundos, você deverá receber a seguinte mensagem: `A conversão foi concluída`. + + :x: Se não funcionar, precisamos ter certeza de que os arquivos do Ubuntu não estão compactados. +
+ +
+ Verificar arquivos descompactados + + - Pressione `Windows` + `R` + - Digite `%localappdata%\Packages` + - Pressione `Enter` + - Abra a pasta chamada `CanonicalGroupLimited.UbuntuonWindows...` + - Clique com o botão direito na pasta `LocalState` + - Clique em `Propriedades` + - Clique em `Avançado` + - Certifique-se de que a opção `Compactar conteúdo` **não** esteja marcada e clique em `Ok`. + + Aplique as alterações apenas nesta pasta e tente converter a versão WSL do Ubuntu novamente. + + :x: Se a conversão ainda não funcionar, por favor **entre em contato com um professor**. +
+ +Agora você pode fechar esta janela do terminal. + +
+ +### Check your username + +Type this in the Ubuntu terminal: + +```bash +whoami +``` + +It should return the username you chose before. + +:x: It if says `root`, **contact a TA** before continuing! diff --git a/_partials/pt/windows_version.md b/_partials/pt/windows_version.md new file mode 100644 index 00000000..4e2490dc --- /dev/null +++ b/_partials/pt/windows_version.md @@ -0,0 +1,65 @@ +## Versão do Windows + +Antes de começarmos, precisamos verificar se a versão do Windows instalada no seu computador é compatível com estas instruções de configuração. + +### Windows 10 ou Windows 11 + +> :warning: **Nota sobre o Windows 10 e segurança** +> +> O setup do bootcamp Le Wagon funciona no Windows 10. Dito isso, recomendamos fortemente a atualização para o Windows 11. A partir de 14 de outubro de 2025, a Microsoft encerrou o suporte ao Windows 10, o que significa que ele não receberá mais atualizações de segurança, potencialmente deixando sua máquina em risco. Para mais detalhes, leia o guia da Microsoft: https://support.microsoft.com/en-us/windows/windows-10-support-has-ended-on-october-14-2025-2ca8b313-1946-43d3-b55c-2b95b107f281. Caso sua máquina não consiga executar o Windows 11, considere mudar para o Ubuntu. + +Para poder configurar seu computador, você precisa ter o **Windows 10 ou Windows 11** instalado. + +Para verificar sua versão do Windows: +- Pressione `Windows` + `R` +- Digite `winver` +- Pressione `Enter` + +:heavy_check_mark: Se as primeiras palavras desta janela forem **Windows 11** você está pronto para prosseguir :+1: + +- :heavy_check_mark: Se as primeiras palavras desta janela forem **Windows 10**, verifique o **Número da versão**:: + +- :x: Caso contrário, você não poderá prosseguir com esta configuração. Você precisa atualizar. + +-
+ Como instalar as últimas atualizações? + + Abra a atualização do Windows: + - Pressione `Windows` + `R` + - Digite `ms-settings:windowsupdate` + - Pressione `Enter` + - Clique em `Verificar atualizações` + + :heavy_check_mark: Se você vir uma marca de seleção verde e a mensagem "Você está atualizado", você está pronto para prosseguir :+1: + + :warning: Se você tiver um ponto de exclamação vermelho e a mensagem "Atualização disponível", instale-os e repita o processo até que apareça que você está atualizado :loop: + + :x: Se você receber uma mensagem de erro sobre o Windows não conseguir aplicar atualizações, **entre em contato com um professor**. + +
+ Ative o Windows Update Service para corrigir atualizações + + Alguns antivírus e softwares desativam o serviço de atualização de que precisamos, resultando no erro que você vê. Vamos consertar isso! + - Pressione `Windows` + `R` + - Digite `services.msc` + - Pressione `Enter` + - Clique duas vezes em `Serviço de atualização do Windows` + - Defina sua `Inicialização` para `Automático` + - Clique em `Iniciar` + - Clique em `Ok` + Então vamos tentar as atualizações novamente! +
+ + + Verifique o Número da versão: + + - Pressione `Windows` + `R` + - Digite `winver` + - Pressione `Enter` + + + :heavy_check_mark: Se disser pelo menos `2004`, você está pronto :+1: + + :x: Se estiver abaixo de `22004`, por favor **entre em contato com um professor**. + +
diff --git a/_partials/pt/windows_virtualization.md b/_partials/pt/windows_virtualization.md new file mode 100644 index 00000000..82717cd4 --- /dev/null +++ b/_partials/pt/windows_virtualization.md @@ -0,0 +1,37 @@ +## Virtualização + +Precisamos garantir que as opções de virtualização estejam habilitadas no BIOS do seu computador. + +Para muitos computadores, este já é o caso. Vamos checar: +- Pressione `Windows` + `R` +- Digite `taskmgr` +- Pressione `Enter` +- Clique na aba `Desempenho` +- Clique em `CPU` + +![Gerenciador de tarefas do Windows](images/windows_task_manager.png) + +:heavy_check_mark: Se você vir "Virtualização: Ativada", está pronto :+1: + +:x: Se a linha estiver faltando ou se a virtualização estiver desabilitada, por favor **entre em contato com um professor antes de tentar ativar a Virtualização** + +
+ Ativar virtualização + + Precisamos acessar o BIOS/UEFI do computador para ativá-lo. + - Pressione `Windows + R` + - Digite `shutdown.exe /r /o /t 1` + - Pressione `Enter` + - Aguarde o computador desligar + - Clique em `Solucionar problemas` + - Clique em `Opções avançadas` + - Clique em `Configurações de firmware UEFI` + - Clique em `Reiniciar` + + Você precisa ativar a opção de virtualização para o seu processador aqui: + - Na maioria das vezes, nas configurações avançadas, nas configurações da CPU ou nas configurações do Northbridge + - A opção pode ter um nome diferente de acordo com o seu computador: + - Intel: `Intel VT-x`, `Tecnologia de virtualização Intel`, `Extensões de virtualização`, `Vanderpool`... + - AMD: `Modo SVM` ou `AMD-V` + - Salve as alterações após a ativação e reinicie o computador através da opção apropriada +
diff --git a/_partials/pt/windows_vscode.md b/_partials/pt/windows_vscode.md new file mode 100644 index 00000000..2fd963d2 --- /dev/null +++ b/_partials/pt/windows_vscode.md @@ -0,0 +1,38 @@ +## Visual Studio Code + +### Instalação + +Vamos instalar o editor de texto [Visual Studio Code](https://code.visualstudio.com). + +- Vá para a [página de download do Visual Studio Code](https://code.visualstudio.com/download). +- Clique no botão "Windows" +- Abra o arquivo que você acabou de baixar. +- Instale-o com algumas opções: + +![Opções de instalação do VS Code](images/windows_vscode_installation.png) + +Quando a instalação for concluída, inicie o VS Code. + +### Conectando o código VS ao Ubuntu + +Para fazer o VS Code interagir corretamente com o Ubuntu, vamos instalar a extensão [Remote - WSL](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl) VS Code. + +Abra seu **terminal Ubuntu**. + +Copie e cole os seguintes comandos no terminal: + +```bash +code --install-extension ms-vscode-remote.remote-wsl +``` + +Em seguida, abra o VS Code em seu terminal: + +```bash +code . +``` + +:heavy_check_mark: Se você vir `WSL: Ubuntu` no canto inferior esquerdo da janela do VS Code, você está pronto para prosseguir :+1: + +![WSL Ubuntu remoto](images/windows_remote_wsl.png) + +:x: Caso contrário, por favor **entre em contato com um professor** diff --git a/_partials/pt/windows_wsl.md b/_partials/pt/windows_wsl.md new file mode 100644 index 00000000..cf411da2 --- /dev/null +++ b/_partials/pt/windows_wsl.md @@ -0,0 +1,113 @@ +## Subsistema Windows para Linux (WSL) + +WSL é o ambiente de desenvolvimento que usamos para executar o Ubuntu. Você pode aprender mais sobre WSL [aqui](https://docs.microsoft.com/en-us/windows/wsl/faq). + +Instalaremos o WSL 2 e o Ubuntu em um comando através do Windows Command Prompt. + +:warning: Nas instruções a seguir, esteja ciente do pressionamento de tecla `Ctrl` + `Shift` + `Enter` para executar o **Windows Command Prompt** com privilégios de administrador em vez de apenas clicar em `Ok` ou pressionar `Enter` . + +- Pressione `Windows` + `R` +- Digite `cmd` +- Pressione **`Ctrl` + `Shift` + `Enter`** + +:warning: Você pode ter que aceitar a confirmação do UAC sobre a elevação de privilégio. + +Uma janela de terminal aparecerá: +- Copie o seguinte comando (`Ctrl` + `C`) +- Cole-o na janela do terminal (`Ctrl` + `V` ou clicando com o botão direito na janela) +- Execute-o pressionando `Enter` + +```powershell +wsl --install +``` + +:heavy_check_mark: Se o comando foi executado sem nenhum erro, reinicie o computador e continue abaixo :+1: + +:x: Se você encontrar uma mensagem de erro (ou se vir algum texto em vermelho na janela), por favor **entre em contato com um professor** + +
+Solução de problemas para Windows 10 (apenas se necessário, consulte um professor) + +#### Para Windows 10 < 2004: instale o WSL 1 primeiro + +:warning: Nas instruções a seguir, esteja ciente do pressionamento de tecla `Ctrl` + `Shift` + `Enter` para executar o **Windows PowerShell** com privilégios de administrador em vez de apenas clicar em `Ok` ou pressionar `Enter` . + +- Pressione `Windows` + `R` +- Digite `powershell` +- Pressione **`Ctrl` + `Shift` + `Enter`** + +:warning: Você pode ter que aceitar a confirmação do UAC sobre a elevação de privilégio. + +Uma janela de terminal azul aparecerá: +- Copie os seguintes comandos um por um (`Ctrl` + `C`) +- Cole-os na janela do PowerShell (`Ctrl` + `V` ou clicando com o botão direito na janela) +- Execute-os pressionando `Enter` + +```powershell +Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux +``` + +```powershell +dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart +``` + +```powershell +dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart +``` + +:heavy_check_mark: Se todos os três comandos foram executados sem nenhum erro, reinicie o computador e continue abaixo :+1: + +:x: Se você encontrar uma mensagem de erro (ou se vir algum texto em vermelho na janela), por favor **entre em contato com um professor** + +#### Para Windows 10 com WSL 1: Atualizar para WSL 2 + +Se você estiver executando o Windows 10, atualizaremos o WSL para a versão 2. + +Assim que o computador for reiniciado, precisamos baixar o instalador WSL2. + +- Vá para a [página de download](https://aka.ms/wsl2kernel) +- Baixe o "pacote de atualização do kernel WSL2 Linux" +- Abra o arquivo que você acabou de baixar +- Clique em `Avançar` +- Clique em `Concluir` + +![Atualize WSL da versão 1 para 2](images/windows_update_wsl.png) + +:heavy_check_mark: Se não encontrou nenhuma mensagem de erro, você está pronto :+1: + +:x: Se você encontrar o erro "Esta atualização se aplica apenas a máquinas com o subsistema Windows para Linux", **clique com o botão direito** no programa e selecione `uninstall`; você poderá instalá-lo normalmente desta vez. + +#### Para Windows 10 com WSL 1: Torne o WSL 2 o subsistema Windows padrão para Linux + +Se você estiver executando o Windows 10, definiremos a versão padrão do WSL como 2. + +Agora que o WSL 2 está instalado, vamos torná-lo a versão padrão: +- Pressione `Windows` + `R` +- Digite `cmd` +- Pressione `Enter` + +Na janela que aparece, digite: + +```bash +wsl --set-default-version 2 +``` + +:heavy_check_mark: Se você vir "A operação foi concluída com sucesso", você pode fechar este terminal e continuar seguindo as instruções abaixo :+1: + +:x: Se a mensagem que você receber for sobre Virtualização, por favor **entre em contato com um professor** + +
+ Ativar recurso Windows da Plataforma de Máquina Virtual + + Siga as etapas descritas [aqui](https://www.configserverfirewall.com/windows-10/please-enable-the-virtual-machine-platform-windows-feature-and-ensure-virtualization-is-enabled-in- the-bios/#:~:text=To%20enable%20WSL%202,%20Open,Windows%20feature%20on%20or%20off.&text=Garanta%20que%20the%20Virtual%20Machine,Windows%20will%20enable%20WSL %202) até você ativar a Plataforma de Máquina Virtual e o Subsistema Windows para Linux +
+ +
+ Ativar recurso Hyper-V do Windows + + Siga as etapas descritas [aqui](https://winaero.com/enable-use-hyper-v-windows-10/) até ativar o grupo Hyper-V + + :information_source: Se você estiver executando o Windows 10 **Home edition**, o recurso Hyper-V não estará disponível para o seu sistema operacional. Não bloqueia e você ainda pode continuar seguindo as instruções abaixo :ok_hand: +
+ +
diff --git a/_partials/pt/yarn.md b/_partials/pt/yarn.md new file mode 100644 index 00000000..ce79f2f5 --- /dev/null +++ b/_partials/pt/yarn.md @@ -0,0 +1,26 @@ +## Yarn + +[`yarn`](https://yarnpkg.com/) é um gerenciador de pacotes para instalar bibliotecas JavaScript. Vamos instalá-lo: + +Em um terminal, execute os seguintes comandos: + +```bash +corepack enable +yarn set version stable +``` + +```bash +exec zsh +``` + +⚠️ Se vires quaisquer mensagens de erro, tenta executar `npm install -g corepack` e, em seguida, volta a executar os comandos acima. + +Em seguida, execute o seguinte comando: + +```bash +yarn -v +``` + +:heavy_check_mark: Se você vir uma versão, você está bem :+1: + +:x: Se não, **entre em contato com um professor** diff --git a/_partials/rbenv.md b/_partials/rbenv.md index 10276e86..f8d5cbb9 100644 --- a/_partials/rbenv.md +++ b/_partials/rbenv.md @@ -14,7 +14,7 @@ rm -rf ~/.rbenv Then in the terminal, run: ```bash -sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev +sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev libyaml-dev ``` ```bash diff --git a/_partials/ruby.md b/_partials/ruby.md index 5148acc3..26206ecd 100644 --- a/_partials/ruby.md +++ b/_partials/ruby.md @@ -29,7 +29,7 @@ Then run: ruby -v ``` -:heavy_check_mark: If you see something starting with `ruby p` then you can proceed :+1: +:heavy_check_mark: If you see something starting with `ruby ` then you can proceed :+1: :x: If not, **ask a teacher** @@ -55,6 +55,12 @@ gem sources -l In the ruby world, we call external libraries `gems`: they are pieces of ruby code that you can download and execute on your computer. Let's install some! +First, we'll update `bundler`, which is what lets us install gems: + +```bash +gem update bundler +``` + In your terminal, copy-paste the following command: ```bash diff --git a/_partials/slack_settings.md b/_partials/slack_settings.md index e8ccc29b..f6c7cd5e 100644 --- a/_partials/slack_settings.md +++ b/_partials/slack_settings.md @@ -10,8 +10,11 @@ The idea is that you'll have Slack open all day, so that you can share useful li To ensure that everything is working fine for video calls, let's test your camera and microphone: - Open the Slack app -- In any channel message bar type `/call --test` and press `Enter` -- Click on the "Start test" green button +- Click your profile picture in the top right. +- Select `Preferences` from the menu. +- Click `Audio & video` in the left-side column. +- Below `Troubleshooting`, click `Run an audio, video and screensharing test`. The test will open in a new window. +- Check that your preferred speaker, microphone and camera devices appear in the drop-down menus, then click `Start test`. ![Check microphone and webcam with Slack](images/slack_call_test.png) diff --git a/_partials/sqlite.md b/_partials/sqlite.md index f4eacf1c..1974309a 100644 --- a/_partials/sqlite.md +++ b/_partials/sqlite.md @@ -5,7 +5,7 @@ In a few weeks, we'll talk about databases and SQL. [SQLite](https://sqlite.org/ In a terminal, execute the following commands: ```bash -sudo apt-get install sqlite3 libsqlite3-dev +sudo apt-get install sqlite3 libsqlite3-dev pkg-config ``` Then run the following command: diff --git a/_partials/ubuntu_settings.md b/_partials/ubuntu_settings.md index d2027869..305c3d4f 100644 --- a/_partials/ubuntu_settings.md +++ b/_partials/ubuntu_settings.md @@ -48,4 +48,3 @@ You must pin: - VS Code - Your Internet browser - Slack -- Zoom diff --git a/_partials/ubuntu_slack.md b/_partials/ubuntu_slack.md index d0bd6e89..9b9fed65 100644 --- a/_partials/ubuntu_slack.md +++ b/_partials/ubuntu_slack.md @@ -1,6 +1,6 @@ ## Slack -[Slack](https://slack.com/) is a communcation platform pretty popular in the tech industry. +[Slack](https://slack.com/) is a communication platform pretty popular in the tech industry. ### Installation diff --git a/_partials/vscode_aifeatures.md b/_partials/vscode_aifeatures.md new file mode 100644 index 00000000..8af297d9 --- /dev/null +++ b/_partials/vscode_aifeatures.md @@ -0,0 +1,17 @@ +### VS Code AI Features + +VS Code includes many powerful **AI features**, which are a great tool once you already know how to code. + +That said, relying on AI too early can hide important concepts and make debugging harder to understand. Once you’re comfortable with the fundamentals, you’ll know when and how to use AI effectively — without letting it do the thinking for you. + +For the start of the bootcamp, we’ll disable these features. At the right point in the course, we’ll reenable them so you can put them to good use. + +In **VS Code**: + +1. Let's open the VS Code "Command **P**alette": type `Ctrl-Shift-P` (Windows / Linux) or `Cmd-Shift-P` (macOS). +1. This will open the Command Palette: a small text box at the top of your screen. Start typing `aifeatures` until you see "Chat: Learn How to Hide AI features". Click on it. + ![The Command Palette at the top of the screen](images/vscode_find_aifeatures.png) +1. This will open the settings, and will show you the option "Disable and hide built-in AI features ...". Tick the checkbox in front of that option. + ![Check the disable option](images/vscode_disable_aifeatures.png) + +Later, if you want **to reenable** the AI features, you can follow the same instructions to untick the checkbox. diff --git a/_partials/vscode_extensions.md b/_partials/vscode_extensions.md index a095e2a2..fa1eae77 100644 --- a/_partials/vscode_extensions.md +++ b/_partials/vscode_extensions.md @@ -8,41 +8,23 @@ Copy-paste the following commands in your terminal: ```bash code --install-extension ms-vscode.sublime-keybindings -``` - -```bash code --install-extension emmanuelbeziat.vscode-great-icons -``` - -```bash code --install-extension github.github-vscode-theme -``` - -```bash code --install-extension MS-vsliveshare.vsliveshare -``` - -```bash -code --install-extension rebornix.ruby -``` - -```bash +code --install-extension shopify.ruby-lsp code --install-extension dbaeumer.vscode-eslint -``` - -```bash code --install-extension Rubymaniac.vscode-paste-and-indent -``` - -```bash code --install-extension alexcvzz.vscode-sqlite +code --install-extension anteprimorac.html-end-tag-labels +code --install-extension rayhanw.erb-helpers ``` Here is a list of the extensions you are installing: + - [Sublime Text Keymap and Settings Importer](https://marketplace.visualstudio.com/items?itemName=ms-vscode.sublime-keybindings) - [VSCode Great Icons](https://marketplace.visualstudio.com/items?itemName=emmanuelbeziat.vscode-great-icons) - [Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare) -- [Ruby](https://marketplace.visualstudio.com/items?itemName=rebornix.Ruby) +- [Ruby](https://marketplace.visualstudio.com/items?itemName=shopify.ruby-lsp) - [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) - [Paste and Indent](https://marketplace.visualstudio.com/items?itemName=Rubymaniac.vscode-paste-and-indent) - [SQLite](https://marketplace.visualstudio.com/items?itemName=alexcvzz.vscode-sqlite) diff --git a/_partials/windows_browser.md b/_partials/windows_browser.md index fc65fb49..da430936 100644 --- a/_partials/windows_browser.md +++ b/_partials/windows_browser.md @@ -13,14 +13,23 @@ To be sure that you can interact with your browser installed on Windows from you ls /mnt/c/Program\ Files\ \(x86\)/Google/Chrome/Application/chrome.exe ``` - If you get an error like `ls: cannot access...` Run the following commands: + Did you get an error like `ls: cannot access...`? + +
+ Yes, I had an error + +Run the following commands: ```bash echo "export BROWSER=\"/mnt/c/Program Files/Google/Chrome/Application/chrome.exe\"" >> ~/.zshrc echo "export GH_BROWSER=\"'/mnt/c/Program Files/Google/Chrome/Application/chrome.exe'\"" >> ~/.zshrc ``` +
+ +
+ No, everything was fine - Else run: + Run the following commands: ```bash echo "export BROWSER=\"/mnt/c/Program Files (x86)/Google/Chrome/Application/chrome.exe\"" >> ~/.zshrc @@ -28,6 +37,10 @@ To be sure that you can interact with your browser installed on Windows from you ```
+--- + + +
Mozilla Firefox as your default browser @@ -37,14 +50,24 @@ To be sure that you can interact with your browser installed on Windows from you ls /mnt/c/Program\ Files\ \(x86\)/Mozilla\ Firefox/firefox.exe ``` - If you get an error like `ls: cannot access...` Run the following commands: + Did you get an error like `ls: cannot access...`? + +
+ Yes, I had an error + + Run the following commands: ```bash echo "export BROWSER=\"/mnt/c/Program Files/Mozilla Firefox/firefox.exe\"" >> ~/.zshrc echo "export GH_BROWSER=\"'/mnt/c/Program Files/Mozilla Firefox/firefox.exe'\"" >> ~/.zshrc ``` - Else run: +
+ +
+ No, everything was fine + + Run the following commands: ```bash echo "export BROWSER=\"/mnt/c/Program Files (x86)/Mozilla Firefox/firefox.exe\"" >> ~/.zshrc @@ -52,15 +75,22 @@ To be sure that you can interact with your browser installed on Windows from you ```
+--- + +
+
Microsoft Edge as your default browser Run the commands: ```bash - echo "export BROWSER='\"/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe\"'" >> ~/.zshrc + echo "export BROWSER=\"/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe\"" >> ~/.zshrc echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'\"" >> ~/.zshrc ``` + +--- +
Restart your terminal. diff --git a/_partials/windows_postgresql.md b/_partials/windows_postgresql.md index ba8f3585..e64ff3bd 100644 --- a/_partials/windows_postgresql.md +++ b/_partials/windows_postgresql.md @@ -18,6 +18,8 @@ sudo /etc/init.d/postgresql start sudo -u postgres psql --command "CREATE ROLE \"`whoami`\" LOGIN createdb superuser;" ``` +_📝 If you get an error saying `could not change directory to "/home/your_name": Permission denied` that is totally fine, and there's no need to worry 💆 If, on the first run, it says `CREATE ROLE` in the end all worked fine._ + You can configure PostgreSQL to autostart, so you don't have to execute `sudo /etc/init.d/postgresql start` each time you open a new terminal: ```bash @@ -34,6 +36,6 @@ echo "sudo /etc/init.d/postgresql start" >> ~/.zshrc Open a new terminal. -:heavy_check_mark: If you see a `* Starting PostgreSQL 14 database server` message, you're good to go :+1: +:heavy_check_mark: If you see a `* Starting postgresql (via systemctl): postgresql.service` OR `* Starting PostgreSQL 14 database server` message, you're good to go :+1: :x: If not, **contact a teacher**. diff --git a/_partials/windows_settings.md b/_partials/windows_settings.md index 2f433ad7..8a3a016b 100644 --- a/_partials/windows_settings.md +++ b/_partials/windows_settings.md @@ -49,4 +49,3 @@ You must pin: - VS Code - Your Internet browser - Slack -- Zoom diff --git a/_partials/windows_slack.md b/_partials/windows_slack.md index 2a8a247b..00c910e2 100644 --- a/_partials/windows_slack.md +++ b/_partials/windows_slack.md @@ -1,6 +1,6 @@ ## Slack -[Slack](https://slack.com/) is a communcation platform pretty popular in the tech industry. +[Slack](https://slack.com/) is a communication platform pretty popular in the tech industry. ### Installation diff --git a/_partials/windows_terminal.md b/_partials/windows_terminal.md index e1af6707..f4d16ae8 100644 --- a/_partials/windows_terminal.md +++ b/_partials/windows_terminal.md @@ -6,7 +6,10 @@ If you are running Windows 11, the Windows Terminal is already installed and you can proceed to the next section :point_down: -If you are running Windows 10, let's install Windows Terminal, a real modern terminal: +If you are running Windows 10, let's install Windows Terminal, a real modern terminal. + +
+Windows 10: Install Windows Terminal - Click on `Start` - Type `Microsoft Store` @@ -31,6 +34,8 @@ If you are running Windows 10, let's install Windows Terminal, a real modern ter Once the installation is finished, the `Install` button becomes a `Launch` button: click on it. +
+ ### Ubuntu as the default terminal Let's make Ubuntu the default terminal of your Windows Terminal application. @@ -47,13 +52,13 @@ It should open the terminal settings: You may see an orange circle rather than a penguin as the logo for Ubuntu. -We have circle in red the part you will change: +We have circled in red the part you need to add: ![Windows Terminal JSON settings file](images/windows_terminal_settings_json.png) -First, let's ask Ubuntu to start directly inside your Ubuntu Home Directory instead of the Windows one: -- Locate the entry with both `"name": "Ubuntu",` and `"hidden": false,` -- Add the following line after it: +First, let's ask Ubuntu to start directly inside your Ubuntu Home Directory instead of the Windows one. + +- Place this line inside the { } block that contains "name": "Ubuntu" (like in the screenshot): ```bash "commandline": "wsl.exe ~", @@ -61,12 +66,13 @@ First, let's ask Ubuntu to start directly inside your Ubuntu Home Directory inst :warning: Do not forget the comma at the end of the line! -Then, let's disable warning for copy-pasting commands between Windows and Ubuntu: -- Locate the line `"defaultProfile": "{2c4de342-...}"` +Then, let's disable warnings for copy-pasting commands between Windows and Ubuntu: + +- Locate the line "defaultProfile": "{2c4de342-...}" - Add the following line after it: ```bash -"multiLinePasteWarning": false, +"warning.multiLinePaste": false, ``` :warning: Do not forget the comma at the end of the line! diff --git a/_partials/windows_ubuntu.md b/_partials/windows_ubuntu.md index 26dcadad..5d5326a2 100644 --- a/_partials/windows_ubuntu.md +++ b/_partials/windows_ubuntu.md @@ -2,13 +2,13 @@ ### Installation -:information_source: The following instructions depend on your version of Windows. Please execute only the instructions corresponding to your version :point_down: +After restarting you computer, you should see a terminal window saying WSL is resuming the Ubuntu installation process. When it's done, Ubuntu will be launched. -#### Windows 11 - -If you are running Windows 11, after restarting you computer, you should see a terminal window saying WSL is resuming the Ubuntu installation process. When it's done, Ubuntu will be launched. +
+Troubleshooting for Windows 10 (only if needed, check with a TA) + -#### Windows 10 +If the Ubuntu installation did not resume, first try it again: launch Powershell or the Command Prompt again and run `wsl --install` again. If you are running Windows 10, let's install Ubuntu throught the Microsoft Store: @@ -34,6 +34,8 @@ If you are running Windows 10, let's install Ubuntu throught the Microsoft Store Once the installation is finished, the `Get` button becomes a `Open` button: click on it. +
+ ### First launch At first launch, you will be asked some information: @@ -47,7 +49,6 @@ At first launch, you will be asked some information: :warning: When you type your password, nothing will show up on the screen, **that's normal**. This is a security feature to mask not only your password as a whole but also its length. Just type your password and when you're done, press `Enter`. -You can close the Ubuntu window now that it is installed on your computer. ### Check the WSL version of Ubuntu @@ -77,7 +78,6 @@ wsl -l -v :heavy_check_mark: After a few seconds, you should get the following message: `The conversion is complete`. :x: If it does not work, we need to be sure that Ubuntu files are not compressed. -
Check for Uncompressed Files @@ -96,4 +96,18 @@ wsl -l -v :x: If the conversion still does not work, please **contact a teacher**.
-You can now close this terminal window. +You can close this terminal now. + + + +### Check your username + +Type this in the Ubuntu terminal: + +```bash +whoami +``` + +It should return the username you chose before. + +:x: It if says `root`, **contact a TA** before continuing! diff --git a/_partials/windows_version.md b/_partials/windows_version.md index e08f0a06..9c08817b 100644 --- a/_partials/windows_version.md +++ b/_partials/windows_version.md @@ -4,6 +4,10 @@ Before we start, we need to check that the version of Windows installed on your ### Windows 10 or Windows 11 +> :warning: **Note on Windows 10 and security** +> +> The Le Wagon bootcamp setup works on Windows 10. That said, we highly recommend to upgrade to Windows 11. Since October 14th, 2025, Microsoft has ended support for Windows 10, which means it will no longer receive security updates, potentially putting your machine at risk. For more details, read [Microsoft's guide](https://support.microsoft.com/en-us/windows/windows-10-support-has-ended-on-october-14-2025-2ca8b313-1946-43d3-b55c-2b95b107f281). In case your machine can't run Windows 11, consider switching to Ubuntu. + To be able to set up your computer, you need to have **Windows 10 or Windows 11** installed. To check your Windows version: @@ -11,62 +15,51 @@ To check your Windows version: - Type `winver` - Press `Enter` -:heavy_check_mark: If the first words of this window are **Windows 10 or Windows 11** you're good to go :+1: - -:x: If not, you cannot proceed with this setup. You have to upgrade to Windows 10 first :point_down: +:heavy_check_mark: If the first words of this window are **Windows 11** you're good to go :+1: -
- Upgrade to Windows 10 +If the first words of this window are **Windows 10**, check the **Version number**: - - Download Windows 10 from [Microsoft](https://www.microsoft.com/software-download/windows10ISO) - - Install it. It should take roughly an hour, but this depends on your computer. - - When the installation is over, execute the commands above :point_up: to check that you now have **Windows 10**. -
+- :heavy_check_mark: If it says at least `2004`, you are good to go :+1: -:information_source: [Windows 11 upgrade is rolling out now](https://www.microsoft.com/en-us/windows/get-windows-11), which means it may or may not be available for your computer just yet. +- :x: If it is below `2004`, you need to run an update. -:warning: **If you have Windows 10 installed, you don't need to upgrade to Windows 11 to proceed with this setup**. +-
+ How to install updates? -### Latest updates + Open Windows Update: + - Press `Windows` + `R` + - Type `ms-settings:windowsupdate` + - Press `Enter` + - Click on `Check updates` -Once you're sure that you're using Windows 10 or 11, you need to install all the latest updates. + :heavy_check_mark: If you see a green check mark and the message "You're up to date", you're good to go :+1: -Open Windows Update: -- Press `Windows` + `R` -- Type `ms-settings:windowsupdate` -- Press `Enter` -- Click on `Check updates` + :warning: If you have a red exclamation mark and the message "Update available", please install them and repeat the process until it says that you are up to date :loop: -:heavy_check_mark: If you see a green check mark and the message "You're up to date", you're good to go :+1: + :x: If you have an error message about Windows not being able to apply updates, please **contact a teacher**. -:warning: If you have a red exclamation mark and the message "Update available", please install them and repeat the process until it says that you are up to date :loop: +
+ Activate Windows Update Service to fix Updates -:x: If you have an error message about Windows not being able to apply updates, please **contact a teacher**. + Some antiviruses and pieces of software deactivate the Update service we need, resulting in the error you see. Let's fix that! + - Press `Windows` + `R` + - Type `services.msc` + - Press `Enter` + - Double Click `Windows Update Service` + - Set its `Startup` to `Automatic` + - Click on `Start` + - Click on `Ok` + Then let's try updates again! +
-
- Activate Windows Update Service to fix Updates + Check the version number again: - Some antiviruses and pieces of software deactivate the Update service we need, resulting in the error you see. Let's fix that! - Press `Windows` + `R` - - Type `services.msc` + - Type `winver` - Press `Enter` - - Double Click `Windows Update Service` - - Set its `Startup` to `Automatic` - - Click on `Start` - - Click on `Ok` - Then let's try updates again! -
- -### Minimum version - -Some of the tools we need to install have been release with the `1903` version **or above** of Windows 10 so we need to make sure you have at least this one. - -- Press `Windows` + `R` -- Type `winver` -- Press `Enter` -Check the **Version number**: + :heavy_check_mark: If it says at least `2004`, you are good to go :+1: -:heavy_check_mark: If it says at least `1903`, you are good to go :+1: + :x: If it is below `2004`, **contact a TA**. -:x: If it is below `1903`, please **contact a teacher**. +
diff --git a/_partials/windows_vscode.md b/_partials/windows_vscode.md index a2d1077a..68d15efa 100644 --- a/_partials/windows_vscode.md +++ b/_partials/windows_vscode.md @@ -31,7 +31,7 @@ Then open VS Code from your terminal: code . ``` -:heavy_check_mark: If you see `WSL: Ubuntu` in a green box in the bottom left corner of the VS Code window, you're good to go :+1: +:heavy_check_mark: If you see `WSL: Ubuntu` in the bottom left corner of the VS Code window, you're good to go :+1: ![WSL Ubuntu Remote](images/windows_remote_wsl.png) diff --git a/_partials/windows_wsl.md b/_partials/windows_wsl.md index ca753f73..19982978 100644 --- a/_partials/windows_wsl.md +++ b/_partials/windows_wsl.md @@ -2,21 +2,17 @@ WSL is the development environment we are using to run Ubuntu. You can learn more about WSL [here](https://docs.microsoft.com/en-us/windows/wsl/faq). -:information_source: The following instructions depend on your version of Windows. Please execute only the instructions corresponding to your version :point_down: +We will install WSL 2 and Ubuntu in one command through the Windows Command Prompt. -### Windows 11 - -If you are running Windows 11, we will install WSL 2 and Ubuntu in one command through the Windows Terminal. - -:warning: In the following instruction, please be aware of the `Ctrl` + `Shift` + `Enter` key stroke to execute **Windows Terminal** with administrator privileges instead of just clicking on `Ok`or pressing `Enter`. +:warning: In the following instruction, please be aware of the `Ctrl` + `Shift` + `Enter` key stroke to execute **Windows Command Prompt** with administrator privileges instead of just clicking on `Ok`or pressing `Enter`. - Press `Windows` + `R` -- Type `wt` +- Type `cmd` - Press **`Ctrl` + `Shift` + `Enter`** :warning: You may have to accept the UAC confirmation about the privilege elevation. -A blue terminal window will appear: +A black terminal window will appear: - Copy the following command (`Ctrl` + `C`) - Paste it into the terminal window (`Ctrl` + `V` or by right-clicking in the window) - Run it by pressing `Enter` @@ -27,13 +23,13 @@ wsl --install :heavy_check_mark: If the command ran without any error, please restart your computer and continue below :+1: -:x: If you encounter an error message (or if you see some text in red in the window), please **contact a teacher** +:x: If you encounter an error message (or if you see some text in red in the window), please **contact a teacher**. -### Windows 10 - -#### Install WSL 1 +
+Troubleshooting for Windows 10 (only if needed, check with a TA) + -If you are running Windows 10, we will first install WSL 1 through the PowerShell Terminal. +#### For Windows 10 < 2004: install WSL 1 first :warning: In the following instruction, please be aware of the `Ctrl` + `Shift` + `Enter` key stroke to execute **Windows PowerShell** with administrator privileges instead of just clicking on `Ok`or pressing `Enter`. @@ -64,7 +60,7 @@ dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /nores :x: If you encounter an error message (or if you see some text in red in the window), please **contact a teacher** -#### Upgrade to WSL 2 +#### For Windows 10 users running WSL 1: Upgrade to WSL 2 If you are running Windows 10, we will then upgrade WSL to version 2. @@ -82,7 +78,7 @@ Once your computer has restarted, we need to download the WSL2 installer. :x: If you encounter the error "This update only applies to machines with the Windows Subsystem for Linux", **right click** on the program and select `uninstall`; you shall be able to install it normally this time. -#### Make WSL 2 the default Windows Subsystem for Linux +#### For Windows 10 users running WSL 1: Make WSL 2 the default Windows Subsystem for Linux If you are running Windows 10, we will set WSL default version to 2. @@ -114,3 +110,5 @@ wsl --set-default-version 2 :information_source: If you are running Windows 10 **Home edition**, Hyper-V feature is not available for your operating system. It's non-blocking and you can still continue to follow the instructions below :ok_hand:
+ + diff --git a/_partials/yarn.md b/_partials/yarn.md index 967556b7..0dadbb92 100644 --- a/_partials/yarn.md +++ b/_partials/yarn.md @@ -5,9 +5,12 @@ In a terminal, run the following commands: ```bash -npm install --global yarn +corepack enable +yarn set version stable ``` +⚠️ If you see any error messages, try running `npm install -g corepack` and then run the commands above again. + ```bash exec zsh ``` diff --git a/_partials/zoom.md b/_partials/zoom.md deleted file mode 100644 index 055ed753..00000000 --- a/_partials/zoom.md +++ /dev/null @@ -1,29 +0,0 @@ -## Zoom - -To be able to interact when we are not in the same physical room, we will be using [Zoom](https://zoom.us/), a video conferencing tool. - -:warning: If you already have Zoom installed, please make sure that the version is at least **5.6**. - -Go to [zoom.us/download](https://zoom.us/download). - -Under **Zoom Client** click the **Download** button. - -Open the file you have just downloaded to install the app. - -Open the Zoom app. - -If you already have a Zoom account, sign in using your credentials. - -If not, click on the **Sign Up Free** link: - -![Sign Up Free to Zoom](images/zoom_sign_up_free.png) - -You will be redirected to Zoom's website to complete a form. - -When it's done, go back to the Zoom app and sign in using your credentials. - -You should then see a screen like this: - -![Zoom Home Screen](images/zoom_home_screen.png) - -You can now close the Zoom app. diff --git a/build.rb b/build.rb index 5e2046a6..74e5ead1 100755 --- a/build.rb +++ b/build.rb @@ -1,20 +1,20 @@ #!/usr/bin/env ruby -wU PLACEHOLDERS = { - 'RUBY_SETUP_VERSION' => "3.1.2", + 'RUBY_SETUP_VERSION' => "3.3.5", 'NVM_VERSION' => "0.39.1", - 'NODE_VERSION' => "16.15.1", - 'GEMS' => "colored faker http pry-byebug rake rails rest-client rspec rubocop-performance sqlite3" + 'NODE_VERSION' => "20.17.0", + 'GEMS' => "colored faker http pry-byebug rake rails:8.1.1 rest-client rspec rubocop-performance sqlite3:2.8.1 activerecord:8.1.1 ruby-lsp" } MACOS = %w[ intro - macos_zoom github macos_command_line_tools macos_homebrew macos_vscode vscode_extensions + vscode_aifeatures vscode_liveshare macos_terminal oh_my_zsh @@ -35,7 +35,6 @@ WINDOWS = %w[ intro - zoom github windows_version windows_virtualization @@ -44,6 +43,7 @@ windows_vscode windows_terminal vscode_extensions + vscode_aifeatures vscode_liveshare cli_tools oh_my_zsh @@ -66,10 +66,10 @@ UBUNTU = %w[ intro - zoom github ubuntu_vscode vscode_extensions + vscode_aifeatures vscode_liveshare cli_tools oh_my_zsh @@ -95,7 +95,7 @@ "ubuntu.md" => UBUNTU } -["", "cn", "es", "fr"].each do |locale| +["", "cn", "es", "fr", "pt"].each do |locale| SETUPS.each do |filename, partials| filename = "#{filename.split(".md").first}.#{locale}.md" unless locale.empty? File.open(filename, "w:utf-8") do |f| diff --git a/check.rb b/check.rb index aa975b23..1a8c87d6 100644 --- a/check.rb +++ b/check.rb @@ -1,7 +1,7 @@ require "io/console" require "json" -REQUIRED_RUBY_VERSION = "3.1.2" +REQUIRED_RUBY_VERSION = "3.3.5" REQUIRED_GIT_VERSION = "2.0" REQUIRED_GEMS = %w[colored faker http pry-byebug rake rails rest-client rspec rubocop-performance sqlite3] MINIMUM_AVATAR_SIZE = 2 * 1024 diff --git a/docs/macos_cheatsheet.md b/docs/macos_cheatsheet.md index 08375713..13690673 100644 --- a/docs/macos_cheatsheet.md +++ b/docs/macos_cheatsheet.md @@ -17,3 +17,16 @@ This should help ```bash git -C $(brew --repository homebrew/core) checkout master ``` + +## Error: Permission denied @ apply2files - /usr/local/lib/docker/cli-plugins + +If you get a Homebrew error `Permission denied @ apply2files` with "docker" in the path that follows, + +run +``` +mkdir -p /Applications/Docker.app/Contents/Resources/cli-plugins +``` +and then rerun `brew cleanup`. + +See ![this page](https://flaviocopes.com/homebrew-fix-permission-denied-apply2files/) for more info + diff --git a/images/macos_dock.png b/images/macos_dock.png index cd8315c2..86ac50d6 100644 Binary files a/images/macos_dock.png and b/images/macos_dock.png differ diff --git a/images/vscode_disable_aifeatures.png b/images/vscode_disable_aifeatures.png new file mode 100644 index 00000000..83e76f7f Binary files /dev/null and b/images/vscode_disable_aifeatures.png differ diff --git a/images/vscode_find_aifeatures.png b/images/vscode_find_aifeatures.png new file mode 100644 index 00000000..e86ab2c4 Binary files /dev/null and b/images/vscode_find_aifeatures.png differ diff --git a/images/windows_terminal_settings_json.png b/images/windows_terminal_settings_json.png index e285bdac..2b076f1c 100644 Binary files a/images/windows_terminal_settings_json.png and b/images/windows_terminal_settings_json.png differ diff --git a/macos.cn.md b/macos.cn.md index e286314c..672867c2 100644 --- a/macos.cn.md +++ b/macos.cn.md @@ -1,45 +1,11 @@ # 电脑设置教程 -以下的教程将会帮助你为接下来在[Le Wagon Web Development course](https://www.lewagon.com/web-development-course/full-time)全栈开发训练营中做好准备： +以下的教程将会帮助你为接下来在[Le Wagon AI Software Development course](https://www.lewagon.com/web-development-course/full-time)全栈开发训练营中做好准备： 请**仔细阅读并按顺序执行指令**。如果你在哪一步卡住了，不用犹豫，可以举手咨询老师:raising_hand: 让我们开始吧 :rocket: -## Zoom - -为了让我们能够线上的交流，我们将会使用[Zoom](https://zoom.us/)，一个视频会议工具。 - -:warning: 如果你已经安装了Zoom，请确保它的版本至少是**5.6**。 - -打开[zoom.us/download](https://zoom.us/download). - -在**Zoom会议客户端（Zoom Client）**下方点击**下载（Download）**按钮。 - -打开你刚刚下载的文件并安装应用程序。 - -打开Zoom。 - -如果你的Mac使用Apple silicon的话, [你必须安装Rosetta](https://support.apple.com/en-us/HT211861)。点击安装（install），然后输入你的用户名和密码来允许安装。 - -![Install Rosetta](https://support.apple.com/library/content/dam/edam/applecare/images/en_US/macos/Big-Sur/macos-big-sur-software-update-rosetta-alert.jpg) - -如果你已经有Zoom账号了，那就用你的账号密码登陆吧。 - -如果没有账号的话，点击**Sign Up Free**链接： - -![Sign Up Free to Zoom](images/zoom_sign_up_free.png) - -接下来，它会跳转到Zoom的网站让你填一个表。 - -完成这个表之后，回到Zoom软件，然后用你的账号密码登陆吧。 - -你应该会看到下面这个界面： - -![Zoom Home Screen](images/zoom_home_screen.png) - -现在你可以关掉Zoom了。 - ## GitHub账户 @@ -49,6 +15,8 @@ ![](images/github_upload_picture.png) +**[启用双因素认证（2FA）](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-text-messages)**。当您尝试登录时，GitHub将向您发送带有代码的短信。这对于安全性很重要，也很快将成为贡献GitHub上的代码的必要条件。 + ## 一个有关在mac上跳出应用程序的小贴士 @@ -163,11 +131,11 @@ code :x: 如果没有成功打开的话，**请联系你的老师** -## VS Code插件 +## VS Code 插件 ### 安装 -现在我们来给VS Code安装一些有用的插件吧。 +现在我们来给 VS Code 安装一些有用的插件吧。 复制粘贴下面的命令到终端： @@ -175,22 +143,45 @@ code code --install-extension ms-vscode.sublime-keybindings code --install-extension emmanuelbeziat.vscode-great-icons code --install-extension MS-vsliveshare.vsliveshare -code --install-extension rebornix.ruby +code --install-extension shopify.ruby-lsp code --install-extension dbaeumer.vscode-eslint code --install-extension Rubymaniac.vscode-paste-and-indent code --install-extension alexcvzz.vscode-sqlite +code --install-extension anteprimorac.html-end-tag-labels +code --install-extension marcoroth.herb-lsp +code --install-extension rayhanw.erb-helpers ``` 你安装的就是下面这些插件： + - [Sublime Text Keymap and Settings Importer](https://marketplace.visualstudio.com/items?itemName=ms-vscode.sublime-keybindings) - [VSCode Great Icons](https://marketplace.visualstudio.com/items?itemName=emmanuelbeziat.vscode-great-icons) - [Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare) -- [Ruby](https://marketplace.visualstudio.com/items?itemName=rebornix.Ruby) +- [Ruby](https://marketplace.visualstudio.com/items?itemName=shopify.ruby-lsp) - [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) - [Paste and Indent](https://marketplace.visualstudio.com/items?itemName=Rubymaniac.vscode-paste-and-indent) - [SQLite](https://marketplace.visualstudio.com/items?itemName=alexcvzz.vscode-sqlite) +### VS Code AI Features + +VS Code includes many powerful **AI features**, which are a great tool once you already know how to code. + +That said, relying on AI too early can hide important concepts and make debugging harder to understand. Once you’re comfortable with the fundamentals, you’ll know when and how to use AI effectively — without letting it do the thinking for you. + +For the start of the bootcamp, we’ll disable these features. At the right point in the course, we’ll reenable them so you can put them to good use. + +In **VS Code**: + +1. Let's open the VS Code "Command **P**alette": type `Ctrl-Shift-P` (Windows / Linux) or `Cmd-Shift-P` (macOS). +1. This will open the Command Palette: a small text box at the top of your screen. Start typing `aifeatures` until you see "Chat: Learn How to Hide AI features". Click on it. + ![The Command Palette at the top of the screen](images/vscode_find_aifeatures.png) +1. This will open the settings, and will show you the option "Disable and hide built-in AI features ...". Tick the checkbox in front of that option. + ![Check the disable option](images/vscode_disable_aifeatures.png) + +Later, if you want **to reenable** the AI features, you can follow the same instructions to untick the checkbox. + + ## macOS Terminal Theme @@ -236,20 +227,18 @@ CLI是[Command-line Interface（命令行界面）](https://baike.baidu.com/item :warning: **不要更改下面指令中的`email`** ```bash -gh auth login -s 'user:email' -w +gh auth login -s 'user:email' -w --git-protocol ssh ``` -gh会问你几个问题： - -`What is your preferred protocol for Git operations?（你要用什么协议来执行Git操作？）` 让箭头`>`停在`SSH`前面，然后敲击回车。SSH使用SSH密钥来登陆用户，而不是用用户名和密码。 +`gh`会问你几个问题： -`Generate a new SSH key to add to your GitHub account?（生成新的SSH密钥，然后添加到Github账号上？）` 敲击回车，让gh帮你生成。 +- `Generate a new SSH key to add to your GitHub account?（生成新的SSH密钥，然后添加到Github账号上？）` 敲击回车，让gh帮你生成。 -如果你以前生成过SSH密钥，那你就会看到这个问题`Upload your SSH public key to your GitHub account?（上传公共密钥到Github账户上上吗？）` 上下移动箭头`>`，让它停在你想选的SSH公钥前面，然后敲击回车。 + 如果你以前生成过SSH密钥，那你就会看到这个问题`Upload your SSH public key to your GitHub account?（上传公共密钥到Github账户上上吗？）` 上下移动箭头`>`，让它停在你想选的SSH公钥前面，然后敲击回车。 -`Enter a passphrase for your new SSH key (Optional)（输入新的SSH密钥的密码（非必填））`. 输入一个密码，然后写下来或者记住它。这是保护你本地私钥的密码。然后敲击回车。 +- `Enter a passphrase for your new SSH key (Optional)（输入新的SSH密钥的密码（非必填））`. 输入一个密码，然后写下来或者记住它。这是保护你本地私钥的密码。然后敲击回车。 -:warning: 当你输入你的密码的时候，屏幕上不会有任何的显示，**这是正常的**。这是一个安全保护的设置，来隐藏你整个密码，包括它的长度。你可以放心的输入你的密码，结束后按下`Enter`就可以了。 +- `Title for your SSH key`。你可以把它留在建议的 "GitHub CLI"，按`Enter`。 然后你会看到下面的文字输出： @@ -331,7 +320,7 @@ cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh :point_up: 这会**提示**填写你的全名（`FirstName LastName`）和你的邮箱。 -:warning: 注意啦，你**需要**填`gh api ...`命令列出的其中一个电子邮箱。不然，Kitt就没办法跟进你的学习进程。 +:warning: 注意啦，你**需要**填`gh api ...`命令列出的其中一个电子邮箱。不然，Kitt就没办法跟进你的学习进程。 你选择的电子邮件将**公开**显示在互联网上。💡 如果您不希望您的电子邮件出现在您可能会贡献的公共存储库中，请选择 `@users.noreply.github.com` 地址。 现在运行下面的命令来**重置**你的终端： @@ -369,7 +358,7 @@ brew uninstall --force rbenv ruby-build ```bash exec zsh -brew install rbenv +brew install rbenv libyaml ``` @@ -382,13 +371,13 @@ brew install rbenv 运行下方这个指令，它会**花费一些时间（5-10分钟）** ```bash -rbenv install 3.1.2 +rbenv install 3.3.5 ``` -当Ruby安装好后，运行下面这个指令来告诉系统使用3.1.2这个版本作为默认版本。 +当Ruby安装好后，运行下面这个指令来告诉系统使用3.3.5这个版本作为默认版本。 ```bash -rbenv global 3.1.2 +rbenv global 3.3.5 ``` 然后**重置**你的终端，然后检查Ruby版本： @@ -398,7 +387,7 @@ exec zsh ruby -v ``` -:heavy_check_mark: 如果你有看到`ruby 3.1.2p`，那么你可以继续下一步+1: +:heavy_check_mark: 如果你有看到`ruby 3.3.5`，那么你可以继续下一步+1: :x: 如果没有的话，**询问一下老师**。 @@ -422,10 +411,16 @@ gem sources -l 在ruby的世界里，我们将外部的库称之为`gems`：他们是一些你可以下载并在你的电脑上运行的ruby代码。让我们一起安装一些! +首先，我们将更新`bundler`，它是用于安装 gem 的工具： + +```bash +gem update bundler +``` + 在你的终端里，复制粘贴下面的指令： ```bash -gem install colored faker http pry-byebug rake rails rest-client rspec rubocop-performance sqlite3 +gem install colored faker http pry-byebug rake rails:8.1.1 rest-client rspec rubocop-performance sqlite3:2.8.1 activerecord:8.1.1 ruby-lsp ``` :heavy_check_mark: 如果你看到 `xx gems installed`，那么一切正常 :+1: @@ -470,7 +465,7 @@ nvm -v 现在，让我们来安装node： ```bash -nvm install 16.15.1 +nvm install 20.17.0 ``` 当这个指令执行结束之后，运行： @@ -479,7 +474,7 @@ nvm install 16.15.1 node -v ``` -如果看到`v16.15.1`，那么你安装成功了:heavy_check_mark: 然后，你就可以运行下面这个命令了： +如果看到`v20.17.0`，那么你安装成功了:heavy_check_mark: 然后，你就可以运行下面这个命令了： ```bash nvm cache clear @@ -493,9 +488,16 @@ nvm cache clear 让我们一起来安装[`yarn`](https://classic.yarnpkg.com/en/docs/install): ```bash -npm install --global yarn +corepack enable +yarn set version stable +``` + +```bash +exec zsh ``` +⚠️ 如果你看到任何错误信息，请尝试运行 `npm install -g corepack` 然后再次运行上面的命令。 + 重启终端并运行： ```bash @@ -535,8 +537,12 @@ sqlite3 -version 运行下方指令： ```bash -brew install postgresql -brew services start postgresql +brew install postgresql@15 libpq +brew link --force libpq +``` + +```bash +brew services start postgresql@15 ``` 当你结束了上方的指令之后，让我们一起来核查一下它是否安装成功了： @@ -548,7 +554,7 @@ psql -d postgres 如果你进入到了一个像下方这个，一个新的输入框的话，那么说明你的PostgreSQL已经安装好啦！ ```bash -psql (14.4) +psql (15.2) Type "help" for help. postgres=# @@ -611,9 +617,12 @@ curl -Ls https://web-dev-challenge-lewagon-image.oss-cn-shanghai.aliyuncs.com/se 之后你可以全天开着Slack，这样你可以在上面分享有用的链接/寻求帮助/决定去那儿吃饭/... 为了确保视频电话可以正常工作，让我们一起测试摄像头和麦克风： -- 打开Slack应用程序 -- 在任意群组的消息编辑框里输入`/call --test`并按下`Enter` -- 按下"Start test"绿色按钮 +- 打开Slack应用程序。 +- 点击右上方的个人照片。 +- 从菜单中选择 `首选项(Preferences)`。 +- 点击左侧栏中的 `音频和视频(Audio & video)`。 +- 在 `故障排除(Troubleshooting)`下面，点击 `运行音频、视频和屏幕共享测试(Run an audio, video and screensharing test)`。该测试将在一个新窗口中打开。 +- 检查你使用的扬声器、麦克风和摄像机设备是否出现在选项中，然后点击 `开始测试(Start test)`。 ![在Slack检查麦克风和摄像头](images/slack_call_test.png) @@ -670,7 +679,6 @@ defaults write com.apple.screencapture location "${HOME}/Desktop" - VS Code - 你的浏览器 - Slack -- Zoom ## 设置完成啦! diff --git a/macos.es.md b/macos.es.md index c87f528d..d09d2c92 100644 --- a/macos.es.md +++ b/macos.es.md @@ -1,47 +1,12 @@ # Instrucciones de la configuración -Aquí abajo encontrarás las instrucciones para la configuración que tu computadora necesita para el [curso de Desarrollo Web de Le Wagon](https://www.lewagon.com/web-development-course/full-time). +Aquí abajo encontrarás las instrucciones para la configuración que tu computadora necesita para el [curso de AI Software Development de Le Wagon](https://www.lewagon.com/web-development-course/full-time). Por favor, **léelas cuidadosamente y ejecuta todos los comandos en el orden indicado**. Si tienes algún problema, no dudes en pedirle ayuda a tu profesor :raising_hand: ¡Comencemos! :rocket: -## Zoom - -Para poder interactuar cuando no estemos en el mismo lugar físico, usaremos [Zoom](https://zoom.us/), una herramienta de videoconferencia. - -:warning: Si ya tienes Zoom instalado, por favor asegúrate de que por lo menos tienes la versión **5.6**. - -Ve a [zoom.us/download](https://zoom.us/download). - -Haz clic en el botón **Download** debajo de **Zoom Client**. - -Abre el archivo que acabas de descargar para instalar la aplicación. - -Abre la aplicación Zoom. - -Si tienes una Mac con Apple silicon, [te pedirán instalar Rosetta](https://support.apple.com/en-us/HT211861). Haz clic en instalar. Luego escribe tu nombre y contraseña para que corra la instalación. - -![Instala Rosetta](https://support.apple.com/library/content/dam/edam/applecare/images/en_US/macos/Big-Sur/macos-big-sur-software-update-rosetta-alert.jpg) - -Si ya tienes una cuenta Zoom, inicia sesión con tus credenciales. - -Si no, haz clic en el enlace **Sign Up Free**, que significa registrarse gratuitamente: - -![Registrarse gratuitamente en Zoom](images/zoom_sign_up_free.png) - -Te redireccionarán a la página de Zoom para que completes un formulario. - -Cuando termines, regresa a la aplicación Zoom e inicia sesión usando tus credenciales. - -Deberías ver una pantalla como la siguiente: - -![Pantalla de inicio de Zoom](images/zoom_home_screen.png) - -Ya puedes cerrar la aplicación Zoom. - - ## Cuenta GitHub ¿Ya tienes una cuenta GitHub? Si no es el caso, [ábrela ya](https://github.com/join). @@ -50,6 +15,8 @@ Ya puedes cerrar la aplicación Zoom. ![Foto GitHub](images/github_picture.png) +:point_right: **[Habilita la Autenticación de Dos Factores (2FA)](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-text-messages)**. GitHub te enviará mensajes de texto con un código cuando intentes iniciar sesión. Esto es importante para la seguridad y también pronto será necesario para contribuir código en GitHub. + ## Cómo cerrar aplicaciones en una Mac correctamente @@ -178,22 +145,44 @@ code --install-extension ms-vscode.sublime-keybindings code --install-extension emmanuelbeziat.vscode-great-icons code --install-extension github.github-vscode-theme code --install-extension MS-vsliveshare.vsliveshare -code --install-extension rebornix.ruby +code --install-extension shopify.ruby-lsp code --install-extension dbaeumer.vscode-eslint code --install-extension Rubymaniac.vscode-paste-and-indent code --install-extension alexcvzz.vscode-sqlite +code --install-extension anteprimorac.html-end-tag-labels +code --install-extension marcoroth.herb-lsp +code --install-extension rayhanw.erb-helpers ``` Aquí está la lista de las extensiones que estás instalando: - [Sublime Text Keymap and Settings Importer](https://marketplace.visualstudio.com/items?itemName=ms-vscode.sublime-keybindings) - [VSCode Great Icons](https://marketplace.visualstudio.com/items?itemName=emmanuelbeziat.vscode-great-icons) - [Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare) -- [Ruby](https://marketplace.visualstudio.com/items?itemName=rebornix.Ruby) +- [Ruby](https://marketplace.visualstudio.com/items?itemName=shopify.ruby-lsp) - [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) - [Paste and Indent](https://marketplace.visualstudio.com/items?itemName=Rubymaniac.vscode-paste-and-indent) - [SQLite](https://marketplace.visualstudio.com/items?itemName=alexcvzz.vscode-sqlite) +### Funciones de IA en VS Code + +VS Code incluye muchas y potentes **funciones de IA**, que son una gran herramienta una vez que ya sabes programar. + +Dicho esto, depender de la IA demasiado pronto puede ocultar conceptos importantes y dificultar la comprensión de la depuración. Una vez que estés cómodo con los fundamentos, sabrás cuándo y cómo usar la IA de forma eficaz —sin dejar que haga el trabajo por ti. + +Para el inicio del bootcamp, desactivaremos estas funciones. Llegado el momento apropiado en el curso, las volveremos a habilitar para que puedas utilizarlas bien. + +En **VS Code**: + +1. Abramos la "Paleta de comandos" de VS Code: escribe `Ctrl-Shift-P` (Windows / Linux) o `Cmd-Shift-P` (macOS). +1. Se abrirá la Paleta de comandos: una pequeña caja de texto en la parte superior de la pantalla. Empieza a escribir `aifeatures` hasta que veas "Chat: Learn How to Hide AI features". Haz clic en ella. + ![The Command Palette at the top of the screen](images/vscode_find_aifeatures.png) +1. Esto abrirá la configuración y te mostrará la opción "Disable and hide built-in AI features ...". Marca la casilla delante de esa opción. + ![Check the disable option](images/vscode_disable_aifeatures.png) + +Más adelante, si quieres **volver a habilitar** las funciones de IA, puedes seguir las mismas instrucciones para desmarcar la casilla. + + ### Configuración de Live Share [Visual Studio Live Share](https://visualstudio.microsoft.com/services/live-share/) es una extensión de VS Code que te permite compartir el código en tu editor de texto para debugging y pair-programming: ¡Instalémoslo! @@ -250,6 +239,8 @@ CLI es una abreviación de [Command-line Interface](https://en.wikipedia.org/wik En esta sección usaremos [GitHub CLI](https://cli.github.com/) para interactuar directamente con GitHub desde la terminal. +Usaremos la GitHub CLI (`gh`) para conectarnos a GitHub utilizando *SSH*, un protocolo para iniciar la sesión utilizando claves SSH en lugar de la famosa pareja nombre de usuario y contraseña. + Ya debería haberse instalado en tu computadora con los comandos que ejecutaste anteriormente. Lo primero que hay que hacer para **iniciar sesión** es copiar y pegar el comando siguiente en tu terminal: @@ -257,20 +248,18 @@ Lo primero que hay que hacer para **iniciar sesión** es copiar y pegar el coman :warning: **NO edites el `email`** ```bash -gh auth login -s 'user:email' -w +gh auth login -s 'user:email' -w --git-protocol ssh ``` -gh le hará algunas preguntas: +`gh` le hará algunas preguntas: -`What is your preferred protocol for Git operations?` Con las flechas, elige `SSH` y presiona `Enter`. SSH es un protocolo para iniciar la sesión utilizando claves SSH en lugar de la famosa pareja nombre de usuario y contraseña. +- `Generate a new SSH key to add to your GitHub account?` Presiona `Enter` para pedirle a gh que genere las claves SSH por ti. -`Generate a new SSH key to add to your GitHub account?` Presiona `Enter` para pedirle a gh que genere las claves SSH por ti. + Si ya tienes claves SSH, verás en su lugar `Upload your SSH public key to your GitHub account?`Con las flechas, selecciona la ruta de tu archivo de clave pública y pulsa `Intro`. -Si ya tienes claves SSH, verás en su lugar `Upload your SSH public key to your GitHub account?`Con las flechas, selecciona la ruta de tu archivo de clave pública y pulsa `Intro`. +- `Enter a passphrase for your new SSH key (Optional)`. Pon algo que quieras y que recuerdes. Es una contraseña para proteger tu private key que está almacenada en tu disco duro. Luego presiona `Enter`. -`Enter a passphrase for your new SSH key (Optional)`. Pon algo que quieras y que recuerdes. Es una contraseña para proteger tu private key que está almacenada en tu disco duro. Luego presiona `Enter`. - -:warning: Cuando escribas tu passphrase, no verás nada en la pantalla. **Esto es normal**. Es una herramienta de seguridad para ocultar tanto el contenido de tu passphrase como su longitud. Simplemente escribe tu passphrase y presiona `Enter` al terminar. +- `Title for your SSH key`. Puede dejarlo en la propuesta "GitHub CLI", presiona `Enter`. Obtendrás el siguiente resultado: @@ -351,7 +340,7 @@ Ejecuta el instalador de `git`: cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh ``` -:point_up: Esto te **pedirá** tu nombre (`FirstName LastName`) y tu email. +:point_up: Esto te **pedirá** tu nombre (`FirstName LastName`) y tu email. Cualquier correo que elijas se mostrará **públicamente** en internet. 💡 Selecciona la dirección `@users.noreply.github.com` si no quieres que tu correo electrónico aparezca en los repositorios públicos a los que puedas contribuir. :warning: **Necesitas** poner uno de los emails que aparecen arriba gracias al comando anterior `gh api ...`. De lo contrario, Kitt no podrá hacerle seguimiento a tu progreso. @@ -390,7 +379,7 @@ exec zsh Luego ejecuta esto: ```bash -brew install rbenv +brew install rbenv libyaml ``` @@ -403,13 +392,13 @@ Ahora estás listo para instalar la última versión de [ruby](https://www.ruby- Corre este comando, **tomará un tiempo (5-10 minutos)** ```bash -rbenv install 3.1.2 +rbenv install 3.3.5 ``` -Cuando la instalación de ruby termine, corre este comando para decirle al sistema que use la versión 3.1.2 por defecto. +Cuando la instalación de ruby termine, corre este comando para decirle al sistema que use la versión 3.3.5 por defecto. ```bash -rbenv global 3.1.2 +rbenv global 3.3.5 ``` **Reinicia** tu terminal y chequea tu versión Ruby: @@ -424,7 +413,7 @@ Luego ejecuta esto: ruby -v ``` -:heavy_check_mark: Si ves algo que comience por `ruby 3.1.2p`, entonces puedes continuar +1: +:heavy_check_mark: Si ves algo que comience por `ruby 3.3.5`, entonces puedes continuar +1: :x: Si no es el caso, **pídele ayuda a un profesor**. @@ -450,10 +439,16 @@ gem sources -l En el universo de ruby, a las librerías externas se les llama `gems`: son pedazos de código ruby que puedes descargar y ejecutar en tu computadora. ¡Instalemos algunas! +Primero, vamos a actualizar `bundler`, que es lo que nos permite instalar gemas: + +```bash +gem update bundler +``` + En tu terminal, copia y pega el siguiente comando: ```bash -gem install colored faker http pry-byebug rake rails rest-client rspec rubocop-performance sqlite3 +gem install colored faker http pry-byebug rake rails:8.1.1 rest-client rspec rubocop-performance sqlite3:2.8.1 activerecord:8.1.1 ruby-lsp ``` :heavy_check_mark: Si obtienes `xx gems installed`, entonces todo está bien :+1: @@ -498,7 +493,7 @@ Deberías ver una versión. Si no, pídele ayuda a tu profesor. Ahora instala node: ```bash -nvm install 16.15.1 +nvm install 20.17.0 ``` Cuando termine la instalación, corre lo siguiente: @@ -507,7 +502,7 @@ Cuando termine la instalación, corre lo siguiente: node -v ``` -Si ves `v16.15.1`, the installation succeeded :heavy_check_mark: entonces ahora puedes ejecutar lo siguiente: +Si ves `v20.17.0`, the installation succeeded :heavy_check_mark: entonces ahora puedes ejecutar lo siguiente: ```bash nvm cache clear @@ -523,10 +518,16 @@ nvm cache clear En una terminal, ejecuta los siguientes comandos: ```bash -npm install --global yarn +corepack enable +yarn set version stable +``` + +```bash exec zsh ``` +⚠️ Si ves algún mensaje de error, intenta ejecutar `npm install -g corepack` y luego vuelve a ejecutar los comandos anteriores. + Luego ejecuta este comando: ```bash @@ -568,8 +569,12 @@ Vamos a instalarlo ahora. Ejecuta los siguientes comandos: ```bash -brew install postgresql -brew services start postgresql +brew install postgresql@15 libpq +brew link --force libpq +``` + +```bash +brew services start postgresql@15 ``` Cuando termines, verifica que funcione: @@ -581,7 +586,7 @@ psql -d postgres Deberías ver un nuevo mensaje como este :point_down: ```bash -psql (14.4) +psql (15.2) Type "help" for help. postgres=# @@ -652,7 +657,11 @@ La idea es tener Slack abierto todo el día para compartir enlaces útiles / ped Para asegurarte de que todo lo relacionado a videollamadas funcione bien, prueba tu cámara y tu micrófono: - Abre la aplicación Slack -- Escribe `/call --test` en la barra de mensaje de cualquier canal y presiona `Enter` +- Haz clic en tu foto de perfil en la esquina superior derecha +- Selecciona "Preferencias" en el menú. +- Haz clic en "Audio y vídeo" en la columna de la izquierda. +- Debajo de "Solución de problemas", haz clic en "Ejecutar una prueba de audio, vídeo y pantalla compartida". La prueba se abrirá en una nueva ventana. +- Comprueba que tus dispositivos preferidos de altavoz, micrófono y cámara aparecen en los menús desplegables y haz clic en "Iniciar prueba" - Haz clic en el botón verde "Start test" ![Chequea el micrófono y la cámara con Slack](images/slack_call_test.png) @@ -668,9 +677,9 @@ Para asegurarte de que todo lo relacionado a videollamadas funcione bien, prueba ### Seguridad -Es imperativo proteger tu sesión con una contraseña. Si todavía no es el caso, ve a ` > System Preferences > Users & Groups` y cambia la contraseña de tu computadora. Luego ve a ` > System Preferences > Security > General`. Configura el sistema para que pida la contraseña cada `5 seconds` después de regresar de la opción suspender y cuando se active el protector de pantalla. +Es imperativo proteger tu sesión con una contraseña. Si todavía no es el caso, ve a ` > System Settings... > Users & Groups` y cambia la contraseña de tu computadora. Luego ve a ` > System Settings... > Lock Screen`. Configura el sistema para que pida la contraseña cada `5 seconds` después de regresar de la opción suspender y cuando se active el protector de pantalla. -También puedes ir a ` > System Preferences > Mission Control` y haz clic en el botón `Hot Corners` abajo a la izquierda. Selecciona la opción donde al hacer clic en la esquina inferior derecha se active el protector de pantalla. De esa manera al dejar tu escritorio podrás bloquear tu pantalla rápidamente poniendo el cursor del ratón en la esquina inferior derecha. En 5 segundos tu Macbook se bloqueará y te pedirá la contraseña para volver a tu sesión. +También puedes ir a ` > System Settings... > Desktop & Dock` y hacer clic en el botón `Hot Corners...` abajo a la izquierda. Selecciona la opción donde al hacer clic en la esquina inferior derecha se active el protector de pantalla. De esa manera al dejar tu escritorio podrás bloquear tu pantalla rápidamente poniendo el cursor del ratón en la esquina inferior derecha. En 5 segundos tu Macbook se bloqueará y te pedirá la contraseña para volver a tu sesión. ### Teclado @@ -678,7 +687,7 @@ A medida que te vayas convirtiendo en programador, entenderás que pierdes tiemp #### Velocidad del teclado -Ve a ` > System Preferences > Keyboard`. Coloca a `Key Repeat` en la posición más rápida (a la derecha) y a `Delay Until Repeat` en la posición más corta (a la derecha). +Ve a ` > System Settings... > Keyboard`. Coloca a `Key repeat rate` en la posición más rápida (a la derecha) y a `Delay until repeat` en la posición más corta (a la derecha). #### macOS para hackers @@ -710,12 +719,11 @@ Ancla lo siguiente: - VS Code - Tu navegador de Internet - Slack -- Zoom ## ¡Fin de la configuración! -Tu computadora está lista para el [curso de Desarrollo Web de Le Wagon](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: +Tu computadora está lista para el [curso de AI Software Development de Le Wagon](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: Disfrútalo, sabemos que te va a ir genial :rocket: diff --git a/macos.fr.md b/macos.fr.md index a95c715c..47e52eb8 100644 --- a/macos.fr.md +++ b/macos.fr.md @@ -1,47 +1,12 @@ # Instructions de configuration -Les instructions ci-dessous vont te permettre de configurer ton ordinateur pour [la formation Développement Web du Wagon](https://www.lewagon.com/web-development-course/full-time). +Les instructions ci-dessous vont te permettre de configurer ton ordinateur pour [la formation AI Software Development du Wagon](https://www.lewagon.com/web-development-course/full-time). **Lis-les attentivement et exécute toutes les commandes dans l’ordre suivant**. En cas de blocage, n’hésite pas à demander au prof :raising_hand: C’est parti :rocket: -## Zoom - -Pour interagir quand on ne sera pas dans la même pièce, on utilisera [Zoom](https://zoom.us), un outil de visioconférence. - -:warning: Si Zoom est déjà installé sur ton ordinateur, vérifie qu’il s’agit au moins de la version **5.6**. - -Va sur [zoom.us/download](https://zoom.us/download). - -Sous **Client Zoom**, clique sur le bouton **Télécharger**. - -Ouvre le fichier que tu viens de télécharger pour installer l’application. - -Ouvre l’application Zoom. - -Si tu as un Mac avec un processeur Apple Silicon, [on te demande d'installer Rosetta](https://support.apple.com/en-us/HT211861). Clique sur installer, puis tape ton nom d'utilisateur et ton mot de passe pour autoriser l'installation. - -![Installer Rosetta](https://support.apple.com/library/content/dam/edam/applecare/images/en_US/macos/Big-Sur/macos-big-sur-software-update-rosetta-alert.jpg) - -Si tu as déjà un compte Zoom, connecte-toi avec tes identifiants. - -Sinon, clique sur le lien **Inscrivez-vous, c’est gratuit** : - -![Inscrivez-vous à Zoom, c’est gratuit](images/zoom_sign_up_free.png) - -Sur le site Web de Zoom, remplis le formulaire. - -Une fois que tu as terminé, retourne sur l’application Zoom et connecte-toi avec tes identifiants. - -Tu devrais voir apparaître un écran ressemblant à ça : - -![Écran d’accueil Zoom](images/zoom_home_screen.png) - -Tu peux fermer l’application Zoom. - - ## Compte GitHub Est-ce que tu as déjà un compte GitHub ? Si ce n’est pas le cas, [inscris-toi maintenant](https://github.com/join). @@ -50,6 +15,8 @@ Est-ce que tu as déjà un compte GitHub ? Si ce n’est pas le cas, [inscris-t ![image de GitHub](images/github_picture.png) +:point_right: **[Activez l'authentification à deux facteurs (2FA)](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-text-messages)**. GitHub vous enverra des messages texte avec un code lorsque vous essayez de vous connecter. C'est important pour la sécurité et cela sera bientôt obligatoire pour contribuer du code sur GitHub. + ## Comment quitter des applications sur un Mac @@ -176,22 +143,44 @@ Copie-colle les commandes suivantes dans le terminal : code --install-extension ms-vscode.sublime-keybindings code --install-extension emmanuelbeziat.vscode-great-icons code --install-extension MS-vsliveshare.vsliveshare -code --install-extension rebornix.ruby +code --install-extension shopify.ruby-lsp code --install-extension dbaeumer.vscode-eslint code --install-extension Rubymaniac.vscode-paste-and-indent code --install-extension alexcvzz.vscode-sqlite +code --install-extension anteprimorac.html-end-tag-labels +code --install-extension marcoroth.herb-lsp +code --install-extension rayhanw.erb-helpers ``` Voici la liste des extensions que tu es en train d'installer : - [Sublime Text Keymap and Settings Importer](https://marketplace.visualstudio.com/items?itemName=ms-vscode.sublime-keybindings) - [VSCode Great Icons](https://marketplace.visualstudio.com/items?itemName=emmanuelbeziat.vscode-great-icons) - [Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare) -- [Ruby](https://marketplace.visualstudio.com/items?itemName=rebornix.Ruby) +- [Ruby](https://marketplace.visualstudio.com/items?itemName=shopify.ruby-lsp) - [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) - [Paste and Indent](https://marketplace.visualstudio.com/items?itemName=Rubymaniac.vscode-paste-and-indent) - [SQLite](https://marketplace.visualstudio.com/items?itemName=alexcvzz.vscode-sqlite) +### Fonctionnalités IA de VS Code + +VS Code inclut de nombreuses **fonctionnalités d'IA** puissantes, qui sont un excellent outil une fois que vous savez déjà coder. + +Cela dit, s'appuyer sur l'IA trop tôt peut masquer des concepts importants et rendre le débogage plus difficile à comprendre. Une fois à l'aise avec les fondamentaux, vous saurez quand et comment utiliser l'IA efficacement — sans lui laisser faire la réflexion à votre place. + +Pour le début du bootcamp, nous allons désactiver ces fonctionnalités. Au bon moment du cours, nous les réactiverons afin que vous puissiez les utiliser à bon escient. + +Dans **VS Code** : + +1. Ouvrez la "Palette de commandes" de VS Code : tapez `Ctrl-Shift-P` (Windows / Linux) ou `Cmd-Shift-P` (macOS). +1. La Palette de commandes s'ouvrira : une petite zone de texte en haut de l'écran. Commencez à taper `aifeatures` jusqu'à voir "Chat: Learn How to Hide AI features". Cliquez dessus. + ![La palette de commandes en haut de l'écran](images/vscode_find_aifeatures.png) +1. Cela ouvrira les paramètres et affichera l'option "Disable and hide built-in AI features ...". Cochez la case devant cette option. + ![Cochez l'option de désactivation](images/vscode_disable_aifeatures.png) + +Plus tard, si vous souhaitez **réactiver** les fonctionnalités d'IA, vous pouvez suivre les mêmes instructions pour décocher la case. + + ### Configuration de Live Share [Visual Studio Live Share](https://visualstudio.microsoft.com/services/live-share/) est une extension de VS Code, qui te permet de partager du code dans ton éditeur de texte pour débugger et faire de la programmation en binôme. Configurons-le ! @@ -246,6 +235,8 @@ CLI est l’acronyme de [Command-line Interface](https://en.wikipedia.org/wiki/C Dans cette section, tu vas installer [GitHub CLI](https://cli.github.com/) pour interagir avec GitHub directement depuis le terminal. +Nous allons utiliser GitHub CLI (`gh`) pour nous connecter à GitHub en utilisant *SSH*, un protocole pour s'authentifier en utilisant des clés SSH au lieu de la fameuse paire nom d'utilisateur et mot de passe. + Elle doit déjà être installée sur ton ordinateur grâce aux commandes précédentes. Pour **te connecter**, commence par copier-coller la commande suivante dans ton terminal : @@ -253,20 +244,18 @@ Pour **te connecter**, commence par copier-coller la commande suivante dans ton :warning: **NE modifie PAS `email`** ```bash -gh auth login -s 'user:email' -w +gh auth login -s 'user:email' -w --git-protocol ssh ``` -gh va te poser quelques questions : +`gh` va te poser quelques questions : -`What is your preferred protocol for Git operations?` Avec les flèches, choisis `SSH` et appuie sur `Enter`. SSH est un protocole pour s'authentifier en utilisant des clés SSH au lieu de la fameuse paire nom d'utilisateur et mot de passe. +- `Generate a new SSH key to add to your GitHub account?` Appuie sur `Enter` pour demander à gh de générer les clés SSH pour toi. -`Generate a new SSH key to add to your GitHub account?` Appuie sur `Enter` pour demander à gh de générer les clés SSH pour toi. + Si tu as déjà des clés SSH, tu verras à la place `Upload your SSH public key to your GitHub account?` Avec les flèches, sélectionne le chemain de ta clé publique et appuie sur `Enter`. -Si tu as déjà des clés SSH, tu verras à la place `Upload your SSH public key to your GitHub account?` Avec les flèches, sélectionne le chemain de ta clé publique et appuie sur `Enter`. +- `Enter a passphrase for your new SSH key (Optional)`. Saisis un mot de passe dont tu te souviendras. Ce mot de passe sert à protéger ta clé privée enregistrée sur ton disque sur. Ensuite, appuie sur `Enter`. -`Enter a passphrase for your new SSH key (Optional)`. Saisis un mot de passe dont tu te souviendras. Ce mot de passe sert à protéger ta clé privée enregistrée sur ton disque sur. Ensuite, appuie sur `Enter`. - -:warning: Lorsque tu saisiras ton mot de passe, rien ne s’affichera à l’écran ; **c’est normal**. Il s’agit d’une mesure de sécurité permettant de masquer non seulement les caractères de ton mot de passe, mais aussi sa longueur. Saisis simplement ton mot de passe, puis appuie sur `Enter`. +- `Title for your SSH key`. Tu peux laisser ce qui est proposé par défaut, à savoir "GitHub CLI", appuie sur `Enter`. Tu obtiendras le résultat suivant : @@ -349,7 +338,7 @@ cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh :point_up: On te **demandera** de fournir ton nom (`FirstName LastName`) et ton adresse e-mail. -:warning: Tu **dois** saisir l’une des adresses e-mail indiquées ci-dessus avec la commande `gh api ...` précédente. Sinon, Kitt ne pourra pas suivre tes progrès. +:warning: Tu **dois** saisir l’une des adresses e-mail indiquées ci-dessus avec la commande `gh api ...` précédente. Sinon, Kitt ne pourra pas suivre tes progrès. 💡 Sélectionnez l'adresse `@users.noreply.github.com` si vous ne souhaitez pas que votre adresse e-mail apparaisse dans les dépôts publics auxquels vous pourriez contribuer. **Réinitialise** ton terminal en exécutant : @@ -386,7 +375,7 @@ exec zsh Puis exécute ensuite : ```bash -brew install rbenv +brew install rbenv libyaml ``` @@ -399,14 +388,14 @@ Tu peux maintenant installer la dernière version de [ruby](https://www.ruby-lan Exécute cette commande ; cela **peut prendre un moment (5-10 minutes)** ```bash -rbenv install 3.1.2 +rbenv install 3.3.5 ``` Une fois que l’installation de Ruby est terminée, exécute cette commande pour indiquer au système -d’utiliser la version 3.1.2 par défaut. +d’utiliser la version 3.3.5 par défaut. ```bash -rbenv global 3.1.2 +rbenv global 3.3.5 ``` **Réinitialise** ton ton terminal et vérifie ta version de Ruby : @@ -421,7 +410,7 @@ Puis exécute : ruby -v ``` -:heavy_check_mark: Si tu vois apparaître un message commençant par `ruby 3.1.2p`, tu peux continuer :+1: +:heavy_check_mark: Si tu vois apparaître un message commençant par `ruby 3.3.5`, tu peux continuer :+1: :x: Sinon, **demande au prof** @@ -447,10 +436,16 @@ gem sources -l Dans l’environnement ruby, les bibliothèques externes sont appelées des `gems` : ce sont des bouts de code ruby, que tu peux télécharger et exécuter sur ton ordinateur. On va en installer quelques-unes. +Tout d'abord, nous allons mettre à jour `bundler`, ce qui nous permet d'installer des gemmes : + +```bash +gem update bundler +``` + Copie-colle la commande suivante dans ton terminal : ```bash -gem install colored faker http pry-byebug rake rails rest-client rspec rubocop-performance sqlite3 +gem install colored faker http pry-byebug rake rails:8.1.1 rest-client rspec rubocop-performance sqlite3:2.8.1 activerecord:8.1.1 ruby-lsp ``` :heavy_check_mark: Si tu vois apparaître `xx gems installed`, c’est bon :+1: @@ -495,7 +490,7 @@ Tu devrais voir apparaître une version. Sinon, demande au prof. On va maintenant installer node : ```bash -nvm install 16.15.1 +nvm install 20.17.0 ``` Une fois l’installation terminée, exécute : @@ -504,7 +499,7 @@ Une fois l’installation terminée, exécute : node -v ``` -Si tu vois apparaître `v16.15.1`, l'installation a réussi :heavy_check_mark: Tu peux alors exécuter : +Si tu vois apparaître `v20.17.0`, l'installation a réussi :heavy_check_mark: Tu peux alors exécuter : ```bash nvm cache clear @@ -520,10 +515,16 @@ nvm cache clear Exécute les commandes suivantes dans le terminal : ```bash -npm install --global yarn +corepack enable +yarn set version stable +``` + +```bash exec zsh ``` +⚠️ Si tu rencontres des messages d'erreur, essaye d'exécuter `npm install -g corepack` puis exécute à nouveau les commandes ci-dessus. + Puis exécute la commande suivante : ```bash @@ -562,14 +563,18 @@ Parfois, SQLite n'est pas suffisant et nous aurons besoin d'un outil plus avanc Installons-le maintenant. -Exécute les commandes suivantes : +Exécute les commandes suivantes : + +```bash +brew install postgresql@15 libpq +brew link --force libpq +``` ```bash -brew install postgresql -brew services start postgresql +brew services start postgresql@15 ``` -Une fois que c’est fait, on va vérifier que tout a bien fonctionné : +Une fois que c’est fait, on va vérifier que tout a bien fonctionné : ```bash psql -d postgres @@ -578,7 +583,7 @@ psql -d postgres Tu devrais voir apparaître un nouveau message comme celui-ci :point_down: ```bash -psql (14.4) +psql (15.2) Type "help" for help. postgres=# @@ -649,8 +654,11 @@ L’idée est de laisser Slack ouvert toute la journée pour partager des liens On va vérifier que tout fonctionne correctement ; pour cela, on va tester ta caméra et ton microphone : - Ouvre l’application Slack -- Dans la barre de message de n’importe quel channel, saisis `/call --test` et appuie sur `Enter` -- Clique sur le bouton vert « Démarrer le test » +- Clique sur ta photo de profil en haut à droite +- Clique sur `Preferences` depuis le menu +- Séléctionne `Audio & video` dans la colonne de gauche +- En dessous de `Troubleshooting`, clique sur `Run an audio, video and screensharing test`. Le test va s’ouvrir dans une nouvelle fenêtre +- Vérifie que ton microphone, caméra, et enceintes soient bien séléctionnés, puis clique sur `Start test` ![Vérifier le fonctionnement du microphone et de la webcam avec Slack](images/slack_call_test.png) @@ -665,9 +673,9 @@ Tu peux également installer l’application Slack sur ton téléphone et te con ### Sécurité -Tu dois obligatoirement protéger ta session avec un mot de passe. Si ce n’est pas déjà le cas, va dans ` > Préférences système > Utilisateurs & groupes` et modifie le mot de passe de ton compte. Va aussi dans ` > Préférences système > Sécurité > Général` et configure la sécurité de façon à ce que ton mot de passe te soit demandé `5 secondes` après la mise en veille ou le démarrage de l’économiseur d’écran. +Tu dois obligatoirement protéger ta session avec un mot de passe. Si ce n’est pas déjà le cas, va dans ` > Réglages Système > Utilisateurs & groupes` et modifie le mot de passe de ton compte. Va aussi dans ` > Réglages Système > Sécurité > Général` et configure la sécurité de façon à ce que ton mot de passe te soit demandé `5 secondes` après la mise en veille ou le démarrage de l’économiseur d’écran. -Tu peux également aller dans ` > Préférences système > Mission Control` et cliquer sur le bouton `Hot Corners` en bas à gauche. Choisis le coin inférieur droit pour démarrer l’économiseur d’écran. De cette façon, lorsque tu quitteras ton bureau, tu pourras rapidement verrouiller ton écran en plaçant ta souris dans le coin inférieur droit. Cinq secondes plus tard, ton Mac sera verrouillé et tu devras fournir ton mot de passe pour accéder à ta session. +Tu peux également aller dans ` > Réglages Système > Bureau et Dock` et cliquer sur le bouton `coins actifs (Hot Corners)` en bas à gauche. Choisis le coin inférieur droit pour démarrer l’économiseur d’écran. De cette façon, lorsque tu quitteras ton bureau, tu pourras rapidement verrouiller ton écran en plaçant ta souris dans le coin inférieur droit. Cinq secondes plus tard, ton Mac sera verrouillé et tu devras fournir ton mot de passe pour accéder à ta session. ### Clavier @@ -675,7 +683,7 @@ Au fur et à mesure de ta formation de programmeur, tu comprendras que quitter l #### Vitesse du clavier -Va dans ` > Préférences système > Clavier`. Définis `Répétition de touches` sur la position la plus rapide (à droite) et `Pause avant répétition` sur la position la plus courte (à droite). +Va dans ` > Réglages Système > Clavier`. Définis `Vitesse de répétition des touches` sur la position la plus rapide (à droite) et `Pause avant répétition` sur la position la plus courte (à droite). #### macOS pour les hackers @@ -707,12 +715,11 @@ Tu dois épingler : - VS Code - ton navigateur Internet - Slack -- Zoom ## La configuration est terminée ! -Ton ordinateur est prêt pour [la formation Développement Web du Wagon](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: +Ton ordinateur est prêt pour [la formation AI Software Development du Wagon](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: Profite du bootcamp, tu vas assurer :rocket: diff --git a/macos.md b/macos.md index ccd52a77..9180f04f 100644 --- a/macos.md +++ b/macos.md @@ -1,6 +1,6 @@ # Setup instructions -You will find below the instructions to set up your computer for [Le Wagon Web Development course](https://www.lewagon.com/web-development-course/full-time). +You will find below the instructions to set up your computer for [Le Wagon AI Software Development course](https://www.lewagon.com/web-development-course/full-time). Please **read them carefully and execute all commands in the following order**. @@ -11,41 +11,6 @@ You can also have a look at [our cheatsheets](https://github.com/lewagon/setup/t Let's start :rocket: -## Zoom - -To be able to interact when we are not in the same physical room, we will be using [Zoom](https://zoom.us/), a video conferencing tool. - -:warning: If you already have Zoom installed, please make sure that the version is at least **5.6**. - -Go to [zoom.us/download](https://zoom.us/download). - -Under **Zoom Client** click the **Download** button. - -Open the file you have just downloaded to install the app. - -Open the Zoom app. - -If you have a Mac with Apple silicon, [you are asked to install Rosetta](https://support.apple.com/en-us/HT211861). Click Install, then enter your user name and password to allow installation to proceed. - -![Install Rosetta](https://support.apple.com/library/content/dam/edam/applecare/images/en_US/macos/Big-Sur/macos-big-sur-software-update-rosetta-alert.jpg) - -If you already have a Zoom account, sign in using your credentials. - -If not, click on the **Sign Up Free** link: - -![Sign Up Free to Zoom](images/zoom_sign_up_free.png) - -You will be redirected to Zoom's website to complete a form. - -When it's done, go back to the Zoom app and sign in using your credentials. - -You should then see a screen like this: - -![Zoom Home Screen](images/zoom_home_screen.png) - -You can now close the Zoom app. - - ## GitHub account Have you signed up to GitHub? If not, [do it right away](https://github.com/join). @@ -54,6 +19,8 @@ Have you signed up to GitHub? If not, [do it right away](https://github.com/join ![GitHub picture](images/github_picture.png) +:point_right: **[Enable Two-Factor Authentication (2FA)](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-text-messages)**. GitHub will send you text messages with a code when you try to log in. This is important for security and also will soon be required in order to contribute code on GitHub. + ## A note about quitting apps on a Mac @@ -197,46 +164,47 @@ Copy-paste the following commands in your terminal: ```bash code --install-extension ms-vscode.sublime-keybindings -``` - -```bash code --install-extension emmanuelbeziat.vscode-great-icons -``` - -```bash code --install-extension github.github-vscode-theme -``` - -```bash code --install-extension MS-vsliveshare.vsliveshare -``` - -```bash -code --install-extension rebornix.ruby -``` - -```bash +code --install-extension shopify.ruby-lsp code --install-extension dbaeumer.vscode-eslint -``` - -```bash code --install-extension Rubymaniac.vscode-paste-and-indent -``` - -```bash code --install-extension alexcvzz.vscode-sqlite +code --install-extension anteprimorac.html-end-tag-labels +code --install-extension rayhanw.erb-helpers ``` Here is a list of the extensions you are installing: + - [Sublime Text Keymap and Settings Importer](https://marketplace.visualstudio.com/items?itemName=ms-vscode.sublime-keybindings) - [VSCode Great Icons](https://marketplace.visualstudio.com/items?itemName=emmanuelbeziat.vscode-great-icons) - [Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare) -- [Ruby](https://marketplace.visualstudio.com/items?itemName=rebornix.Ruby) +- [Ruby](https://marketplace.visualstudio.com/items?itemName=shopify.ruby-lsp) - [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) - [Paste and Indent](https://marketplace.visualstudio.com/items?itemName=Rubymaniac.vscode-paste-and-indent) - [SQLite](https://marketplace.visualstudio.com/items?itemName=alexcvzz.vscode-sqlite) +### VS Code AI Features + +VS Code includes many powerful **AI features**, which are a great tool once you already know how to code. + +That said, relying on AI too early can hide important concepts and make debugging harder to understand. Once you’re comfortable with the fundamentals, you’ll know when and how to use AI effectively — without letting it do the thinking for you. + +For the start of the bootcamp, we’ll disable these features. At the right point in the course, we’ll reenable them so you can put them to good use. + +In **VS Code**: + +1. Let's open the VS Code "Command **P**alette": type `Ctrl-Shift-P` (Windows / Linux) or `Cmd-Shift-P` (macOS). +1. This will open the Command Palette: a small text box at the top of your screen. Start typing `aifeatures` until you see "Chat: Learn How to Hide AI features". Click on it. + ![The Command Palette at the top of the screen](images/vscode_find_aifeatures.png) +1. This will open the settings, and will show you the option "Disable and hide built-in AI features ...". Tick the checkbox in front of that option. + ![Check the disable option](images/vscode_disable_aifeatures.png) + +Later, if you want **to reenable** the AI features, you can follow the same instructions to untick the checkbox. + + ### Live Share configuration [Visual Studio Live Share](https://visualstudio.microsoft.com/services/live-share/) is a VS Code extension which allows you to share the code in your text editor for debugging and pair-programming: let's set it up! @@ -295,25 +263,25 @@ In this section, we will use [GitHub CLI](https://cli.github.com/) to interact w It should already be installed on your computer from the previous commands. +We will use the GitHub CLI (`gh`) to connect to GitHub using *SSH*, a protocol to log in using SSH keys instead of the well known username/password pair. + First in order to **login**, copy-paste the following command in your terminal: :warning: **DO NOT edit the `email`** ```bash -gh auth login -s 'user:email' -w +gh auth login -s 'user:email' -w --git-protocol ssh ``` -gh will ask you few questions: - -`What is your preferred protocol for Git operations?` With the arrows, choose `SSH` and press `Enter`. SSH is a protocol to log in using SSH keys instead of the well known username/password pair. +`gh` will ask you few questions: -`Generate a new SSH key to add to your GitHub account?` Press `Enter` to ask gh to generate the SSH keys for you. +- `Generate a new SSH key to add to your GitHub account?` Press `Enter` to ask gh to generate the SSH keys for you. -If you already have SSH keys, you will see instead `Upload your SSH public key to your GitHub account?` With the arrows, select your public key file path and press `Enter`. + If you already have SSH keys, you will see instead `Upload your SSH public key to your GitHub account?` With the arrows, select your public key file path and press `Enter`. -`Enter a passphrase for your new SSH key (Optional)`. Type something you want and that you'll remember. It's a password to protect your private key stored on your hard drive. Then press `Enter`. +- `Enter a passphrase for your new SSH key (Optional)`. Type something you want and that you'll remember. It's a password to protect your private key stored on your hard drive. Then press `Enter`. -:warning: When you type your passphrase, nothing will show up on the screen, **that's normal**. This is a security feature to mask not only your passphrase as a whole but also its length. Just type your passphrase and when you're done, press `Enter`. +- `Title for your SSH key`. You can leave it at the proposed "GitHub CLI", press `Enter`. You will then get the following output: @@ -408,7 +376,8 @@ cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh :point_up: This will **prompt** you for your name (`FirstName LastName`) and your email. -:warning: You **need** to put one of the email listed above thanks to the previous `gh api ...` command. If you don't do that, Kitt won't be able to track your progress. +:warning: You **need** to put one of the emails listed above thanks to the previous `gh api ...` command. If you don't do that, Kitt won't be able to track your progress. 💡 Select the `@users.noreply.github.com` address if you don't want your email to appear in public repositories you may contribute to. + Please now **reset** your terminal by running: @@ -448,7 +417,7 @@ exec zsh Then run: ```bash -brew install rbenv +brew install rbenv libyaml ``` @@ -461,14 +430,14 @@ Now, you are ready to install the latest [ruby](https://www.ruby-lang.org/en/) v Run this command, it will **take a while (5-10 minutes)** ```bash -rbenv install 3.1.2 +rbenv install 3.3.5 ``` Once the ruby installation is done, run this command to tell the system -to use the 3.1.2 version by default. +to use the 3.3.5 version by default. ```bash -rbenv global 3.1.2 +rbenv global 3.3.5 ``` **Reset** your terminal and check your Ruby version: @@ -483,7 +452,7 @@ Then run: ruby -v ``` -:heavy_check_mark: If you see something starting with `ruby 3.1.2p` then you can proceed :+1: +:heavy_check_mark: If you see something starting with `ruby 3.3.5` then you can proceed :+1: :x: If not, **ask a teacher** @@ -509,10 +478,16 @@ gem sources -l In the ruby world, we call external libraries `gems`: they are pieces of ruby code that you can download and execute on your computer. Let's install some! +First, we'll update `bundler`, which is what lets us install gems: + +```bash +gem update bundler +``` + In your terminal, copy-paste the following command: ```bash -gem install colored faker http pry-byebug rake rails rest-client rspec rubocop-performance sqlite3 +gem install colored faker http pry-byebug rake rails:8.1.1 rest-client rspec rubocop-performance sqlite3:2.8.1 activerecord:8.1.1 ruby-lsp ``` :heavy_check_mark: If you get `xx gems installed`, then all good :+1: @@ -560,7 +535,7 @@ You should see a version. If not, ask a teacher. Now let's install node: ```bash -nvm install 16.15.1 +nvm install 20.17.0 ``` When the installation is finished, run: @@ -569,7 +544,7 @@ When the installation is finished, run: node -v ``` -If you see `v16.15.1`, the installation succeeded :heavy_check_mark: You can then run: +If you see `v20.17.0`, the installation succeeded :heavy_check_mark: You can then run: ```bash nvm cache clear @@ -585,9 +560,12 @@ nvm cache clear In a terminal, run the following commands: ```bash -npm install --global yarn +corepack enable +yarn set version stable ``` +⚠️ If you see any error messages, try running `npm install -g corepack` and then run the commands above again. + ```bash exec zsh ``` @@ -633,11 +611,12 @@ Let's install it now. Run the following commands: ```bash -brew install postgresql +brew install postgresql@15 libpq +brew link --force libpq ``` ```bash -brew services start postgresql +brew services start postgresql@15 ``` Once you've done that, let's check that it worked: @@ -649,7 +628,7 @@ psql -d postgres You should you see a new prompt like this one :point_down: ```bash -psql (14.4) +psql (15.2) Type "help" for help. postgres=# @@ -684,23 +663,17 @@ curl -Ls https://raw.githubusercontent.com/lewagon/setup/master/check.rb > _.rb ## Kitt -:warning: If you have received an email from Le Wagon inviting you to sign up on Kitt (our learning platform), you can safely skip this step. Instead, please follow the instructions in the email you received if you haven't done so already. - -If you are unsure about what to do, you can follow [this link](https://kitt.lewagon.com/). If you are already logged in, you can safely skip this section. If you are not logged in, click on `Enter Kitt as a Student`. If you manage to login, you can safely skip this step. Otherwise ask a teacher whether you should have received an email or follow the instructions below. - -Register as a Wagon alumni by going to [kitt.lewagon.com/onboarding](http://kitt.lewagon.com/onboarding). Select your batch, sign in with GitHub and enter all your information. - -Your teacher will then validate that you are indeed part of the batch. You can ask them to do it as soon as you completed the registration form. - -Once the teacher has approved your profile, go to your email inbox. You should have 2 emails: +You should have received an email from Le Wagon inviting you to sign up on [Kitt](https://kitt.lewagon.com) (our learning platform). When submitting your onboarding form on Kitt, you should have received two additional invitations: - One from Slack, inviting you to the Le Wagon Alumni slack community (where you'll chat with your buddies and all the previous alumni). Click on **Join** and fill the information. - One from GitHub, inviting you to `lewagon` team. **Accept it** otherwise you won't be able to access the lecture slides. +If you haven't, please contact your teaching team. + ## Slack -[Slack](https://slack.com/) is a communcation platform pretty popular in the tech industry. +[Slack](https://slack.com/) is a communication platform pretty popular in the tech industry. ### Installation @@ -721,8 +694,11 @@ The idea is that you'll have Slack open all day, so that you can share useful li To ensure that everything is working fine for video calls, let's test your camera and microphone: - Open the Slack app -- In any channel message bar type `/call --test` and press `Enter` -- Click on the "Start test" green button +- Click your profile picture in the top right. +- Select `Preferences` from the menu. +- Click `Audio & video` in the left-side column. +- Below `Troubleshooting`, click `Run an audio, video and screensharing test`. The test will open in a new window. +- Check that your preferred speaker, microphone and camera devices appear in the drop-down menus, then click `Start test`. ![Check microphone and webcam with Slack](images/slack_call_test.png) @@ -737,9 +713,9 @@ You can also install Slack app on your phone and sign in `lewagon-alumni`! ### Security -It is mandatory that you protect your session behind a password.If it is not already the case, go to ` > System Preferences > Users & Groups` and change your account password. You should also go to ` > System Preferences > Security > General`. You should require a password `5 seconds` after sleep or screen saver begins. +It is mandatory that you protect your session behind a password. If it is not already the case, go to ` > System Settings... > Users & Groups` and change your account password. You should also go to ` > System Settings... > Lock Screen`. You should require a password `5 seconds` after screen saver begins or display is turned off. -You can also go to ` > System Preferences > Mission Control` and click on the `Hot Corners` button at the bottom left. Choose for the bottom right corner to start the screen saver. That way, when you leave your desk, you can quickly lock you screen by putting your mouse in the bottom right corner. 5 seconds after, your Macbook will be locked and will ask for a password to get back on the session. +You can also go to ` > System Settings... > Desktop & Dock` and click on the `Hot Corners...` button at the bottom left. Choose for the bottom right corner to start the screen saver. That way, when you leave your desk, you can quickly lock you screen by putting your mouse in the bottom right corner. 5 seconds after, your MacBook will be locked and will ask for a password to get back on the session. ### Keyboard @@ -747,7 +723,7 @@ As you become a programmer, you'll understand that leaving the keyboard takes a #### Keyboard speed -Go to ` > System Preferences > Keyboard`. Set `Key Repeat` to the fastest position (to the right) and `Delay Until Repeat` to the shortest position (to the right). +Go to ` > System Settings... > Keyboard`. Set `Key repeat rate` to the fastest position (to the right) and `Delay until repeat` to the shortest position (also to the right). #### macOS For hackers @@ -779,12 +755,11 @@ You must pin: - VS Code - Your Internet browser - Slack -- Zoom ## Setup completed! -Your computer is now all set for [Le Wagon Web Development course](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: +Your computer is now all set for [Le Wagon AI Software Development course](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: Enjoy the bootcamp, you will nail it :rocket: diff --git a/macos.pt.md b/macos.pt.md new file mode 100644 index 00000000..8f399c5d --- /dev/null +++ b/macos.pt.md @@ -0,0 +1,766 @@ +# Instruções de configuração + +Você encontrará abaixo as instruções para configurar seu computador para o [curso de AI Software Development Le Wagon](https://www.lewagon.com/web-development-course/full-time). + +Por favor **leia-os com atenção e execute todos os comandos na seguinte ordem**. + +Se você tiver dúvidas, não hesite em pedir ajuda a um professor :raising_hand: + +Você também pode dar uma olhada em [nossas cheatsheets](https://github.com/lewagon/setup/tree/master/docs) para soluções e dicas de problemas comuns :heavy_check_mark: + +Vamos começar :rocket: + + +## Conta GitHub + +Você se inscreveu no GitHub? Caso contrário, [faça isso imediatamente](https://github.com/join). + +:point_right: **[Carregue uma imagem](https://github.com/settings/profile)** e coloque seu nome corretamente em sua conta GitHub. Isso é importante porque usaremos um painel interno com seu avatar. Faça isso **agora**, antes de continuar com este guia. + +![Imagem do GitHub](images/github_picture.png) + +:point_right: [Ative a Autenticação em Duas Etapas (2FA)](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-text-messages). O GitHub enviará mensagens de texto com um código quando você tentar fazer login. Isso é importante para a segurança e em breve será necessário para contribuir com código no GitHub. + + +## Uma observação sobre como encerrar aplicativos em um Mac + +Clicar na pequena cruz vermelha no canto superior esquerdo da janela do aplicativo em um Mac **não o encerra**, apenas fecha uma janela ativa. Para sair do aplicativo _de verdade_ pressione `Cmd + Q` quando o aplicativo estiver ativo ou navegue até `APP_NAME` -> `Quit` na barra de menu. + +![Sair do Terminal no macOS](images/macos_quit.png) + +Durante esta configuração, você será solicitado a **sair e reabrir** os aplicativos várias vezes. Certifique-se de fazer isso corretamente :pray: + +## Ferramentas de linha de comando + +Abra um novo terminal, copie e cole o seguinte comando e pressione `Enter`: + +```bash +xcode-select --install +``` + +Se você receber a mensagem a seguir, basta pular esta etapa e ir para a próxima. + +```bash +# ferramentas de linha de comando já estão instaladas, use "Atualização de Software" para instalar atualizações +``` + +Caso contrário, abrirá uma janela perguntando se deseja instalar algum software: clique em “Instalar” e aguarde. + + +![Instale o xcode-select no macOS](images/macos_xcode_select_install.png) + +:heavy_check_mark: Se você vir a mensagem "O software foi instalado", tudo bem :+1: + +:x: Se o comando `xcode-select --install` falhar, tente novamente: às vezes os servidores Apple ficam sobrecarregados. + +:x: Se você vir a mensagem "O Xcode não está disponível no servidor de atualização de software", será necessário atualizar o catálogo de atualização de software: + +```bash +sudo softwareupdate --clear-catalog +``` + +Feito isso, você pode tentar instalar novamente. + + +## Homebrew + +[Homebrew](http://brew.sh/) é um gerenciador de pacotes: é um software usado para instalar outros softwares a partir da linha de comando. Vamos instalá-lo! + +Abra um terminal e execute: + +```bash +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" +``` + +Isso solicitará sua confirmação (pressione `Enter`) e sua **senha da conta de usuário do macOS** (aquela que você usa para [fazer login](https://support.apple.com/en-gb/HT202860) quando você reinicia seu Macbook). + +:warning: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`. + +:warning: Se você vir este aviso :point_down:, execute os dois comandos na seção `Próximas etapas` para adicionar o Homebrew ao seu PATH: + +![Aviso de instalação do macOS Homebrew](images/macos_homebrew_warning.png) + +```bash +# ⚠️ Execute esses comandos apenas se você viu este aviso ☝ +echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile +eval "$(/opt/homebrew/bin/brew shellenv)" +``` + +Se você já tem o Homebrew, ele lhe dirá, tudo bem, vá em frente. + +Em seguida, instale algum software útil: + +```bash +brew update +``` + +Se você receber um erro `/usr/local deve ser gravável`, basta executar isto: + +```bash +sudo chown -R $USER:admin /usr/local +``` + +```bash +brew update +``` + +Continue executando o seguinte no terminal (você pode copiar/colar todas as linhas de uma vez). + +```bash +brew upgrade git || brew install git +``` + +```bash +brew upgrade gh || brew install gh +``` + +```bash +brew upgrade wget || brew install wget +``` + +```bash +brew upgrade imagemagick || brew install imagemagick +``` + +```bash +brew upgrade jq || brew install jq +``` + +```bash +brew upgrade openssl || brew install openssl +``` + + +## Visual Studio Code + +### Instalação + +Vamos instalar o editor de texto [Visual Studio Code](https://code.visualstudio.com). + +Copie (`Cmd` + `C`) o comando abaixo e cole-o em seu terminal (`Cmd` + `V`): + +```bash +brew install --cask visual-studio-code +``` + +Em seguida, inicie o VS Code executando o seguinte comando em seu terminal: + +```bash +code +``` + +:heavy_check_mark: Se uma janela do VS Code acabou de abrir, você está pronto :+1: + +:x: Caso contrário, por favor **entre em contato com um professor** + + +## Extensões do VS Code + +### Instalação + +Vamos instalar algumas extensões úteis no VS Code. + +Copie e cole os seguintes comandos em seu terminal: + +```bash +code --install-extension ms-vscode.sublime-keybindings +code --install-extension emmanuelbeziat.vscode-great-icons +code --install-extension github.github-vscode-theme +code --install-extension MS-vsliveshare.vsliveshare +code --install-extension shopify.ruby-lsp +code --install-extension dbaeumer.vscode-eslint +code --install-extension Rubymaniac.vscode-paste-and-indent +code --install-extension alexcvzz.vscode-sqlite +code --install-extension anteprimorac.html-end-tag-labels +code --install-extension marcoroth.herb-lsp +code --install-extension rayhanw.erb-helpers +``` + +Aqui está uma lista das extensões que você está instalando: + +- [Sublime Text Keymap and Settings Importer](https://marketplace.visualstudio.com/items?itemName=ms-vscode.sublime-keybindings) +- [VSCode Great Icons](https://marketplace.visualstudio.com/items?itemName=emmanuelbeziat.vscode-great-icons) +- [Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare) +- [Ruby](https://marketplace.visualstudio.com/items?itemName=shopify.ruby-lsp) +- [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) +- [Paste and Indent](https://marketplace.visualstudio.com/items?itemName=Rubymaniac.vscode-paste-and-indent) +- [SQLite](https://marketplace.visualstudio.com/items?itemName=alexcvzz.vscode-sqlite) + + +### Recursos de IA no VS Code + +O VS Code inclui muitos **recursos poderosos de IA**, que são ótimas ferramentas quando você já sabe programar. + +Dito isso, confiar na IA muito cedo pode ocultar conceitos importantes e dificultar o entendimento da depuração. Quando você estiver confortável com os fundamentos, saberá quando e como usar a IA de forma eficaz — sem deixar que ela faça o raciocínio por você. + +Para o início do bootcamp, vamos desativar esses recursos. No momento certo do curso, os reativaremos para que você possa usá-los bem. + +Em **VS Code**: + +1. Vamos abrir a "Paleta de Comandos" do VS Code: digite `Ctrl-Shift-P` (Windows / Linux) ou `Cmd-Shift-P` (macOS). +1. Isso abrirá a Paleta de Comandos: uma pequena caixa de texto no topo da tela. Comece a digitar `aifeatures` até ver "Chat: Learn How to Hide AI features". Clique nela. + ![A Paleta de Comandos no topo da tela](images/vscode_find_aifeatures.png) +1. Isso abrirá as configurações e mostrará a opção "Disable and hide built-in AI features ...". Marque a caixa de seleção à frente dessa opção. + ![Marcar a opção para desativar](images/vscode_disable_aifeatures.png) + +Mais tarde, se quiser **reativar** os recursos de IA, você pode seguir as mesmas instruções para desmarcar a caixa. + + +### Configuração do Live Share + +[Visual Studio Live Share](https://visualstudio.microsoft.com/services/live-share/) é uma extensão do VS Code que permite compartilhar o código em seu editor de texto para depuração e programação em pares: vamos configurá-lo acima! + +Inicie o VS Code em seu terminal digitando `code` e pressionando `Enter`. + +Clique na pequena seta na parte inferior da barra esquerda :point_down: + +![VS Code Live Share](images/vscode_live_share.png) + +- Clique no botão "Compartilhar" e depois em "GitHub (faça login usando a conta GitHub)". +- Um pop-up aparece solicitando que você faça login no GitHub: clique em “Permitir”. +- Você é redirecionado para uma página do GitHub em seu navegador solicitando autorização do Visual Studio Code: clique em "Continuar" e depois em "Autorizar github". +- O VS Code pode exibir pop-ups adicionais: feche-os clicando em "OK". + +É isso, você está pronto para continuar! + + +## Tema do Terminal macOS + +Inicie um terminal, clique em `Terminal > Preferências` e defina o tema "Pro" como perfil padrão. + +![Definir tema Pro para terminal macOS](images/macos_terminal_pro.png) + +Na guia Janela, defina também seu **Tamanho da janela** para Colunas: 200, Linhas: 50 + +**Saia e reinicie** seu terminal: agora ele deve ter um belo fundo preto, mais agradável aos olhos. + + +## Oh-My-Zsh + +Vamos instalar o plugin `zsh` [Oh My Zsh](https://ohmyz.sh/). + +Em um terminal execute o seguinte comando: + +```bash +sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" +``` + +Se for perguntado "Deseja alterar seu shell padrão para zsh?", pressione `Y` + +No final seu terminal deverá ficar assim: + +![Terminal Ubuntu com OhMyZsh](images/oh_my_zsh.png) + +:heavy_check_mark: Se isso acontecer, você pode continuar :+1: + +:x: Caso contrário, por favor **entre em contato com um professor** + + +## CLI do GitHub + +CLI é o acrônimo de [Interface de linha de comando](https://en.wikipedia.org/wiki/Command-line_interface). + +Nesta seção, usaremos [GitHub CLI](https://cli.github.com/) para interagir com o GitHub diretamente do terminal. + +Usaremos o GitHub CLI (`gh`) para conectar ao GitHub usando *SSH*, um protocolo para fazer login usando chaves SSH em vez do conhecido par nome de usuário/senha. + + +Ele já deve estar instalado no seu computador a partir dos comandos anteriores. + +Primeiro, para **fazer login**, copie e cole o seguinte comando em seu terminal: + +:warning: **NÃO edite o `email`** + +```bash +gh auth login -s 'user:email' -w --git-protocol ssh +``` + +`gh` fará algumas perguntas: + +- `Generate a new SSH key to add to your GitHub account?` Pressione `Enter` para pedir ao gh para gerar as chaves SSH para você. + + Se você já possui chaves SSH, verá `Upload your SSH public key to your GitHub account?` Com as setas, selecione o caminho do arquivo de sua chave pública e pressione `Enter`. + +- `Enter a passphrase for your new SSH key (Optional)`. Digite algo que você deseja e que você lembrará. É uma senha para proteger sua chave privada armazenada no disco rígido. Em seguida, pressione `Enter`. + +- `Title for your SSH key`. Você pode deixá-lo no "GitHub CLI" proposto, pressione `Enter`. + +Você obterá então a seguinte saída: + +```bash +! First copy your one-time code: 0EF9-D015 +- Press Enter to open github.com in your browser... +``` + +Selecione e copie o código (`0EF9-D015` no exemplo) e pressione `Enter`. + +Seu navegador será aberto e solicitará que você autorize o GitHub CLI a usar sua conta GitHub. Aceite e espere um pouco. + +Volte ao terminal, pressione `Enter` novamente e pronto. + +Para verificar se você está conectado corretamente, digite: + +```bash +gh auth status +``` + +:heavy_check_mark: Se você estiver `Logado no github.com como `, então tudo bem :+1: + +:x: Caso contrário, **entre em contato com um professor**. + + +## Dotfiles (configuração padrão) + +Os hackers adoram refinar e aprimorar sua estrutura e ferramentas. + +Começaremos com uma ótima configuração padrão fornecida pelo Le Wagon: [`lewagon/dotfiles`](https://github.com/lewagon/dotfiles). + +Como sua configuração é pessoal, você precisa de seu próprio repositório para armazená-la. Então você irá fazer o **fork** do repositório Le Wagon. + +Bifurcar significa que você criará um novo repositório em sua própria conta GitHub `$GITHUB_USERNAME/dotfiles`, idêntico ao original do Le Wagon que você poderá modificar à vontade. + +Abra seu terminal e defina uma variável para seu nome de usuário GitHub: + +```bash +export GITHUB_USERNAME=`gh api user | jq -r '.login'` +``` + +```bash +echo $GITHUB_USERNAME +``` + +:heavy_check_mark: Você deverá ver seu nome de usuário do GitHub impresso. + +:x: Se não, **pare aqui** e peça ajuda. Pode haver um problema com a etapa anterior (`gh auth`). + +:warning: Por favor note que esta variável só é definida para o tempo em que seu terminal está aberto. Se você fechá-lo antes ou durante as próximas etapas, será necessário configurá-lo novamente com as duas etapas acima! + + +É hora de fazer um fork do repositório e cloná-lo em seu computador: + +```bash +mkdir -p ~/code/$GITHUB_USERNAME && cd $_ +``` + +```bash +gh repo fork lewagon/dotfiles --clone +``` + +### Instalador do Dotfiles + +Execute o instalador `dotfiles`: + +```bash +cd ~/code/$GITHUB_USERNAME/dotfiles +``` + +```bash +zsh install.sh +``` + +Verifique os e-mails registrados em sua conta GitHub. Você precisará escolher um na próxima etapa: + +```bash +gh api user/emails | jq -r '.[].email' +``` + +:heavy_check_mark: Se você vir a lista de seus e-mails registrados, você pode prosseguir :+1: + +:x: Caso contrário, [reautentique no GitHub](https://github.com/lewagon/setup/blob/master/macos.pt.md#github-cli) antes de executar este comando :point_up: novamente. + +### Instalador git + +Execute o instalador `git`: + +```bash +cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh +``` + +:point_up: Isso **solicitará** seu nome (`Nome Sobrenome`) e seu e-mail. O email que você escolher será exibido **publicamente** na internet. 💡 Selecione o endereço `@users.noreply.github.com` se você não deseja que seu e-mail apareça em repositórios públicos aos quais você possa contribuir. + +:warning: Você **precisa** colocar um dos e-mails listados acima graças ao comando anterior `gh api ...`. Se você não fizer isso, Kitt não conseguirá acompanhar seu progresso. + +Agora **reinicie** seu terminal executando: + +```bash +exec zsh +``` + + +## rbenv + +Vamos instalar o [`rbenv`](https://github.com/sstephenson/rbenv), um software para instalar e gerenciar ambientes `ruby`. + +Primeiro, precisamos limpar qualquer instalação anterior do Ruby que você possa ter: + +```bash +rvm implode && sudo rm -rf ~/.rvm +# If you got "zsh: command not found: rvm", carry on. It means `rvm` is not +# on your computer, that's what we want! + +sudo rm -rf $HOME/.rbenv /usr/local/rbenv /opt/rbenv /usr/local/opt/rbenv +``` + +:warning: Este comando pode solicitar sua senha. + +:warning: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`. + +No terminal, execute: + +```bash +brew uninstall --force rbenv ruby-build +``` + +```bash +exec zsh +``` + +Então rode: + +```bash +brew install rbenv libyaml +``` + + +## Ruby + +### Instalação + +Agora, você está pronto para instalar a versão mais recente do [ruby](https://www.ruby-lang.org/en/) e defini-la como a versão padrão. + +Execute este comando, **demorará um pouco (5 a 10 minutos)** + +```bash +rbenv install 3.3.5 +``` + +Assim que a instalação do Ruby estiver concluída, execute este comando para informar ao sistema +para usar a versão 3.3.5 por padrão. + +```bash +rbenv global 3.3.5 +``` + +**Reinicialize** seu terminal e verifique sua versão do Ruby: + +```bash +exec zsh +``` + +Então corra: + +```bash +ruby -v +``` + +:heavy_check_mark: Se você vir algo começando com `ruby 3.3.5` então você pode prosseguir :+1: + +:x: Se não, **pergunte a um professor** + +### Instalando algumas gems + +
+ Se você estiver na China 🇨🇳 clique aqui + + :warning: Se você estiver na China, você deve atualizar a forma como instalaremos o gem com os seguintes comandos. + +```bash +# Somente China! +fontes de gemas --remove https://rubygems.org/ +fontes de gemas -a https://gems.ruby-china.com/ +fontes de gemas -l +#***FONTES ATUAIS*** +# https://gems.ruby-china.com/ +# Ruby-china.com deve estar na lista agora +``` +
+ +**Todos, na China ou não**, continuem aqui para instalar gems. + +No mundo Ruby, chamamos bibliotecas externas de `gems`: são pedaços de código Ruby que você pode baixar e executar em seu computador. Vamos instalar alguns! + +No seu terminal, copie e cole o seguinte comando: + +```bash +gem install colored faker http pry-byebug rake rails:8.1.1 rest-client rspec rubocop-performance sqlite3:2.8.1 activerecord:8.1.1 ruby-lsp +``` + +:heavy_check_mark: Se você tiver `xx gems installed`, então tudo bem :+1: + +:x: Se você encontrar o seguinte erro: + +```bash +ERROR: While executing gem ... (TypeError) +incompatible marshal file format (can't be read) +format version 4.8 required; 60.33 given +``` + +Execute o seguinte comando: +```bash +rm -rf ~/.gemrc +``` + +Execute novamente o comando para instalar as gemas. + +:warning: **NUNCA** instale uma gem com `sudo gem install`! Mesmo se você encontrar uma resposta do Stackoverflow (ou o terminal) solicitando que você faça isso. + + +## Node.js + +[Node.js](https://nodejs.org/en/) é um tempo de execução JavaScript para executar código JavaScript no terminal. Vamos instalá-lo com [nvm](https://github.com/nvm-sh/nvm), um gerenciador de versões para Node.js. + +Em um terminal, execute os seguintes comandos: + +```bash +curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | zsh +``` + +```bash +exec zsh +``` + +Em seguida, execute o seguinte comando: + +```bash +nvm -v +``` + +Você deverá ver uma versão. Se não, pergunte a um professor. + +Agora vamos instalar o Node.js: + +```bash +nvm install 20.17.0 +``` + +Quando a instalação terminar, execute: + +```bash +node -v +``` + +Se você vir `v20.17.0`, a instalação foi bem-sucedida :heavy_check_mark: Você pode então executar: + +```bash +nvm cache clear +``` + +:x: Caso contrário, **entre em contato com um professor** + + +## Yarn + +[`yarn`](https://yarnpkg.com/) é um gerenciador de pacotes para instalar bibliotecas JavaScript. Vamos instalá-lo: + +Em um terminal, execute os seguintes comandos: + +```bash +corepack enable +yarn set version stable +``` + +```bash +exec zsh +``` + +⚠️ Se vires quaisquer mensagens de erro, tenta executar `npm install -g corepack` e, em seguida, volta a executar os comandos acima. + +Em seguida, execute o seguinte comando: + +```bash +yarn -v +``` + +:heavy_check_mark: Se você vir uma versão, você está bem :+1: + +:x: Se não, **entre em contato com um professor** + + +## SQLite + +Em algumas semanas falaremos sobre bancos de dados e SQL. [SQLite](https://sqlite.org/index.html) é um mecanismo de banco de dados usado para executar consultas SQL em bancos de dados de arquivo único. Vamos instalá-lo: + +Em um terminal, execute os seguintes comandos: + +```bash +brew install sqlite +``` + +Em seguida, execute o seguinte comando: + +```bash +sqlite3 -version +``` + +:heavy_check_mark: Se você vir uma versão, você está bem :+1: + +:x: Se não, **peça um professor** + + +## PostgreSQL + +Às vezes, o SQLite não é suficiente e precisaremos de uma ferramenta mais avançada chamada [PostgreSQL](https://www.postgresql.org/), um sistema de banco de dados de código aberto, robusto e pronto para produção. + +Vamos instalá-lo agora. + +Execute os seguintes comandos: + +```bash +brew install postgresql@15 libpq +brew link --force libpq +``` + +```bash +brew services start postgresql@15 +``` + +Depois de fazer isso, vamos verificar se funcionou: + +```bash +psql -d postgres +``` + +Você deverá ver um novo prompt como este :point_down: + +```bash +psql (15.2) +Type "help" for help. + +postgres=# +``` + +:heavy_check_mark: Se for esse o caso, digite `\q` e depois `Enter` para sair deste prompt. Você está pronto para ir :+1: + +:x: Se não, por favor **entre em contato com um professor** + + +## Checagem + +Vamos verificar se você instalou tudo com sucesso. + +No seu terminal, execute o seguinte comando: + +```bash +exec zsh +``` + +Então corra: + +```bash +curl -Ls https://raw.githubusercontent.com/lewagon/setup/master/check.rb > _.rb && ruby _.rb && rm _.rb || rm _.rb +``` + +:heavy_check_mark: Se você receber uma mensagem verde `Awesome! Your computer is now ready!`, então você está bem :+1: + +:x: Caso contrário, **entre em contato com um professor**. + + +## Kitt + +:warning: Se você recebeu um e-mail do Le Wagon convidando você a se inscrever no Kitt (nossa plataforma de aprendizagem), você pode pular esta etapa com segurança. Em vez disso, siga as instruções no e-mail que você recebeu, caso ainda não tenha feito isso. + +Se não tiver certeza sobre o que fazer, siga [este link](https://kitt.lewagon.com/). Se você já estiver logado, pode pular esta seção com segurança. Se você não estiver logado, clique em `Enter Kitt as a Student`. Se você conseguir fazer login, poderá pular esta etapa com segurança. Caso contrário, pergunte a um professor se você deveria ter recebido um e-mail ou siga as instruções abaixo. + +Registre-se como Alumni da Le Wagon acessando [kitt.lewagon.com/onboarding](http://kitt.lewagon.com/onboarding). Selecione seu batch, faça login no GitHub e insira todas as suas informações. + +Seu professor irá então validar que você realmente faz parte do batch. Você pode pedir que eles façam isso assim que preencher o formulário de registro. + +Assim que o professor aprovar seu perfil, acesse sua caixa de entrada de e-mail. Você deve ter 2 e-mails: + +- Um do Slack, convidando você para a comunidade Le Wagon Alumni do Slack (onde você conversará com seus amigos e todos os ex-alunos anteriores). Clique em **Inscreva-se** e preencha os dados. +- Um do GitHub, convidando você para a equipe `lewagon`. **Aceite** caso contrário você não conseguirá acessar os slides da aula. + + +## Slack + +[Slack](https://slack.com/) é uma plataforma de comunicação bastante popular na indústria de tecnologia. + +### Instalação + +[Baixe o aplicativo Slack](https://itunes.apple.com/us/app/slack/id803453959?mt=12) e instale-o. + +:warning: Se você já usa o Slack em seu navegador, baixe e instale **o aplicativo para desktop** que vem com todos os recursos. + + +### Configurações + +Inicie o aplicativo e faça login na organização `lewagon-alumni`. + +Certifique-se de **fazer upload de uma foto de perfil** :point_down: + +![Como fazer upload de uma foto de perfil no Slack](images/slack_profile_picture.gif) + +A ideia é que você tenha o Slack aberto o dia todo, para que você possa compartilhar links úteis/pedir ajuda/decidir onde ir almoçar/etc. + +Para garantir que tudo está funcionando bem nas videochamadas, vamos testar sua câmera e microfone: +- Abra o aplicativo Slack +- Clique na foto do seu perfil no canto superior direito. +- Selecione `Preferências` no menu. +- Clique em `Áudio e vídeo` na coluna do lado esquerdo. +- Abaixo de `Solução de problemas`, clique em `Executar um teste de áudio, vídeo e compartilhamento de tela`. O teste será aberto em uma nova janela. +- Verifique se seus dispositivos preferidos de alto-falante, microfone e câmera aparecem nos menus suspensos e clique em `Iniciar teste`. + +![Verifique o microfone e a webcam com o Slack](images/slack_call_test.png) + +:heavy_check_mark: Quando o teste terminar, você deverá ver mensagens verdes de "Sucesso" pelo menos para seu microfone e câmera. :+1: + +:x: Caso contrário, **entre em contato com um professor**. + +Você também pode instalar o aplicativo Slack no seu telefone e entrar em `lewagon-alumni`! + + +## Configurações do MacOS + +### Segurança + +É obrigatório que você proteja sua sessão com uma senha. Se ainda não for o caso, vá para ` > Ajustes do Sistema > Usuários e Grupos` e altere a senha da sua conta. Você também deve ir para ` > Ajustes do Sistema > Segurança > Geral`. Você deve exigir uma senha `5 segundos` após o início da suspensão ou da proteção de tela. + +Você também pode ir para ` > Ajustes do Sistema > Controle daVelocidade de repetição de teclaVelocidade de repetição de Escritorio y Dock` e clicar no botão `cantos de acesso rápido (Hot Corners)` no canto inferior esquerdo. Escolha no canto inferior direito para iniciar o protetor de tela. Dessa forma, ao sair da mesa, você pode bloquear rapidamente a tela colocando o mouse no canto inferior direito. 5 segundos depois, seu MacBook estará bloqueado e solicitará uma senha para voltar à sessão. + +### Teclado + +Ao se tornar um programador, você entenderá que deixar o teclado leva muito tempo, então você vai querer minimizar o uso do trackpad ou do mouse. Aqui estão alguns truques no macOS para ajudá-lo a fazer isso. + +#### Velocidade do teclado + +Vá para ` > Preferências do Sistema > Teclado`. Defina `Velocidade de repetição de tecla` para a posição mais rápida (à direita) e `Atraso da repetição` para a posição mais curta (à direita). + +#### macOS Para hackers + +[Leia este script](https://github.com/mathiasbynens/dotfiles/blob/master/.macos) e escolha algumas coisas que você acha que combinam com você. Por exemplo, você pode digitar no terminal este: + +```bash +# Expanding the save panel by default +defaults write NSGlobalDomain NSNavPanelExpandedStateForSaveMode -bool true +defaults write NSGlobalDomain PMPrintingExpandedStateForPrint -bool true +defaults write NSGlobalDomain PMPrintingExpandedStateForPrint2 -bool true + +# Save screenshots to the Desktop (or elsewhere) +defaults write com.apple.screencapture location "${HOME}/Desktop" + +# etc.. +``` + +### Fixe aplicativos no seu dock + +Você usará a maioria dos aplicativos que instalou hoje com muita frequência. Vamos fixá-los no seu dock para que fiquem a apenas um clique de distância! + +Para fixar um aplicativo no seu dock, inicie o aplicativo, clique com o botão direito no ícone na barra de tarefas para abrir o menu de contexto e escolha "Opções" e depois "Manter no Dock". + +![Como fixar um aplicativo na barra de tarefas do macOS](images/macos_dock.png) + +Você deve fixar: +- Seu terminal +- Seu explorador de arquivos +- VS Code +- Seu navegador de Internet +- Slack + + +## Configuração concluída! + +Seu computador agora está pronto para o [curso de AI Software Development Le Wagon](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: + +Aproveite o bootcamp, você vai acertar :rocket: + + diff --git a/ubuntu.cn.md b/ubuntu.cn.md index dbf53c54..3b71ecca 100644 --- a/ubuntu.cn.md +++ b/ubuntu.cn.md @@ -1,41 +1,11 @@ # 电脑设置教程 -以下的教程将会帮助你为接下来在[Le Wagon Web Development course](https://www.lewagon.com/web-development-course/full-time)全栈开发训练营中做好准备： +以下的教程将会帮助你为接下来在[Le Wagon AI Software Development course](https://www.lewagon.com/web-development-course/full-time)全栈开发训练营中做好准备： 请**仔细阅读并按顺序执行指令**。如果你在哪一步卡住了，不用犹豫，可以举手咨询老师:raising_hand: 让我们开始吧 :rocket: -## Zoom - -为了让我们能够线上的交流，我们将会使用[Zoom](https://zoom.us/)，一个视频会议工具。 - -:warning: 如果你已经安装了Zoom，请确保它的版本至少是**5.6**。 - -打开[https://zoom.us/download](https://zoom.us/download)。 - -在**Zoom会议客户端（Zoom Client）**下方点击**下载（Download）**按钮。 - -打开你刚刚下载的文件并安装应用程序。 - -打开Zoom。 - -如果你已经有Zoom账号了，那就用你的账号密码登陆吧。 - -如果没有账号的话，点击**Sign Up Free**链接： - -![Sign Up Free to Zoom](images/zoom_sign_up_free.png) - -接下来，它会跳转到Zoom的网站让你填一个表。 - -完成这个表之后，回到Zoom软件，然后用你的账号密码登陆吧。 - -你应该会看到下面这个界面： - -![Zoom Home Screen](images/zoom_home_screen.png) - -现在你可以关掉Zoom了。 - ## GitHub账户 @@ -45,6 +15,8 @@ ![](images/github_upload_picture.png) +**[启用双因素认证（2FA）](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-text-messages)**。当您尝试登录时，GitHub将向您发送带有代码的短信。这对于安全性很重要，也很快将成为贡献GitHub上的代码的必要条件。 + ## Visual Studio Code @@ -80,11 +52,11 @@ code :x: 如果没有的话，**请向老师求助**。 -## VS Code插件 +## VS Code 插件 ### 安装 -现在我们来给VS Code安装一些有用的插件吧。 +现在我们来给 VS Code 安装一些有用的插件吧。 复制粘贴下面的命令到终端： @@ -92,22 +64,45 @@ code code --install-extension ms-vscode.sublime-keybindings code --install-extension emmanuelbeziat.vscode-great-icons code --install-extension MS-vsliveshare.vsliveshare -code --install-extension rebornix.ruby +code --install-extension shopify.ruby-lsp code --install-extension dbaeumer.vscode-eslint code --install-extension Rubymaniac.vscode-paste-and-indent code --install-extension alexcvzz.vscode-sqlite +code --install-extension anteprimorac.html-end-tag-labels +code --install-extension marcoroth.herb-lsp +code --install-extension rayhanw.erb-helpers ``` 你安装的就是下面这些插件： + - [Sublime Text Keymap and Settings Importer](https://marketplace.visualstudio.com/items?itemName=ms-vscode.sublime-keybindings) - [VSCode Great Icons](https://marketplace.visualstudio.com/items?itemName=emmanuelbeziat.vscode-great-icons) - [Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare) -- [Ruby](https://marketplace.visualstudio.com/items?itemName=rebornix.Ruby) +- [Ruby](https://marketplace.visualstudio.com/items?itemName=shopify.ruby-lsp) - [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) - [Paste and Indent](https://marketplace.visualstudio.com/items?itemName=Rubymaniac.vscode-paste-and-indent) - [SQLite](https://marketplace.visualstudio.com/items?itemName=alexcvzz.vscode-sqlite) +### VS Code AI Features + +VS Code includes many powerful **AI features**, which are a great tool once you already know how to code. + +That said, relying on AI too early can hide important concepts and make debugging harder to understand. Once you’re comfortable with the fundamentals, you’ll know when and how to use AI effectively — without letting it do the thinking for you. + +For the start of the bootcamp, we’ll disable these features. At the right point in the course, we’ll reenable them so you can put them to good use. + +In **VS Code**: + +1. Let's open the VS Code "Command **P**alette": type `Ctrl-Shift-P` (Windows / Linux) or `Cmd-Shift-P` (macOS). +1. This will open the Command Palette: a small text box at the top of your screen. Start typing `aifeatures` until you see "Chat: Learn How to Hide AI features". Click on it. + ![The Command Palette at the top of the screen](images/vscode_find_aifeatures.png) +1. This will open the settings, and will show you the option "Disable and hide built-in AI features ...". Tick the checkbox in front of that option. + ![Check the disable option](images/vscode_disable_aifeatures.png) + +Later, if you want **to reenable** the AI features, you can follow the same instructions to untick the checkbox. + + ## Command line tools @@ -193,20 +188,18 @@ CLI是[Command-line Interface（命令行界面）](https://baike.baidu.com/item :warning: **不要更改下面指令中的`email`** ```bash -gh auth login -s 'user:email' -w +gh auth login -s 'user:email' -w --git-protocol ssh ``` -gh会问你几个问题： +`gh`会问你几个问题： -`What is your preferred protocol for Git operations?（你要用什么协议来执行Git操作？）` 让箭头`>`停在`SSH`前面，然后敲击回车。SSH使用SSH密钥来登陆用户，而不是用用户名和密码。 +- `Generate a new SSH key to add to your GitHub account?（生成新的SSH密钥，然后添加到Github账号上？）` 敲击回车，让gh帮你生成。 -`Generate a new SSH key to add to your GitHub account?（生成新的SSH密钥，然后添加到Github账号上？）` 敲击回车，让gh帮你生成。 + 如果你以前生成过SSH密钥，那你就会看到这个问题`Upload your SSH public key to your GitHub account?（上传公共密钥到Github账户上上吗？）` 上下移动箭头`>`，让它停在你想选的SSH公钥前面，然后敲击回车。 -如果你以前生成过SSH密钥，那你就会看到这个问题`Upload your SSH public key to your GitHub account?（上传公共密钥到Github账户上上吗？）` 上下移动箭头`>`，让它停在你想选的SSH公钥前面，然后敲击回车。 +- `Enter a passphrase for your new SSH key (Optional)（输入新的SSH密钥的密码（非必填））`. 输入一个密码，然后写下来或者记住它。这是保护你本地私钥的密码。然后敲击回车。 -`Enter a passphrase for your new SSH key (Optional)（输入新的SSH密钥的密码（非必填））`. 输入一个密码，然后写下来或者记住它。这是保护你本地私钥的密码。然后敲击回车。 - -:warning: 当你输入你的密码的时候，屏幕上不会有任何的显示，**这是正常的**。这是一个安全保护的设置，来隐藏你整个密码，包括它的长度。你可以放心的输入你的密码，结束后按下`Enter`就可以了。 +- `Title for your SSH key`。你可以把它留在建议的 "GitHub CLI"，按`Enter`。 然后你会看到下面的文字输出： @@ -288,7 +281,7 @@ cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh :point_up: 这会**提示**填写你的全名（`FirstName LastName`）和你的邮箱。 -:warning: 注意啦，你**需要**填`gh api ...`命令列出的其中一个电子邮箱。不然，Kitt就没办法跟进你的学习进程。 +:warning: 注意啦，你**需要**填`gh api ...`命令列出的其中一个电子邮箱。不然，Kitt就没办法跟进你的学习进程。 你选择的电子邮件将**公开**显示在互联网上。💡 如果您不希望您的电子邮件出现在您可能会贡献的公共存储库中，请选择 `@users.noreply.github.com` 地址。 现在运行下面的命令来**重置**你的终端： @@ -336,7 +329,7 @@ rm -rf ~/.rbenv 然后在终端里运行: ```bash -sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev +sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev libyaml-dev ``` ```bash @@ -358,13 +351,13 @@ exec zsh 运行下方这个指令，它会**花费一些时间（5-10分钟）** ```bash -rbenv install 3.1.2 +rbenv install 3.3.5 ``` -当Ruby安装好后，运行下面这个指令来告诉系统使用3.1.2这个版本作为默认版本。 +当Ruby安装好后，运行下面这个指令来告诉系统使用3.3.5这个版本作为默认版本。 ```bash -rbenv global 3.1.2 +rbenv global 3.3.5 ``` 然后**重置**你的终端，然后检查Ruby版本： @@ -374,7 +367,7 @@ exec zsh ruby -v ``` -:heavy_check_mark: 如果你有看到`ruby 3.1.2p`，那么你可以继续下一步+1: +:heavy_check_mark: 如果你有看到`ruby 3.3.5`，那么你可以继续下一步+1: :x: 如果没有的话，**询问一下老师**。 @@ -398,10 +391,16 @@ gem sources -l 在ruby的世界里，我们将外部的库称之为`gems`：他们是一些你可以下载并在你的电脑上运行的ruby代码。让我们一起安装一些! +首先，我们将更新`bundler`，它是用于安装 gem 的工具： + +```bash +gem update bundler +``` + 在你的终端里，复制粘贴下面的指令： ```bash -gem install colored faker http pry-byebug rake rails rest-client rspec rubocop-performance sqlite3 +gem install colored faker http pry-byebug rake rails:8.1.1 rest-client rspec rubocop-performance sqlite3:2.8.1 activerecord:8.1.1 ruby-lsp ``` :heavy_check_mark: 如果你看到 `xx gems installed`，那么一切正常 :+1: @@ -446,7 +445,7 @@ nvm -v 现在，让我们来安装node： ```bash -nvm install 16.15.1 +nvm install 20.17.0 ``` 当这个指令执行结束之后，运行： @@ -455,7 +454,7 @@ nvm install 16.15.1 node -v ``` -如果看到`v16.15.1`，那么你安装成功了:heavy_check_mark: 然后，你就可以运行下面这个命令了： +如果看到`v20.17.0`，那么你安装成功了:heavy_check_mark: 然后，你就可以运行下面这个命令了： ```bash nvm cache clear @@ -469,9 +468,16 @@ nvm cache clear 让我们一起来安装[`yarn`](https://classic.yarnpkg.com/en/docs/install): ```bash -npm install --global yarn +corepack enable +yarn set version stable ``` +```bash +exec zsh +``` + +⚠️ 如果你看到任何错误信息，请尝试运行 `npm install -g corepack` 然后再次运行上面的命令。 + 重启终端并运行： ```bash @@ -488,7 +494,7 @@ yarn -v 在终端，执行下面的命令： ```bash -sudo apt-get install sqlite3 libsqlite3-dev +sudo apt-get install sqlite3 libsqlite3-dev pkg-config ``` 然后执行下面的命令： @@ -581,9 +587,12 @@ After the test are finished, you should have green "All clear" messages at least 之后你可以全天开着Slack，这样你可以在上面分享有用的链接/寻求帮助/决定去那儿吃饭/... 为了确保视频电话可以正常工作，让我们一起测试摄像头和麦克风： -- 打开Slack应用程序 -- 在任意群组的消息编辑框里输入`/call --test`并按下`Enter` -- 按下"Start test"绿色按钮 +- 打开Slack应用程序。 +- 点击右上方的个人照片。 +- 从菜单中选择 `首选项(Preferences)`。 +- 点击左侧栏中的 `音频和视频(Audio & video)`。 +- 在 `故障排除(Troubleshooting)`下面，点击 `运行音频、视频和屏幕共享测试(Run an audio, video and screensharing test)`。该测试将在一个新窗口中打开。 +- 检查你使用的扬声器、麦克风和摄像机设备是否出现在选项中，然后点击 `开始测试(Start test)`。 ![在Slack检查麦克风和摄像头](images/slack_call_test.png) @@ -644,7 +653,6 @@ You must pin: - VS Code - Your Internet browser - Slack -- Zoom ## 设置完成啦! diff --git a/ubuntu.es.md b/ubuntu.es.md index ac178dff..d59541b5 100644 --- a/ubuntu.es.md +++ b/ubuntu.es.md @@ -1,43 +1,12 @@ # Instrucciones de la configuración -Aquí abajo encontrarás las instrucciones para la configuración que tu computadora necesita para el [curso de Desarrollo Web de Le Wagon](https://www.lewagon.com/web-development-course/full-time). +Aquí abajo encontrarás las instrucciones para la configuración que tu computadora necesita para el [curso de AI Software Development de Le Wagon](https://www.lewagon.com/web-development-course/full-time). Por favor, **léelas cuidadosamente y ejecuta todos los comandos en el orden indicado**. Si tienes algún problema, no dudes en pedirle ayuda a tu profesor :raising_hand: ¡Comencemos! :rocket: -## Zoom - -Para poder interactuar cuando no estemos en el mismo lugar físico, usaremos [Zoom](https://zoom.us/), una herramienta de videoconferencia. - -:warning: Si ya tienes Zoom instalado, por favor asegúrate de que por lo menos tienes versión **5.6**. - -Ve a [zoom.us/download](https://zoom.us/download). - -Haz clic en el botón **Download** debajo de **Zoom Client**. - -Abre el archivo que acabas de descargar para instalar la aplicación. - -Abre la aplicación Zoom. - -Si ya tienes una cuenta Zoom, inicia sesión con tus credenciales. - -Si no, haz clic en el enlace **Sign Up Free**, que significa registrarse gratuitamente: - -![Registrarse gratuitamente en Zoom](images/zoom_sign_up_free.png) - -Te redireccionarán a la página de Zoom para que completes un formulario. - -Cuando termines, regresa a la aplicación Zoom e inicia sesión usando tus credenciales. - -Deberías ver una pantalla como la siguiente: - -![Pantalla de inicio de Zoom](images/zoom_home_screen.png) - -Ya puedes cerrar la aplicación Zoom. - - ## Cuenta GitHub ¿Ya tienes una cuenta GitHub? Si no es el caso, [ábrela ya](https://github.com/join). @@ -46,6 +15,8 @@ Ya puedes cerrar la aplicación Zoom. ![Foto GitHub](images/github_picture.png) +:point_right: **[Habilita la Autenticación de Dos Factores (2FA)](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-text-messages)**. GitHub te enviará mensajes de texto con un código cuando intentes iniciar sesión. Esto es importante para la seguridad y también pronto será necesario para contribuir código en GitHub. + ## Visual Studio Code @@ -94,22 +65,44 @@ code --install-extension ms-vscode.sublime-keybindings code --install-extension emmanuelbeziat.vscode-great-icons code --install-extension github.github-vscode-theme code --install-extension MS-vsliveshare.vsliveshare -code --install-extension rebornix.ruby +code --install-extension shopify.ruby-lsp code --install-extension dbaeumer.vscode-eslint code --install-extension Rubymaniac.vscode-paste-and-indent code --install-extension alexcvzz.vscode-sqlite +code --install-extension anteprimorac.html-end-tag-labels +code --install-extension marcoroth.herb-lsp +code --install-extension rayhanw.erb-helpers ``` Aquí está la lista de las extensiones que estás instalando: - [Sublime Text Keymap and Settings Importer](https://marketplace.visualstudio.com/items?itemName=ms-vscode.sublime-keybindings) - [VSCode Great Icons](https://marketplace.visualstudio.com/items?itemName=emmanuelbeziat.vscode-great-icons) - [Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare) -- [Ruby](https://marketplace.visualstudio.com/items?itemName=rebornix.Ruby) +- [Ruby](https://marketplace.visualstudio.com/items?itemName=shopify.ruby-lsp) - [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) - [Paste and Indent](https://marketplace.visualstudio.com/items?itemName=Rubymaniac.vscode-paste-and-indent) - [SQLite](https://marketplace.visualstudio.com/items?itemName=alexcvzz.vscode-sqlite) +### Funciones de IA en VS Code + +VS Code incluye muchas y potentes **funciones de IA**, que son una gran herramienta una vez que ya sabes programar. + +Dicho esto, depender de la IA demasiado pronto puede ocultar conceptos importantes y dificultar la comprensión de la depuración. Una vez que estés cómodo con los fundamentos, sabrás cuándo y cómo usar la IA de forma eficaz —sin dejar que haga el trabajo por ti. + +Para el inicio del bootcamp, desactivaremos estas funciones. Llegado el momento apropiado en el curso, las volveremos a habilitar para que puedas utilizarlas bien. + +En **VS Code**: + +1. Abramos la "Paleta de comandos" de VS Code: escribe `Ctrl-Shift-P` (Windows / Linux) o `Cmd-Shift-P` (macOS). +1. Se abrirá la Paleta de comandos: una pequeña caja de texto en la parte superior de la pantalla. Empieza a escribir `aifeatures` hasta que veas "Chat: Learn How to Hide AI features". Haz clic en ella. + ![The Command Palette at the top of the screen](images/vscode_find_aifeatures.png) +1. Esto abrirá la configuración y te mostrará la opción "Disable and hide built-in AI features ...". Marca la casilla delante de esa opción. + ![Check the disable option](images/vscode_disable_aifeatures.png) + +Más adelante, si quieres **volver a habilitar** las funciones de IA, puedes seguir las mismas instrucciones para desmarcar la casilla. + + ### Configuración de Live Share [Visual Studio Live Share](https://visualstudio.microsoft.com/services/live-share/) es una extensión de VS Code que te permite compartir el código en tu editor de texto para debugging y pair-programming: ¡Instalémoslo! @@ -130,6 +123,36 @@ Eso es todo. ¡Ya puedes continuar! ## Herramientas de línea de comando +### Comprueba la configuración regional (locale) + +La "locale" es un mecanismo que permite adaptar los programas a su idioma y país. + +Comprobemos que la configuración regional por defecto es el inglés: + +```bash +locale +``` + +Si la salida no contiene `LANG=en_US.UTF-8`, ejecute el siguiente comando en un Ubuntu terminal para instalar la locale inglesa: + +```bash +sudo locale-gen en_US.UTF-8 +``` + +Si después, recibes una advertencia (`bash: warning: setlocale: LC_ALL: cannot change locale (en_US.utf-8)`) en tu terminal, por favor haz lo siguiente: + +
+ Generar la configuración regional<>/summary> + +Por favor, ejecuta estas líneas en tu terminal. + +```bash +sudo update-locale LANG=en_US.UTF8 +sudo apt-get update +sudo apt-get install language-pack-en language-pack-en-base manpages +``` +
+ ### Zsh & Git En lugar de usar el `bash` [shell](https://en.wikipedia.org/wiki/Shell_(computing)) predeterminado, usaremos `zsh`. @@ -204,6 +227,8 @@ CLI es una abreviación de [Command-line Interface](https://en.wikipedia.org/wik En esta sección usaremos [GitHub CLI](https://cli.github.com/) para interactuar directamente con GitHub desde la terminal. +Usaremos la GitHub CLI (`gh`) para conectarnos a GitHub utilizando *SSH*, un protocolo para iniciar la sesión utilizando claves SSH en lugar de la famosa pareja nombre de usuario y contraseña. + Ya debería haberse instalado en tu computadora con los comandos que ejecutaste anteriormente. Lo primero que hay que hacer para **iniciar sesión** es copiar y pegar el comando siguiente en tu terminal: @@ -211,20 +236,18 @@ Lo primero que hay que hacer para **iniciar sesión** es copiar y pegar el coman :warning: **NO edites el `email`** ```bash -gh auth login -s 'user:email' -w +gh auth login -s 'user:email' -w --git-protocol ssh ``` -gh le hará algunas preguntas: +`gh` le hará algunas preguntas: -`What is your preferred protocol for Git operations?` Con las flechas, elige `SSH` y presiona `Enter`. SSH es un protocolo para iniciar la sesión utilizando claves SSH en lugar de la famosa pareja nombre de usuario y contraseña. +- `Generate a new SSH key to add to your GitHub account?` Presiona `Enter` para pedirle a gh que genere las claves SSH por ti. -`Generate a new SSH key to add to your GitHub account?` Presiona `Enter` para pedirle a gh que genere las claves SSH por ti. + Si ya tienes claves SSH, verás en su lugar `Upload your SSH public key to your GitHub account?`Con las flechas, selecciona la ruta de tu archivo de clave pública y pulsa `Intro`. -Si ya tienes claves SSH, verás en su lugar `Upload your SSH public key to your GitHub account?`Con las flechas, selecciona la ruta de tu archivo de clave pública y pulsa `Intro`. +- `Enter a passphrase for your new SSH key (Optional)`. Pon algo que quieras y que recuerdes. Es una contraseña para proteger tu private key que está almacenada en tu disco duro. Luego presiona `Enter`. -`Enter a passphrase for your new SSH key (Optional)`. Pon algo que quieras y que recuerdes. Es una contraseña para proteger tu private key que está almacenada en tu disco duro. Luego presiona `Enter`. - -:warning: Cuando escribas tu passphrase, no verás nada en la pantalla. **Esto es normal**. Es una herramienta de seguridad para ocultar tanto el contenido de tu passphrase como su longitud. Simplemente escribe tu passphrase y presiona `Enter` al terminar. +- `Title for your SSH key`. Puede dejarlo en la propuesta "GitHub CLI", presiona `Enter`. Obtendrás el siguiente resultado: @@ -305,7 +328,7 @@ Ejecuta el instalador de `git`: cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh ``` -:point_up: Esto te **pedirá** tu nombre (`FirstName LastName`) y tu email. +:point_up: Esto te **pedirá** tu nombre (`FirstName LastName`) y tu email. Cualquier correo que elijas se mostrará **públicamente** en internet. 💡 Selecciona la dirección `@users.noreply.github.com` si no quieres que tu correo electrónico aparezca en los repositorios públicos a los que puedas contribuir. :warning: **Necesitas** poner uno de los emails que aparecen arriba gracias al comando anterior `gh api ...`. De lo contrario, Kitt no podrá hacerle seguimiento a tu progreso. @@ -355,7 +378,7 @@ rm -rf ~/.rbenv Luego ejecuta lo siguiente en tu terminal: ```bash -sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev +sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev libyaml-dev ``` ```bash @@ -377,13 +400,13 @@ Ahora estás listo para instalar la última versión de [ruby](https://www.ruby- Corre este comando, **tomará un tiempo (5-10 minutos)** ```bash -rbenv install 3.1.2 +rbenv install 3.3.5 ``` -Cuando la instalación de ruby termine, corre este comando para decirle al sistema que use la versión 3.1.2 por defecto. +Cuando la instalación de ruby termine, corre este comando para decirle al sistema que use la versión 3.3.5 por defecto. ```bash -rbenv global 3.1.2 +rbenv global 3.3.5 ``` **Reinicia** tu terminal y chequea tu versión Ruby: @@ -398,7 +421,7 @@ Luego ejecuta esto: ruby -v ``` -:heavy_check_mark: Si ves algo que comience por `ruby 3.1.2p`, entonces puedes continuar +1: +:heavy_check_mark: Si ves algo que comience por `ruby 3.3.5`, entonces puedes continuar +1: :x: Si no es el caso, **pídele ayuda a un profesor**. @@ -424,10 +447,16 @@ gem sources -l En el universo de ruby, a las librerías externas se les llama `gems`: son pedazos de código ruby que puedes descargar y ejecutar en tu computadora. ¡Instalemos algunas! +Primero, vamos a actualizar `bundler`, que es lo que nos permite instalar gemas: + +```bash +gem update bundler +``` + En tu terminal, copia y pega el siguiente comando: ```bash -gem install colored faker http pry-byebug rake rails rest-client rspec rubocop-performance sqlite3 +gem install colored faker http pry-byebug rake rails:8.1.1 rest-client rspec rubocop-performance sqlite3:2.8.1 activerecord:8.1.1 ruby-lsp ``` :heavy_check_mark: Si obtienes `xx gems installed`, entonces todo está bien :+1: @@ -472,7 +501,7 @@ Deberías ver una versión. Si no, pídele ayuda a tu profesor. Ahora instala node: ```bash -nvm install 16.15.1 +nvm install 20.17.0 ``` Cuando termine la instalación, corre lo siguiente: @@ -481,7 +510,7 @@ Cuando termine la instalación, corre lo siguiente: node -v ``` -Si ves `v16.15.1`, the installation succeeded :heavy_check_mark: entonces ahora puedes ejecutar lo siguiente: +Si ves `v20.17.0`, the installation succeeded :heavy_check_mark: entonces ahora puedes ejecutar lo siguiente: ```bash nvm cache clear @@ -497,10 +526,16 @@ nvm cache clear En una terminal, ejecuta los siguientes comandos: ```bash -npm install --global yarn +corepack enable +yarn set version stable +``` + +```bash exec zsh ``` +⚠️ Si ves algún mensaje de error, intenta ejecutar `npm install -g corepack` y luego vuelve a ejecutar los comandos anteriores. + Luego ejecuta este comando: ```bash @@ -519,7 +554,7 @@ En algunas semanas hablaremos de bases de datos y de SQL. [SQLite](https://sqlit En un terminal, ejecuta los siguientes comandos: ```bash -sudo apt-get install sqlite3 libsqlite3-dev +sudo apt-get install sqlite3 libsqlite3-dev pkg-config ``` A continuación, ejecuta el siguiente comando: @@ -608,7 +643,11 @@ La idea es tener Slack abierto todo el día para compartir enlaces útiles / ped Para asegurarte de que todo lo relacionado a videollamadas funcione bien, prueba tu cámara y tu micrófono: - Abre la aplicación Slack -- Escribe `/call --test` en la barra de mensaje de cualquier canal y presiona `Enter` +- Haz clic en tu foto de perfil en la esquina superior derecha +- Selecciona "Preferencias" en el menú. +- Haz clic en "Audio y vídeo" en la columna de la izquierda. +- Debajo de "Solución de problemas", haz clic en "Ejecutar una prueba de audio, vídeo y pantalla compartida". La prueba se abrirá en una nueva ventana. +- Comprueba que tus dispositivos preferidos de altavoz, micrófono y cámara aparecen en los menús desplegables y haz clic en "Iniciar prueba" - Haz clic en el botón verde "Start test" ![Chequea el micrófono y la cámara con Slack](images/slack_call_test.png) @@ -670,12 +709,11 @@ Ancla lo siguiente: - VS Code - Tu navegador de Internet - Slack -- Zoom ## ¡Fin de la configuración! -Tu computadora está lista para el [curso de Desarrollo Web de Le Wagon](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: +Tu computadora está lista para el [curso de AI Software Development de Le Wagon](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: Disfrútalo, sabemos que te va a ir genial :rocket: diff --git a/ubuntu.fr.md b/ubuntu.fr.md index 3cedf8f7..5b3eb7b5 100644 --- a/ubuntu.fr.md +++ b/ubuntu.fr.md @@ -1,43 +1,12 @@ # Instructions de configuration -Les instructions ci-dessous vont te permettre de configurer ton ordinateur pour [la formation Développement Web du Wagon](https://www.lewagon.com/web-development-course/full-time). +Les instructions ci-dessous vont te permettre de configurer ton ordinateur pour [la formation AI Software Development du Wagon](https://www.lewagon.com/web-development-course/full-time). **Lis-les attentivement et exécute toutes les commandes dans l’ordre suivant**. En cas de blocage, n’hésite pas à demander au prof :raising_hand: C’est parti :rocket: -## Zoom - -Pour interagir quand on ne sera pas dans la même pièce, on utilisera [Zoom](https://zoom.us), un outil de visioconférence. - -:warning: Si Zoom est déjà installé sur ton ordinateur, vérifie qu’il s’agit au moins de la version **5.6**. - -Va sur [zoom.us/download](https://zoom.us/download). - -Sous **Client Zoom**, clique sur le bouton **Télécharger**. - -Ouvre le fichier que tu viens de télécharger pour installer l’application. - -Ouvre l’application Zoom. - -Si tu as déjà un compte Zoom, connecte-toi avec tes identifiants. - -Sinon, clique sur le lien **Inscrivez-vous, c’est gratuit** : - -![Inscrivez-vous à Zoom, c’est gratuit](images/zoom_sign_up_free.png) - -Sur le site Web de Zoom, remplis le formulaire. - -Une fois que tu as terminé, retourne sur l’application Zoom et connecte-toi avec tes identifiants. - -Tu devrais voir apparaître un écran ressemblant à ça : - -![Écran d’accueil Zoom](images/zoom_home_screen.png) - -Tu peux fermer l’application Zoom. - - ## Compte GitHub Est-ce que tu as déjà un compte GitHub ? Si ce n’est pas le cas, [inscris-toi maintenant](https://github.com/join). @@ -46,6 +15,8 @@ Est-ce que tu as déjà un compte GitHub ? Si ce n’est pas le cas, [inscris-t ![image de GitHub](images/github_picture.png) +:point_right: **[Activez l'authentification à deux facteurs (2FA)](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-text-messages)**. GitHub vous enverra des messages texte avec un code lorsque vous essayez de vous connecter. C'est important pour la sécurité et cela sera bientôt obligatoire pour contribuer du code sur GitHub. + ## Visual Studio Code @@ -93,22 +64,44 @@ Copie-colle les commandes suivantes dans le terminal : code --install-extension ms-vscode.sublime-keybindings code --install-extension emmanuelbeziat.vscode-great-icons code --install-extension MS-vsliveshare.vsliveshare -code --install-extension rebornix.ruby +code --install-extension shopify.ruby-lsp code --install-extension dbaeumer.vscode-eslint code --install-extension Rubymaniac.vscode-paste-and-indent code --install-extension alexcvzz.vscode-sqlite +code --install-extension anteprimorac.html-end-tag-labels +code --install-extension marcoroth.herb-lsp +code --install-extension rayhanw.erb-helpers ``` Voici la liste des extensions que tu es en train d'installer : - [Sublime Text Keymap and Settings Importer](https://marketplace.visualstudio.com/items?itemName=ms-vscode.sublime-keybindings) - [VSCode Great Icons](https://marketplace.visualstudio.com/items?itemName=emmanuelbeziat.vscode-great-icons) - [Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare) -- [Ruby](https://marketplace.visualstudio.com/items?itemName=rebornix.Ruby) +- [Ruby](https://marketplace.visualstudio.com/items?itemName=shopify.ruby-lsp) - [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) - [Paste and Indent](https://marketplace.visualstudio.com/items?itemName=Rubymaniac.vscode-paste-and-indent) - [SQLite](https://marketplace.visualstudio.com/items?itemName=alexcvzz.vscode-sqlite) +### Fonctionnalités IA de VS Code + +VS Code inclut de nombreuses **fonctionnalités d'IA** puissantes, qui sont un excellent outil une fois que vous savez déjà coder. + +Cela dit, s'appuyer sur l'IA trop tôt peut masquer des concepts importants et rendre le débogage plus difficile à comprendre. Une fois à l'aise avec les fondamentaux, vous saurez quand et comment utiliser l'IA efficacement — sans lui laisser faire la réflexion à votre place. + +Pour le début du bootcamp, nous allons désactiver ces fonctionnalités. Au bon moment du cours, nous les réactiverons afin que vous puissiez les utiliser à bon escient. + +Dans **VS Code** : + +1. Ouvrez la "Palette de commandes" de VS Code : tapez `Ctrl-Shift-P` (Windows / Linux) ou `Cmd-Shift-P` (macOS). +1. La Palette de commandes s'ouvrira : une petite zone de texte en haut de l'écran. Commencez à taper `aifeatures` jusqu'à voir "Chat: Learn How to Hide AI features". Cliquez dessus. + ![La palette de commandes en haut de l'écran](images/vscode_find_aifeatures.png) +1. Cela ouvrira les paramètres et affichera l'option "Disable and hide built-in AI features ...". Cochez la case devant cette option. + ![Cochez l'option de désactivation](images/vscode_disable_aifeatures.png) + +Plus tard, si vous souhaitez **réactiver** les fonctionnalités d'IA, vous pouvez suivre les mêmes instructions pour décocher la case. + + ### Configuration de Live Share [Visual Studio Live Share](https://visualstudio.microsoft.com/services/live-share/) est une extension de VS Code, qui te permet de partager du code dans ton éditeur de texte pour débugger et faire de la programmation en binôme. Configurons-le ! @@ -129,6 +122,36 @@ C’est bon ! ## Outils en ligne de commande +### Vérifier la locale + +Le concept de "locale" permet de personnaliser les programms en fonction de ta langue et ton pays. + +Vérifions que la locale est bien en **anglais** dans le terminal : + +```bash +locale +``` + +Si la commande ne renvoie pas quelque chose qui contient `LANG=en_US.UTF-8`, lance ceci dans un terminal Ubuntu : + +```bash +sudo locale-gen en_US.UTF-8 +``` + +Si après, tu reçois un avertissement (`bash: warning: setlocale: LC_ALL: cannot change locale (en_US.utf-8)`) dans ton terminal, veuillez faire ce qui suit : + +
+ Générer la localisation + +Veuillez exécuter ces lignes dans ton terminal. + +```bash +sudo update-locale LANG=en_US.UTF8 +sudo apt-get update +sudo apt-get install language-pack-en language-pack-en-base manpages +``` +
+ ### Zsh & Git Au lieu d’utiliser le [shell](https://fr.wikipedia.org/wiki/Interface_syst%C3%A8me) `bash` par défaut, nous utiliserons `zsh`. @@ -203,6 +226,8 @@ CLI est l’acronyme de [Command-line Interface](https://en.wikipedia.org/wiki/C Dans cette section, tu vas installer [GitHub CLI](https://cli.github.com/) pour interagir avec GitHub directement depuis le terminal. +Nous allons utiliser GitHub CLI (`gh`) pour nous connecter à GitHub en utilisant *SSH*, un protocole pour s'authentifier en utilisant des clés SSH au lieu de la fameuse paire nom d'utilisateur et mot de passe. + Elle doit déjà être installée sur ton ordinateur grâce aux commandes précédentes. Pour **te connecter**, commence par copier-coller la commande suivante dans ton terminal : @@ -210,20 +235,18 @@ Pour **te connecter**, commence par copier-coller la commande suivante dans ton :warning: **NE modifie PAS `email`** ```bash -gh auth login -s 'user:email' -w +gh auth login -s 'user:email' -w --git-protocol ssh ``` -gh va te poser quelques questions : +`gh` va te poser quelques questions : -`What is your preferred protocol for Git operations?` Avec les flèches, choisis `SSH` et appuie sur `Enter`. SSH est un protocole pour s'authentifier en utilisant des clés SSH au lieu de la fameuse paire nom d'utilisateur et mot de passe. +- `Generate a new SSH key to add to your GitHub account?` Appuie sur `Enter` pour demander à gh de générer les clés SSH pour toi. -`Generate a new SSH key to add to your GitHub account?` Appuie sur `Enter` pour demander à gh de générer les clés SSH pour toi. + Si tu as déjà des clés SSH, tu verras à la place `Upload your SSH public key to your GitHub account?` Avec les flèches, sélectionne le chemain de ta clé publique et appuie sur `Enter`. -Si tu as déjà des clés SSH, tu verras à la place `Upload your SSH public key to your GitHub account?` Avec les flèches, sélectionne le chemain de ta clé publique et appuie sur `Enter`. +- `Enter a passphrase for your new SSH key (Optional)`. Saisis un mot de passe dont tu te souviendras. Ce mot de passe sert à protéger ta clé privée enregistrée sur ton disque sur. Ensuite, appuie sur `Enter`. -`Enter a passphrase for your new SSH key (Optional)`. Saisis un mot de passe dont tu te souviendras. Ce mot de passe sert à protéger ta clé privée enregistrée sur ton disque sur. Ensuite, appuie sur `Enter`. - -:warning: Lorsque tu saisiras ton mot de passe, rien ne s’affichera à l’écran ; **c’est normal**. Il s’agit d’une mesure de sécurité permettant de masquer non seulement les caractères de ton mot de passe, mais aussi sa longueur. Saisis simplement ton mot de passe, puis appuie sur `Enter`. +- `Title for your SSH key`. Tu peux laisser ce qui est proposé par défaut, à savoir "GitHub CLI", appuie sur `Enter`. Tu obtiendras le résultat suivant : @@ -306,7 +329,7 @@ cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh :point_up: On te **demandera** de fournir ton nom (`FirstName LastName`) et ton adresse e-mail. -:warning: Tu **dois** saisir l’une des adresses e-mail indiquées ci-dessus avec la commande `gh api ...` précédente. Sinon, Kitt ne pourra pas suivre tes progrès. +:warning: Tu **dois** saisir l’une des adresses e-mail indiquées ci-dessus avec la commande `gh api ...` précédente. Sinon, Kitt ne pourra pas suivre tes progrès. 💡 Sélectionnez l'adresse `@users.noreply.github.com` si vous ne souhaitez pas que votre adresse e-mail apparaisse dans les dépôts publics auxquels vous pourriez contribuer. **Réinitialise** ton terminal en exécutant : @@ -354,7 +377,7 @@ rm -rf ~/.rbenv Puis dans le terminal, exécute : ```bash -sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev +sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev libyaml-dev ``` ```bash @@ -376,14 +399,14 @@ Tu peux maintenant installer la dernière version de [ruby](https://www.ruby-lan Exécute cette commande ; cela **peut prendre un moment (5-10 minutes)** ```bash -rbenv install 3.1.2 +rbenv install 3.3.5 ``` Une fois que l’installation de Ruby est terminée, exécute cette commande pour indiquer au système -d’utiliser la version 3.1.2 par défaut. +d’utiliser la version 3.3.5 par défaut. ```bash -rbenv global 3.1.2 +rbenv global 3.3.5 ``` **Réinitialise** ton ton terminal et vérifie ta version de Ruby : @@ -398,7 +421,7 @@ Puis exécute : ruby -v ``` -:heavy_check_mark: Si tu vois apparaître un message commençant par `ruby 3.1.2p`, tu peux continuer :+1: +:heavy_check_mark: Si tu vois apparaître un message commençant par `ruby 3.3.5`, tu peux continuer :+1: :x: Sinon, **demande au prof** @@ -424,10 +447,16 @@ gem sources -l Dans l’environnement ruby, les bibliothèques externes sont appelées des `gems` : ce sont des bouts de code ruby, que tu peux télécharger et exécuter sur ton ordinateur. On va en installer quelques-unes. +Tout d'abord, nous allons mettre à jour `bundler`, ce qui nous permet d'installer des gemmes : + +```bash +gem update bundler +``` + Copie-colle la commande suivante dans ton terminal : ```bash -gem install colored faker http pry-byebug rake rails rest-client rspec rubocop-performance sqlite3 +gem install colored faker http pry-byebug rake rails:8.1.1 rest-client rspec rubocop-performance sqlite3:2.8.1 activerecord:8.1.1 ruby-lsp ``` :heavy_check_mark: Si tu vois apparaître `xx gems installed`, c’est bon :+1: @@ -472,7 +501,7 @@ Tu devrais voir apparaître une version. Sinon, demande au prof. On va maintenant installer node : ```bash -nvm install 16.15.1 +nvm install 20.17.0 ``` Une fois l’installation terminée, exécute : @@ -481,7 +510,7 @@ Une fois l’installation terminée, exécute : node -v ``` -Si tu vois apparaître `v16.15.1`, l'installation a réussi :heavy_check_mark: Tu peux alors exécuter : +Si tu vois apparaître `v20.17.0`, l'installation a réussi :heavy_check_mark: Tu peux alors exécuter : ```bash nvm cache clear @@ -497,10 +526,16 @@ nvm cache clear Exécute les commandes suivantes dans le terminal : ```bash -npm install --global yarn +corepack enable +yarn set version stable +``` + +```bash exec zsh ``` +⚠️ Si tu rencontres des messages d'erreur, essaye d'exécuter `npm install -g corepack` puis exécute à nouveau les commandes ci-dessus. + Puis exécute la commande suivante : ```bash @@ -519,7 +554,7 @@ Dans quelques semaines, on abordera les bases de données et le SQL. [SQLite](ht Dans un terminal, exécute la commande suivante : ```bash -sudo apt-get install sqlite3 libsqlite3-dev +sudo apt-get install sqlite3 libsqlite3-dev pkg-config ``` Puis exécute celle-ci : @@ -610,8 +645,11 @@ L’idée est de laisser Slack ouvert toute la journée pour partager des liens On va vérifier que tout fonctionne correctement ; pour cela, on va tester ta caméra et ton microphone : - Ouvre l’application Slack -- Dans la barre de message de n’importe quel channel, saisis `/call --test` et appuie sur `Enter` -- Clique sur le bouton vert « Démarrer le test » +- Clique sur ta photo de profil en haut à droite +- Clique sur `Preferences` depuis le menu +- Séléctionne `Audio & video` dans la colonne de gauche +- En dessous de `Troubleshooting`, clique sur `Run an audio, video and screensharing test`. Le test va s’ouvrir dans une nouvelle fenêtre +- Vérifie que ton microphone, caméra, et enceintes soient bien séléctionnés, puis clique sur `Start test` ![Vérifier le fonctionnement du microphone et de la webcam avec Slack](images/slack_call_test.png) @@ -672,12 +710,11 @@ Tu dois épingler : - VS Code - ton navigateur Internet - Slack -- Zoom ## La configuration est terminée ! -Ton ordinateur est prêt pour [la formation Développement Web du Wagon](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: +Ton ordinateur est prêt pour [la formation AI Software Development du Wagon](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: Profite du bootcamp, tu vas assurer :rocket: diff --git a/ubuntu.md b/ubuntu.md index e5d77990..73460787 100644 --- a/ubuntu.md +++ b/ubuntu.md @@ -1,6 +1,6 @@ # Setup instructions -You will find below the instructions to set up your computer for [Le Wagon Web Development course](https://www.lewagon.com/web-development-course/full-time). +You will find below the instructions to set up your computer for [Le Wagon AI Software Development course](https://www.lewagon.com/web-development-course/full-time). Please **read them carefully and execute all commands in the following order**. @@ -11,37 +11,6 @@ You can also have a look at [our cheatsheets](https://github.com/lewagon/setup/t Let's start :rocket: -## Zoom - -To be able to interact when we are not in the same physical room, we will be using [Zoom](https://zoom.us/), a video conferencing tool. - -:warning: If you already have Zoom installed, please make sure that the version is at least **5.6**. - -Go to [zoom.us/download](https://zoom.us/download). - -Under **Zoom Client** click the **Download** button. - -Open the file you have just downloaded to install the app. - -Open the Zoom app. - -If you already have a Zoom account, sign in using your credentials. - -If not, click on the **Sign Up Free** link: - -![Sign Up Free to Zoom](images/zoom_sign_up_free.png) - -You will be redirected to Zoom's website to complete a form. - -When it's done, go back to the Zoom app and sign in using your credentials. - -You should then see a screen like this: - -![Zoom Home Screen](images/zoom_home_screen.png) - -You can now close the Zoom app. - - ## GitHub account Have you signed up to GitHub? If not, [do it right away](https://github.com/join). @@ -50,6 +19,8 @@ Have you signed up to GitHub? If not, [do it right away](https://github.com/join ![GitHub picture](images/github_picture.png) +:point_right: **[Enable Two-Factor Authentication (2FA)](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-text-messages)**. GitHub will send you text messages with a code when you try to log in. This is important for security and also will soon be required in order to contribute code on GitHub. + ## Visual Studio Code @@ -110,46 +81,47 @@ Copy-paste the following commands in your terminal: ```bash code --install-extension ms-vscode.sublime-keybindings -``` - -```bash code --install-extension emmanuelbeziat.vscode-great-icons -``` - -```bash code --install-extension github.github-vscode-theme -``` - -```bash code --install-extension MS-vsliveshare.vsliveshare -``` - -```bash -code --install-extension rebornix.ruby -``` - -```bash +code --install-extension shopify.ruby-lsp code --install-extension dbaeumer.vscode-eslint -``` - -```bash code --install-extension Rubymaniac.vscode-paste-and-indent -``` - -```bash code --install-extension alexcvzz.vscode-sqlite +code --install-extension anteprimorac.html-end-tag-labels +code --install-extension rayhanw.erb-helpers ``` Here is a list of the extensions you are installing: + - [Sublime Text Keymap and Settings Importer](https://marketplace.visualstudio.com/items?itemName=ms-vscode.sublime-keybindings) - [VSCode Great Icons](https://marketplace.visualstudio.com/items?itemName=emmanuelbeziat.vscode-great-icons) - [Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare) -- [Ruby](https://marketplace.visualstudio.com/items?itemName=rebornix.Ruby) +- [Ruby](https://marketplace.visualstudio.com/items?itemName=shopify.ruby-lsp) - [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) - [Paste and Indent](https://marketplace.visualstudio.com/items?itemName=Rubymaniac.vscode-paste-and-indent) - [SQLite](https://marketplace.visualstudio.com/items?itemName=alexcvzz.vscode-sqlite) +### VS Code AI Features + +VS Code includes many powerful **AI features**, which are a great tool once you already know how to code. + +That said, relying on AI too early can hide important concepts and make debugging harder to understand. Once you’re comfortable with the fundamentals, you’ll know when and how to use AI effectively — without letting it do the thinking for you. + +For the start of the bootcamp, we’ll disable these features. At the right point in the course, we’ll reenable them so you can put them to good use. + +In **VS Code**: + +1. Let's open the VS Code "Command **P**alette": type `Ctrl-Shift-P` (Windows / Linux) or `Cmd-Shift-P` (macOS). +1. This will open the Command Palette: a small text box at the top of your screen. Start typing `aifeatures` until you see "Chat: Learn How to Hide AI features". Click on it. + ![The Command Palette at the top of the screen](images/vscode_find_aifeatures.png) +1. This will open the settings, and will show you the option "Disable and hide built-in AI features ...". Tick the checkbox in front of that option. + ![Check the disable option](images/vscode_disable_aifeatures.png) + +Later, if you want **to reenable** the AI features, you can follow the same instructions to untick the checkbox. + + ### Live Share configuration [Visual Studio Live Share](https://visualstudio.microsoft.com/services/live-share/) is a VS Code extension which allows you to share the code in your text editor for debugging and pair-programming: let's set it up! @@ -170,6 +142,36 @@ That's it, you're good to go! ## Command line tools +### Check the locale + +The locale is a mechanism allowing to customize programs to your language and country. + +Let's verify that the default locale is set to English, please type this in the Ubuntu terminal: + +```bash +locale +``` + +If the output does not contain `LANG=en_US.UTF-8`, run the following command in a Ubuntu terminal to install the english locale: + +```bash +sudo locale-gen en_US.UTF-8 +``` + +If after, you receive a warning (`bash: warning: setlocale: LC_ALL: cannot change locale (en_US.utf-8)`) in your terminal, please do the following: + +
+ Generate locale + +Please, run this lines in your terminal. + +```bash +sudo update-locale LANG=en_US.UTF8 +sudo apt-get update +sudo apt-get install language-pack-en language-pack-en-base manpages +``` +
+ ### Zsh & Git Instead of using the default `bash` [shell](https://en.wikipedia.org/wiki/Shell_(computing)), we will use `zsh`. @@ -255,25 +257,25 @@ In this section, we will use [GitHub CLI](https://cli.github.com/) to interact w It should already be installed on your computer from the previous commands. +We will use the GitHub CLI (`gh`) to connect to GitHub using *SSH*, a protocol to log in using SSH keys instead of the well known username/password pair. + First in order to **login**, copy-paste the following command in your terminal: :warning: **DO NOT edit the `email`** ```bash -gh auth login -s 'user:email' -w +gh auth login -s 'user:email' -w --git-protocol ssh ``` -gh will ask you few questions: - -`What is your preferred protocol for Git operations?` With the arrows, choose `SSH` and press `Enter`. SSH is a protocol to log in using SSH keys instead of the well known username/password pair. +`gh` will ask you few questions: -`Generate a new SSH key to add to your GitHub account?` Press `Enter` to ask gh to generate the SSH keys for you. +- `Generate a new SSH key to add to your GitHub account?` Press `Enter` to ask gh to generate the SSH keys for you. -If you already have SSH keys, you will see instead `Upload your SSH public key to your GitHub account?` With the arrows, select your public key file path and press `Enter`. + If you already have SSH keys, you will see instead `Upload your SSH public key to your GitHub account?` With the arrows, select your public key file path and press `Enter`. -`Enter a passphrase for your new SSH key (Optional)`. Type something you want and that you'll remember. It's a password to protect your private key stored on your hard drive. Then press `Enter`. +- `Enter a passphrase for your new SSH key (Optional)`. Type something you want and that you'll remember. It's a password to protect your private key stored on your hard drive. Then press `Enter`. -:warning: When you type your passphrase, nothing will show up on the screen, **that's normal**. This is a security feature to mask not only your passphrase as a whole but also its length. Just type your passphrase and when you're done, press `Enter`. +- `Title for your SSH key`. You can leave it at the proposed "GitHub CLI", press `Enter`. You will then get the following output: @@ -368,7 +370,8 @@ cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh :point_up: This will **prompt** you for your name (`FirstName LastName`) and your email. -:warning: You **need** to put one of the email listed above thanks to the previous `gh api ...` command. If you don't do that, Kitt won't be able to track your progress. +:warning: You **need** to put one of the emails listed above thanks to the previous `gh api ...` command. If you don't do that, Kitt won't be able to track your progress. 💡 Select the `@users.noreply.github.com` address if you don't want your email to appear in public repositories you may contribute to. + Please now **reset** your terminal by running: @@ -410,7 +413,7 @@ rm -rf ~/.rbenv Then in the terminal, run: ```bash -sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev +sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev libyaml-dev ``` ```bash @@ -435,14 +438,14 @@ Now, you are ready to install the latest [ruby](https://www.ruby-lang.org/en/) v Run this command, it will **take a while (5-10 minutes)** ```bash -rbenv install 3.1.2 +rbenv install 3.3.5 ``` Once the ruby installation is done, run this command to tell the system -to use the 3.1.2 version by default. +to use the 3.3.5 version by default. ```bash -rbenv global 3.1.2 +rbenv global 3.3.5 ``` **Reset** your terminal and check your Ruby version: @@ -457,7 +460,7 @@ Then run: ruby -v ``` -:heavy_check_mark: If you see something starting with `ruby 3.1.2p` then you can proceed :+1: +:heavy_check_mark: If you see something starting with `ruby 3.3.5` then you can proceed :+1: :x: If not, **ask a teacher** @@ -483,10 +486,16 @@ gem sources -l In the ruby world, we call external libraries `gems`: they are pieces of ruby code that you can download and execute on your computer. Let's install some! +First, we'll update `bundler`, which is what lets us install gems: + +```bash +gem update bundler +``` + In your terminal, copy-paste the following command: ```bash -gem install colored faker http pry-byebug rake rails rest-client rspec rubocop-performance sqlite3 +gem install colored faker http pry-byebug rake rails:8.1.1 rest-client rspec rubocop-performance sqlite3:2.8.1 activerecord:8.1.1 ruby-lsp ``` :heavy_check_mark: If you get `xx gems installed`, then all good :+1: @@ -534,7 +543,7 @@ You should see a version. If not, ask a teacher. Now let's install node: ```bash -nvm install 16.15.1 +nvm install 20.17.0 ``` When the installation is finished, run: @@ -543,7 +552,7 @@ When the installation is finished, run: node -v ``` -If you see `v16.15.1`, the installation succeeded :heavy_check_mark: You can then run: +If you see `v20.17.0`, the installation succeeded :heavy_check_mark: You can then run: ```bash nvm cache clear @@ -559,9 +568,12 @@ nvm cache clear In a terminal, run the following commands: ```bash -npm install --global yarn +corepack enable +yarn set version stable ``` +⚠️ If you see any error messages, try running `npm install -g corepack` and then run the commands above again. + ```bash exec zsh ``` @@ -584,7 +596,7 @@ In a few weeks, we'll talk about databases and SQL. [SQLite](https://sqlite.org/ In a terminal, execute the following commands: ```bash -sudo apt-get install sqlite3 libsqlite3-dev +sudo apt-get install sqlite3 libsqlite3-dev pkg-config ``` Then run the following command: @@ -638,23 +650,17 @@ curl -Ls https://raw.githubusercontent.com/lewagon/setup/master/check.rb > _.rb ## Kitt -:warning: If you have received an email from Le Wagon inviting you to sign up on Kitt (our learning platform), you can safely skip this step. Instead, please follow the instructions in the email you received if you haven't done so already. - -If you are unsure about what to do, you can follow [this link](https://kitt.lewagon.com/). If you are already logged in, you can safely skip this section. If you are not logged in, click on `Enter Kitt as a Student`. If you manage to login, you can safely skip this step. Otherwise ask a teacher whether you should have received an email or follow the instructions below. - -Register as a Wagon alumni by going to [kitt.lewagon.com/onboarding](http://kitt.lewagon.com/onboarding). Select your batch, sign in with GitHub and enter all your information. - -Your teacher will then validate that you are indeed part of the batch. You can ask them to do it as soon as you completed the registration form. - -Once the teacher has approved your profile, go to your email inbox. You should have 2 emails: +You should have received an email from Le Wagon inviting you to sign up on [Kitt](https://kitt.lewagon.com) (our learning platform). When submitting your onboarding form on Kitt, you should have received two additional invitations: - One from Slack, inviting you to the Le Wagon Alumni slack community (where you'll chat with your buddies and all the previous alumni). Click on **Join** and fill the information. - One from GitHub, inviting you to `lewagon` team. **Accept it** otherwise you won't be able to access the lecture slides. +If you haven't, please contact your teaching team. + ## Slack -[Slack](https://slack.com/) is a communcation platform pretty popular in the tech industry. +[Slack](https://slack.com/) is a communication platform pretty popular in the tech industry. ### Installation @@ -675,8 +681,11 @@ The idea is that you'll have Slack open all day, so that you can share useful li To ensure that everything is working fine for video calls, let's test your camera and microphone: - Open the Slack app -- In any channel message bar type `/call --test` and press `Enter` -- Click on the "Start test" green button +- Click your profile picture in the top right. +- Select `Preferences` from the menu. +- Click `Audio & video` in the left-side column. +- Below `Troubleshooting`, click `Run an audio, video and screensharing test`. The test will open in a new window. +- Check that your preferred speaker, microphone and camera devices appear in the drop-down menus, then click `Start test`. ![Check microphone and webcam with Slack](images/slack_call_test.png) @@ -737,12 +746,11 @@ You must pin: - VS Code - Your Internet browser - Slack -- Zoom ## Setup completed! -Your computer is now all set for [Le Wagon Web Development course](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: +Your computer is now all set for [Le Wagon AI Software Development course](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: Enjoy the bootcamp, you will nail it :rocket: diff --git a/ubuntu.pt.md b/ubuntu.pt.md new file mode 100644 index 00000000..1b5f82db --- /dev/null +++ b/ubuntu.pt.md @@ -0,0 +1,758 @@ +# Instruções de configuração + +Você encontrará abaixo as instruções para configurar seu computador para o [curso de AI Software Development Le Wagon](https://www.lewagon.com/web-development-course/full-time). + +Por favor **leia-os com atenção e execute todos os comandos na seguinte ordem**. + +Se você tiver dúvidas, não hesite em pedir ajuda a um professor :raising_hand: + +Você também pode dar uma olhada em [nossas cheatsheets](https://github.com/lewagon/setup/tree/master/docs) para soluções e dicas de problemas comuns :heavy_check_mark: + +Vamos começar :rocket: + + +## Conta GitHub + +Você se inscreveu no GitHub? Caso contrário, [faça isso imediatamente](https://github.com/join). + +:point_right: **[Carregue uma imagem](https://github.com/settings/profile)** e coloque seu nome corretamente em sua conta GitHub. Isso é importante porque usaremos um painel interno com seu avatar. Faça isso **agora**, antes de continuar com este guia. + +![Imagem do GitHub](images/github_picture.png) + +:point_right: [Ative a Autenticação em Duas Etapas (2FA)](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-text-messages). O GitHub enviará mensagens de texto com um código quando você tentar fazer login. Isso é importante para a segurança e em breve será necessário para contribuir com código no GitHub. + + +## Visual Studio Code + +### Instalação + +Vamos instalar o editor de texto [Visual Studio Code](https://code.visualstudio.com). + +Copie (`Ctrl` + `C`) os comandos abaixo e cole-os em seu terminal (`Ctrl` + `Shift` + `v`): + +```bash +wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg +``` + +```bash +sudo install -o root -g root -m 644 packages.microsoft.gpg /etc/apt/trusted.gpg.d/ +``` + +```bash +sudo sh -c 'echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/trusted.gpg.d/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list' +``` + +```bash +rm -f packages.microsoft.gpg +``` + +```bash +sudo apt update +``` + +```bash +sudo apt install -y code +``` + +Esses comandos solicitarão sua senha: digite-a. + +:warning: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`. + +### Iniciando a partir do terminal + +Agora vamos iniciar o VS Code no **terminal**: + +```bash +code +``` + +:heavy_check_mark: Se uma janela do VS Code acabou de abrir, você está pronto: +1: + +:x: Caso contrário, por favor **entre em contato com um professor** + + +## Extensões do VS Code + +### Instalação + +Vamos instalar algumas extensões úteis no VS Code. + +Copie e cole os seguintes comandos em seu terminal: + +```bash +code --install-extension ms-vscode.sublime-keybindings +code --install-extension emmanuelbeziat.vscode-great-icons +code --install-extension github.github-vscode-theme +code --install-extension MS-vsliveshare.vsliveshare +code --install-extension shopify.ruby-lsp +code --install-extension dbaeumer.vscode-eslint +code --install-extension Rubymaniac.vscode-paste-and-indent +code --install-extension alexcvzz.vscode-sqlite +code --install-extension anteprimorac.html-end-tag-labels +code --install-extension marcoroth.herb-lsp +code --install-extension rayhanw.erb-helpers +``` + +Aqui está uma lista das extensões que você está instalando: + +- [Sublime Text Keymap and Settings Importer](https://marketplace.visualstudio.com/items?itemName=ms-vscode.sublime-keybindings) +- [VSCode Great Icons](https://marketplace.visualstudio.com/items?itemName=emmanuelbeziat.vscode-great-icons) +- [Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare) +- [Ruby](https://marketplace.visualstudio.com/items?itemName=shopify.ruby-lsp) +- [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) +- [Paste and Indent](https://marketplace.visualstudio.com/items?itemName=Rubymaniac.vscode-paste-and-indent) +- [SQLite](https://marketplace.visualstudio.com/items?itemName=alexcvzz.vscode-sqlite) + + +### Recursos de IA no VS Code + +O VS Code inclui muitos **recursos poderosos de IA**, que são ótimas ferramentas quando você já sabe programar. + +Dito isso, confiar na IA muito cedo pode ocultar conceitos importantes e dificultar o entendimento da depuração. Quando você estiver confortável com os fundamentos, saberá quando e como usar a IA de forma eficaz — sem deixar que ela faça o raciocínio por você. + +Para o início do bootcamp, vamos desativar esses recursos. No momento certo do curso, os reativaremos para que você possa usá-los bem. + +Em **VS Code**: + +1. Vamos abrir a "Paleta de Comandos" do VS Code: digite `Ctrl-Shift-P` (Windows / Linux) ou `Cmd-Shift-P` (macOS). +1. Isso abrirá a Paleta de Comandos: uma pequena caixa de texto no topo da tela. Comece a digitar `aifeatures` até ver "Chat: Learn How to Hide AI features". Clique nela. + ![A Paleta de Comandos no topo da tela](images/vscode_find_aifeatures.png) +1. Isso abrirá as configurações e mostrará a opção "Disable and hide built-in AI features ...". Marque a caixa de seleção à frente dessa opção. + ![Marcar a opção para desativar](images/vscode_disable_aifeatures.png) + +Mais tarde, se quiser **reativar** os recursos de IA, você pode seguir as mesmas instruções para desmarcar a caixa. + + +### Configuração do Live Share + +[Visual Studio Live Share](https://visualstudio.microsoft.com/services/live-share/) é uma extensão do VS Code que permite compartilhar o código em seu editor de texto para depuração e programação em pares: vamos configurá-lo acima! + +Inicie o VS Code em seu terminal digitando `code` e pressionando `Enter`. + +Clique na pequena seta na parte inferior da barra esquerda :point_down: + +![VS Code Live Share](images/vscode_live_share.png) + +- Clique no botão "Compartilhar" e depois em "GitHub (faça login usando a conta GitHub)". +- Um pop-up aparece solicitando que você faça login no GitHub: clique em “Permitir”. +- Você é redirecionado para uma página do GitHub em seu navegador solicitando autorização do Visual Studio Code: clique em "Continuar" e depois em "Autorizar github". +- O VS Code pode exibir pop-ups adicionais: feche-os clicando em "OK". + +É isso, você está pronto para continuar! + + +## Ferramentas de linha de comando + +### Verifique a localidade + +A localidade é um mecanismo que permite personalizar programas de acordo com seu idioma e país. + +Vamos verificar se a localidade padrão está definida como inglês, digite isto no terminal do Ubuntu: + +```bash +locale +``` + +Se a saída não contiver `LANG=en_US.UTF-8`, execute o seguinte comando em um terminal Ubuntu para instalar a localidade em inglês: + +```bash +sudo locale-gen en_US.UTF-8 +``` + +Se, depois, receberes um aviso (`bash: warning: setlocale: LC_ALL: cannot change locale (en_US.utf-8)`) no teu terminal, por favor faz o seguinte: + +
+ Gerar localidade + +Por favor, executa estas linhas no teu terminal. + +```bash +sudo update-locale LANG=en_US.UTF8 +sudo apt-get update +sudo apt-get install language-pack-en language-pack-en-base manpages +``` +
+ +### Zsh e Git + +Em vez de usar o `bash` [shell](https://en.wikipedia.org/wiki/Shell_(computing)), usaremos `zsh`. + +Também usaremos [`git`](https://git-scm.com/), um software de linha de comando usado para controle de versão. + +Vamos instalá-los, juntamente com outras ferramentas úteis: +- Abra um **terminal Ubuntu** +- Copie e cole os seguintes comandos: + +```bash +sudo apt update +``` + +```bash +sudo apt install -y curl git imagemagick jq unzip vim zsh tree +``` + +Esses comandos solicitarão sua senha: digite-a. + +:warning: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`. + +### Instalação da CLI do GitHub + +Vamos agora instalar a [CLI oficial do GitHub](https://cli.github.com) (interface de linha de comando). É um software usado para interagir com sua conta GitHub através da linha de comando. + +Em seu terminal, copie e cole os seguintes comandos e digite sua senha, se solicitado: + +```bash +sudo apt remove -y gitsome # gh command can conflict with gitsome if already installed +curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg +``` + +```bash +echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null +``` + +```bash +sudo apt update +``` + +```bash +sudo apt install -y gh +``` + +Para verificar se `gh` foi instalado com sucesso em sua máquina, você pode executar: + +```bash +gh --version +``` + +:heavy_check_mark: Se você vir `gh versão X.Y.Z (AAAA-MM-DD)`, está pronto para prosseguir :+1: + +:x: Caso contrário, por favor **entre em contato com um professor** + + +## Oh-My-Zsh + +Vamos instalar o plugin `zsh` [Oh My Zsh](https://ohmyz.sh/). + +Em um terminal execute o seguinte comando: + +```bash +sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" +``` + +Se for perguntado "Deseja alterar seu shell padrão para zsh?", pressione `Y` + +No final seu terminal deverá ficar assim: + +![Terminal Ubuntu com OhMyZsh](images/oh_my_zsh.png) + +:heavy_check_mark: Se isso acontecer, você pode continuar :+1: + +:x: Caso contrário, por favor **entre em contato com um professor** + + +## CLI do GitHub + +CLI é o acrônimo de [Interface de linha de comando](https://en.wikipedia.org/wiki/Command-line_interface). + +Nesta seção, usaremos [GitHub CLI](https://cli.github.com/) para interagir com o GitHub diretamente do terminal. + +Usaremos o GitHub CLI (`gh`) para conectar ao GitHub usando *SSH*, um protocolo para fazer login usando chaves SSH em vez do conhecido par nome de usuário/senha. + + +Ele já deve estar instalado no seu computador a partir dos comandos anteriores. + +Primeiro, para **fazer login**, copie e cole o seguinte comando em seu terminal: + +:warning: **NÃO edite o `email`** + +```bash +gh auth login -s 'user:email' -w --git-protocol ssh +``` + +`gh` fará algumas perguntas: + +- `Generate a new SSH key to add to your GitHub account?` Pressione `Enter` para pedir ao gh para gerar as chaves SSH para você. + + Se você já possui chaves SSH, verá `Upload your SSH public key to your GitHub account?` Com as setas, selecione o caminho do arquivo de sua chave pública e pressione `Enter`. + +- `Enter a passphrase for your new SSH key (Optional)`. Digite algo que você deseja e que você lembrará. É uma senha para proteger sua chave privada armazenada no disco rígido. Em seguida, pressione `Enter`. + +- `Title for your SSH key`. Você pode deixá-lo no "GitHub CLI" proposto, pressione `Enter`. + +Você obterá então a seguinte saída: + +```bash +! First copy your one-time code: 0EF9-D015 +- Press Enter to open github.com in your browser... +``` + +Selecione e copie o código (`0EF9-D015` no exemplo) e pressione `Enter`. + +Seu navegador será aberto e solicitará que você autorize o GitHub CLI a usar sua conta GitHub. Aceite e espere um pouco. + +Volte ao terminal, pressione `Enter` novamente e pronto. + +Para verificar se você está conectado corretamente, digite: + +```bash +gh auth status +``` + +:heavy_check_mark: Se você estiver `Logado no github.com como `, então tudo bem :+1: + +:x: Caso contrário, **entre em contato com um professor**. + + +## Dotfiles (configuração padrão) + +Os hackers adoram refinar e aprimorar sua estrutura e ferramentas. + +Começaremos com uma ótima configuração padrão fornecida pelo Le Wagon: [`lewagon/dotfiles`](https://github.com/lewagon/dotfiles). + +Como sua configuração é pessoal, você precisa de seu próprio repositório para armazená-la. Então você irá fazer o **fork** do repositório Le Wagon. + +Bifurcar significa que você criará um novo repositório em sua própria conta GitHub `$GITHUB_USERNAME/dotfiles`, idêntico ao original do Le Wagon que você poderá modificar à vontade. + +Abra seu terminal e defina uma variável para seu nome de usuário GitHub: + +```bash +export GITHUB_USERNAME=`gh api user | jq -r '.login'` +``` + +```bash +echo $GITHUB_USERNAME +``` + +:heavy_check_mark: Você deverá ver seu nome de usuário do GitHub impresso. + +:x: Se não, **pare aqui** e peça ajuda. Pode haver um problema com a etapa anterior (`gh auth`). + +:warning: Por favor note que esta variável só é definida para o tempo em que seu terminal está aberto. Se você fechá-lo antes ou durante as próximas etapas, será necessário configurá-lo novamente com as duas etapas acima! + + +É hora de fazer um fork do repositório e cloná-lo em seu computador: + +```bash +mkdir -p ~/code/$GITHUB_USERNAME && cd $_ +``` + +```bash +gh repo fork lewagon/dotfiles --clone +``` + +### Instalador do Dotfiles + +Execute o instalador `dotfiles`: + +```bash +cd ~/code/$GITHUB_USERNAME/dotfiles +``` + +```bash +zsh install.sh +``` + +Verifique os e-mails registrados em sua conta GitHub. Você precisará escolher um na próxima etapa: + +```bash +gh api user/emails | jq -r '.[].email' +``` + +:heavy_check_mark: Se você vir a lista de seus e-mails registrados, você pode prosseguir :+1: + +:x: Caso contrário, [reautentique no GitHub](https://github.com/lewagon/setup/blob/master/ubuntu.pt.md#github-cli) antes de executar este comando :point_up: novamente. + +### Instalador git + +Execute o instalador `git`: + +```bash +cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh +``` + +:point_up: Isso **solicitará** seu nome (`Nome Sobrenome`) e seu e-mail. O email que você escolher será exibido **publicamente** na internet. 💡 Selecione o endereço `@users.noreply.github.com` se você não deseja que seu e-mail apareça em repositórios públicos aos quais você possa contribuir. + +:warning: Você **precisa** colocar um dos e-mails listados acima graças ao comando anterior `gh api ...`. Se você não fizer isso, Kitt não conseguirá acompanhar seu progresso. + +Agora **reinicie** seu terminal executando: + +```bash +exec zsh +``` + + +## Desativar prompt de senha SSH + +Você não quer que sua senha seja solicitada sempre que se comunicar com um repositório distante. Então, você precisa adicionar o plugin `ssh-agent` ao `oh my zsh`: + +Primeiro, abra o arquivo `.zshrc`: + +```bash +code ~/.zshrc +``` + +Então: +- Identifique a linha que começa com `plugins=` +- Adicione `ssh-agent` no final da lista de plugins + +:heavy_check_mark: Salve o arquivo `.zshrc` com `Ctrl` + `S` e feche seu editor de texto. + + +## rbenv + +Vamos instalar o [`rbenv`](https://github.com/sstephenson/rbenv), um software para instalar e gerenciar ambientes `ruby`. + +Primeiro, precisamos limpar qualquer instalação anterior do Ruby que você possa ter: + +```bash +rvm implode && sudo rm -rf ~/.rvm +# Se você obteve "zsh: comando não encontrado: rvm", continue. +# Significa que `rvm` não está no seu computador, é isso que queremos! +rm -rf ~/.rbenv +``` + +Então no terminal, execute: + +```bash +sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev libyaml-dev +``` + +```bash +git clone https://github.com/rbenv/rbenv.git ~/.rbenv +``` + +```bash +git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build +``` + +```bash +exec zsh +``` + + +## Ruby + +### Instalação + +Agora, você está pronto para instalar a versão mais recente do [ruby](https://www.ruby-lang.org/en/) e defini-la como a versão padrão. + +Execute este comando, **demorará um pouco (5 a 10 minutos)** + +```bash +rbenv install 3.3.5 +``` + +Assim que a instalação do Ruby estiver concluída, execute este comando para informar ao sistema +para usar a versão 3.3.5 por padrão. + +```bash +rbenv global 3.3.5 +``` + +**Reinicialize** seu terminal e verifique sua versão do Ruby: + +```bash +exec zsh +``` + +Então corra: + +```bash +ruby -v +``` + +:heavy_check_mark: Se você vir algo começando com `ruby 3.3.5` então você pode prosseguir :+1: + +:x: Se não, **pergunte a um professor** + +### Instalando algumas gems + +
+ Se você estiver na China 🇨🇳 clique aqui + + :warning: Se você estiver na China, você deve atualizar a forma como instalaremos o gem com os seguintes comandos. + +```bash +# Somente China! +fontes de gemas --remove https://rubygems.org/ +fontes de gemas -a https://gems.ruby-china.com/ +fontes de gemas -l +#***FONTES ATUAIS*** +# https://gems.ruby-china.com/ +# Ruby-china.com deve estar na lista agora +``` +
+ +**Todos, na China ou não**, continuem aqui para instalar gems. + +No mundo Ruby, chamamos bibliotecas externas de `gems`: são pedaços de código Ruby que você pode baixar e executar em seu computador. Vamos instalar alguns! + +No seu terminal, copie e cole o seguinte comando: + +```bash +gem install colored faker http pry-byebug rake rails:8.1.1 rest-client rspec rubocop-performance sqlite3:2.8.1 activerecord:8.1.1 ruby-lsp +``` + +:heavy_check_mark: Se você tiver `xx gems installed`, então tudo bem :+1: + +:x: Se você encontrar o seguinte erro: + +```bash +ERROR: While executing gem ... (TypeError) +incompatible marshal file format (can't be read) +format version 4.8 required; 60.33 given +``` + +Execute o seguinte comando: +```bash +rm -rf ~/.gemrc +``` + +Execute novamente o comando para instalar as gemas. + +:warning: **NUNCA** instale uma gem com `sudo gem install`! Mesmo se você encontrar uma resposta do Stackoverflow (ou o terminal) solicitando que você faça isso. + + +## Node.js + +[Node.js](https://nodejs.org/en/) é um tempo de execução JavaScript para executar código JavaScript no terminal. Vamos instalá-lo com [nvm](https://github.com/nvm-sh/nvm), um gerenciador de versões para Node.js. + +Em um terminal, execute os seguintes comandos: + +```bash +curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | zsh +``` + +```bash +exec zsh +``` + +Em seguida, execute o seguinte comando: + +```bash +nvm -v +``` + +Você deverá ver uma versão. Se não, pergunte a um professor. + +Agora vamos instalar o Node.js: + +```bash +nvm install 20.17.0 +``` + +Quando a instalação terminar, execute: + +```bash +node -v +``` + +Se você vir `v20.17.0`, a instalação foi bem-sucedida :heavy_check_mark: Você pode então executar: + +```bash +nvm cache clear +``` + +:x: Caso contrário, **entre em contato com um professor** + + +## Yarn + +[`yarn`](https://yarnpkg.com/) é um gerenciador de pacotes para instalar bibliotecas JavaScript. Vamos instalá-lo: + +Em um terminal, execute os seguintes comandos: + +```bash +corepack enable +yarn set version stable +``` + +```bash +exec zsh +``` + +⚠️ Se vires quaisquer mensagens de erro, tenta executar `npm install -g corepack` e, em seguida, volta a executar os comandos acima. + +Em seguida, execute o seguinte comando: + +```bash +yarn -v +``` + +:heavy_check_mark: Se você vir uma versão, você está bem :+1: + +:x: Se não, **entre em contato com um professor** + + +## SQLite + +Em algumas semanas falaremos sobre bancos de dados e SQL. [SQLite](https://sqlite.org/index.html) é um mecanismo de banco de dados usado para executar consultas SQL em bancos de dados de arquivo único. Vamos instalá-lo: + +Em um terminal, execute os seguintes comandos: + +```bash +sudo apt-get install sqlite3 libsqlite3-dev pkg-config +``` + +Em seguida, execute o seguinte comando: + +```bash +sqlite3 -version +``` + +:heavy_check_mark: Se você vir uma versão, você está bem :+1: + +:x: Se não, **peça um professor** + + +## PostgreSQL + +Às vezes, o SQLite não é suficiente e precisaremos de uma ferramenta mais avançada chamada [PostgreSQL](https://www.postgresql.org/), um sistema de banco de dados de código aberto, robusto e pronto para produção. + +Vamos instalá-lo agora. + +Execute os seguintes comandos: + +```bash +sudo apt install -y postgresql postgresql-contrib libpq-dev build-essential +``` + +```bash +sudo -u postgres psql --command "CREATE ROLE \"`whoami`\" LOGIN createdb superuser;" +``` + + +## Checagem + +Vamos verificar se você instalou tudo com sucesso. + +No seu terminal, execute o seguinte comando: + +```bash +exec zsh +``` + +Então corra: + +```bash +curl -Ls https://raw.githubusercontent.com/lewagon/setup/master/check.rb > _.rb && ruby _.rb && rm _.rb || rm _.rb +``` + +:heavy_check_mark: Se você receber uma mensagem verde `Awesome! Your computer is now ready!`, então você está bem :+1: + +:x: Caso contrário, **entre em contato com um professor**. + + +## Kitt + +:warning: Se você recebeu um e-mail do Le Wagon convidando você a se inscrever no Kitt (nossa plataforma de aprendizagem), você pode pular esta etapa com segurança. Em vez disso, siga as instruções no e-mail que você recebeu, caso ainda não tenha feito isso. + +Se não tiver certeza sobre o que fazer, siga [este link](https://kitt.lewagon.com/). Se você já estiver logado, pode pular esta seção com segurança. Se você não estiver logado, clique em `Enter Kitt as a Student`. Se você conseguir fazer login, poderá pular esta etapa com segurança. Caso contrário, pergunte a um professor se você deveria ter recebido um e-mail ou siga as instruções abaixo. + +Registre-se como Alumni da Le Wagon acessando [kitt.lewagon.com/onboarding](http://kitt.lewagon.com/onboarding). Selecione seu batch, faça login no GitHub e insira todas as suas informações. + +Seu professor irá então validar que você realmente faz parte do batch. Você pode pedir que eles façam isso assim que preencher o formulário de registro. + +Assim que o professor aprovar seu perfil, acesse sua caixa de entrada de e-mail. Você deve ter 2 e-mails: + +- Um do Slack, convidando você para a comunidade Le Wagon Alumni do Slack (onde você conversará com seus amigos e todos os ex-alunos anteriores). Clique em **Inscreva-se** e preencha os dados. +- Um do GitHub, convidando você para a equipe `lewagon`. **Aceite** caso contrário você não conseguirá acessar os slides da aula. + + +## Slack + +[Slack](https://slack.com/) é uma plataforma de comunicação bastante popular na indústria de tecnologia. + +### Instalação + +[Baixe o aplicativo Slack](https://get.slack.help/hc/en-us/articles/212924728-Slack-for-Linux-beta-) e instale-o. + +:warning: Se você já usa o Slack em seu navegador, baixe e instale **o aplicativo para desktop** que vem com todos os recursos. + + +### Configurações + +Inicie o aplicativo e faça login na organização `lewagon-alumni`. + +Certifique-se de **fazer upload de uma foto de perfil** :point_down: + +![Como fazer upload de uma foto de perfil no Slack](images/slack_profile_picture.gif) + +A ideia é que você tenha o Slack aberto o dia todo, para que você possa compartilhar links úteis/pedir ajuda/decidir onde ir almoçar/etc. + +Para garantir que tudo está funcionando bem nas videochamadas, vamos testar sua câmera e microfone: +- Abra o aplicativo Slack +- Clique na foto do seu perfil no canto superior direito. +- Selecione `Preferências` no menu. +- Clique em `Áudio e vídeo` na coluna do lado esquerdo. +- Abaixo de `Solução de problemas`, clique em `Executar um teste de áudio, vídeo e compartilhamento de tela`. O teste será aberto em uma nova janela. +- Verifique se seus dispositivos preferidos de alto-falante, microfone e câmera aparecem nos menus suspensos e clique em `Iniciar teste`. + +![Verifique o microfone e a webcam com o Slack](images/slack_call_test.png) + +:heavy_check_mark: Quando o teste terminar, você deverá ver mensagens verdes de "Sucesso" pelo menos para seu microfone e câmera. :+1: + +:x: Caso contrário, **entre em contato com um professor**. + +Você também pode instalar o aplicativo Slack no seu telefone e entrar em `lewagon-alumni`! + + +## Configurações do Ubuntu + +### Instale o codec de vídeo H264 + +Na nossa plataforma pedagógica (Kitt, você vai descobrir em breve!), temos alguns vídeos. Por padrão, o Firefox no Linux não pode reproduzi-los porque eles usam um codec não suportado (H264). Para que esses vídeos funcionem para você, você precisa executar o seguinte: + +```bash +sudo apt install libavcodec-extra -y +``` + +### Instale ferramentas de terminal úteis + +`tree` é uma boa ferramenta para visualizar uma árvore de diretórios dentro do terminal: + +`ncdu` é um utilitário de disco de interface baseado em texto. + +`htop` é um visualizador de processos interativo. + +`tig` é uma interface em modo texto para `git`. + +```bash +sudo apt install tree ncdu htop tig +``` + +### Ubuntu inotify + +O Ubuntu está sempre rastreando alterações em suas pastas e para isso usa o inotify. +Por padrão, o limite do Ubuntu é definido para 8.192 arquivos monitorados. + +Como a programação envolve muitos arquivos, precisamos aumentar esse limite. +Em seu terminal, execute: + +```bash +echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p +``` + +### Fixe aplicativos no seu dock + +Você usará a maioria dos aplicativos que instalou hoje com muita frequência. Então, vamos fixá-los no seu dock para que fiquem a apenas um clique de distância! + +Para fixar um aplicativo no seu dock, inicie o aplicativo, clique com o botão direito no ícone do dock para abrir o menu de contexto e escolha "Adicionar aos Favoritos". + +![Como fixar um aplicativo no dock no Ubuntu](images/ubuntu_dock.png) + +Você deve fixar: +- Seu terminal +- Seu explorador de arquivos +- VS Code +- Seu navegador de Internet +- Slack + + +## Configuração concluída! + +Seu computador agora está pronto para o [curso de AI Software Development Le Wagon](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: + +Aproveite o bootcamp, você vai acertar :rocket: + + diff --git a/windows.cn.md b/windows.cn.md index d8351183..660cb3c2 100644 --- a/windows.cn.md +++ b/windows.cn.md @@ -1,41 +1,11 @@ # 电脑设置教程 -以下的教程将会帮助你为接下来在[Le Wagon Web Development course](https://www.lewagon.com/web-development-course/full-time)全栈开发训练营中做好准备： +以下的教程将会帮助你为接下来在[Le Wagon AI Software Development course](https://www.lewagon.com/web-development-course/full-time)全栈开发训练营中做好准备： 请**仔细阅读并按顺序执行指令**。如果你在哪一步卡住了，不用犹豫，可以举手咨询老师:raising_hand: 让我们开始吧 :rocket: -## Zoom - -为了让我们能够线上的交流，我们将会使用[Zoom](https://zoom.us/)，一个视频会议工具。 - -:warning: 如果你已经安装了Zoom，请确保它的版本至少是**5.6**。 - -打开[https://zoom.us/download](https://zoom.us/download)。 - -在**Zoom会议客户端（Zoom Client）**下方点击**下载（Download）**按钮。 - -打开你刚刚下载的文件并安装应用程序。 - -打开Zoom。 - -如果你已经有Zoom账号了，那就用你的账号密码登陆吧。 - -如果没有账号的话，点击**Sign Up Free**链接： - -![Sign Up Free to Zoom](images/zoom_sign_up_free.png) - -接下来，它会跳转到Zoom的网站让你填一个表。 - -完成这个表之后，回到Zoom软件，然后用你的账号密码登陆吧。 - -你应该会看到下面这个界面： - -![Zoom Home Screen](images/zoom_home_screen.png) - -现在你可以关掉Zoom了。 - ## GitHub账户 @@ -45,6 +15,8 @@ ![](images/github_upload_picture.png) +**[启用双因素认证（2FA）](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-text-messages)**。当您尝试登录时，GitHub将向您发送带有代码的短信。这对于安全性很重要，也很快将成为贡献GitHub上的代码的必要条件。 + ## 开始设置的条件 @@ -498,7 +470,7 @@ wsl -l -v - 在它后面加上这行： ```bash -"multiLinePasteWarning": false, +"warning.multiLinePaste": false, ``` :warning: 别忘了这行最后有个逗号哟！ @@ -512,11 +484,11 @@ wsl -l -v **从现在开始，每次我们说终端的时候，就是在指这个终端。**不用使用其他的terminal了。 -## VS Code插件 +## VS Code 插件 ### 安装 -现在我们来给VS Code安装一些有用的插件吧。 +现在我们来给 VS Code 安装一些有用的插件吧。 复制粘贴下面的命令到终端： @@ -524,22 +496,45 @@ wsl -l -v code --install-extension ms-vscode.sublime-keybindings code --install-extension emmanuelbeziat.vscode-great-icons code --install-extension MS-vsliveshare.vsliveshare -code --install-extension rebornix.ruby +code --install-extension shopify.ruby-lsp code --install-extension dbaeumer.vscode-eslint code --install-extension Rubymaniac.vscode-paste-and-indent code --install-extension alexcvzz.vscode-sqlite +code --install-extension anteprimorac.html-end-tag-labels +code --install-extension marcoroth.herb-lsp +code --install-extension rayhanw.erb-helpers ``` 你安装的就是下面这些插件： + - [Sublime Text Keymap and Settings Importer](https://marketplace.visualstudio.com/items?itemName=ms-vscode.sublime-keybindings) - [VSCode Great Icons](https://marketplace.visualstudio.com/items?itemName=emmanuelbeziat.vscode-great-icons) - [Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare) -- [Ruby](https://marketplace.visualstudio.com/items?itemName=rebornix.Ruby) +- [Ruby](https://marketplace.visualstudio.com/items?itemName=shopify.ruby-lsp) - [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) - [Paste and Indent](https://marketplace.visualstudio.com/items?itemName=Rubymaniac.vscode-paste-and-indent) - [SQLite](https://marketplace.visualstudio.com/items?itemName=alexcvzz.vscode-sqlite) +### VS Code AI Features + +VS Code includes many powerful **AI features**, which are a great tool once you already know how to code. + +That said, relying on AI too early can hide important concepts and make debugging harder to understand. Once you’re comfortable with the fundamentals, you’ll know when and how to use AI effectively — without letting it do the thinking for you. + +For the start of the bootcamp, we’ll disable these features. At the right point in the course, we’ll reenable them so you can put them to good use. + +In **VS Code**: + +1. Let's open the VS Code "Command **P**alette": type `Ctrl-Shift-P` (Windows / Linux) or `Cmd-Shift-P` (macOS). +1. This will open the Command Palette: a small text box at the top of your screen. Start typing `aifeatures` until you see "Chat: Learn How to Hide AI features". Click on it. + ![The Command Palette at the top of the screen](images/vscode_find_aifeatures.png) +1. This will open the settings, and will show you the option "Disable and hide built-in AI features ...". Tick the checkbox in front of that option. + ![Check the disable option](images/vscode_disable_aifeatures.png) + +Later, if you want **to reenable** the AI features, you can follow the same instructions to untick the checkbox. + + ## Command line tools @@ -685,6 +680,7 @@ sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install. ```bash + echo "export BROWSER=\"/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe\"" >> ~/.zshrc echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'\"" >> ~/.zshrc ``` @@ -726,20 +722,18 @@ CLI是[Command-line Interface（命令行界面）](https://baike.baidu.com/item :warning: **不要更改下面指令中的`email`** ```bash -gh auth login -s 'user:email' -w +gh auth login -s 'user:email' -w --git-protocol ssh ``` -gh会问你几个问题： +`gh`会问你几个问题： -`What is your preferred protocol for Git operations?（你要用什么协议来执行Git操作？）` 让箭头`>`停在`SSH`前面，然后敲击回车。SSH使用SSH密钥来登陆用户，而不是用用户名和密码。 +- `Generate a new SSH key to add to your GitHub account?（生成新的SSH密钥，然后添加到Github账号上？）` 敲击回车，让gh帮你生成。 -`Generate a new SSH key to add to your GitHub account?（生成新的SSH密钥，然后添加到Github账号上？）` 敲击回车，让gh帮你生成。 + 如果你以前生成过SSH密钥，那你就会看到这个问题`Upload your SSH public key to your GitHub account?（上传公共密钥到Github账户上上吗？）` 上下移动箭头`>`，让它停在你想选的SSH公钥前面，然后敲击回车。 -如果你以前生成过SSH密钥，那你就会看到这个问题`Upload your SSH public key to your GitHub account?（上传公共密钥到Github账户上上吗？）` 上下移动箭头`>`，让它停在你想选的SSH公钥前面，然后敲击回车。 +- `Enter a passphrase for your new SSH key (Optional)（输入新的SSH密钥的密码（非必填））`. 输入一个密码，然后写下来或者记住它。这是保护你本地私钥的密码。然后敲击回车。 -`Enter a passphrase for your new SSH key (Optional)（输入新的SSH密钥的密码（非必填））`. 输入一个密码，然后写下来或者记住它。这是保护你本地私钥的密码。然后敲击回车。 - -:warning: 当你输入你的密码的时候，屏幕上不会有任何的显示，**这是正常的**。这是一个安全保护的设置，来隐藏你整个密码，包括它的长度。你可以放心的输入你的密码，结束后按下`Enter`就可以了。 +- `Title for your SSH key`。你可以把它留在建议的 "GitHub CLI"，按`Enter`。 然后你会看到下面的文字输出： @@ -821,7 +815,7 @@ cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh :point_up: 这会**提示**填写你的全名（`FirstName LastName`）和你的邮箱。 -:warning: 注意啦，你**需要**填`gh api ...`命令列出的其中一个电子邮箱。不然，Kitt就没办法跟进你的学习进程。 +:warning: 注意啦，你**需要**填`gh api ...`命令列出的其中一个电子邮箱。不然，Kitt就没办法跟进你的学习进程。 你选择的电子邮件将**公开**显示在互联网上。💡 如果您不希望您的电子邮件出现在您可能会贡献的公共存储库中，请选择 `@users.noreply.github.com` 地址。 现在运行下面的命令来**重置**你的终端： @@ -869,7 +863,7 @@ rm -rf ~/.rbenv 然后在终端里运行: ```bash -sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev +sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev libyaml-dev ``` ```bash @@ -891,13 +885,13 @@ exec zsh 运行下方这个指令，它会**花费一些时间（5-10分钟）** ```bash -rbenv install 3.1.2 +rbenv install 3.3.5 ``` -当Ruby安装好后，运行下面这个指令来告诉系统使用3.1.2这个版本作为默认版本。 +当Ruby安装好后，运行下面这个指令来告诉系统使用3.3.5这个版本作为默认版本。 ```bash -rbenv global 3.1.2 +rbenv global 3.3.5 ``` 然后**重置**你的终端，然后检查Ruby版本： @@ -907,7 +901,7 @@ exec zsh ruby -v ``` -:heavy_check_mark: 如果你有看到`ruby 3.1.2p`，那么你可以继续下一步+1: +:heavy_check_mark: 如果你有看到`ruby 3.3.5`，那么你可以继续下一步+1: :x: 如果没有的话，**询问一下老师**。 @@ -931,10 +925,16 @@ gem sources -l 在ruby的世界里，我们将外部的库称之为`gems`：他们是一些你可以下载并在你的电脑上运行的ruby代码。让我们一起安装一些! +首先，我们将更新`bundler`，它是用于安装 gem 的工具： + +```bash +gem update bundler +``` + 在你的终端里，复制粘贴下面的指令： ```bash -gem install colored faker http pry-byebug rake rails rest-client rspec rubocop-performance sqlite3 +gem install colored faker http pry-byebug rake rails:8.1.1 rest-client rspec rubocop-performance sqlite3:2.8.1 activerecord:8.1.1 ruby-lsp ``` :heavy_check_mark: 如果你看到 `xx gems installed`，那么一切正常 :+1: @@ -979,7 +979,7 @@ nvm -v 现在，让我们来安装node： ```bash -nvm install 16.15.1 +nvm install 20.17.0 ``` 当这个指令执行结束之后，运行： @@ -988,7 +988,7 @@ nvm install 16.15.1 node -v ``` -如果看到`v16.15.1`，那么你安装成功了:heavy_check_mark: 然后，你就可以运行下面这个命令了： +如果看到`v20.17.0`，那么你安装成功了:heavy_check_mark: 然后，你就可以运行下面这个命令了： ```bash nvm cache clear @@ -1002,9 +1002,16 @@ nvm cache clear 让我们一起来安装[`yarn`](https://classic.yarnpkg.com/en/docs/install): ```bash -npm install --global yarn +corepack enable +yarn set version stable ``` +```bash +exec zsh +``` + +⚠️ 如果你看到任何错误信息，请尝试运行 `npm install -g corepack` 然后再次运行上面的命令。 + 重启终端并运行： ```bash @@ -1021,7 +1028,7 @@ yarn -v 在终端，执行下面的命令： ```bash -sudo apt-get install sqlite3 libsqlite3-dev +sudo apt-get install sqlite3 libsqlite3-dev pkg-config ``` 然后执行下面的命令： @@ -1071,7 +1078,7 @@ echo "sudo /etc/init.d/postgresql start" >> ~/.zshrc 打开一个新的终端。 -:heavy_check_mark: 如果你看到一行字说`* Starting PostgreSQL 12 database server`，那你就可以进行下一步了 :+1: +:heavy_check_mark: 如果你看到一行字说`* Starting postgresql (via systemctl): postgresql.service`还是`* Starting PostgreSQL 14 database server`，那你就可以进行下一步了 :+1: :x: 如果没有的话， **请让老师来帮助你**。 @@ -1139,9 +1146,12 @@ curl -Ls https://web-dev-challenge-lewagon-image.oss-cn-shanghai.aliyuncs.com/se 之后你可以全天开着Slack，这样你可以在上面分享有用的链接/寻求帮助/决定去那儿吃饭/... 为了确保视频电话可以正常工作，让我们一起测试摄像头和麦克风： -- 打开Slack应用程序 -- 在任意群组的消息编辑框里输入`/call --test`并按下`Enter` -- 按下"Start test"绿色按钮 +- 打开Slack应用程序。 +- 点击右上方的个人照片。 +- 从菜单中选择 `首选项(Preferences)`。 +- 点击左侧栏中的 `音频和视频(Audio & video)`。 +- 在 `故障排除(Troubleshooting)`下面，点击 `运行音频、视频和屏幕共享测试(Run an audio, video and screensharing test)`。该测试将在一个新窗口中打开。 +- 检查你使用的扬声器、麦克风和摄像机设备是否出现在选项中，然后点击 `开始测试(Start test)`。 ![在Slack检查麦克风和摄像头](images/slack_call_test.png) diff --git a/windows.es.md b/windows.es.md index 1fcafd08..31e836ff 100644 --- a/windows.es.md +++ b/windows.es.md @@ -1,43 +1,12 @@ # Instrucciones de la configuración -Aquí abajo encontrarás las instrucciones para la configuración que tu computadora necesita para el [curso de Desarrollo Web de Le Wagon](https://www.lewagon.com/web-development-course/full-time). +Aquí abajo encontrarás las instrucciones para la configuración que tu computadora necesita para el [curso de AI Software Development de Le Wagon](https://www.lewagon.com/web-development-course/full-time). Por favor, **léelas cuidadosamente y ejecuta todos los comandos en el orden indicado**. Si tienes algún problema, no dudes en pedirle ayuda a tu profesor :raising_hand: ¡Comencemos! :rocket: -## Zoom - -Para poder interactuar cuando no estemos en el mismo lugar físico, usaremos [Zoom](https://zoom.us/), una herramienta de videoconferencia. - -:warning: Si ya tienes Zoom instalado, por favor asegúrate de que por lo menos tienes versión **5.6**. - -Ve a [zoom.us/download](https://zoom.us/download). - -Haz clic en el botón **Download** debajo de **Zoom Client**. - -Abre el archivo que acabas de descargar para instalar la aplicación. - -Abre la aplicación Zoom. - -Si ya tienes una cuenta Zoom, inicia sesión con tus credenciales. - -Si no, haz clic en el enlace **Sign Up Free**, que significa registrarse gratuitamente: - -![Registrarse gratuitamente en Zoom](images/zoom_sign_up_free.png) - -Te redireccionarán a la página de Zoom para que completes un formulario. - -Cuando termines, regresa a la aplicación Zoom e inicia sesión usando tus credenciales. - -Deberías ver una pantalla como la siguiente: - -![Pantalla de inicio de Zoom](images/zoom_home_screen.png) - -Ya puedes cerrar la aplicación Zoom. - - ## Cuenta GitHub ¿Ya tienes una cuenta GitHub? Si no es el caso, [ábrela ya](https://github.com/join). @@ -46,6 +15,8 @@ Ya puedes cerrar la aplicación Zoom. ![Foto GitHub](images/github_picture.png) +:point_right: **[Habilita la Autenticación de Dos Factores (2FA)](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-text-messages)**. GitHub te enviará mensajes de texto con un código cuando intentes iniciar sesión. Esto es importante para la seguridad y también pronto será necesario para contribuir código en GitHub. + ## La versión de Windows @@ -53,6 +24,10 @@ Antes de comenzar, necesitamos verificar que la versión de Windows instalada en ### Windows 10 o Windows 11 +> :warning: **Nota sobre Windows 10 y seguridad** +> +> La configuración del bootcamp de Le Wagon funciona en Windows 10. Dicho esto, recomendamos encarecidamente actualizar a Windows 11. Desde el 14 de octubre de 2025 Microsoft finalizó el soporte para Windows 10, lo que significa que ya no recibirá actualizaciones de seguridad y podría poner tu equipo en riesgo. Para más detalles, consulta la [guía de Microsoft](https://support.microsoft.com/en-us/windows/windows-10-support-has-ended-on-october-14-2025-2ca8b313-1946-43d3-b55c-2b95b107f281). Si tu equipo no puede ejecutar Windows 11, considera cambiar a Ubuntu. + Para poder configurar tu computadora, necesitas tener **Windows 10 o Windows 11** instalado. Para chequear la versión de tu Windows: @@ -60,65 +35,54 @@ Para chequear la versión de tu Windows: - Escribe `winver` - Presiona `Enter` -: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: +: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: -:x: Si no es el caso, no puedes continuar. Primero debes actualizar tu versión a Windows 10 :point_down: +:heavy_check_mark: Si las primeras palabras de esta ventana son **Windows 10**, verifica el **número de la versión**: -
- Actualizar a Windows 10 - - - Descarga Windows 10 desde [Microsoft](https://www.microsoft.com/software-download/windows10ISO) - - Instálalo. Debería tomar como una hora pero realmente depende de tu computadora. - - Cuando termine la instalación, ejecuta los comandos de aquí arriba :point_up: para chequear que tengas **Windows 10**. -
+- :heavy_check_mark: Si dice al menos `2004`, entonces todo está bien :+1: -: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. +- :x: Si es inferior a `2004`, debes actualizar tu versión. -:warning: **Si tienes Windows 10 instalado, no necesitas actualizarlo a Windows 11 para hacer esta configuración**. +-
+ Cómo instalar las últimas actualizaciones? -### Últimas actualizaciones + Abre Windows Update: + - Presiona `Windows` + `R` + - Escribe `ms-settings:windowsupdate` + - Presiona `Enter` + - Haz clic en `Check updates` -Una vez que estés seguro de que estés usando Windows 10 o 11, instala las siguientes actualizaciones. + :heavy_check_mark: Si tienes una marca verde y el siguiente mensaje "You're up to date", entonces todo está bien :+1: -Abre Windows Update: -- Presiona `Windows` + `R` -- Escribe `ms-settings:windowsupdate` -- Presiona `Enter` -- Haz clic en `Check updates` + :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: -:heavy_check_mark: Si tienes una marca verde y el siguiente mensaje "You're up to date", entonces todo está bien :+1: + :x: Si obtienes un mensaje de error diciendo que Windows no puede aplicar las actualizaciones, por favor **contacta a un profesor**. -: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: +
+ Activa Windows Update Service para resolver las Actualizaciones -:x: Si obtienes un mensaje de error diciendo que Windows no puede aplicar las actualizaciones, por favor **contacta a un profesor**. + Algunos antivirus y programas deshabilitan las actualizaciones que necesitamos y luego se muestra un error. ¡Solucionemos esto! + - Presiona `Windows` + `R` + - Escribe `services.msc` + - Presiona `Enter` + - Haz doble clic en `Windows Update Service` + - Coloca su `Startup` en `Automatic` + - Haz clic en `Start` + - Haz clic en `Ok` + ¡Ahora intenta instalar las actualizaciones nuevamente! +
-
- Activa Windows Update Service para resolver las Actualizaciones + Verifica el número de la versión: - Algunos antivirus y programas deshabilitan las actualizaciones que necesitamos y luego se muestra un error. ¡Solucionemos esto! - Presiona `Windows` + `R` - - Escribe `services.msc` + - Escribe `winver` - Presiona `Enter` - - Haz doble clic en `Windows Update Service` - - Coloca su `Startup` en `Automatic` - - Haz clic en `Start` - - Haz clic en `Ok` - ¡Ahora intenta instalar las actualizaciones nuevamente! -
- -### Requisito mínimo para la versión - -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. - -- Presiona `Windows` + `R` -- Escribe `winver` -- Presiona `Enter` -Verifica el **número de la versión**: + :heavy_check_mark: Si dice al menos `2004`, entonces todo está bien :+1: -:heavy_check_mark: Si dice al menos `1903`, entonces todo está bien :+1: + :x: Si es inferior a `2004`, por favor **contacta a un profesor**. -:x: Si es inferior a `1903`, por favor **contacta a un profesor**. +
## Virtualización @@ -164,21 +128,17 @@ Normalmente ya es el caso en muchas computadoras. Verifiquemos: 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). -: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: +Instalaremos WSL 2 y Ubuntu con un comando a través de la Windows Command Prompt. -### Windows 11 - -Si usas Windows 11, instalaremos WSL 2 y Ubuntu con un comando a través de la terminal de Windows. - -: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`. +: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`. - Presiona `Windows` + `R` -- Escribe `wt` +- Escribe `cmd` - Presiona **`Ctrl` + `Shift` + `Enter`** :warning: tal vez tengas que aceptar la confirmación UAC sobre el cambio en los privilegios. -Un ventana de terminal azul aparecerá: +Un ventana de terminal aparecerá: - Copia el siguiente comando (`Ctrl` + `C`) - Pégalo en la ventana de la terminal (`Ctrl` + `V` o haciendo clic derecho en la ventana) - Ejecútalo presionado `Enter` @@ -191,11 +151,10 @@ wsl --install :x: Si obtienes un mensaje de error (o si ves algún texto en rojo en la ventana), por favor **contacta a un profesor** -### Windows 10 - -#### Instalación de WSL 1 +
+Solución de problemas para Windows 10 (solo si es necesario, consulta con un profesor) -Si tienes Windows 10, primero instalaremos WSL 1 por medio de la Terminal de PowerShell. +#### Para Windows 10 < 2004: instala primero WSL 1 :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`. @@ -226,7 +185,7 @@ dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /nores :x: Si obtienes un mensaje de error (o si ves algún texto en rojo en la ventada), por favor **contacta a un profesor** -#### Actualización a WSL 2 +#### Para Windows 10 con WSL 1: Actualización a WSL 2 Si tienes Windows 10, actualizaremos WSL a la versión 2. @@ -244,7 +203,7 @@ Cuando se reinicie tu computadora, descarga el instalador de WSL2. :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. -#### Coloca WSL 2 como el Subsistema Windows por defecto para Linux +#### Para Windows 10 con WSL 1: Coloca WSL 2 como el Subsistema Windows por defecto para Linux Si tienes Windows 10, pondremos la versión predeterminada de WSL en 2. @@ -277,18 +236,20 @@ wsl --set-default-version 2 :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:
+ + ## Ubuntu ### Instalación -: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: - -#### 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. -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. +
+Solución de problemas para Windows 10 (solo si es necesario, consulta con un profesor) -#### Windows 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. +
Si tienes Windows 10, instala la terminal de Windows por medio de la Microsoft Store: @@ -314,6 +275,8 @@ Si tienes Windows 10, instala la terminal de Windows por medio de la Microsoft S Cuando termine la instalación, el botón `Get` se transformará en un botón `Open`: Haz clic en él. + + ### Primer uso La primera vez que lo abras, te pedirán que: @@ -327,8 +290,6 @@ La primera vez que lo abras, te pedirán que: :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. -Ahora puedes cerrar la ventana de Ubuntu ya que está instalado en tu computadora. - ### Chequea la versión WSL de Ubuntu - Presiona `Windows` + `R` @@ -357,7 +318,6 @@ wsl -l -v :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. :x: Si no funciona, tendremos que asegurarnos de que los archivos de Ubuntu no estén comprimidos. -
Chequea si los archivos no están comprimidos @@ -378,6 +338,20 @@ wsl -l -v Ya puedes cerrar la ventana de la terminal. +
+ +### Comprueba tu nombre de usuario + +Escribe esto en la terminal de Ubuntu: + +```bash +whoami +``` + +Debería devolver el nombre de usuario que elegiste anteriormente. + +:x: Si dice `root`, **contacta a un profesor** antes de continuar. + ## Visual Studio Code @@ -412,7 +386,7 @@ Luego abre VS Code desde la terminal: code . ``` -:heavy_check_mark: Si ves `WSL: Ubuntu` en una caja verde en la esquina inferior izquierda de la ventana de VS Code, entonces todo está bien y puedes continuar :+1: +:heavy_check_mark: Si ves `WSL: Ubuntu` en la esquina inferior izquierda de la ventana de VS Code, entonces todo está bien y puedes continuar :+1: ![WSL Ubuntu Remote](images/windows_remote_wsl.png) @@ -427,8 +401,10 @@ code . Si estás utilizando Windows 11, la terminal de Windows ya está instalada y puedes ir a la siguiente sección :point_down: +Si tienes Windows 10, instala la terminal de Windows. Verás que es una terminal moderna. -Si tienes Windows 10, instala la terminal de Windows. Verás que es una terminal moderna: +
+**Windows 10**: Instalar Windows Terminal - Haz clic en `Start` - Escribe `Microsoft Store` @@ -453,6 +429,8 @@ Si tienes Windows 10, instala la terminal de Windows. Verás que es una terminal Cuando termine la instalación, el botón `Install` se transformará en un botón `Launch`: haz clic en él. +
+ ### Ubuntu como terminal predeterminada Hagamos que Ubuntu sea la terminal predeterminada de tu aplicación Windows terminal. @@ -486,7 +464,7 @@ Luego deshabilita el warning para copiar y pegar comandos entre Windows y Ubuntu - Agrega la siguiente línea debajo de eso: ```bash -"multiLinePasteWarning": false, +"warning.multiLinePaste": false, ``` :warning: ¡No olvides la coma al final de la línea! @@ -512,22 +490,44 @@ code --install-extension ms-vscode.sublime-keybindings code --install-extension emmanuelbeziat.vscode-great-icons code --install-extension github.github-vscode-theme code --install-extension MS-vsliveshare.vsliveshare -code --install-extension rebornix.ruby +code --install-extension shopify.ruby-lsp code --install-extension dbaeumer.vscode-eslint code --install-extension Rubymaniac.vscode-paste-and-indent code --install-extension alexcvzz.vscode-sqlite +code --install-extension anteprimorac.html-end-tag-labels +code --install-extension marcoroth.herb-lsp +code --install-extension rayhanw.erb-helpers ``` Aquí está la lista de las extensiones que estás instalando: - [Sublime Text Keymap and Settings Importer](https://marketplace.visualstudio.com/items?itemName=ms-vscode.sublime-keybindings) - [VSCode Great Icons](https://marketplace.visualstudio.com/items?itemName=emmanuelbeziat.vscode-great-icons) - [Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare) -- [Ruby](https://marketplace.visualstudio.com/items?itemName=rebornix.Ruby) +- [Ruby](https://marketplace.visualstudio.com/items?itemName=shopify.ruby-lsp) - [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) - [Paste and Indent](https://marketplace.visualstudio.com/items?itemName=Rubymaniac.vscode-paste-and-indent) - [SQLite](https://marketplace.visualstudio.com/items?itemName=alexcvzz.vscode-sqlite) +### Funciones de IA en VS Code + +VS Code incluye muchas y potentes **funciones de IA**, que son una gran herramienta una vez que ya sabes programar. + +Dicho esto, depender de la IA demasiado pronto puede ocultar conceptos importantes y dificultar la comprensión de la depuración. Una vez que estés cómodo con los fundamentos, sabrás cuándo y cómo usar la IA de forma eficaz —sin dejar que haga el trabajo por ti. + +Para el inicio del bootcamp, desactivaremos estas funciones. Llegado el momento apropiado en el curso, las volveremos a habilitar para que puedas utilizarlas bien. + +En **VS Code**: + +1. Abramos la "Paleta de comandos" de VS Code: escribe `Ctrl-Shift-P` (Windows / Linux) o `Cmd-Shift-P` (macOS). +1. Se abrirá la Paleta de comandos: una pequeña caja de texto en la parte superior de la pantalla. Empieza a escribir `aifeatures` hasta que veas "Chat: Learn How to Hide AI features". Haz clic en ella. + ![The Command Palette at the top of the screen](images/vscode_find_aifeatures.png) +1. Esto abrirá la configuración y te mostrará la opción "Disable and hide built-in AI features ...". Marca la casilla delante de esa opción. + ![Check the disable option](images/vscode_disable_aifeatures.png) + +Más adelante, si quieres **volver a habilitar** las funciones de IA, puedes seguir las mismas instrucciones para desmarcar la casilla. + + ### Configuración de Live Share [Visual Studio Live Share](https://visualstudio.microsoft.com/services/live-share/) es una extensión de VS Code que te permite compartir el código en tu editor de texto para debugging y pair-programming: ¡Instalémoslo! @@ -548,6 +548,36 @@ Eso es todo. ¡Ya puedes continuar! ## Herramientas de línea de comando +### Comprueba la configuración regional (locale) + +La "locale" es un mecanismo que permite adaptar los programas a su idioma y país. + +Comprobemos que la configuración regional por defecto es el inglés: + +```bash +locale +``` + +Si la salida no contiene `LANG=en_US.UTF-8`, ejecute el siguiente comando en un Ubuntu terminal para instalar la locale inglesa: + +```bash +sudo locale-gen en_US.UTF-8 +``` + +Si después, recibes una advertencia (`bash: warning: setlocale: LC_ALL: cannot change locale (en_US.utf-8)`) en tu terminal, por favor haz lo siguiente: + +
+ Generar la configuración regional<>/summary> + +Por favor, ejecuta estas líneas en tu terminal. + +```bash +sudo update-locale LANG=en_US.UTF8 +sudo apt-get update +sudo apt-get install language-pack-en language-pack-en-base manpages +``` +
+ ### Zsh & Git En lugar de usar el `bash` [shell](https://en.wikipedia.org/wiki/Shell_(computing)) predeterminado, usaremos `zsh`. @@ -676,6 +706,7 @@ Para asegurarnos de que puedas interactuar desde la terminal de Ubuntu con el na Ejecuta el siguiente comandos: ```bash + echo "export BROWSER=\"/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe\"" >> ~/.zshrc echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'\"" >> ~/.zshrc ``` @@ -707,6 +738,8 @@ CLI es una abreviación de [Command-line Interface](https://en.wikipedia.org/wik En esta sección usaremos [GitHub CLI](https://cli.github.com/) para interactuar directamente con GitHub desde la terminal. +Usaremos la GitHub CLI (`gh`) para conectarnos a GitHub utilizando *SSH*, un protocolo para iniciar la sesión utilizando claves SSH en lugar de la famosa pareja nombre de usuario y contraseña. + Ya debería haberse instalado en tu computadora con los comandos que ejecutaste anteriormente. Lo primero que hay que hacer para **iniciar sesión** es copiar y pegar el comando siguiente en tu terminal: @@ -714,20 +747,18 @@ Lo primero que hay que hacer para **iniciar sesión** es copiar y pegar el coman :warning: **NO edites el `email`** ```bash -gh auth login -s 'user:email' -w +gh auth login -s 'user:email' -w --git-protocol ssh ``` -gh le hará algunas preguntas: - -`What is your preferred protocol for Git operations?` Con las flechas, elige `SSH` y presiona `Enter`. SSH es un protocolo para iniciar la sesión utilizando claves SSH en lugar de la famosa pareja nombre de usuario y contraseña. +`gh` le hará algunas preguntas: -`Generate a new SSH key to add to your GitHub account?` Presiona `Enter` para pedirle a gh que genere las claves SSH por ti. +- `Generate a new SSH key to add to your GitHub account?` Presiona `Enter` para pedirle a gh que genere las claves SSH por ti. -Si ya tienes claves SSH, verás en su lugar `Upload your SSH public key to your GitHub account?`Con las flechas, selecciona la ruta de tu archivo de clave pública y pulsa `Intro`. + Si ya tienes claves SSH, verás en su lugar `Upload your SSH public key to your GitHub account?`Con las flechas, selecciona la ruta de tu archivo de clave pública y pulsa `Intro`. -`Enter a passphrase for your new SSH key (Optional)`. Pon algo que quieras y que recuerdes. Es una contraseña para proteger tu private key que está almacenada en tu disco duro. Luego presiona `Enter`. +- `Enter a passphrase for your new SSH key (Optional)`. Pon algo que quieras y que recuerdes. Es una contraseña para proteger tu private key que está almacenada en tu disco duro. Luego presiona `Enter`. -:warning: Cuando escribas tu passphrase, no verás nada en la pantalla. **Esto es normal**. Es una herramienta de seguridad para ocultar tanto el contenido de tu passphrase como su longitud. Simplemente escribe tu passphrase y presiona `Enter` al terminar. +- `Title for your SSH key`. Puede dejarlo en la propuesta "GitHub CLI", presiona `Enter`. Obtendrás el siguiente resultado: @@ -808,7 +839,7 @@ Ejecuta el instalador de `git`: cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh ``` -:point_up: Esto te **pedirá** tu nombre (`FirstName LastName`) y tu email. +:point_up: Esto te **pedirá** tu nombre (`FirstName LastName`) y tu email. Cualquier correo que elijas se mostrará **públicamente** en internet. 💡 Selecciona la dirección `@users.noreply.github.com` si no quieres que tu correo electrónico aparezca en los repositorios públicos a los que puedas contribuir. :warning: **Necesitas** poner uno de los emails que aparecen arriba gracias al comando anterior `gh api ...`. De lo contrario, Kitt no podrá hacerle seguimiento a tu progreso. @@ -858,7 +889,7 @@ rm -rf ~/.rbenv Luego ejecuta lo siguiente en tu terminal: ```bash -sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev +sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev libyaml-dev ``` ```bash @@ -880,13 +911,13 @@ Ahora estás listo para instalar la última versión de [ruby](https://www.ruby- Corre este comando, **tomará un tiempo (5-10 minutos)** ```bash -rbenv install 3.1.2 +rbenv install 3.3.5 ``` -Cuando la instalación de ruby termine, corre este comando para decirle al sistema que use la versión 3.1.2 por defecto. +Cuando la instalación de ruby termine, corre este comando para decirle al sistema que use la versión 3.3.5 por defecto. ```bash -rbenv global 3.1.2 +rbenv global 3.3.5 ``` **Reinicia** tu terminal y chequea tu versión Ruby: @@ -901,7 +932,7 @@ Luego ejecuta esto: ruby -v ``` -:heavy_check_mark: Si ves algo que comience por `ruby 3.1.2p`, entonces puedes continuar +1: +:heavy_check_mark: Si ves algo que comience por `ruby 3.3.5`, entonces puedes continuar +1: :x: Si no es el caso, **pídele ayuda a un profesor**. @@ -927,10 +958,16 @@ gem sources -l En el universo de ruby, a las librerías externas se les llama `gems`: son pedazos de código ruby que puedes descargar y ejecutar en tu computadora. ¡Instalemos algunas! +Primero, vamos a actualizar `bundler`, que es lo que nos permite instalar gemas: + +```bash +gem update bundler +``` + En tu terminal, copia y pega el siguiente comando: ```bash -gem install colored faker http pry-byebug rake rails rest-client rspec rubocop-performance sqlite3 +gem install colored faker http pry-byebug rake rails:8.1.1 rest-client rspec rubocop-performance sqlite3:2.8.1 activerecord:8.1.1 ruby-lsp ``` :heavy_check_mark: Si obtienes `xx gems installed`, entonces todo está bien :+1: @@ -975,7 +1012,7 @@ Deberías ver una versión. Si no, pídele ayuda a tu profesor. Ahora instala node: ```bash -nvm install 16.15.1 +nvm install 20.17.0 ``` Cuando termine la instalación, corre lo siguiente: @@ -984,7 +1021,7 @@ Cuando termine la instalación, corre lo siguiente: node -v ``` -Si ves `v16.15.1`, the installation succeeded :heavy_check_mark: entonces ahora puedes ejecutar lo siguiente: +Si ves `v20.17.0`, the installation succeeded :heavy_check_mark: entonces ahora puedes ejecutar lo siguiente: ```bash nvm cache clear @@ -1000,10 +1037,16 @@ nvm cache clear En una terminal, ejecuta los siguientes comandos: ```bash -npm install --global yarn +corepack enable +yarn set version stable +``` + +```bash exec zsh ``` +⚠️ Si ves algún mensaje de error, intenta ejecutar `npm install -g corepack` y luego vuelve a ejecutar los comandos anteriores. + Luego ejecuta este comando: ```bash @@ -1022,7 +1065,7 @@ En algunas semanas hablaremos de bases de datos y de SQL. [SQLite](https://sqlit En un terminal, ejecuta los siguientes comandos: ```bash -sudo apt-get install sqlite3 libsqlite3-dev +sudo apt-get install sqlite3 libsqlite3-dev pkg-config ``` A continuación, ejecuta el siguiente comando: @@ -1072,7 +1115,7 @@ echo "sudo /etc/init.d/postgresql start" >> ~/.zshrc Abre una nueva terminal. -:heavy_check_mark: Si ves un mensaje `* Starting PostgreSQL 12 database server`, entonces todo está bien y puedes continuar :+1: +:heavy_check_mark: Si ves un mensaje `* Starting postgresql (via systemctl): postgresql.service` O `* Starting PostgreSQL 14 database server`, entonces todo está bien y puedes continuar :+1: :x: Si no es el caso, **contacta a un profesor**. @@ -1137,7 +1180,11 @@ La idea es tener Slack abierto todo el día para compartir enlaces útiles / ped Para asegurarte de que todo lo relacionado a videollamadas funcione bien, prueba tu cámara y tu micrófono: - Abre la aplicación Slack -- Escribe `/call --test` en la barra de mensaje de cualquier canal y presiona `Enter` +- Haz clic en tu foto de perfil en la esquina superior derecha +- Selecciona "Preferencias" en el menú. +- Haz clic en "Audio y vídeo" en la columna de la izquierda. +- Debajo de "Solución de problemas", haz clic en "Ejecutar una prueba de audio, vídeo y pantalla compartida". La prueba se abrirá en una nueva ventana. +- Comprueba que tus dispositivos preferidos de altavoz, micrófono y cámara aparecen en los menús desplegables y haz clic en "Iniciar prueba" - Haz clic en el botón verde "Start test" ![Chequea el micrófono y la cámara con Slack](images/slack_call_test.png) @@ -1200,12 +1247,11 @@ Ancla lo siguiente: - VS Code - Tu navegador de Internet - Slack -- Zoom ## ¡Fin de la configuración! -Tu computadora está lista para el [curso de Desarrollo Web de Le Wagon](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: +Tu computadora está lista para el [curso de AI Software Development de Le Wagon](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: Disfrútalo, sabemos que te va a ir genial :rocket: diff --git a/windows.fr.md b/windows.fr.md index 2145c9d9..fb652820 100644 --- a/windows.fr.md +++ b/windows.fr.md @@ -1,43 +1,12 @@ # Instructions de configuration -Les instructions ci-dessous vont te permettre de configurer ton ordinateur pour [la formation Développement Web du Wagon](https://www.lewagon.com/web-development-course/full-time). +Les instructions ci-dessous vont te permettre de configurer ton ordinateur pour [la formation AI Software Development du Wagon](https://www.lewagon.com/web-development-course/full-time). **Lis-les attentivement et exécute toutes les commandes dans l’ordre suivant**. En cas de blocage, n’hésite pas à demander au prof :raising_hand: C’est parti :rocket: -## Zoom - -Pour interagir quand on ne sera pas dans la même pièce, on utilisera [Zoom](https://zoom.us), un outil de visioconférence. - -:warning: Si Zoom est déjà installé sur ton ordinateur, vérifie qu’il s’agit au moins de la version **5.6**. - -Va sur [zoom.us/download](https://zoom.us/download). - -Sous **Client Zoom**, clique sur le bouton **Télécharger**. - -Ouvre le fichier que tu viens de télécharger pour installer l’application. - -Ouvre l’application Zoom. - -Si tu as déjà un compte Zoom, connecte-toi avec tes identifiants. - -Sinon, clique sur le lien **Inscrivez-vous, c’est gratuit** : - -![Inscrivez-vous à Zoom, c’est gratuit](images/zoom_sign_up_free.png) - -Sur le site Web de Zoom, remplis le formulaire. - -Une fois que tu as terminé, retourne sur l’application Zoom et connecte-toi avec tes identifiants. - -Tu devrais voir apparaître un écran ressemblant à ça : - -![Écran d’accueil Zoom](images/zoom_home_screen.png) - -Tu peux fermer l’application Zoom. - - ## Compte GitHub Est-ce que tu as déjà un compte GitHub ? Si ce n’est pas le cas, [inscris-toi maintenant](https://github.com/join). @@ -46,6 +15,8 @@ Est-ce que tu as déjà un compte GitHub ? Si ce n’est pas le cas, [inscris-t ![image de GitHub](images/github_picture.png) +:point_right: **[Activez l'authentification à deux facteurs (2FA)](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-text-messages)**. GitHub vous enverra des messages texte avec un code lorsque vous essayez de vous connecter. C'est important pour la sécurité et cela sera bientôt obligatoire pour contribuer du code sur GitHub. + ## Version de Windows @@ -53,6 +24,10 @@ Avant de commencer, on va vérifier que la version de Windows installée sur ton ### Windows 10 ou Windows 11 +> :warning: **Note sur Windows 10 et la sécurité** +> +> La configuration du bootcamp Le Wagon fonctionne sur Windows 10. Cela dit, on recommande fortement de passer à Windows 11. Depuis le 14 octobre 2025, Microsoft a mis fin au support de Windows 10 : il ne reçoit plus de mises à jour de sécurité, ce qui peut exposer ta machine. Pour plus de détails, consulte le [guide de Microsoft](https://support.microsoft.com/en-us/windows/windows-10-support-has-ended-on-october-14-2025-2ca8b313-1946-43d3-b55c-2b95b107f281). Si ton ordinateur ne peut pas exécuter Windows 11, envisage de passer à Ubuntu. + Pour pouvoir configurer ton ordinateur, **Windows 10 ou Windows 11** doit être installé dessus. Pour connaître ta version de Windows : @@ -60,65 +35,55 @@ Pour connaître ta version de Windows : - Saisis `winver` - Appuie sur `Enter` -:heavy_check_mark: Si les premiers mots qui apparaissent dans cette fenêtre sont **Windows 10 ou Windows 11**, c’est bon :+1: +:heavy_check_mark: Si les premiers mots qui apparaissent dans cette fenêtre sont **Windows 11**, c’est bon :+1: -:x: Sinon, tu ne pourras pas utiliser cette configuration. Il faut que tu mettes à jour ton Windows à la version 10 :point_down: +Si les premiers mots qui apparaissent dans cette fenêtre sont **Windows 10**, vérifie le numéro de version: -
- Mise à niveau vers Windows 10 +- :heavy_check_mark: Si la version indique au moins `2004`, c’est bon :+1: - - Télécharge Windows 10 depuis [Microsoft](https://www.microsoft.com/fr-fr/software-download/windows10) - - Installe-le. L’installation devrait prendre une heure environ, mais cela dépend de ton ordinateur - - Une fois l’installation terminée, exécute les commandes ci-dessus pour vérifier que tu es sous **Windows 10** -
+- :x: Sinon, il faut que tu mettes à jour ton Windows. -:information_source: [La mise à jour Windows 11 est toujours en cours de déploiement](https://www.microsoft.com/en-us/windows/get-windows-11), ce qui signifie qu'elle peut être disponible, ou pas, pour ton ordinateur. +-
+ Comment installer les dernières mises à jour -:warning: **Si tu as Windows 10 installé, tu n'as pas besoin de faire la mise à jour Windows 11 pour continuer cette configuration**. + Ouvre Windows Update : + - Appuie sur `Windows` + `R` + - Saisis `ms-settings:windowsupdate` + - Appuie sur `Enter` + - Clique sur « Rechercher les mises à jour » -### Dernières mises à jour + :heavy_check_mark: Si tu vois apparaître une coche verte et le message « Vous êtes à jour », c’est bon :+1: -Une fois que tu as vérifié que tu utilises Windows 10 ou 11, tu vas devoir installer les dernières mises à jour. + :warning: Si tu vois apparaître un point d’exclamation rouge et le message « Mise à jour disponible », installe-la et recommence jusqu’à ce que le message « Vous êtes à jour » apparaisse :loop: -Ouvre Windows Update : -- Appuie sur `Windows` + `R` -- Saisis `ms-settings:windowsupdate` -- Appuie sur `Enter` -- Clique sur « Rechercher les mises à jour » + :x: Si tu vois apparaître un message d’erreur indiquant que Windows ne peut pas appliquer les mises à jour, **demande au prof**. -:heavy_check_mark: Si tu vois apparaître une coche verte et le message « Vous êtes à jour », c’est bon :+1: +
+ Activer le service Windows Update pour corriger les mises à jour -:warning: Si tu vois apparaître un point d’exclamation rouge et le message « Mise à jour disponible », installe-la et recommence jusqu’à ce que le message « Vous êtes à jour » apparaisse :loop: + Certains antivirus et logiciels désactivent le service de mise à jour dont on a besoin, entraînant l’erreur que tu vois apparaître. On va corriger ça ! + - Appuie sur `Windows` + `R` + - Saisis `services.msc` + - Appuie sur `Enter` + - Double-clique sur `Windows Update Service` + - Définis `Startup` sur `Automatic` + - Clique sur `Start` + - Clique sur `Ok` + On va maintenant réessayer d’effectuer les mises à jour. +
-:x: Si tu vois apparaître un message d’erreur indiquant que Windows ne peut pas appliquer les mises à jour, **demande au prof**. + Vérifie le numéro de version : -
- Activer le service Windows Update pour corriger les mises à jour - - Certains antivirus et logiciels désactivent le service de mise à jour dont on a besoin, entraînant l’erreur que tu vois apparaître. On va corriger ça ! - Appuie sur `Windows` + `R` - - Saisis `services.msc` + - Saisis `winver` - Appuie sur `Enter` - - Double-clique sur `Windows Update Service` - - Définis `Startup` sur `Automatic` - - Clique sur `Start` - - Clique sur `Ok` - On va maintenant réessayer d’effectuer les mises à jour. -
- -### Version minimum -Certains des outils qu’on doit installer sont compatibles avec la version `1903` **ou une version ultérieure** de Windows 10 ; on doit donc vérifier que tu as bien cette version au minimum. - -- Appuie sur `Windows` + `R` -- Saisis `winver` -- Appuie sur `Enter` -Vérifie le **numéro de version** : + :heavy_check_mark: Si la version indique au moins `1903`, c’est bon :+1: -:heavy_check_mark: Si la version indique au moins `1903`, c’est bon :+1: + :x: S’il s’agit d’une version antérieure, **demande au prof**. -:x: S’il s’agit d’une version antérieure, **demande au prof**. +
## Virtualisation @@ -165,21 +130,17 @@ C’est déjà le cas sur de nombreux ordinateurs. Vérifions-le : WSL est l’environnement de développement que l’on utilise pour exécuter Ubuntu. Pour en savoir plus sur WSL, [consulte cette page](https://docs.microsoft.com/fr-fr/windows/wsl/faq). -:information_source: Les instructions suivantes dépendent de ta version de Windows. Exécute uniquement les instructions qui correspondent à ta version :point_down: - -### Windows 11 - -Si tu as Windows 11, nous allons installer WSL 2 et Ubuntu en une seule commande via le Windows Terminal. +Nous allons installer WSL 2 et Ubuntu en une seule commande via le Windows Command Prompt. -:warning: Dans les instructions suivantes, utilise la combinaison de touches `Ctrl` + `Shift` + `Enter` pour exécuter **Windows Terminal** en tant qu’administrateur au lieu de cliquer simplement sur `Ok` ou d’appuyer sur `Enter`. +:warning: Dans les instructions suivantes, utilise la combinaison de touches `Ctrl` + `Shift` + `Enter` pour exécuter **Windows Command Prompt** en tant qu’administrateur au lieu de cliquer simplement sur `Ok` ou d’appuyer sur `Enter`. - Appuie sur `Windows` + `R` -- Saisis `wt` +- Saisis `cmd` - Appuie sur **`Ctrl` + `Shift` + `Enter`** :warning: Tu devras peut-être accepter la confirmation UAC concernant l’octroi des droits d’administrateur. -Une fenêtre de terminal bleue apparaîtra : +Une fenêtre de terminal apparaîtra : - Copie la commande suivante (`Ctrl` + `C`) - Colle-la dans la fenêtre du terminal (`Ctrl` + `V` ou en faisant un clic droit dans la fenêtre) - Exécute-les en appuyant sur `Enter` @@ -190,13 +151,12 @@ wsl --install :heavy_check_mark: Si la commande s’exécute sans erreur, redémarre ton ordinateur et suis les instructions ci-dessous :+1: -:x: Si tu obtiens un message d’erreur (ou si tu vois apparaître du texte en rouge dans la fenêtre), **demande au prof** - -### Windows 10 +:x: Si tu obtiens un message d’erreur (ou si tu vois apparaître du texte en rouge dans la fenêtre), **demande au prof**. -#### Installer WSL 1 +
+Dépannage pour Windows 10 (uniquement si nécessaire, vérifie avec un professeur) -Si tu as Windows 10, on va d'abord installer WSL 1 à partir du terminal PowerShell. +#### Pour Windows 10 < 2004 : installer d'abord WSL 1 :warning: Dans les instructions suivantes, utilise la combinaison de touches `Ctrl` + `Shift` + `Enter` pour exécuter **Windows PowerShell** en tant qu’administrateur au lieu de cliquer simplement sur `Ok` ou d’appuyer sur `Enter`. @@ -227,7 +187,7 @@ dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /nores :x: Si tu obtiens un message d’erreur (ou si tu vois apparaître du texte en rouge dans la fenêtre), **demande au prof** -#### Mise à niveau vers WSL 2 +#### Pour Windows 10 avec WSL 1 : Mise à niveau vers WSL 2 Si tu as Windows 10, on va maintenant mettre à jour WSL à la version 2. @@ -245,7 +205,7 @@ Une fois que ton ordinateur a redémarré, on doit télécharger le programme d :x: Si tu obtiens l’erreur « Cette mise à jour s’applique seulement aux machines avec le sous-système Windows pour Linux », **fais un clic droit** sur le programme et sélectionne `uninstall` ; tu devrais pouvoir l’installer normalement cette fois-ci. -#### Définir WSL 2 comme sous-système Windows pour Linux par défaut +#### Pour Windows 10 avec WSL 1 : Définir WSL 2 comme sous-système Windows pour Linux par défaut Si tu as Windows 10, on va enfin définir la version 2 de WSL comme étant la version par défaut. @@ -278,18 +238,19 @@ wsl --set-default-version 2 :information_source: Si tu as Windows 10 **Home edition**, la fonction Hyper-V n'est pas disponible sur ton système d'exploitation. Ce n'est pas bloquant et tu peux continuer à suivre les instructions ci-dessous :ok_hand:
+ + ## Ubuntu ### Installation -:information_source: Les instructions suivantes dépendent de ta version de Windows. N'exécute que les instructions qui correspondent à ta version :point_down: - -#### Windows 11 - 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. -#### Windows 10 +
+Résolution des problèmes pour Windows 10 (uniquement si nécessaire, vérifie avec un TA) + +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. Si tu as Windows 10, installons Ubuntu via le Microsoft Store : @@ -315,6 +276,8 @@ Si tu as Windows 10, installons Ubuntu via le Microsoft Store : Une fois l’installation terminée, le bouton « Installer » se transforme en bouton « Lancer » ; clique dessus. +
+ ### Premier lancement Au premier lancement, on te demandera de fournir des informations : @@ -358,7 +321,6 @@ wsl -l -v :heavy_check_mark: Au bout de quelques secondes, tu devrais voir apparaître le message suivant : `The conversion is complete`. :x: Si ce n’est pas le cas, il faut vérifier que les fichiers Ubuntu ne sont pas compressés. -
Vérifier que les fichiers sont décompressés @@ -379,6 +341,20 @@ wsl -l -v Tu peux maintenant fermer cette fenêtre de terminal. +
+ +### Vérifier ton nom d'utilisateur + +Tape cette commande dans le terminal Ubuntu : + +```bash +whoami +``` + +Cela devrait renvoyer le nom d'utilisateur que tu as choisi précédemment. + +:x: Si cela affiche `root`, **contacte un TA** avant de continuer ! + ## Visual Studio Code @@ -411,7 +387,7 @@ Then open VS Code from your terminal: code . ``` -:heavy_check_mark: Si tu vois `WSL: Ubuntu` dans une case verte dans le coin inférieur gauche de la fenêtre VS Code, c'est tout bon :+1: +:heavy_check_mark: Si tu vois `WSL: Ubuntu` dans le coin inférieur gauche de la fenêtre VS Code, c'est tout bon :+1: ![WSL Ubuntu Remote](images/windows_remote_wsl.png) @@ -426,7 +402,10 @@ code . Si tu as Windows 11, le Windows Terminal est déjà installé et tu peux passer à la section suivante :point_down: -Si tu as Windows 10, nous allons installer le Windows Terminal, un terminal vraiment moderne : +Si tu as Windows 10, nous allons installer le Windows Terminal, un terminal vraiment moderne. + +
+Windows 10: Installer le Windows Terminal - Clique sur `Démarrer` - Saisis `Microsoft Store` @@ -451,6 +430,8 @@ Si tu as Windows 10, nous allons installer le Windows Terminal, un terminal vrai Une fois l’installation terminée, le bouton « Installer » se transforme en bouton « Lancer » ; clique dessus. +
+ ### Définir Ubuntu comme terminal par défaut On va définir Ubuntu comme terminal par défaut de ton application Windows Terminal. @@ -484,7 +465,7 @@ On va ensuite désactiver les avertissements pour les commandes de copier-coller - Ajoute la ligne suivante après : ```bash -"multiLinePasteWarning": false, +"warning.multiLinePaste": false, ``` :warning: N’oublie pas la virgule à la fin de la ligne ! @@ -510,22 +491,44 @@ Copie-colle les commandes suivantes dans le terminal : code --install-extension ms-vscode.sublime-keybindings code --install-extension emmanuelbeziat.vscode-great-icons code --install-extension MS-vsliveshare.vsliveshare -code --install-extension rebornix.ruby +code --install-extension shopify.ruby-lsp code --install-extension dbaeumer.vscode-eslint code --install-extension Rubymaniac.vscode-paste-and-indent code --install-extension alexcvzz.vscode-sqlite +code --install-extension anteprimorac.html-end-tag-labels +code --install-extension marcoroth.herb-lsp +code --install-extension rayhanw.erb-helpers ``` Voici la liste des extensions que tu es en train d'installer : - [Sublime Text Keymap and Settings Importer](https://marketplace.visualstudio.com/items?itemName=ms-vscode.sublime-keybindings) - [VSCode Great Icons](https://marketplace.visualstudio.com/items?itemName=emmanuelbeziat.vscode-great-icons) - [Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare) -- [Ruby](https://marketplace.visualstudio.com/items?itemName=rebornix.Ruby) +- [Ruby](https://marketplace.visualstudio.com/items?itemName=shopify.ruby-lsp) - [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) - [Paste and Indent](https://marketplace.visualstudio.com/items?itemName=Rubymaniac.vscode-paste-and-indent) - [SQLite](https://marketplace.visualstudio.com/items?itemName=alexcvzz.vscode-sqlite) +### Fonctionnalités IA de VS Code + +VS Code inclut de nombreuses **fonctionnalités d'IA** puissantes, qui sont un excellent outil une fois que vous savez déjà coder. + +Cela dit, s'appuyer sur l'IA trop tôt peut masquer des concepts importants et rendre le débogage plus difficile à comprendre. Une fois à l'aise avec les fondamentaux, vous saurez quand et comment utiliser l'IA efficacement — sans lui laisser faire la réflexion à votre place. + +Pour le début du bootcamp, nous allons désactiver ces fonctionnalités. Au bon moment du cours, nous les réactiverons afin que vous puissiez les utiliser à bon escient. + +Dans **VS Code** : + +1. Ouvrez la "Palette de commandes" de VS Code : tapez `Ctrl-Shift-P` (Windows / Linux) ou `Cmd-Shift-P` (macOS). +1. La Palette de commandes s'ouvrira : une petite zone de texte en haut de l'écran. Commencez à taper `aifeatures` jusqu'à voir "Chat: Learn How to Hide AI features". Cliquez dessus. + ![La palette de commandes en haut de l'écran](images/vscode_find_aifeatures.png) +1. Cela ouvrira les paramètres et affichera l'option "Disable and hide built-in AI features ...". Cochez la case devant cette option. + ![Cochez l'option de désactivation](images/vscode_disable_aifeatures.png) + +Plus tard, si vous souhaitez **réactiver** les fonctionnalités d'IA, vous pouvez suivre les mêmes instructions pour décocher la case. + + ### Configuration de Live Share [Visual Studio Live Share](https://visualstudio.microsoft.com/services/live-share/) est une extension de VS Code, qui te permet de partager du code dans ton éditeur de texte pour débugger et faire de la programmation en binôme. Configurons-le ! @@ -546,6 +549,36 @@ C’est bon ! ## Outils en ligne de commande +### Vérifier la locale + +Le concept de "locale" permet de personnaliser les programms en fonction de ta langue et ton pays. + +Vérifions que la locale est bien en **anglais** dans le terminal : + +```bash +locale +``` + +Si la commande ne renvoie pas quelque chose qui contient `LANG=en_US.UTF-8`, lance ceci dans un terminal Ubuntu : + +```bash +sudo locale-gen en_US.UTF-8 +``` + +Si après, tu reçois un avertissement (`bash: warning: setlocale: LC_ALL: cannot change locale (en_US.utf-8)`) dans ton terminal, veuillez faire ce qui suit : + +
+ Générer la localisation + +Veuillez exécuter ces lignes dans ton terminal. + +```bash +sudo update-locale LANG=en_US.UTF8 +sudo apt-get update +sudo apt-get install language-pack-en language-pack-en-base manpages +``` +
+ ### Zsh & Git Au lieu d’utiliser le [shell](https://fr.wikipedia.org/wiki/Interface_syst%C3%A8me) `bash` par défaut, nous utiliserons `zsh`. @@ -674,7 +707,8 @@ Si tu obtiens une erreur du type `ls: cannot access...`, exécute la commande su Exécute la commandes : ```bash - echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'\"" + echo "export BROWSER=\"/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe\"" >> ~/.zshrc + echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'\"" >> ~/.zshrc ``` @@ -705,6 +739,8 @@ CLI est l’acronyme de [Command-line Interface](https://en.wikipedia.org/wiki/C Dans cette section, tu vas installer [GitHub CLI](https://cli.github.com/) pour interagir avec GitHub directement depuis le terminal. +Nous allons utiliser GitHub CLI (`gh`) pour nous connecter à GitHub en utilisant *SSH*, un protocole pour s'authentifier en utilisant des clés SSH au lieu de la fameuse paire nom d'utilisateur et mot de passe. + Elle doit déjà être installée sur ton ordinateur grâce aux commandes précédentes. Pour **te connecter**, commence par copier-coller la commande suivante dans ton terminal : @@ -712,20 +748,18 @@ Pour **te connecter**, commence par copier-coller la commande suivante dans ton :warning: **NE modifie PAS `email`** ```bash -gh auth login -s 'user:email' -w +gh auth login -s 'user:email' -w --git-protocol ssh ``` -gh va te poser quelques questions : +`gh` va te poser quelques questions : -`What is your preferred protocol for Git operations?` Avec les flèches, choisis `SSH` et appuie sur `Enter`. SSH est un protocole pour s'authentifier en utilisant des clés SSH au lieu de la fameuse paire nom d'utilisateur et mot de passe. +- `Generate a new SSH key to add to your GitHub account?` Appuie sur `Enter` pour demander à gh de générer les clés SSH pour toi. -`Generate a new SSH key to add to your GitHub account?` Appuie sur `Enter` pour demander à gh de générer les clés SSH pour toi. + Si tu as déjà des clés SSH, tu verras à la place `Upload your SSH public key to your GitHub account?` Avec les flèches, sélectionne le chemain de ta clé publique et appuie sur `Enter`. -Si tu as déjà des clés SSH, tu verras à la place `Upload your SSH public key to your GitHub account?` Avec les flèches, sélectionne le chemain de ta clé publique et appuie sur `Enter`. +- `Enter a passphrase for your new SSH key (Optional)`. Saisis un mot de passe dont tu te souviendras. Ce mot de passe sert à protéger ta clé privée enregistrée sur ton disque sur. Ensuite, appuie sur `Enter`. -`Enter a passphrase for your new SSH key (Optional)`. Saisis un mot de passe dont tu te souviendras. Ce mot de passe sert à protéger ta clé privée enregistrée sur ton disque sur. Ensuite, appuie sur `Enter`. - -:warning: Lorsque tu saisiras ton mot de passe, rien ne s’affichera à l’écran ; **c’est normal**. Il s’agit d’une mesure de sécurité permettant de masquer non seulement les caractères de ton mot de passe, mais aussi sa longueur. Saisis simplement ton mot de passe, puis appuie sur `Enter`. +- `Title for your SSH key`. Tu peux laisser ce qui est proposé par défaut, à savoir "GitHub CLI", appuie sur `Enter`. Tu obtiendras le résultat suivant : @@ -808,7 +842,7 @@ cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh :point_up: On te **demandera** de fournir ton nom (`FirstName LastName`) et ton adresse e-mail. -:warning: Tu **dois** saisir l’une des adresses e-mail indiquées ci-dessus avec la commande `gh api ...` précédente. Sinon, Kitt ne pourra pas suivre tes progrès. +:warning: Tu **dois** saisir l’une des adresses e-mail indiquées ci-dessus avec la commande `gh api ...` précédente. Sinon, Kitt ne pourra pas suivre tes progrès. 💡 Sélectionnez l'adresse `@users.noreply.github.com` si vous ne souhaitez pas que votre adresse e-mail apparaisse dans les dépôts publics auxquels vous pourriez contribuer. **Réinitialise** ton terminal en exécutant : @@ -856,7 +890,7 @@ rm -rf ~/.rbenv Puis dans le terminal, exécute : ```bash -sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev +sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev libyaml-dev ``` ```bash @@ -878,14 +912,14 @@ Tu peux maintenant installer la dernière version de [ruby](https://www.ruby-lan Exécute cette commande ; cela **peut prendre un moment (5-10 minutes)** ```bash -rbenv install 3.1.2 +rbenv install 3.3.5 ``` Une fois que l’installation de Ruby est terminée, exécute cette commande pour indiquer au système -d’utiliser la version 3.1.2 par défaut. +d’utiliser la version 3.3.5 par défaut. ```bash -rbenv global 3.1.2 +rbenv global 3.3.5 ``` **Réinitialise** ton ton terminal et vérifie ta version de Ruby : @@ -900,7 +934,7 @@ Puis exécute : ruby -v ``` -:heavy_check_mark: Si tu vois apparaître un message commençant par `ruby 3.1.2p`, tu peux continuer :+1: +:heavy_check_mark: Si tu vois apparaître un message commençant par `ruby 3.3.5`, tu peux continuer :+1: :x: Sinon, **demande au prof** @@ -926,10 +960,16 @@ gem sources -l Dans l’environnement ruby, les bibliothèques externes sont appelées des `gems` : ce sont des bouts de code ruby, que tu peux télécharger et exécuter sur ton ordinateur. On va en installer quelques-unes. +Tout d'abord, nous allons mettre à jour `bundler`, ce qui nous permet d'installer des gemmes : + +```bash +gem update bundler +``` + Copie-colle la commande suivante dans ton terminal : ```bash -gem install colored faker http pry-byebug rake rails rest-client rspec rubocop-performance sqlite3 +gem install colored faker http pry-byebug rake rails:8.1.1 rest-client rspec rubocop-performance sqlite3:2.8.1 activerecord:8.1.1 ruby-lsp ``` :heavy_check_mark: Si tu vois apparaître `xx gems installed`, c’est bon :+1: @@ -974,7 +1014,7 @@ Tu devrais voir apparaître une version. Sinon, demande au prof. On va maintenant installer node : ```bash -nvm install 16.15.1 +nvm install 20.17.0 ``` Une fois l’installation terminée, exécute : @@ -983,7 +1023,7 @@ Une fois l’installation terminée, exécute : node -v ``` -Si tu vois apparaître `v16.15.1`, l'installation a réussi :heavy_check_mark: Tu peux alors exécuter : +Si tu vois apparaître `v20.17.0`, l'installation a réussi :heavy_check_mark: Tu peux alors exécuter : ```bash nvm cache clear @@ -999,10 +1039,16 @@ nvm cache clear Exécute les commandes suivantes dans le terminal : ```bash -npm install --global yarn +corepack enable +yarn set version stable +``` + +```bash exec zsh ``` +⚠️ Si tu rencontres des messages d'erreur, essaye d'exécuter `npm install -g corepack` puis exécute à nouveau les commandes ci-dessus. + Puis exécute la commande suivante : ```bash @@ -1021,7 +1067,7 @@ Dans quelques semaines, on abordera les bases de données et le SQL. [SQLite](ht Dans un terminal, exécute la commande suivante : ```bash -sudo apt-get install sqlite3 libsqlite3-dev +sudo apt-get install sqlite3 libsqlite3-dev pkg-config ``` Puis exécute celle-ci : @@ -1071,7 +1117,7 @@ echo "sudo /etc/init.d/postgresql start" >> ~/.zshrc Ouvre un nouveau terminal. -:heavy_check_mark: Si tu vois apparaître le message `* Starting PostgreSQL 12 database server`, c’est bon :+1: +:heavy_check_mark: Si tu vois apparaître le message `* Starting postgresql (via systemctl): postgresql.service` OU `* Starting PostgreSQL 14 database server`, c’est bon :+1: :x: Sinon, **demande au prof**. @@ -1136,8 +1182,11 @@ L’idée est de laisser Slack ouvert toute la journée pour partager des liens On va vérifier que tout fonctionne correctement ; pour cela, on va tester ta caméra et ton microphone : - Ouvre l’application Slack -- Dans la barre de message de n’importe quel channel, saisis `/call --test` et appuie sur `Enter` -- Clique sur le bouton vert « Démarrer le test » +- Clique sur ta photo de profil en haut à droite +- Clique sur `Preferences` depuis le menu +- Séléctionne `Audio & video` dans la colonne de gauche +- En dessous de `Troubleshooting`, clique sur `Run an audio, video and screensharing test`. Le test va s’ouvrir dans une nouvelle fenêtre +- Vérifie que ton microphone, caméra, et enceintes soient bien séléctionnés, puis clique sur `Start test` ![Vérifier le fonctionnement du microphone et de la webcam avec Slack](images/slack_call_test.png) @@ -1199,12 +1248,11 @@ Tu dois épingler : - VS Code - ton navigateur Internet - Slack -- Zoom ## La configuration est terminée ! -Ton ordinateur est prêt pour [la formation Développement Web du Wagon](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: +Ton ordinateur est prêt pour [la formation AI Software Development du Wagon](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: Profite du bootcamp, tu vas assurer :rocket: diff --git a/windows.md b/windows.md index a540e469..2c68c6cb 100644 --- a/windows.md +++ b/windows.md @@ -1,6 +1,6 @@ # Setup instructions -You will find below the instructions to set up your computer for [Le Wagon Web Development course](https://www.lewagon.com/web-development-course/full-time). +You will find below the instructions to set up your computer for [Le Wagon AI Software Development course](https://www.lewagon.com/web-development-course/full-time). Please **read them carefully and execute all commands in the following order**. @@ -11,37 +11,6 @@ You can also have a look at [our cheatsheets](https://github.com/lewagon/setup/t Let's start :rocket: -## Zoom - -To be able to interact when we are not in the same physical room, we will be using [Zoom](https://zoom.us/), a video conferencing tool. - -:warning: If you already have Zoom installed, please make sure that the version is at least **5.6**. - -Go to [zoom.us/download](https://zoom.us/download). - -Under **Zoom Client** click the **Download** button. - -Open the file you have just downloaded to install the app. - -Open the Zoom app. - -If you already have a Zoom account, sign in using your credentials. - -If not, click on the **Sign Up Free** link: - -![Sign Up Free to Zoom](images/zoom_sign_up_free.png) - -You will be redirected to Zoom's website to complete a form. - -When it's done, go back to the Zoom app and sign in using your credentials. - -You should then see a screen like this: - -![Zoom Home Screen](images/zoom_home_screen.png) - -You can now close the Zoom app. - - ## GitHub account Have you signed up to GitHub? If not, [do it right away](https://github.com/join). @@ -50,6 +19,8 @@ Have you signed up to GitHub? If not, [do it right away](https://github.com/join ![GitHub picture](images/github_picture.png) +:point_right: **[Enable Two-Factor Authentication (2FA)](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-text-messages)**. GitHub will send you text messages with a code when you try to log in. This is important for security and also will soon be required in order to contribute code on GitHub. + ## Windows version @@ -57,6 +28,10 @@ Before we start, we need to check that the version of Windows installed on your ### Windows 10 or Windows 11 +> :warning: **Note on Windows 10 and security** +> +> The Le Wagon bootcamp setup works on Windows 10. That said, we highly recommend to upgrade to Windows 11. Since October 14th, 2025, Microsoft has ended support for Windows 10, which means it will no longer receive security updates, potentially putting your machine at risk. For more details, read [Microsoft's guide](https://support.microsoft.com/en-us/windows/windows-10-support-has-ended-on-october-14-2025-2ca8b313-1946-43d3-b55c-2b95b107f281). In case your machine can't run Windows 11, consider switching to Ubuntu. + To be able to set up your computer, you need to have **Windows 10 or Windows 11** installed. To check your Windows version: @@ -64,65 +39,54 @@ To check your Windows version: - Type `winver` - Press `Enter` -:heavy_check_mark: If the first words of this window are **Windows 10 or Windows 11** you're good to go :+1: +:heavy_check_mark: If the first words of this window are **Windows 11** you're good to go :+1: -:x: If not, you cannot proceed with this setup. You have to upgrade to Windows 10 first :point_down: +If the first words of this window are **Windows 10**, check the **Version number**: -
- Upgrade to Windows 10 +- :heavy_check_mark: If it says at least `2004`, you are good to go :+1: - - Download Windows 10 from [Microsoft](https://www.microsoft.com/software-download/windows10ISO) - - Install it. It should take roughly an hour, but this depends on your computer. - - When the installation is over, execute the commands above :point_up: to check that you now have **Windows 10**. -
+- :x: If it is below `2004`, you need to run an update. -:information_source: [Windows 11 upgrade is rolling out now](https://www.microsoft.com/en-us/windows/get-windows-11), which means it may or may not be available for your computer just yet. +-
+ How to install updates? -:warning: **If you have Windows 10 installed, you don't need to upgrade to Windows 11 to proceed with this setup**. + Open Windows Update: + - Press `Windows` + `R` + - Type `ms-settings:windowsupdate` + - Press `Enter` + - Click on `Check updates` -### Latest updates + :heavy_check_mark: If you see a green check mark and the message "You're up to date", you're good to go :+1: -Once you're sure that you're using Windows 10 or 11, you need to install all the latest updates. + :warning: If you have a red exclamation mark and the message "Update available", please install them and repeat the process until it says that you are up to date :loop: -Open Windows Update: -- Press `Windows` + `R` -- Type `ms-settings:windowsupdate` -- Press `Enter` -- Click on `Check updates` + :x: If you have an error message about Windows not being able to apply updates, please **contact a teacher**. -:heavy_check_mark: If you see a green check mark and the message "You're up to date", you're good to go :+1: +
+ Activate Windows Update Service to fix Updates -:warning: If you have a red exclamation mark and the message "Update available", please install them and repeat the process until it says that you are up to date :loop: + Some antiviruses and pieces of software deactivate the Update service we need, resulting in the error you see. Let's fix that! + - Press `Windows` + `R` + - Type `services.msc` + - Press `Enter` + - Double Click `Windows Update Service` + - Set its `Startup` to `Automatic` + - Click on `Start` + - Click on `Ok` + Then let's try updates again! +
-:x: If you have an error message about Windows not being able to apply updates, please **contact a teacher**. + Check the version number again: -
- Activate Windows Update Service to fix Updates - - Some antiviruses and pieces of software deactivate the Update service we need, resulting in the error you see. Let's fix that! - Press `Windows` + `R` - - Type `services.msc` + - Type `winver` - Press `Enter` - - Double Click `Windows Update Service` - - Set its `Startup` to `Automatic` - - Click on `Start` - - Click on `Ok` - Then let's try updates again! -
- -### Minimum version -Some of the tools we need to install have been release with the `1903` version **or above** of Windows 10 so we need to make sure you have at least this one. + :heavy_check_mark: If it says at least `2004`, you are good to go :+1: -- Press `Windows` + `R` -- Type `winver` -- Press `Enter` - -Check the **Version number**: - -:heavy_check_mark: If it says at least `1903`, you are good to go :+1: + :x: If it is below `2004`, **contact a TA**. -:x: If it is below `1903`, please **contact a teacher**. +
## Virtualization @@ -168,21 +132,17 @@ For many computers, this is already the case. Let's check: WSL is the development environment we are using to run Ubuntu. You can learn more about WSL [here](https://docs.microsoft.com/en-us/windows/wsl/faq). -:information_source: The following instructions depend on your version of Windows. Please execute only the instructions corresponding to your version :point_down: +We will install WSL 2 and Ubuntu in one command through the Windows Command Prompt. -### Windows 11 - -If you are running Windows 11, we will install WSL 2 and Ubuntu in one command through the Windows Terminal. - -:warning: In the following instruction, please be aware of the `Ctrl` + `Shift` + `Enter` key stroke to execute **Windows Terminal** with administrator privileges instead of just clicking on `Ok`or pressing `Enter`. +:warning: In the following instruction, please be aware of the `Ctrl` + `Shift` + `Enter` key stroke to execute **Windows Command Prompt** with administrator privileges instead of just clicking on `Ok`or pressing `Enter`. - Press `Windows` + `R` -- Type `wt` +- Type `cmd` - Press **`Ctrl` + `Shift` + `Enter`** :warning: You may have to accept the UAC confirmation about the privilege elevation. -A blue terminal window will appear: +A black terminal window will appear: - Copy the following command (`Ctrl` + `C`) - Paste it into the terminal window (`Ctrl` + `V` or by right-clicking in the window) - Run it by pressing `Enter` @@ -193,13 +153,13 @@ wsl --install :heavy_check_mark: If the command ran without any error, please restart your computer and continue below :+1: -:x: If you encounter an error message (or if you see some text in red in the window), please **contact a teacher** - -### Windows 10 +:x: If you encounter an error message (or if you see some text in red in the window), please **contact a teacher**. -#### Install WSL 1 +
+Troubleshooting for Windows 10 (only if needed, check with a TA) + -If you are running Windows 10, we will first install WSL 1 through the PowerShell Terminal. +#### For Windows 10 < 2004: install WSL 1 first :warning: In the following instruction, please be aware of the `Ctrl` + `Shift` + `Enter` key stroke to execute **Windows PowerShell** with administrator privileges instead of just clicking on `Ok`or pressing `Enter`. @@ -230,7 +190,7 @@ dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /nores :x: If you encounter an error message (or if you see some text in red in the window), please **contact a teacher** -#### Upgrade to WSL 2 +#### For Windows 10 users running WSL 1: Upgrade to WSL 2 If you are running Windows 10, we will then upgrade WSL to version 2. @@ -248,7 +208,7 @@ Once your computer has restarted, we need to download the WSL2 installer. :x: If you encounter the error "This update only applies to machines with the Windows Subsystem for Linux", **right click** on the program and select `uninstall`; you shall be able to install it normally this time. -#### Make WSL 2 the default Windows Subsystem for Linux +#### For Windows 10 users running WSL 1: Make WSL 2 the default Windows Subsystem for Linux If you are running Windows 10, we will set WSL default version to 2. @@ -281,18 +241,20 @@ wsl --set-default-version 2 :information_source: If you are running Windows 10 **Home edition**, Hyper-V feature is not available for your operating system. It's non-blocking and you can still continue to follow the instructions below :ok_hand:
+ + ## Ubuntu ### Installation -:information_source: The following instructions depend on your version of Windows. Please execute only the instructions corresponding to your version :point_down: +After restarting you computer, you should see a terminal window saying WSL is resuming the Ubuntu installation process. When it's done, Ubuntu will be launched. -#### Windows 11 - -If you are running Windows 11, after restarting you computer, you should see a terminal window saying WSL is resuming the Ubuntu installation process. When it's done, Ubuntu will be launched. +
+Troubleshooting for Windows 10 (only if needed, check with a TA) + -#### Windows 10 +If the Ubuntu installation did not resume, first try it again: launch Powershell or the Command Prompt again and run `wsl --install` again. If you are running Windows 10, let's install Ubuntu throught the Microsoft Store: @@ -318,6 +280,8 @@ If you are running Windows 10, let's install Ubuntu throught the Microsoft Store Once the installation is finished, the `Get` button becomes a `Open` button: click on it. +
+ ### First launch At first launch, you will be asked some information: @@ -331,7 +295,6 @@ At first launch, you will be asked some information: :warning: When you type your password, nothing will show up on the screen, **that's normal**. This is a security feature to mask not only your password as a whole but also its length. Just type your password and when you're done, press `Enter`. -You can close the Ubuntu window now that it is installed on your computer. ### Check the WSL version of Ubuntu @@ -361,7 +324,6 @@ wsl -l -v :heavy_check_mark: After a few seconds, you should get the following message: `The conversion is complete`. :x: If it does not work, we need to be sure that Ubuntu files are not compressed. -
Check for Uncompressed Files @@ -380,7 +342,21 @@ wsl -l -v :x: If the conversion still does not work, please **contact a teacher**.
-You can now close this terminal window. +You can close this terminal now. + + + +### Check your username + +Type this in the Ubuntu terminal: + +```bash +whoami +``` + +It should return the username you chose before. + +:x: It if says `root`, **contact a TA** before continuing! ## Visual Studio Code @@ -416,7 +392,7 @@ Then open VS Code from your terminal: code . ``` -:heavy_check_mark: If you see `WSL: Ubuntu` in a green box in the bottom left corner of the VS Code window, you're good to go :+1: +:heavy_check_mark: If you see `WSL: Ubuntu` in the bottom left corner of the VS Code window, you're good to go :+1: ![WSL Ubuntu Remote](images/windows_remote_wsl.png) @@ -431,7 +407,10 @@ code . If you are running Windows 11, the Windows Terminal is already installed and you can proceed to the next section :point_down: -If you are running Windows 10, let's install Windows Terminal, a real modern terminal: +If you are running Windows 10, let's install Windows Terminal, a real modern terminal. + +
+Windows 10: Install Windows Terminal - Click on `Start` - Type `Microsoft Store` @@ -456,6 +435,8 @@ If you are running Windows 10, let's install Windows Terminal, a real modern ter Once the installation is finished, the `Install` button becomes a `Launch` button: click on it. +
+ ### Ubuntu as the default terminal Let's make Ubuntu the default terminal of your Windows Terminal application. @@ -472,13 +453,13 @@ It should open the terminal settings: You may see an orange circle rather than a penguin as the logo for Ubuntu. -We have circle in red the part you will change: +We have circled in red the part you need to add: ![Windows Terminal JSON settings file](images/windows_terminal_settings_json.png) -First, let's ask Ubuntu to start directly inside your Ubuntu Home Directory instead of the Windows one: -- Locate the entry with both `"name": "Ubuntu",` and `"hidden": false,` -- Add the following line after it: +First, let's ask Ubuntu to start directly inside your Ubuntu Home Directory instead of the Windows one. + +- Place this line inside the { } block that contains "name": "Ubuntu" (like in the screenshot): ```bash "commandline": "wsl.exe ~", @@ -486,12 +467,13 @@ First, let's ask Ubuntu to start directly inside your Ubuntu Home Directory inst :warning: Do not forget the comma at the end of the line! -Then, let's disable warning for copy-pasting commands between Windows and Ubuntu: -- Locate the line `"defaultProfile": "{2c4de342-...}"` +Then, let's disable warnings for copy-pasting commands between Windows and Ubuntu: + +- Locate the line "defaultProfile": "{2c4de342-...}" - Add the following line after it: ```bash -"multiLinePasteWarning": false, +"warning.multiLinePaste": false, ``` :warning: Do not forget the comma at the end of the line! @@ -515,46 +497,47 @@ Copy-paste the following commands in your terminal: ```bash code --install-extension ms-vscode.sublime-keybindings -``` - -```bash code --install-extension emmanuelbeziat.vscode-great-icons -``` - -```bash code --install-extension github.github-vscode-theme -``` - -```bash code --install-extension MS-vsliveshare.vsliveshare -``` - -```bash -code --install-extension rebornix.ruby -``` - -```bash +code --install-extension shopify.ruby-lsp code --install-extension dbaeumer.vscode-eslint -``` - -```bash code --install-extension Rubymaniac.vscode-paste-and-indent -``` - -```bash code --install-extension alexcvzz.vscode-sqlite +code --install-extension anteprimorac.html-end-tag-labels +code --install-extension rayhanw.erb-helpers ``` Here is a list of the extensions you are installing: + - [Sublime Text Keymap and Settings Importer](https://marketplace.visualstudio.com/items?itemName=ms-vscode.sublime-keybindings) - [VSCode Great Icons](https://marketplace.visualstudio.com/items?itemName=emmanuelbeziat.vscode-great-icons) - [Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare) -- [Ruby](https://marketplace.visualstudio.com/items?itemName=rebornix.Ruby) +- [Ruby](https://marketplace.visualstudio.com/items?itemName=shopify.ruby-lsp) - [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) - [Paste and Indent](https://marketplace.visualstudio.com/items?itemName=Rubymaniac.vscode-paste-and-indent) - [SQLite](https://marketplace.visualstudio.com/items?itemName=alexcvzz.vscode-sqlite) +### VS Code AI Features + +VS Code includes many powerful **AI features**, which are a great tool once you already know how to code. + +That said, relying on AI too early can hide important concepts and make debugging harder to understand. Once you’re comfortable with the fundamentals, you’ll know when and how to use AI effectively — without letting it do the thinking for you. + +For the start of the bootcamp, we’ll disable these features. At the right point in the course, we’ll reenable them so you can put them to good use. + +In **VS Code**: + +1. Let's open the VS Code "Command **P**alette": type `Ctrl-Shift-P` (Windows / Linux) or `Cmd-Shift-P` (macOS). +1. This will open the Command Palette: a small text box at the top of your screen. Start typing `aifeatures` until you see "Chat: Learn How to Hide AI features". Click on it. + ![The Command Palette at the top of the screen](images/vscode_find_aifeatures.png) +1. This will open the settings, and will show you the option "Disable and hide built-in AI features ...". Tick the checkbox in front of that option. + ![Check the disable option](images/vscode_disable_aifeatures.png) + +Later, if you want **to reenable** the AI features, you can follow the same instructions to untick the checkbox. + + ### Live Share configuration [Visual Studio Live Share](https://visualstudio.microsoft.com/services/live-share/) is a VS Code extension which allows you to share the code in your text editor for debugging and pair-programming: let's set it up! @@ -575,6 +558,36 @@ That's it, you're good to go! ## Command line tools +### Check the locale + +The locale is a mechanism allowing to customize programs to your language and country. + +Let's verify that the default locale is set to English, please type this in the Ubuntu terminal: + +```bash +locale +``` + +If the output does not contain `LANG=en_US.UTF-8`, run the following command in a Ubuntu terminal to install the english locale: + +```bash +sudo locale-gen en_US.UTF-8 +``` + +If after, you receive a warning (`bash: warning: setlocale: LC_ALL: cannot change locale (en_US.utf-8)`) in your terminal, please do the following: + +
+ Generate locale + +Please, run this lines in your terminal. + +```bash +sudo update-locale LANG=en_US.UTF8 +sudo apt-get update +sudo apt-get install language-pack-en language-pack-en-base manpages +``` +
+ ### Zsh & Git Instead of using the default `bash` [shell](https://en.wikipedia.org/wiki/Shell_(computing)), we will use `zsh`. @@ -667,14 +680,23 @@ To be sure that you can interact with your browser installed on Windows from you ls /mnt/c/Program\ Files\ \(x86\)/Google/Chrome/Application/chrome.exe ``` - If you get an error like `ls: cannot access...` Run the following commands: + Did you get an error like `ls: cannot access...`? + +
+ Yes, I had an error + +Run the following commands: ```bash echo "export BROWSER=\"/mnt/c/Program Files/Google/Chrome/Application/chrome.exe\"" >> ~/.zshrc echo "export GH_BROWSER=\"'/mnt/c/Program Files/Google/Chrome/Application/chrome.exe'\"" >> ~/.zshrc ``` +
- Else run: +
+ No, everything was fine + + Run the following commands: ```bash echo "export BROWSER=\"/mnt/c/Program Files (x86)/Google/Chrome/Application/chrome.exe\"" >> ~/.zshrc @@ -682,6 +704,10 @@ To be sure that you can interact with your browser installed on Windows from you ```
+--- + + +
Mozilla Firefox as your default browser @@ -691,14 +717,24 @@ To be sure that you can interact with your browser installed on Windows from you ls /mnt/c/Program\ Files\ \(x86\)/Mozilla\ Firefox/firefox.exe ``` - If you get an error like `ls: cannot access...` Run the following commands: + Did you get an error like `ls: cannot access...`? + +
+ Yes, I had an error + + Run the following commands: ```bash echo "export BROWSER=\"/mnt/c/Program Files/Mozilla Firefox/firefox.exe\"" >> ~/.zshrc echo "export GH_BROWSER=\"'/mnt/c/Program Files/Mozilla Firefox/firefox.exe'\"" >> ~/.zshrc ``` - Else run: +
+ +
+ No, everything was fine + + Run the following commands: ```bash echo "export BROWSER=\"/mnt/c/Program Files (x86)/Mozilla Firefox/firefox.exe\"" >> ~/.zshrc @@ -706,15 +742,22 @@ To be sure that you can interact with your browser installed on Windows from you ```
+--- + +
+
Microsoft Edge as your default browser Run the commands: ```bash - echo "export BROWSER='\"/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe\"'" >> ~/.zshrc + echo "export BROWSER=\"/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe\"" >> ~/.zshrc echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'\"" >> ~/.zshrc ``` + +--- +
Restart your terminal. @@ -746,25 +789,25 @@ In this section, we will use [GitHub CLI](https://cli.github.com/) to interact w It should already be installed on your computer from the previous commands. +We will use the GitHub CLI (`gh`) to connect to GitHub using *SSH*, a protocol to log in using SSH keys instead of the well known username/password pair. + First in order to **login**, copy-paste the following command in your terminal: :warning: **DO NOT edit the `email`** ```bash -gh auth login -s 'user:email' -w +gh auth login -s 'user:email' -w --git-protocol ssh ``` -gh will ask you few questions: +`gh` will ask you few questions: -`What is your preferred protocol for Git operations?` With the arrows, choose `SSH` and press `Enter`. SSH is a protocol to log in using SSH keys instead of the well known username/password pair. +- `Generate a new SSH key to add to your GitHub account?` Press `Enter` to ask gh to generate the SSH keys for you. -`Generate a new SSH key to add to your GitHub account?` Press `Enter` to ask gh to generate the SSH keys for you. + If you already have SSH keys, you will see instead `Upload your SSH public key to your GitHub account?` With the arrows, select your public key file path and press `Enter`. -If you already have SSH keys, you will see instead `Upload your SSH public key to your GitHub account?` With the arrows, select your public key file path and press `Enter`. +- `Enter a passphrase for your new SSH key (Optional)`. Type something you want and that you'll remember. It's a password to protect your private key stored on your hard drive. Then press `Enter`. -`Enter a passphrase for your new SSH key (Optional)`. Type something you want and that you'll remember. It's a password to protect your private key stored on your hard drive. Then press `Enter`. - -:warning: When you type your passphrase, nothing will show up on the screen, **that's normal**. This is a security feature to mask not only your passphrase as a whole but also its length. Just type your passphrase and when you're done, press `Enter`. +- `Title for your SSH key`. You can leave it at the proposed "GitHub CLI", press `Enter`. You will then get the following output: @@ -859,7 +902,8 @@ cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh :point_up: This will **prompt** you for your name (`FirstName LastName`) and your email. -:warning: You **need** to put one of the email listed above thanks to the previous `gh api ...` command. If you don't do that, Kitt won't be able to track your progress. +:warning: You **need** to put one of the emails listed above thanks to the previous `gh api ...` command. If you don't do that, Kitt won't be able to track your progress. 💡 Select the `@users.noreply.github.com` address if you don't want your email to appear in public repositories you may contribute to. + Please now **reset** your terminal by running: @@ -901,7 +945,7 @@ rm -rf ~/.rbenv Then in the terminal, run: ```bash -sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev +sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev libyaml-dev ``` ```bash @@ -926,14 +970,14 @@ Now, you are ready to install the latest [ruby](https://www.ruby-lang.org/en/) v Run this command, it will **take a while (5-10 minutes)** ```bash -rbenv install 3.1.2 +rbenv install 3.3.5 ``` Once the ruby installation is done, run this command to tell the system -to use the 3.1.2 version by default. +to use the 3.3.5 version by default. ```bash -rbenv global 3.1.2 +rbenv global 3.3.5 ``` **Reset** your terminal and check your Ruby version: @@ -948,7 +992,7 @@ Then run: ruby -v ``` -:heavy_check_mark: If you see something starting with `ruby 3.1.2p` then you can proceed :+1: +:heavy_check_mark: If you see something starting with `ruby 3.3.5` then you can proceed :+1: :x: If not, **ask a teacher** @@ -974,10 +1018,16 @@ gem sources -l In the ruby world, we call external libraries `gems`: they are pieces of ruby code that you can download and execute on your computer. Let's install some! +First, we'll update `bundler`, which is what lets us install gems: + +```bash +gem update bundler +``` + In your terminal, copy-paste the following command: ```bash -gem install colored faker http pry-byebug rake rails rest-client rspec rubocop-performance sqlite3 +gem install colored faker http pry-byebug rake rails:8.1.1 rest-client rspec rubocop-performance sqlite3:2.8.1 activerecord:8.1.1 ruby-lsp ``` :heavy_check_mark: If you get `xx gems installed`, then all good :+1: @@ -1025,7 +1075,7 @@ You should see a version. If not, ask a teacher. Now let's install node: ```bash -nvm install 16.15.1 +nvm install 20.17.0 ``` When the installation is finished, run: @@ -1034,7 +1084,7 @@ When the installation is finished, run: node -v ``` -If you see `v16.15.1`, the installation succeeded :heavy_check_mark: You can then run: +If you see `v20.17.0`, the installation succeeded :heavy_check_mark: You can then run: ```bash nvm cache clear @@ -1050,9 +1100,12 @@ nvm cache clear In a terminal, run the following commands: ```bash -npm install --global yarn +corepack enable +yarn set version stable ``` +⚠️ If you see any error messages, try running `npm install -g corepack` and then run the commands above again. + ```bash exec zsh ``` @@ -1075,7 +1128,7 @@ In a few weeks, we'll talk about databases and SQL. [SQLite](https://sqlite.org/ In a terminal, execute the following commands: ```bash -sudo apt-get install sqlite3 libsqlite3-dev +sudo apt-get install sqlite3 libsqlite3-dev pkg-config ``` Then run the following command: @@ -1109,6 +1162,8 @@ sudo /etc/init.d/postgresql start sudo -u postgres psql --command "CREATE ROLE \"`whoami`\" LOGIN createdb superuser;" ``` +_📝 If you get an error saying `could not change directory to "/home/your_name": Permission denied` that is totally fine, and there's no need to worry 💆 If, on the first run, it says `CREATE ROLE` in the end all worked fine._ + You can configure PostgreSQL to autostart, so you don't have to execute `sudo /etc/init.d/postgresql start` each time you open a new terminal: ```bash @@ -1125,7 +1180,7 @@ echo "sudo /etc/init.d/postgresql start" >> ~/.zshrc Open a new terminal. -:heavy_check_mark: If you see a `* Starting PostgreSQL 14 database server` message, you're good to go :+1: +:heavy_check_mark: If you see a `* Starting postgresql (via systemctl): postgresql.service` OR `* Starting PostgreSQL 14 database server` message, you're good to go :+1: :x: If not, **contact a teacher**. @@ -1153,23 +1208,17 @@ curl -Ls https://raw.githubusercontent.com/lewagon/setup/master/check.rb > _.rb ## Kitt -:warning: If you have received an email from Le Wagon inviting you to sign up on Kitt (our learning platform), you can safely skip this step. Instead, please follow the instructions in the email you received if you haven't done so already. - -If you are unsure about what to do, you can follow [this link](https://kitt.lewagon.com/). If you are already logged in, you can safely skip this section. If you are not logged in, click on `Enter Kitt as a Student`. If you manage to login, you can safely skip this step. Otherwise ask a teacher whether you should have received an email or follow the instructions below. - -Register as a Wagon alumni by going to [kitt.lewagon.com/onboarding](http://kitt.lewagon.com/onboarding). Select your batch, sign in with GitHub and enter all your information. - -Your teacher will then validate that you are indeed part of the batch. You can ask them to do it as soon as you completed the registration form. - -Once the teacher has approved your profile, go to your email inbox. You should have 2 emails: +You should have received an email from Le Wagon inviting you to sign up on [Kitt](https://kitt.lewagon.com) (our learning platform). When submitting your onboarding form on Kitt, you should have received two additional invitations: - One from Slack, inviting you to the Le Wagon Alumni slack community (where you'll chat with your buddies and all the previous alumni). Click on **Join** and fill the information. - One from GitHub, inviting you to `lewagon` team. **Accept it** otherwise you won't be able to access the lecture slides. +If you haven't, please contact your teaching team. + ## Slack -[Slack](https://slack.com/) is a communcation platform pretty popular in the tech industry. +[Slack](https://slack.com/) is a communication platform pretty popular in the tech industry. ### Installation @@ -1190,8 +1239,11 @@ The idea is that you'll have Slack open all day, so that you can share useful li To ensure that everything is working fine for video calls, let's test your camera and microphone: - Open the Slack app -- In any channel message bar type `/call --test` and press `Enter` -- Click on the "Start test" green button +- Click your profile picture in the top right. +- Select `Preferences` from the menu. +- Click `Audio & video` in the left-side column. +- Below `Troubleshooting`, click `Run an audio, video and screensharing test`. The test will open in a new window. +- Check that your preferred speaker, microphone and camera devices appear in the drop-down menus, then click `Start test`. ![Check microphone and webcam with Slack](images/slack_call_test.png) @@ -1253,12 +1305,11 @@ You must pin: - VS Code - Your Internet browser - Slack -- Zoom ## Setup completed! -Your computer is now all set for [Le Wagon Web Development course](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: +Your computer is now all set for [Le Wagon AI Software Development course](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: Enjoy the bootcamp, you will nail it :rocket: diff --git a/windows.pt.md b/windows.pt.md new file mode 100644 index 00000000..277fecaa --- /dev/null +++ b/windows.pt.md @@ -0,0 +1,1312 @@ +# Instruções de configuração + +Você encontrará abaixo as instruções para configurar seu computador para o [curso de AI Software Development Le Wagon](https://www.lewagon.com/web-development-course/full-time). + +Por favor **leia-os com atenção e execute todos os comandos na seguinte ordem**. + +Se você tiver dúvidas, não hesite em pedir ajuda a um professor :raising_hand: + +Você também pode dar uma olhada em [nossas cheatsheets](https://github.com/lewagon/setup/tree/master/docs) para soluções e dicas de problemas comuns :heavy_check_mark: + +Vamos começar :rocket: + + +## Conta GitHub + +Você se inscreveu no GitHub? Caso contrário, [faça isso imediatamente](https://github.com/join). + +:point_right: **[Carregue uma imagem](https://github.com/settings/profile)** e coloque seu nome corretamente em sua conta GitHub. Isso é importante porque usaremos um painel interno com seu avatar. Faça isso **agora**, antes de continuar com este guia. + +![Imagem do GitHub](images/github_picture.png) + +:point_right: [Ative a Autenticação em Duas Etapas (2FA)](https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-text-messages). O GitHub enviará mensagens de texto com um código quando você tentar fazer login. Isso é importante para a segurança e em breve será necessário para contribuir com código no GitHub. + + +## Versão do Windows + +Antes de começarmos, precisamos verificar se a versão do Windows instalada no seu computador é compatível com estas instruções de configuração. + +### Windows 10 ou Windows 11 + +> :warning: **Nota sobre o Windows 10 e segurança** +> +> O setup do bootcamp Le Wagon funciona no Windows 10. Dito isso, recomendamos fortemente a atualização para o Windows 11. A partir de 14 de outubro de 2025, a Microsoft encerrou o suporte ao Windows 10, o que significa que ele não receberá mais atualizações de segurança, potencialmente deixando sua máquina em risco. Para mais detalhes, leia o guia da Microsoft: https://support.microsoft.com/en-us/windows/windows-10-support-has-ended-on-october-14-2025-2ca8b313-1946-43d3-b55c-2b95b107f281. Caso sua máquina não consiga executar o Windows 11, considere mudar para o Ubuntu. + +Para poder configurar seu computador, você precisa ter o **Windows 10 ou Windows 11** instalado. + +Para verificar sua versão do Windows: +- Pressione `Windows` + `R` +- Digite `winver` +- Pressione `Enter` + +:heavy_check_mark: Se as primeiras palavras desta janela forem **Windows 11** você está pronto para prosseguir :+1: + +- :heavy_check_mark: Se as primeiras palavras desta janela forem **Windows 10**, verifique o **Número da versão**:: + +- :x: Caso contrário, você não poderá prosseguir com esta configuração. Você precisa atualizar. + +-
+ Como instalar as últimas atualizações? + + Abra a atualização do Windows: + - Pressione `Windows` + `R` + - Digite `ms-settings:windowsupdate` + - Pressione `Enter` + - Clique em `Verificar atualizações` + + :heavy_check_mark: Se você vir uma marca de seleção verde e a mensagem "Você está atualizado", você está pronto para prosseguir :+1: + + :warning: Se você tiver um ponto de exclamação vermelho e a mensagem "Atualização disponível", instale-os e repita o processo até que apareça que você está atualizado :loop: + + :x: Se você receber uma mensagem de erro sobre o Windows não conseguir aplicar atualizações, **entre em contato com um professor**. + +
+ Ative o Windows Update Service para corrigir atualizações + + Alguns antivírus e softwares desativam o serviço de atualização de que precisamos, resultando no erro que você vê. Vamos consertar isso! + - Pressione `Windows` + `R` + - Digite `services.msc` + - Pressione `Enter` + - Clique duas vezes em `Serviço de atualização do Windows` + - Defina sua `Inicialização` para `Automático` + - Clique em `Iniciar` + - Clique em `Ok` + Então vamos tentar as atualizações novamente! +
+ + + Verifique o Número da versão: + + - Pressione `Windows` + `R` + - Digite `winver` + - Pressione `Enter` + + + :heavy_check_mark: Se disser pelo menos `2004`, você está pronto :+1: + + :x: Se estiver abaixo de `22004`, por favor **entre em contato com um professor**. + +
+ + +## Virtualização + +Precisamos garantir que as opções de virtualização estejam habilitadas no BIOS do seu computador. + +Para muitos computadores, este já é o caso. Vamos checar: +- Pressione `Windows` + `R` +- Digite `taskmgr` +- Pressione `Enter` +- Clique na aba `Desempenho` +- Clique em `CPU` + +![Gerenciador de tarefas do Windows](images/windows_task_manager.png) + +:heavy_check_mark: Se você vir "Virtualização: Ativada", está pronto :+1: + +:x: Se a linha estiver faltando ou se a virtualização estiver desabilitada, por favor **entre em contato com um professor antes de tentar ativar a Virtualização** + +
+ Ativar virtualização + + Precisamos acessar o BIOS/UEFI do computador para ativá-lo. + - Pressione `Windows + R` + - Digite `shutdown.exe /r /o /t 1` + - Pressione `Enter` + - Aguarde o computador desligar + - Clique em `Solucionar problemas` + - Clique em `Opções avançadas` + - Clique em `Configurações de firmware UEFI` + - Clique em `Reiniciar` + + Você precisa ativar a opção de virtualização para o seu processador aqui: + - Na maioria das vezes, nas configurações avançadas, nas configurações da CPU ou nas configurações do Northbridge + - A opção pode ter um nome diferente de acordo com o seu computador: + - Intel: `Intel VT-x`, `Tecnologia de virtualização Intel`, `Extensões de virtualização`, `Vanderpool`... + - AMD: `Modo SVM` ou `AMD-V` + - Salve as alterações após a ativação e reinicie o computador através da opção apropriada +
+ + +## Subsistema Windows para Linux (WSL) + +WSL é o ambiente de desenvolvimento que usamos para executar o Ubuntu. Você pode aprender mais sobre WSL [aqui](https://docs.microsoft.com/en-us/windows/wsl/faq). + +Instalaremos o WSL 2 e o Ubuntu em um comando através do Windows Command Prompt. + +:warning: Nas instruções a seguir, esteja ciente do pressionamento de tecla `Ctrl` + `Shift` + `Enter` para executar o **Windows Command Prompt** com privilégios de administrador em vez de apenas clicar em `Ok` ou pressionar `Enter` . + +- Pressione `Windows` + `R` +- Digite `cmd` +- Pressione **`Ctrl` + `Shift` + `Enter`** + +:warning: Você pode ter que aceitar a confirmação do UAC sobre a elevação de privilégio. + +Uma janela de terminal aparecerá: +- Copie o seguinte comando (`Ctrl` + `C`) +- Cole-o na janela do terminal (`Ctrl` + `V` ou clicando com o botão direito na janela) +- Execute-o pressionando `Enter` + +```powershell +wsl --install +``` + +:heavy_check_mark: Se o comando foi executado sem nenhum erro, reinicie o computador e continue abaixo :+1: + +:x: Se você encontrar uma mensagem de erro (ou se vir algum texto em vermelho na janela), por favor **entre em contato com um professor** + +
+Solução de problemas para Windows 10 (apenas se necessário, consulte um professor) + +#### Para Windows 10 < 2004: instale o WSL 1 primeiro + +:warning: Nas instruções a seguir, esteja ciente do pressionamento de tecla `Ctrl` + `Shift` + `Enter` para executar o **Windows PowerShell** com privilégios de administrador em vez de apenas clicar em `Ok` ou pressionar `Enter` . + +- Pressione `Windows` + `R` +- Digite `powershell` +- Pressione **`Ctrl` + `Shift` + `Enter`** + +:warning: Você pode ter que aceitar a confirmação do UAC sobre a elevação de privilégio. + +Uma janela de terminal azul aparecerá: +- Copie os seguintes comandos um por um (`Ctrl` + `C`) +- Cole-os na janela do PowerShell (`Ctrl` + `V` ou clicando com o botão direito na janela) +- Execute-os pressionando `Enter` + +```powershell +Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux +``` + +```powershell +dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart +``` + +```powershell +dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart +``` + +:heavy_check_mark: Se todos os três comandos foram executados sem nenhum erro, reinicie o computador e continue abaixo :+1: + +:x: Se você encontrar uma mensagem de erro (ou se vir algum texto em vermelho na janela), por favor **entre em contato com um professor** + +#### Para Windows 10 com WSL 1: Atualizar para WSL 2 + +Se você estiver executando o Windows 10, atualizaremos o WSL para a versão 2. + +Assim que o computador for reiniciado, precisamos baixar o instalador WSL2. + +- Vá para a [página de download](https://aka.ms/wsl2kernel) +- Baixe o "pacote de atualização do kernel WSL2 Linux" +- Abra o arquivo que você acabou de baixar +- Clique em `Avançar` +- Clique em `Concluir` + +![Atualize WSL da versão 1 para 2](images/windows_update_wsl.png) + +:heavy_check_mark: Se não encontrou nenhuma mensagem de erro, você está pronto :+1: + +:x: Se você encontrar o erro "Esta atualização se aplica apenas a máquinas com o subsistema Windows para Linux", **clique com o botão direito** no programa e selecione `uninstall`; você poderá instalá-lo normalmente desta vez. + +#### Para Windows 10 com WSL 1: Torne o WSL 2 o subsistema Windows padrão para Linux + +Se você estiver executando o Windows 10, definiremos a versão padrão do WSL como 2. + +Agora que o WSL 2 está instalado, vamos torná-lo a versão padrão: +- Pressione `Windows` + `R` +- Digite `cmd` +- Pressione `Enter` + +Na janela que aparece, digite: + +```bash +wsl --set-default-version 2 +``` + +:heavy_check_mark: Se você vir "A operação foi concluída com sucesso", você pode fechar este terminal e continuar seguindo as instruções abaixo :+1: + +:x: Se a mensagem que você receber for sobre Virtualização, por favor **entre em contato com um professor** + +
+ Ativar recurso Windows da Plataforma de Máquina Virtual + + Siga as etapas descritas [aqui](https://www.configserverfirewall.com/windows-10/please-enable-the-virtual-machine-platform-windows-feature-and-ensure-virtualization-is-enabled-in- the-bios/#:~:text=To%20enable%20WSL%202,%20Open,Windows%20feature%20on%20or%20off.&text=Garanta%20que%20the%20Virtual%20Machine,Windows%20will%20enable%20WSL %202) até você ativar a Plataforma de Máquina Virtual e o Subsistema Windows para Linux +
+ +
+ Ativar recurso Hyper-V do Windows + + Siga as etapas descritas [aqui](https://winaero.com/enable-use-hyper-v-windows-10/) até ativar o grupo Hyper-V + + :information_source: Se você estiver executando o Windows 10 **Home edition**, o recurso Hyper-V não estará disponível para o seu sistema operacional. Não bloqueia e você ainda pode continuar seguindo as instruções abaixo :ok_hand: +
+ +
+ + +## Ubuntu + +### Instalação + +Após reiniciar o computador, você deverá ver uma janela de terminal informando que o WSL está retomando o processo de instalação do Ubuntu. Quando terminar, o Ubuntu será lançado. + +
+Solução de problemas para Windows 10 (apenas se necessário, consulte um TA) + +Se a instalação do Ubuntu não foi retomada, tente novamente: abra o Powershell ou o Prompt de Comando e execute `wsl --install` novamente. + +Se você estiver executando o Windows 10, vamos instalar o Ubuntu através da Microsoft Store: + +- Clique em `Iniciar` +- Digite `Microsoft Store` +- Clique em `Microsoft Store` na lista +- Procure por `Ubuntu` na barra de pesquisa +- **Selecione a versão sem nenhum número, simplesmente "Ubuntu"** +- Clique em `Obter` + +:warning: Não instale **Ubuntu 18.04 LTS** nem **Ubuntu 20.04**! + +
+ Desinstale versões erradas do Ubuntu + + Para desinstalar uma versão errada do Ubuntu, basta ir até a Lista de Programas Instalados do Windows 10: + - Pressione `Windows` + `R` + - Digite `ms-settings:appsfeatures` + - Pressione `Enter` + + Encontre o software para desinstalar e clique no botão desinstalar. +
+ +Assim que a instalação for concluída, o botão `Get` se torna um botão `Open`: clique nele. + +### Executando pela primeira vez + +Na primeira execução, serão solicitadas algumas informações: +- Escolha um nome de **usuário**: + - uma palavra + - minúsculas + - sem caracteres especiais + - por exemplo: `lewagon` ou seu `nome` +- Escolha uma **senha** +- Confirme sua senha + +:warning: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`. + +Você pode fechar a janela do Ubuntu agora que ele está instalado no seu computador. + +### Verifique a versão WSL do Ubuntu + +- Pressione `Windows` + `R` +- Digite `cmd` +- Pressione `Enter` + +Digite o seguinte comando: + +```bash +wsl -l -v +``` + +:heavy_check_mark: Se a versão do Ubuntu WSL for 2, você está pronto :+1: + +:x: Se a versão do Ubuntu WSL for 1, precisaremos convertê-lo para a versão 2. + +
+ Converter Ubuntu WSL V1 em V2 + + Na janela do prompt de comando, digite: + + ```bash + wsl --set-version Ubuntu 2 + ``` + + :heavy_check_mark: Após alguns segundos, você deverá receber a seguinte mensagem: `A conversão foi concluída`. + + :x: Se não funcionar, precisamos ter certeza de que os arquivos do Ubuntu não estão compactados. +
+ +
+ Verificar arquivos descompactados + + - Pressione `Windows` + `R` + - Digite `%localappdata%\Packages` + - Pressione `Enter` + - Abra a pasta chamada `CanonicalGroupLimited.UbuntuonWindows...` + - Clique com o botão direito na pasta `LocalState` + - Clique em `Propriedades` + - Clique em `Avançado` + - Certifique-se de que a opção `Compactar conteúdo` **não** esteja marcada e clique em `Ok`. + + Aplique as alterações apenas nesta pasta e tente converter a versão WSL do Ubuntu novamente. + + :x: Se a conversão ainda não funcionar, por favor **entre em contato com um professor**. +
+ +Agora você pode fechar esta janela do terminal. + +
+ +### Check your username + +Type this in the Ubuntu terminal: + +```bash +whoami +``` + +It should return the username you chose before. + +:x: It if says `root`, **contact a TA** before continuing! + + +## Visual Studio Code + +### Instalação + +Vamos instalar o editor de texto [Visual Studio Code](https://code.visualstudio.com). + +- Vá para a [página de download do Visual Studio Code](https://code.visualstudio.com/download). +- Clique no botão "Windows" +- Abra o arquivo que você acabou de baixar. +- Instale-o com algumas opções: + +![Opções de instalação do VS Code](images/windows_vscode_installation.png) + +Quando a instalação for concluída, inicie o VS Code. + +### Conectando o código VS ao Ubuntu + +Para fazer o VS Code interagir corretamente com o Ubuntu, vamos instalar a extensão [Remote - WSL](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl) VS Code. + +Abra seu **terminal Ubuntu**. + +Copie e cole os seguintes comandos no terminal: + +```bash +code --install-extension ms-vscode-remote.remote-wsl +``` + +Em seguida, abra o VS Code em seu terminal: + +```bash +code . +``` + +:heavy_check_mark: Se você vir `WSL: Ubuntu` no canto inferior esquerdo da janela do VS Code, você está pronto para prosseguir :+1: + +![WSL Ubuntu remoto](images/windows_remote_wsl.png) + +:x: Caso contrário, por favor **entre em contato com um professor** + + +## Terminal do Windows + +### Instalação + +:information_source: As instruções a seguir dependem da sua versão do Windows. + +Se você estiver executando o Windows 11, o Terminal do Windows já está instalado e você pode prosseguir para a próxima seção :point_down: + +Se você estiver executando o Windows 10, vamos instalar o Windows Terminal, um terminal realmente moderno. + +
+Windows 10: Instalar Windows Terminal + +- Clique em `Iniciar` +- Digite `Microsoft Store` +- Clique em `Microsoft Store` na lista +- Procure por `Windows Terminal` na barra de pesquisa +- **Selecione Terminal do Windows"** +- Clique em `Instalar` + +:warning: NÃO instale o **Windows Terminal Preview**, apenas o **Windows Terminal**! + +
+ Desinstale a versão errada do Terminal do Windows + + Para desinstalar uma versão errada do Terminal Windows, basta ir até a Lista de Programas Instalados do Windows 10: + + - Pressione `Windows` + `R` + - Digite `ms-settings:appsfeatures` + - Pressione `Enter` + + Encontre o software para desinstalar e clique no botão desinstalar. +
+ +Assim que a instalação for concluída, o botão `Instalar` se torna um botão `Iniciar`: clique nele. + +
+ +### Ubuntu como terminal padrão + +Vamos tornar o Ubuntu o terminal padrão do seu aplicativo Windows Terminal. + +Pressione `Ctrl` + `,` + +Deve abrir as configurações do terminal: + +![Configurações do Terminal do Windows](images/windows_terminal_settings.png) + +- Altere o perfil padrão para "Ubuntu" +- Clique em "Salvar" +- Clique em "Abrir arquivo JSON" + +Você pode ver um círculo laranja em vez de um pinguim como logotipo do Ubuntu. + +Temos um círculo em vermelho na parte que você irá alterar: + +![Arquivo de configurações JSON do Terminal do Windows](images/windows_terminal_settings_json.png) + +Primeiro, vamos pedir ao Ubuntu para iniciar diretamente dentro do diretório inicial do Ubuntu, em vez do diretório do Windows: +- Localize a entrada com `"name": "Ubuntu",` e `"hidden": false,` +- Adicione a seguinte linha depois dela: + +```bash +"commandline": "wsl.exe ~", +``` + +:warning: Não esqueça a vírgula no final da linha! + +Então, vamos desabilitar o aviso para comandos de copiar e colar entre o Windows e o Ubuntu: +- Localize a linha `"defaultProfile": "{2c4de342-...}"` +- Adicione a seguinte linha depois dela: + +```bash +"warning.multiLinePaste": false, +``` + +:warning: Não esqueça a vírgula no final da linha! + +Você pode salvar essas alterações pressionando `Ctrl` + `S` + +:heavy_check_mark: Seu **Terminal Windows** agora está configurado :+1: + +Este terminal possui abas: você pode optar por abrir uma nova aba do terminal clicando em **+** ao lado da atual. + +**De agora em diante, toda vez que nos referirmos ao terminal ou ao console será este.** NÃO utilize mais nenhum outro terminal. + + +## Extensões do VS Code + +### Instalação + +Vamos instalar algumas extensões úteis no VS Code. + +Copie e cole os seguintes comandos em seu terminal: + +```bash +code --install-extension ms-vscode.sublime-keybindings +code --install-extension emmanuelbeziat.vscode-great-icons +code --install-extension github.github-vscode-theme +code --install-extension MS-vsliveshare.vsliveshare +code --install-extension shopify.ruby-lsp +code --install-extension dbaeumer.vscode-eslint +code --install-extension Rubymaniac.vscode-paste-and-indent +code --install-extension alexcvzz.vscode-sqlite +code --install-extension anteprimorac.html-end-tag-labels +code --install-extension marcoroth.herb-lsp +code --install-extension rayhanw.erb-helpers +``` + +Aqui está uma lista das extensões que você está instalando: + +- [Sublime Text Keymap and Settings Importer](https://marketplace.visualstudio.com/items?itemName=ms-vscode.sublime-keybindings) +- [VSCode Great Icons](https://marketplace.visualstudio.com/items?itemName=emmanuelbeziat.vscode-great-icons) +- [Live Share](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare) +- [Ruby](https://marketplace.visualstudio.com/items?itemName=shopify.ruby-lsp) +- [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) +- [Paste and Indent](https://marketplace.visualstudio.com/items?itemName=Rubymaniac.vscode-paste-and-indent) +- [SQLite](https://marketplace.visualstudio.com/items?itemName=alexcvzz.vscode-sqlite) + + +### Recursos de IA no VS Code + +O VS Code inclui muitos **recursos poderosos de IA**, que são ótimas ferramentas quando você já sabe programar. + +Dito isso, confiar na IA muito cedo pode ocultar conceitos importantes e dificultar o entendimento da depuração. Quando você estiver confortável com os fundamentos, saberá quando e como usar a IA de forma eficaz — sem deixar que ela faça o raciocínio por você. + +Para o início do bootcamp, vamos desativar esses recursos. No momento certo do curso, os reativaremos para que você possa usá-los bem. + +Em **VS Code**: + +1. Vamos abrir a "Paleta de Comandos" do VS Code: digite `Ctrl-Shift-P` (Windows / Linux) ou `Cmd-Shift-P` (macOS). +1. Isso abrirá a Paleta de Comandos: uma pequena caixa de texto no topo da tela. Comece a digitar `aifeatures` até ver "Chat: Learn How to Hide AI features". Clique nela. + ![A Paleta de Comandos no topo da tela](images/vscode_find_aifeatures.png) +1. Isso abrirá as configurações e mostrará a opção "Disable and hide built-in AI features ...". Marque a caixa de seleção à frente dessa opção. + ![Marcar a opção para desativar](images/vscode_disable_aifeatures.png) + +Mais tarde, se quiser **reativar** os recursos de IA, você pode seguir as mesmas instruções para desmarcar a caixa. + + +### Configuração do Live Share + +[Visual Studio Live Share](https://visualstudio.microsoft.com/services/live-share/) é uma extensão do VS Code que permite compartilhar o código em seu editor de texto para depuração e programação em pares: vamos configurá-lo acima! + +Inicie o VS Code em seu terminal digitando `code` e pressionando `Enter`. + +Clique na pequena seta na parte inferior da barra esquerda :point_down: + +![VS Code Live Share](images/vscode_live_share.png) + +- Clique no botão "Compartilhar" e depois em "GitHub (faça login usando a conta GitHub)". +- Um pop-up aparece solicitando que você faça login no GitHub: clique em “Permitir”. +- Você é redirecionado para uma página do GitHub em seu navegador solicitando autorização do Visual Studio Code: clique em "Continuar" e depois em "Autorizar github". +- O VS Code pode exibir pop-ups adicionais: feche-os clicando em "OK". + +É isso, você está pronto para continuar! + + +## Ferramentas de linha de comando + +### Verifique a localidade + +A localidade é um mecanismo que permite personalizar programas de acordo com seu idioma e país. + +Vamos verificar se a localidade padrão está definida como inglês, digite isto no terminal do Ubuntu: + +```bash +locale +``` + +Se a saída não contiver `LANG=en_US.UTF-8`, execute o seguinte comando em um terminal Ubuntu para instalar a localidade em inglês: + +```bash +sudo locale-gen en_US.UTF-8 +``` + +Se, depois, receberes um aviso (`bash: warning: setlocale: LC_ALL: cannot change locale (en_US.utf-8)`) no teu terminal, por favor faz o seguinte: + +
+ Gerar localidade + +Por favor, executa estas linhas no teu terminal. + +```bash +sudo update-locale LANG=en_US.UTF8 +sudo apt-get update +sudo apt-get install language-pack-en language-pack-en-base manpages +``` +
+ +### Zsh e Git + +Em vez de usar o `bash` [shell](https://en.wikipedia.org/wiki/Shell_(computing)), usaremos `zsh`. + +Também usaremos [`git`](https://git-scm.com/), um software de linha de comando usado para controle de versão. + +Vamos instalá-los, juntamente com outras ferramentas úteis: +- Abra um **terminal Ubuntu** +- Copie e cole os seguintes comandos: + +```bash +sudo apt update +``` + +```bash +sudo apt install -y curl git imagemagick jq unzip vim zsh tree +``` + +Esses comandos solicitarão sua senha: digite-a. + +:warning: Quando você digita sua senha, nada aparecerá na tela, **isso é normal**. Este é um recurso de segurança para mascarar não apenas sua senha como um todo, mas também seu comprimento. Basta digitar sua senha e quando terminar, pressione `Enter`. + +### Instalação da CLI do GitHub + +Vamos agora instalar a [CLI oficial do GitHub](https://cli.github.com) (interface de linha de comando). É um software usado para interagir com sua conta GitHub através da linha de comando. + +Em seu terminal, copie e cole os seguintes comandos e digite sua senha, se solicitado: + +```bash +sudo apt remove -y gitsome # gh command can conflict with gitsome if already installed +curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg +``` + +```bash +echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null +``` + +```bash +sudo apt update +``` + +```bash +sudo apt install -y gh +``` + +Para verificar se `gh` foi instalado com sucesso em sua máquina, você pode executar: + +```bash +gh --version +``` + +:heavy_check_mark: Se você vir `gh versão X.Y.Z (AAAA-MM-DD)`, está pronto para prosseguir :+1: + +:x: Caso contrário, por favor **entre em contato com um professor** + + +## Oh-My-Zsh + +Vamos instalar o plugin `zsh` [Oh My Zsh](https://ohmyz.sh/). + +Em um terminal execute o seguinte comando: + +```bash +sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" +``` + +Se for perguntado "Deseja alterar seu shell padrão para zsh?", pressione `Y` + +No final seu terminal deverá ficar assim: + +![Terminal Ubuntu com OhMyZsh](images/oh_my_zsh.png) + +:heavy_check_mark: Se isso acontecer, você pode continuar :+1: + +:x: Caso contrário, por favor **entre em contato com um professor** + + +## Vinculando seu navegador padrão ao Ubuntu + +Para ter certeza de que você pode interagir com seu navegador instalado no Windows a partir do terminal Ubuntu, precisamos defini-lo como navegador padrão. + +:warning: Você precisa executar pelo menos um dos seguintes comandos abaixo: + +
+ Google Chrome como navegador padrão + + Execute o comando: + + ```bash + ls /mnt/c/Program\ Files\ \(x86\)/Google/Chrome/Application/chrome.exe + ``` + + Você recebeu um erro como `ls: não é possível acessar...`? + +
+ Sim, ocorreu um erro + +Execute os seguintes comandos: + + ```bash + echo "export BROWSER=\"/mnt/c/Program Files/Google/Chrome/Application/chrome.exe\"" >> ~/.zshrc + echo "export GH_BROWSER=\"'/mnt/c/Program Files/Google/Chrome/Application/chrome.exe'\"" >> ~/.zshrc + ``` +
+ +
+ Não, estava tudo bem + + Execute os seguintes comandos: + + ```bash + echo "export BROWSER=\"/mnt/c/Program Files (x86)/Google/Chrome/Application/chrome.exe\"" >> ~/.zshrc + echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Google/Chrome/Application/chrome.exe'\"" >> ~/.zshrc + ``` +
+ +--- + +
+ +
+ Mozilla Firefox como seu navegador padrão + + Execute o comando: + + ```bash + ls /mnt/c/Program\ Files\ \(x86\)/Mozilla\ Firefox/firefox.exe + ``` + + Você recebeu um erro como `ls: não é possível acessar...`? + +
+ Sim, ocorreu um erro + + Execute os seguintes comandos: + + ```bash + echo "export BROWSER=\"/mnt/c/Program Files/Mozilla Firefox/firefox.exe\"" >> ~/.zshrc + echo "export GH_BROWSER=\"'/mnt/c/Program Files/Mozilla Firefox/firefox.exe'\"" >> ~/.zshrc + ``` + +
+ +
+ Não, estava tudo bem + + Execute os seguintes comandos: + + ```bash + echo "export BROWSER=\"/mnt/c/Program Files (x86)/Mozilla Firefox/firefox.exe\"" >> ~/.zshrc + echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Mozilla Firefox/firefox.exe'\"" >> ~/.zshrc + ``` +
+ +--- + +
+ +
+ Microsoft Edge como navegador padrão + + Execute os comandos: + + ```bash + echo "export BROWSER=\"/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe\"" >> ~/.zshrc + echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'\"" >> ~/.zshrc + ``` + +--- + +
+ +Reinicie seu terminal. + +Em seguida, certifique-se de que o seguinte comando retorne "Browser Defined 👌": + +```bash +[ -z "$BROWSER" ] && echo "ERROR: please define a BROWSER environment variable ⚠️" || echo "Browser defined 👌" +``` + +Se isso não acontecer, + +:heavy_check_mark: Se você recebeu esta mensagem, pode continuar :+1: + +:x: Caso contrário, escolha um navegador na lista acima e execute o comando correspondente. Então não se esqueça de redefinir seu terminal: + +```bash +exec zsh +``` + +Não hesite em **entrar em contato com um professor**. + + +## CLI do GitHub + +CLI é o acrônimo de [Interface de linha de comando](https://en.wikipedia.org/wiki/Command-line_interface). + +Nesta seção, usaremos [GitHub CLI](https://cli.github.com/) para interagir com o GitHub diretamente do terminal. + +Usaremos o GitHub CLI (`gh`) para conectar ao GitHub usando *SSH*, um protocolo para fazer login usando chaves SSH em vez do conhecido par nome de usuário/senha. + + +Ele já deve estar instalado no seu computador a partir dos comandos anteriores. + +Primeiro, para **fazer login**, copie e cole o seguinte comando em seu terminal: + +:warning: **NÃO edite o `email`** + +```bash +gh auth login -s 'user:email' -w --git-protocol ssh +``` + +`gh` fará algumas perguntas: + +- `Generate a new SSH key to add to your GitHub account?` Pressione `Enter` para pedir ao gh para gerar as chaves SSH para você. + + Se você já possui chaves SSH, verá `Upload your SSH public key to your GitHub account?` Com as setas, selecione o caminho do arquivo de sua chave pública e pressione `Enter`. + +- `Enter a passphrase for your new SSH key (Optional)`. Digite algo que você deseja e que você lembrará. É uma senha para proteger sua chave privada armazenada no disco rígido. Em seguida, pressione `Enter`. + +- `Title for your SSH key`. Você pode deixá-lo no "GitHub CLI" proposto, pressione `Enter`. + +Você obterá então a seguinte saída: + +```bash +! First copy your one-time code: 0EF9-D015 +- Press Enter to open github.com in your browser... +``` + +Selecione e copie o código (`0EF9-D015` no exemplo) e pressione `Enter`. + +Seu navegador será aberto e solicitará que você autorize o GitHub CLI a usar sua conta GitHub. Aceite e espere um pouco. + +Volte ao terminal, pressione `Enter` novamente e pronto. + +Para verificar se você está conectado corretamente, digite: + +```bash +gh auth status +``` + +:heavy_check_mark: Se você estiver `Logado no github.com como `, então tudo bem :+1: + +:x: Caso contrário, **entre em contato com um professor**. + + +## Dotfiles (configuração padrão) + +Os hackers adoram refinar e aprimorar sua estrutura e ferramentas. + +Começaremos com uma ótima configuração padrão fornecida pelo Le Wagon: [`lewagon/dotfiles`](https://github.com/lewagon/dotfiles). + +Como sua configuração é pessoal, você precisa de seu próprio repositório para armazená-la. Então você irá fazer o **fork** do repositório Le Wagon. + +Bifurcar significa que você criará um novo repositório em sua própria conta GitHub `$GITHUB_USERNAME/dotfiles`, idêntico ao original do Le Wagon que você poderá modificar à vontade. + +Abra seu terminal e defina uma variável para seu nome de usuário GitHub: + +```bash +export GITHUB_USERNAME=`gh api user | jq -r '.login'` +``` + +```bash +echo $GITHUB_USERNAME +``` + +:heavy_check_mark: Você deverá ver seu nome de usuário do GitHub impresso. + +:x: Se não, **pare aqui** e peça ajuda. Pode haver um problema com a etapa anterior (`gh auth`). + +:warning: Por favor note que esta variável só é definida para o tempo em que seu terminal está aberto. Se você fechá-lo antes ou durante as próximas etapas, será necessário configurá-lo novamente com as duas etapas acima! + + +É hora de fazer um fork do repositório e cloná-lo em seu computador: + +```bash +mkdir -p ~/code/$GITHUB_USERNAME && cd $_ +``` + +```bash +gh repo fork lewagon/dotfiles --clone +``` + +### Instalador do Dotfiles + +Execute o instalador `dotfiles`: + +```bash +cd ~/code/$GITHUB_USERNAME/dotfiles +``` + +```bash +zsh install.sh +``` + +Verifique os e-mails registrados em sua conta GitHub. Você precisará escolher um na próxima etapa: + +```bash +gh api user/emails | jq -r '.[].email' +``` + +:heavy_check_mark: Se você vir a lista de seus e-mails registrados, você pode prosseguir :+1: + +:x: Caso contrário, [reautentique no GitHub](https://github.com/lewagon/setup/blob/master/windows.pt.md#github-cli) antes de executar este comando :point_up: novamente. + +### Instalador git + +Execute o instalador `git`: + +```bash +cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh +``` + +:point_up: Isso **solicitará** seu nome (`Nome Sobrenome`) e seu e-mail. O email que você escolher será exibido **publicamente** na internet. 💡 Selecione o endereço `@users.noreply.github.com` se você não deseja que seu e-mail apareça em repositórios públicos aos quais você possa contribuir. + +:warning: Você **precisa** colocar um dos e-mails listados acima graças ao comando anterior `gh api ...`. Se você não fizer isso, Kitt não conseguirá acompanhar seu progresso. + +Agora **reinicie** seu terminal executando: + +```bash +exec zsh +``` + + +## Desativar prompt de senha SSH + +Você não quer que sua senha seja solicitada sempre que se comunicar com um repositório distante. Então, você precisa adicionar o plugin `ssh-agent` ao `oh my zsh`: + +Primeiro, abra o arquivo `.zshrc`: + +```bash +code ~/.zshrc +``` + +Então: +- Identifique a linha que começa com `plugins=` +- Adicione `ssh-agent` no final da lista de plugins + +:heavy_check_mark: Salve o arquivo `.zshrc` com `Ctrl` + `S` e feche seu editor de texto. + + +## rbenv + +Vamos instalar o [`rbenv`](https://github.com/sstephenson/rbenv), um software para instalar e gerenciar ambientes `ruby`. + +Primeiro, precisamos limpar qualquer instalação anterior do Ruby que você possa ter: + +```bash +rvm implode && sudo rm -rf ~/.rvm +# Se você obteve "zsh: comando não encontrado: rvm", continue. +# Significa que `rvm` não está no seu computador, é isso que queremos! +rm -rf ~/.rbenv +``` + +Então no terminal, execute: + +```bash +sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev libyaml-dev +``` + +```bash +git clone https://github.com/rbenv/rbenv.git ~/.rbenv +``` + +```bash +git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build +``` + +```bash +exec zsh +``` + + +## Ruby + +### Instalação + +Agora, você está pronto para instalar a versão mais recente do [ruby](https://www.ruby-lang.org/en/) e defini-la como a versão padrão. + +Execute este comando, **demorará um pouco (5 a 10 minutos)** + +```bash +rbenv install 3.3.5 +``` + +Assim que a instalação do Ruby estiver concluída, execute este comando para informar ao sistema +para usar a versão 3.3.5 por padrão. + +```bash +rbenv global 3.3.5 +``` + +**Reinicialize** seu terminal e verifique sua versão do Ruby: + +```bash +exec zsh +``` + +Então corra: + +```bash +ruby -v +``` + +:heavy_check_mark: Se você vir algo começando com `ruby 3.3.5` então você pode prosseguir :+1: + +:x: Se não, **pergunte a um professor** + +### Instalando algumas gems + +
+ Se você estiver na China 🇨🇳 clique aqui + + :warning: Se você estiver na China, você deve atualizar a forma como instalaremos o gem com os seguintes comandos. + +```bash +# Somente China! +fontes de gemas --remove https://rubygems.org/ +fontes de gemas -a https://gems.ruby-china.com/ +fontes de gemas -l +#***FONTES ATUAIS*** +# https://gems.ruby-china.com/ +# Ruby-china.com deve estar na lista agora +``` +
+ +**Todos, na China ou não**, continuem aqui para instalar gems. + +No mundo Ruby, chamamos bibliotecas externas de `gems`: são pedaços de código Ruby que você pode baixar e executar em seu computador. Vamos instalar alguns! + +No seu terminal, copie e cole o seguinte comando: + +```bash +gem install colored faker http pry-byebug rake rails:8.1.1 rest-client rspec rubocop-performance sqlite3:2.8.1 activerecord:8.1.1 ruby-lsp +``` + +:heavy_check_mark: Se você tiver `xx gems installed`, então tudo bem :+1: + +:x: Se você encontrar o seguinte erro: + +```bash +ERROR: While executing gem ... (TypeError) +incompatible marshal file format (can't be read) +format version 4.8 required; 60.33 given +``` + +Execute o seguinte comando: +```bash +rm -rf ~/.gemrc +``` + +Execute novamente o comando para instalar as gemas. + +:warning: **NUNCA** instale uma gem com `sudo gem install`! Mesmo se você encontrar uma resposta do Stackoverflow (ou o terminal) solicitando que você faça isso. + + +## Node.js + +[Node.js](https://nodejs.org/en/) é um tempo de execução JavaScript para executar código JavaScript no terminal. Vamos instalá-lo com [nvm](https://github.com/nvm-sh/nvm), um gerenciador de versões para Node.js. + +Em um terminal, execute os seguintes comandos: + +```bash +curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | zsh +``` + +```bash +exec zsh +``` + +Em seguida, execute o seguinte comando: + +```bash +nvm -v +``` + +Você deverá ver uma versão. Se não, pergunte a um professor. + +Agora vamos instalar o Node.js: + +```bash +nvm install 20.17.0 +``` + +Quando a instalação terminar, execute: + +```bash +node -v +``` + +Se você vir `v20.17.0`, a instalação foi bem-sucedida :heavy_check_mark: Você pode então executar: + +```bash +nvm cache clear +``` + +:x: Caso contrário, **entre em contato com um professor** + + +## Yarn + +[`yarn`](https://yarnpkg.com/) é um gerenciador de pacotes para instalar bibliotecas JavaScript. Vamos instalá-lo: + +Em um terminal, execute os seguintes comandos: + +```bash +corepack enable +yarn set version stable +``` + +```bash +exec zsh +``` + +⚠️ Se vires quaisquer mensagens de erro, tenta executar `npm install -g corepack` e, em seguida, volta a executar os comandos acima. + +Em seguida, execute o seguinte comando: + +```bash +yarn -v +``` + +:heavy_check_mark: Se você vir uma versão, você está bem :+1: + +:x: Se não, **entre em contato com um professor** + + +## SQLite + +Em algumas semanas falaremos sobre bancos de dados e SQL. [SQLite](https://sqlite.org/index.html) é um mecanismo de banco de dados usado para executar consultas SQL em bancos de dados de arquivo único. Vamos instalá-lo: + +Em um terminal, execute os seguintes comandos: + +```bash +sudo apt-get install sqlite3 libsqlite3-dev pkg-config +``` + +Em seguida, execute o seguinte comando: + +```bash +sqlite3 -version +``` + +:heavy_check_mark: Se você vir uma versão, você está bem :+1: + +:x: Se não, **peça um professor** + + +## PostgreSQL + +Às vezes, o SQLite não é suficiente e precisaremos de uma ferramenta mais avançada chamada [PostgreSQL](https://www.postgresql.org/), um sistema de banco de dados de código aberto, robusto e pronto para produção. + +Vamos instalá-lo agora. + +Execute os seguintes comandos: + +```bash +sudo apt install -y postgresql postgresql-contrib libpq-dev build-essential +``` + +```bash +sudo /etc/init.d/postgresql start +``` + +```bash +sudo -u postgres psql --command "CREATE ROLE \"`whoami`\" LOGIN createdb superuser;" +``` + +Você pode configurar o PostgreSQL para inicialização automática, para que não precise executar `sudo /etc/init.d/postgresql start` cada vez que abrir um novo terminal: + +```bash +sudo echo "`whoami` ALL=NOPASSWD:/etc/init.d/postgresql start" | sudo tee /etc/sudoers.d/postgresql +``` + +```bash +sudo chmod 440 /etc/sudoers.d/postgresql +``` + +```bash +echo "sudo /etc/init.d/postgresql start" >> ~/.zshrc +``` + +Abra um novo terminal. + +:heavy_check_mark: Se você vir uma mensagem `* Starting postgresql (via systemctl): postgresql.service` OU `* Starting PostgreSQL 14 database server`, você está pronto para prosseguir :+1: + +:x: Caso contrário, **entre em contato com um professor**. + + +## Checagem + +Vamos verificar se você instalou tudo com sucesso. + +No seu terminal, execute o seguinte comando: + +```bash +exec zsh +``` + +Então corra: + +```bash +curl -Ls https://raw.githubusercontent.com/lewagon/setup/master/check.rb > _.rb && ruby _.rb && rm _.rb || rm _.rb +``` + +:heavy_check_mark: Se você receber uma mensagem verde `Awesome! Your computer is now ready!`, então você está bem :+1: + +:x: Caso contrário, **entre em contato com um professor**. + + +## Kitt + +:warning: Se você recebeu um e-mail do Le Wagon convidando você a se inscrever no Kitt (nossa plataforma de aprendizagem), você pode pular esta etapa com segurança. Em vez disso, siga as instruções no e-mail que você recebeu, caso ainda não tenha feito isso. + +Se não tiver certeza sobre o que fazer, siga [este link](https://kitt.lewagon.com/). Se você já estiver logado, pode pular esta seção com segurança. Se você não estiver logado, clique em `Enter Kitt as a Student`. Se você conseguir fazer login, poderá pular esta etapa com segurança. Caso contrário, pergunte a um professor se você deveria ter recebido um e-mail ou siga as instruções abaixo. + +Registre-se como Alumni da Le Wagon acessando [kitt.lewagon.com/onboarding](http://kitt.lewagon.com/onboarding). Selecione seu batch, faça login no GitHub e insira todas as suas informações. + +Seu professor irá então validar que você realmente faz parte do batch. Você pode pedir que eles façam isso assim que preencher o formulário de registro. + +Assim que o professor aprovar seu perfil, acesse sua caixa de entrada de e-mail. Você deve ter 2 e-mails: + +- Um do Slack, convidando você para a comunidade Le Wagon Alumni do Slack (onde você conversará com seus amigos e todos os ex-alunos anteriores). Clique em **Inscreva-se** e preencha os dados. +- Um do GitHub, convidando você para a equipe `lewagon`. **Aceite** caso contrário você não conseguirá acessar os slides da aula. + + +## Slack + +[Slack](https://slack.com/) é uma plataforma de comunicação bastante popular na indústria de tecnologia. + +### Instalação + +[Baixe o aplicativo Slack](https://slack.com/downloads/windows) e instale-o. + +:warning: Se você já usa o Slack em seu navegador, baixe e instale **o aplicativo para desktop** que vem com todos os recursos. + + +### Configurações + +Inicie o aplicativo e faça login na organização `lewagon-alumni`. + +Certifique-se de **fazer upload de uma foto de perfil** :point_down: + +![Como fazer upload de uma foto de perfil no Slack](images/slack_profile_picture.gif) + +A ideia é que você tenha o Slack aberto o dia todo, para que você possa compartilhar links úteis/pedir ajuda/decidir onde ir almoçar/etc. + +Para garantir que tudo está funcionando bem nas videochamadas, vamos testar sua câmera e microfone: +- Abra o aplicativo Slack +- Clique na foto do seu perfil no canto superior direito. +- Selecione `Preferências` no menu. +- Clique em `Áudio e vídeo` na coluna do lado esquerdo. +- Abaixo de `Solução de problemas`, clique em `Executar um teste de áudio, vídeo e compartilhamento de tela`. O teste será aberto em uma nova janela. +- Verifique se seus dispositivos preferidos de alto-falante, microfone e câmera aparecem nos menus suspensos e clique em `Iniciar teste`. + +![Verifique o microfone e a webcam com o Slack](images/slack_call_test.png) + +:heavy_check_mark: Quando o teste terminar, você deverá ver mensagens verdes de "Sucesso" pelo menos para seu microfone e câmera. :+1: + +:x: Caso contrário, **entre em contato com um professor**. + +Você também pode instalar o aplicativo Slack no seu telefone e entrar em `lewagon-alumni`! + + +## Configurações do Windows + +### Troque arquivos entre Windows e Ubuntu + +Precisamos de uma maneira fácil de transferir arquivos do Windows para o Ubuntu e vice-versa. + +Para fazer isso, vamos criar atalhos para diretórios do Ubuntu no **File Explorer** do Windows: +- Abra o Windows File Explorer (ou use o atalho `WIN` + `E`) +- Na barra de endereços, digite `\\wsl$\` (ou `\\wsl$\Ubuntu` se não funcionar) +- Agora você tem acesso ao sistema de arquivos Ubuntu +- Mergulhe no sistema de arquivos Ubuntu para procurar diretórios de interesse +- Arraste as pastas desejadas para a barra de endereços para criar atalhos + +![Como adicionar um atalho ao sistema de arquivos Ubuntu no Windows](images/windows_ubuntu_file_system_shortcut.gif) + +### Abra o Windows File Explorer no terminal Ubuntu + +Outra opção para mover arquivos é abrir o Windows **File Explorer** no terminal Ubuntu: +- Abra um terminal Ubuntu +- Vá para o diretório que deseja explorar +- Execute o comando `explorer.exe .` (alternativamente, use `wslview .`) +- Se você receber uma mensagem de erro de entrada e saída, execute `wsl --shutdown` em um Windows PowerShell e reabra um terminal Ubuntu + +![Como iniciar o Windows Explorer a partir do terminal Ubuntu](images/windows_explorer_from_terminal.png) + +### Encontre o seu caminho no sistema de arquivos Ubuntu + +Você pode querer descobrir a localização exata de um diretório do Windows no sistema de arquivos Ubuntu ou vice-versa. + +Para converter um caminho do Windows de e para um caminho do Ubuntu: +- Abra um terminal Ubuntu +- Use o comando `wslpath "C:\Program Files"` para traduzir um caminho do Windows em um caminho do Ubuntu +- Use o comando `wslpath -w "/home"` para traduzir um caminho do Ubuntu em um caminho do Windows +- Em particular, o comando `wslpath -w $(pwd)` retorna o caminho do Windows do diretório atual do Ubuntu + +![Como acessar um caminho do Windows a partir do terminal Ubuntu](images/windows_path_from_terminal.png) + +### Fixe aplicativos na sua barra de tarefas + +Você usará a maioria dos aplicativos que instalou hoje com muita frequência. Vamos fixá-los na barra de tarefas para que estejam a apenas um clique de distância! + +Para fixar um aplicativo na barra de tarefas, inicie o aplicativo, clique com o botão direito no ícone da barra de tarefas para abrir o menu de contexto e escolha “Fixar na barra de tarefas”. + +![Como fixar um aplicativo na barra de tarefas do Windows](images/windows_taskbar.png) + +Você deve fixar: +- Seu terminal +- Seu explorador de arquivos +- VS Code +- Seu navegador de Internet +- Slack + + +## Configuração concluída! + +Seu computador agora está pronto para o [curso de AI Software Development Le Wagon](https://www.lewagon.com/web-development-course/full-time) :muscle: :clap: + +Aproveite o bootcamp, você vai acertar :rocket: + +