setup guides generated

lewagon · Mar 7, 2025 · 2db7a9e · 2db7a9e
1 parent 5e783fd
commit 2db7a9e
Show file tree

Hide file tree

Showing 14 changed files with 332 additions and 428 deletions.
diff --git a/LINUX.es.md b/LINUX.es.md
@@ -548,74 +548,28 @@ pip install -r https://raw.githubusercontent.com/lewagon/data-setup/master/specs
 ```
 
 
-## Mejora `jupyter` notebook y chequeo
-
-### CSS personalizado
+## Mejora `jupyter` notebook
 
 Mejora la visualización del [elemento `details` para revelación de información](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/details) en tus notebooks.
 
-Abre `custom/custom.css` en el directorio config:
-```bash
-cd $(jupyter --config-dir)
-mkdir -p custom
-touch custom/custom.css
-code custom/custom.css
-```
-Edita `custom.css` con la siguiente información:
+Ejecuta las siguientes líneas para crear una hoja de estilos `custom.css` en tu directorio de configuración de Jupyter:
 
-```css
-summary {
-    cursor: pointer;
-    display:list-item;
-}
-summary::marker {
-    font-size: 1em;
-}
+```bash
+LOCATION=$(jupyter --config-dir)/custom
+SOURCE=https://raw.githubusercontent.com/lewagon/data-setup/refs/heads/master/specs/jupyter/custom.css
+mkdir -p $LOCATION
+curl $SOURCE > $LOCATION/custom.css
 ```
 
-Puedes cerrar VS Code.
 
-### Chequeo de `jupyter`
+### Chqueo de la configuración de Python
 
 Reinicia tu terminal:
 
 ```bash
-exec zsh
-```
-
-Ahora verifica que puedas iniciar un servidor de notebook en tu máquina:
-
-```bash
-jupyter notebook
+cd ~/code && exec zsh
 ```
 
-Tu navegador web debería abrir en una ventana `jupyter`:
-
-![jupyter.png](images/jupyter.png)
-
-Haz clic en `New`:
-
-![jupyter_new.png](images/jupyter_new.png)
-
-Debería abrirse una pestaña en un nuevo notebook:
-
-![jupyter_notebook.png](images/jupyter_notebook.png)
-
-### Chequeo de `nbextensions`
-
-Haz una revisión de las `jupyter notebooks nbextensions`. Haz clic en `Nbextensions`:
-
-![jupyter_nbextensions.png](images/jupyter_nbextensions.png)
-
-Deselecciona _"disable configuration for nbextensions without explicit compatibility"_. Esto significa deshabilitar la configuración de nbextensions sin compatibilidad explícita. Luego verifica que _al menos_ las `nbextensions` marcadas en rojo estén habilitadas:
-
-![nbextensions.png](images/nbextensions.png)
-
-Puedes cerrar tu navegador web y luego cerrar el servidor jupyter con `CTRL` + `C`.
-
-
-### Chqueo de la configuración de Python
-
 Verifica tu versión de Python con los siguientes comandos:
 ```bash
 zsh -c "$(curl -fsSL https://raw.githubusercontent.com/lewagon/data-setup/master/checks/python_checker.sh)" 3.12.9
@@ -631,19 +585,33 @@ Ahora ejecuta el siguiente comando para verificar que puedas cargar estos paquet
 python -c "$(curl -fsSL https://raw.githubusercontent.com/lewagon/data-setup/master/checks/pip_check.py)"
 ```
 
-Asegúrate de que puedas usar Jupyter:
+Ahora verifica que puedas iniciar un servidor de notebook en tu máquina:
 
 ```bash
 jupyter notebook
 ```
 
-Y abre un notebook `Python 3`.
+Tu navegador web debería abrir en una ventana `jupyter`:
+
+![jupyter.png](images/jupyter.png)
+
+Haz clic en `New` y, en el menú desplegable, selecciona Python 3 (ipykernel):
+
+![jupyter_new.png](images/jupyter_new.png)
+
+Debería abrirse una pestaña en un nuevo notebook:
+
+![jupyter_notebook.png](images/jupyter_notebook.png)
 
 Asegúrate de que estés usando la versión correcta de python en el notebook. Abre una celda y ejecuta lo siguiente:
 ``` python
 import sys; sys.version
 ```
 
+Debería mostrar 3.12.9 seguido de algunos detalles adicionales. Si no es así, consulta con un TA.
+
+Puedes cerrar tu navegador web y luego cerrar el servidor jupyter con `CTRL` + `C`.
+
 ¡Listo! Ya tienes un virtual env de python completo con todos los paquetes tercerizados que necesitarás en el bootcamp.
 
 

diff --git a/LINUX.md b/LINUX.md
@@ -590,64 +590,28 @@ pip install -r https://raw.githubusercontent.com/lewagon/data-setup/master/specs
 ```
 
 
-## `jupyter` notebook tweaking and check up
+## `jupyter` notebook tweaking
 
-### Custom CSS
+Let's improve the display of the [`details` disclosure elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/details) in your notebooks.
 
-Improve the display of the [`details` disclosure elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/details) in your notebooks.
+Run the following lines to create a `custom.css` stylesheet in your Jupyter config directory:
 
-Open `custom/custom.css` in the config directory:
 ```bash
-cd $(jupyter --config-dir)
-mkdir -p custom
-touch custom/custom.css
-code custom/custom.css
+LOCATION=$(jupyter --config-dir)/custom
+SOURCE=https://raw.githubusercontent.com/lewagon/data-setup/refs/heads/master/specs/jupyter/custom.css
+mkdir -p $LOCATION
+curl $SOURCE > $LOCATION/custom.css
 ```
-Edit `custom.css` with:
 
-```css
-summary {
-    cursor: pointer;
-    display:list-item;
-}
-summary::marker {
-    font-size: 1em;
-}
-```
-
-You can close VS Code.
 
-### `jupyter` check up
+### Python setup check up
 
 Let's reset your terminal:
 
 ```bash
-exec zsh
-```
-
-Now, check you can launch a notebook server on your machine:
-
-```bash
-jupyter notebook
+cd ~/code && exec zsh
 ```
 
-Your web browser should open on a `jupyter` window:
-
-![jupyter.png](images/jupyter.png)
-
-Click on `New`:
-
-![jupyter_new.png](images/jupyter_new.png)
-
-A tab should open on a new notebook:
-
-![jupyter_notebook.png](images/jupyter_notebook.png)
-
-You can close your web browser then terminate the jupyter server with `CTRL` + `C`.
-
-
-### Python setup check up
-
 Check your Python version with the following commands:
 ```bash
 zsh -c "$(curl -fsSL https://raw.githubusercontent.com/lewagon/data-setup/master/checks/python_checker.sh)" 3.12.9
@@ -669,13 +633,27 @@ Make sure you can run Jupyter:
 jupyter notebook
 ```
 
-And open a `Python 3` notebook.
+Your web browser should open on a `jupyter` window:
+
+![jupyter.png](images/jupyter.png)
+
+Click on `New` and in the dropdown menu select `Python 3 (ipykernel)`:
 
-Make sure that you are running the correct python version in the notebook. Open a cell and run :
+![jupyter_new.png](images/jupyter_new.png)
+
+A tab should open on a new notebook:
+
+![jupyter_notebook.png](images/jupyter_notebook.png)
+
+Make sure that you are running the correct python version in the notebook. Open a cell and run:
 ``` python
 import sys; sys.version
 ```
 
+It should output `3.12.9` followed by some more details. If not, check with a TA.
+
+You can close your web browser then terminate the jupyter server with `CTRL` + `C`.
+
 Here you have it! A complete python virtual env with all the third-party packages you'll need for the whole bootcamp.
 
 

diff --git a/LINUX_keep_current.es.md b/LINUX_keep_current.es.md
@@ -275,6 +275,12 @@ sudo service docker stop
 
 ### Chqueo de la configuración de Python
 
+Reinicia tu terminal:
+
+```bash
+cd ~/code && exec zsh
+```
+
 Verifica tu versión de Python con los siguientes comandos:
 ```bash
 zsh -c "$(curl -fsSL https://raw.githubusercontent.com/lewagon/data-setup/master/checks/python_checker.sh)" 3.12.9
@@ -290,19 +296,33 @@ Ahora ejecuta el siguiente comando para verificar que puedas cargar estos paquet
 python -c "$(curl -fsSL https://raw.githubusercontent.com/lewagon/data-setup/master/checks/pip_check.py)"
 ```
 
-Asegúrate de que puedas usar Jupyter:
+Ahora verifica que puedas iniciar un servidor de notebook en tu máquina:
 
 ```bash
 jupyter notebook
 ```
 
-Y abre un notebook `Python 3`.
+Tu navegador web debería abrir en una ventana `jupyter`:
+
+![jupyter.png](images/jupyter.png)
+
+Haz clic en `New` y, en el menú desplegable, selecciona Python 3 (ipykernel):
+
+![jupyter_new.png](images/jupyter_new.png)
+
+Debería abrirse una pestaña en un nuevo notebook:
+
+![jupyter_notebook.png](images/jupyter_notebook.png)
 
 Asegúrate de que estés usando la versión correcta de python en el notebook. Abre una celda y ejecuta lo siguiente:
 ``` python
 import sys; sys.version
 ```
 
+Debería mostrar 3.12.9 seguido de algunos detalles adicionales. Si no es así, consulta con un TA.
+
+Puedes cerrar tu navegador web y luego cerrar el servidor jupyter con `CTRL` + `C`.
+
 ¡Listo! Ya tienes un virtual env de python completo con todos los paquetes tercerizados que necesitarás en el bootcamp.
 
 
diff --git a/LINUX_keep_current.md b/LINUX_keep_current.md
@@ -275,6 +275,12 @@ sudo service docker stop
 
 ### Python setup check up
 
+Let's reset your terminal:
+
+```bash
+cd ~/code && exec zsh
+```
+
 Check your Python version with the following commands:
 ```bash
 zsh -c "$(curl -fsSL https://raw.githubusercontent.com/lewagon/data-setup/master/checks/python_checker.sh)" 3.12.9
@@ -296,13 +302,27 @@ Make sure you can run Jupyter:
 jupyter notebook
 ```
 
-And open a `Python 3` notebook.
+Your web browser should open on a `jupyter` window:
+
+![jupyter.png](images/jupyter.png)
+
+Click on `New` and in the dropdown menu select `Python 3 (ipykernel)`:
 
-Make sure that you are running the correct python version in the notebook. Open a cell and run :
+![jupyter_new.png](images/jupyter_new.png)
+
+A tab should open on a new notebook:
+
+![jupyter_notebook.png](images/jupyter_notebook.png)
+
+Make sure that you are running the correct python version in the notebook. Open a cell and run:
 ``` python
 import sys; sys.version
 ```
 
+It should output `3.12.9` followed by some more details. If not, check with a TA.
+
+You can close your web browser then terminate the jupyter server with `CTRL` + `C`.
+
 Here you have it! A complete python virtual env with all the third-party packages you'll need for the whole bootcamp.