Skip to content

Commit 2db7a9e

Browse files
author
github-actions
committed
setup guides generated
1 parent 5e783fd commit 2db7a9e

14 files changed

+332
-428
lines changed

LINUX.es.md

Lines changed: 25 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -548,74 +548,28 @@ pip install -r https://raw.githubusercontent.com/lewagon/data-setup/master/specs
548548
```
549549

550550

551-
## Mejora `jupyter` notebook y chequeo
552-
553-
### CSS personalizado
551+
## Mejora `jupyter` notebook
554552

555553
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.
556554

557-
Abre `custom/custom.css` en el directorio config:
558-
```bash
559-
cd $(jupyter --config-dir)
560-
mkdir -p custom
561-
touch custom/custom.css
562-
code custom/custom.css
563-
```
564-
Edita `custom.css` con la siguiente información:
555+
Ejecuta las siguientes líneas para crear una hoja de estilos `custom.css` en tu directorio de configuración de Jupyter:
565556

566-
```css
567-
summary {
568-
cursor: pointer;
569-
display:list-item;
570-
}
571-
summary::marker {
572-
font-size: 1em;
573-
}
557+
```bash
558+
LOCATION=$(jupyter --config-dir)/custom
559+
SOURCE=https://raw.githubusercontent.com/lewagon/data-setup/refs/heads/master/specs/jupyter/custom.css
560+
mkdir -p $LOCATION
561+
curl $SOURCE > $LOCATION/custom.css
574562
```
575563

576-
Puedes cerrar VS Code.
577564

578-
### Chequeo de `jupyter`
565+
### Chqueo de la configuración de Python
579566

580567
Reinicia tu terminal:
581568

582569
```bash
583-
exec zsh
584-
```
585-
586-
Ahora verifica que puedas iniciar un servidor de notebook en tu máquina:
587-
588-
```bash
589-
jupyter notebook
570+
cd ~/code && exec zsh
590571
```
591572

592-
Tu navegador web debería abrir en una ventana `jupyter`:
593-
594-
![jupyter.png](images/jupyter.png)
595-
596-
Haz clic en `New`:
597-
598-
![jupyter_new.png](images/jupyter_new.png)
599-
600-
Debería abrirse una pestaña en un nuevo notebook:
601-
602-
![jupyter_notebook.png](images/jupyter_notebook.png)
603-
604-
### Chequeo de `nbextensions`
605-
606-
Haz una revisión de las `jupyter notebooks nbextensions`. Haz clic en `Nbextensions`:
607-
608-
![jupyter_nbextensions.png](images/jupyter_nbextensions.png)
609-
610-
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:
611-
612-
![nbextensions.png](images/nbextensions.png)
613-
614-
Puedes cerrar tu navegador web y luego cerrar el servidor jupyter con `CTRL` + `C`.
615-
616-
617-
### Chqueo de la configuración de Python
618-
619573
Verifica tu versión de Python con los siguientes comandos:
620574
```bash
621575
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
631585
python -c "$(curl -fsSL https://raw.githubusercontent.com/lewagon/data-setup/master/checks/pip_check.py)"
632586
```
633587

634-
Asegúrate de que puedas usar Jupyter:
588+
Ahora verifica que puedas iniciar un servidor de notebook en tu máquina:
635589

636590
```bash
637591
jupyter notebook
638592
```
639593

640-
Y abre un notebook `Python 3`.
594+
Tu navegador web debería abrir en una ventana `jupyter`:
595+
596+
![jupyter.png](images/jupyter.png)
597+
598+
Haz clic en `New` y, en el menú desplegable, selecciona Python 3 (ipykernel):
599+
600+
![jupyter_new.png](images/jupyter_new.png)
601+
602+
Debería abrirse una pestaña en un nuevo notebook:
603+
604+
![jupyter_notebook.png](images/jupyter_notebook.png)
641605

642606
Asegúrate de que estés usando la versión correcta de python en el notebook. Abre una celda y ejecuta lo siguiente:
643607
``` python
644608
import sys; sys.version
645609
```
646610

611+
Debería mostrar 3.12.9 seguido de algunos detalles adicionales. Si no es así, consulta con un TA.
612+
613+
Puedes cerrar tu navegador web y luego cerrar el servidor jupyter con `CTRL` + `C`.
614+
647615
¡Listo! Ya tienes un virtual env de python completo con todos los paquetes tercerizados que necesitarás en el bootcamp.
648616

649617

LINUX.md

Lines changed: 25 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -590,64 +590,28 @@ pip install -r https://raw.githubusercontent.com/lewagon/data-setup/master/specs
590590
```
591591

592592

593-
## `jupyter` notebook tweaking and check up
593+
## `jupyter` notebook tweaking
594594

595-
### Custom CSS
595+
Let's improve the display of the [`details` disclosure elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/details) in your notebooks.
596596

597-
Improve the display of the [`details` disclosure elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/details) in your notebooks.
597+
Run the following lines to create a `custom.css` stylesheet in your Jupyter config directory:
598598

599-
Open `custom/custom.css` in the config directory:
600599
```bash
601-
cd $(jupyter --config-dir)
602-
mkdir -p custom
603-
touch custom/custom.css
604-
code custom/custom.css
600+
LOCATION=$(jupyter --config-dir)/custom
601+
SOURCE=https://raw.githubusercontent.com/lewagon/data-setup/refs/heads/master/specs/jupyter/custom.css
602+
mkdir -p $LOCATION
603+
curl $SOURCE > $LOCATION/custom.css
605604
```
606-
Edit `custom.css` with:
607605

608-
```css
609-
summary {
610-
cursor: pointer;
611-
display:list-item;
612-
}
613-
summary::marker {
614-
font-size: 1em;
615-
}
616-
```
617-
618-
You can close VS Code.
619606

620-
### `jupyter` check up
607+
### Python setup check up
621608

622609
Let's reset your terminal:
623610

624611
```bash
625-
exec zsh
626-
```
627-
628-
Now, check you can launch a notebook server on your machine:
629-
630-
```bash
631-
jupyter notebook
612+
cd ~/code && exec zsh
632613
```
633614

634-
Your web browser should open on a `jupyter` window:
635-
636-
![jupyter.png](images/jupyter.png)
637-
638-
Click on `New`:
639-
640-
![jupyter_new.png](images/jupyter_new.png)
641-
642-
A tab should open on a new notebook:
643-
644-
![jupyter_notebook.png](images/jupyter_notebook.png)
645-
646-
You can close your web browser then terminate the jupyter server with `CTRL` + `C`.
647-
648-
649-
### Python setup check up
650-
651615
Check your Python version with the following commands:
652616
```bash
653617
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:
669633
jupyter notebook
670634
```
671635

672-
And open a `Python 3` notebook.
636+
Your web browser should open on a `jupyter` window:
637+
638+
![jupyter.png](images/jupyter.png)
639+
640+
Click on `New` and in the dropdown menu select `Python 3 (ipykernel)`:
673641

674-
Make sure that you are running the correct python version in the notebook. Open a cell and run :
642+
![jupyter_new.png](images/jupyter_new.png)
643+
644+
A tab should open on a new notebook:
645+
646+
![jupyter_notebook.png](images/jupyter_notebook.png)
647+
648+
Make sure that you are running the correct python version in the notebook. Open a cell and run:
675649
``` python
676650
import sys; sys.version
677651
```
678652

653+
It should output `3.12.9` followed by some more details. If not, check with a TA.
654+
655+
You can close your web browser then terminate the jupyter server with `CTRL` + `C`.
656+
679657
Here you have it! A complete python virtual env with all the third-party packages you'll need for the whole bootcamp.
680658

681659

LINUX_keep_current.es.md

Lines changed: 22 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -275,6 +275,12 @@ sudo service docker stop
275275

276276
### Chqueo de la configuración de Python
277277

278+
Reinicia tu terminal:
279+
280+
```bash
281+
cd ~/code && exec zsh
282+
```
283+
278284
Verifica tu versión de Python con los siguientes comandos:
279285
```bash
280286
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
290296
python -c "$(curl -fsSL https://raw.githubusercontent.com/lewagon/data-setup/master/checks/pip_check.py)"
291297
```
292298

293-
Asegúrate de que puedas usar Jupyter:
299+
Ahora verifica que puedas iniciar un servidor de notebook en tu máquina:
294300

295301
```bash
296302
jupyter notebook
297303
```
298304

299-
Y abre un notebook `Python 3`.
305+
Tu navegador web debería abrir en una ventana `jupyter`:
306+
307+
![jupyter.png](images/jupyter.png)
308+
309+
Haz clic en `New` y, en el menú desplegable, selecciona Python 3 (ipykernel):
310+
311+
![jupyter_new.png](images/jupyter_new.png)
312+
313+
Debería abrirse una pestaña en un nuevo notebook:
314+
315+
![jupyter_notebook.png](images/jupyter_notebook.png)
300316

301317
Asegúrate de que estés usando la versión correcta de python en el notebook. Abre una celda y ejecuta lo siguiente:
302318
``` python
303319
import sys; sys.version
304320
```
305321

322+
Debería mostrar 3.12.9 seguido de algunos detalles adicionales. Si no es así, consulta con un TA.
323+
324+
Puedes cerrar tu navegador web y luego cerrar el servidor jupyter con `CTRL` + `C`.
325+
306326
¡Listo! Ya tienes un virtual env de python completo con todos los paquetes tercerizados que necesitarás en el bootcamp.
307327

308328

LINUX_keep_current.md

Lines changed: 22 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -275,6 +275,12 @@ sudo service docker stop
275275

276276
### Python setup check up
277277

278+
Let's reset your terminal:
279+
280+
```bash
281+
cd ~/code && exec zsh
282+
```
283+
278284
Check your Python version with the following commands:
279285
```bash
280286
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:
296302
jupyter notebook
297303
```
298304

299-
And open a `Python 3` notebook.
305+
Your web browser should open on a `jupyter` window:
306+
307+
![jupyter.png](images/jupyter.png)
308+
309+
Click on `New` and in the dropdown menu select `Python 3 (ipykernel)`:
300310

301-
Make sure that you are running the correct python version in the notebook. Open a cell and run :
311+
![jupyter_new.png](images/jupyter_new.png)
312+
313+
A tab should open on a new notebook:
314+
315+
![jupyter_notebook.png](images/jupyter_notebook.png)
316+
317+
Make sure that you are running the correct python version in the notebook. Open a cell and run:
302318
``` python
303319
import sys; sys.version
304320
```
305321

322+
It should output `3.12.9` followed by some more details. If not, check with a TA.
323+
324+
You can close your web browser then terminate the jupyter server with `CTRL` + `C`.
325+
306326
Here you have it! A complete python virtual env with all the third-party packages you'll need for the whole bootcamp.
307327

308328

0 commit comments

Comments
 (0)