lewagon / setup

Setup instructions for Le Wagon's students on their first day of Web Development Bootcamp
https://www.lewagon.com
18.29k stars 1.6k forks source link

improved format of windows browser section #436

Closed SebiBasti closed 1 year ago

SebiBasti commented 1 year ago

This is related to https://github.com/lewagon/setup/issues/430

During Windows Setup Day we regularly encountered issues with the Linking your default browser to Ubuntu section. I did not change the content of this section but improved the format. Each section now has a nested collapsable menu which asks the student if they encountered an issue. This hopefully solves the recurring problem that students execute both command blocks.

This is how it looks now:


Linking your default browser to Ubuntu

To be sure that you can interact with your browser installed on Windows from your Ubuntu terminal, we need to set it as your default browser there.

:warning: You need to execute at least one of the following commands below:

Google Chrome as your default browser Run the command: ```bash ls /mnt/c/Program\ Files\ \(x86\)/Google/Chrome/Application/chrome.exe ``` 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 Run the following commands: ```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 as your default browser Run the command: ```bash ls /mnt/c/Program\ Files\ \(x86\)/Mozilla\ Firefox/firefox.exe ``` 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 ```
No, everything was fine Run the following commands: ```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 as your default browser Run the commands: ```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 ``` ---

Restart your terminal.

Then please make sure that the following command returns "Browser defined 👌":

[ -z "$BROWSER" ] && echo "ERROR: please define a BROWSER environment variable ⚠️" || echo "Browser defined 👌"

If it does not,

:heavy_check_mark: If you got this message, you can continue :+1:

:x: If not, choose a browser in the list above and execute the corresponding command. Then don't forget to reset your terminal:

exec zsh

Do not hesitate to contact a teacher.

SebiBasti commented 1 year ago

@v-natalia let me know what you think

v-natalia commented 1 year ago

I loved it! Much clearer!