Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fralfaro/ds-python-course
Python course template (Spanish)
https://github.com/fralfaro/ds-python-course
mkdocs python template-repository
Last synced: 2 days ago
JSON representation
Python course template (Spanish)
- Host: GitHub
- URL: https://github.com/fralfaro/ds-python-course
- Owner: fralfaro
- License: mit
- Created: 2023-07-24T12:23:42.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-04-05T02:36:06.000Z (10 months ago)
- Last Synced: 2024-11-22T15:42:12.436Z (2 months ago)
- Topics: mkdocs, python, template-repository
- Homepage: https://fralfaro.github.io/DS-Python-Course/
- Size: 1.85 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Curso de Python (Template)
## Descripción del Repositorio
```
|
├───.github
│ └───workflows
│ documentation.yml
│
├────docs
│ ├───.images
│ │ logo.bmp
│ │ logo_python.svg
│ │
│ │ __init__.py
│ │ basic.ipynb
│ │ index.md
│ │ intro.ipynb
│ │ pandas.ipynb
│ │ seaborn.ipynb
│
│ .gitignore
│ LICENSE
│ mkdocs.yml
│ poetry.lock
│ pyproject.toml
│ README.md
```
donde:
* `documentation.yml`: archivo para generar el CI del proyecto.
* `docs`: carpeta donde se almacenan los jupyter notebooks.
* `images`: carpeta con las imagenes del *logo* y el *favicon*.
* `index.md`: archivo markdown inicial.
* `*.ipynb`: archivos jupyter notebook.
* `.gitignore`: lugar donde se define los archivos a ignorar.
* `LICENSE`: licencia asociada al proyecto.
* `mkdocs.yml`: archivo que orquestará la documentación del proyecto.
* `poetry.lock`: archivo que orquestará el proyecto y sus dependencias.
* `pyproject.toml`: archivo que orquestará el proyecto y sus dependencias.
* `README.md`: archivo que describe el repositorio.
## Github Settings
### Actions
1. Ir a `Settings -> Actions -> General`.
2. Marcar las opciones como se muestra en la imagen y guardar sus cambios.
### Pages
1. Ir a `Settings -> Pages -> GitHub Pages`.
2. Marcar las opciones como se muestra en la imagen y guardar sus cambios.
> **Nota**: Primero debe realizar los cambios en `Actions`, realizar un `git push` (de algún archivo) para habilitar esta opción correctamente.
## Archivos a modificar
### [Readme.md](README.md)
```
```
Debe cambiar:
* **fralfaro**: nombre de usuario en github.
* **DS-Python-Course**: nombre del curso.
### [`mkdocs.yml`](mkdocs.yml)
**Sección**: Project information - Repository
```
# Project information
site_name: Home
site_url: https://github.com/fralfaro/DS-Python-Course
site_author: Francisco Alfaro
site_description:
# Repository
repo_name: fralfaro/DS-Python-Course
repo_url: https://github.com/fralfaro/DS-Python-Course
edit_uri: ''
```
Debe cambiar:
* **fralfaro**: nombre de usuario en github.
* **DS-Python-Course**: nombre del curso.
* **site_author**: Nombre del autor
**Sección**: Theme
```
# Theme
theme:
name: material
language: es
logo: images/logo.bmp
favicon: images/logo_python.svg
```
Debe cambiar:
* **favicon**: imagen a utilizar como *favicon*.
**Sección**: Customization
```
# Customization
extra:
social:
- icon: fontawesome/brands/github
link: https://github.com/fralfaro
- icon: fontawesome/brands/linkedin
link: https://www.linkedin.com/in/faam/
- icon: fontawesome/solid/globe
link: https://fralfaro.github.io/portfolio/
```
En esta sección se agregan las redes sociales
que ustedes maneja (más detalles,
ver el siguiente [link](https://squidfunk.github.io/mkdocs-material/reference/icons-emojis/#with-animations)).
**Sección**: TOC
```
# TOC
nav:
- Home: index.md
- Conceptos Básicos:
- intro.ipynb
- basic.ipynb
- Manipulación Datos:
- pandas.ipynb
- seaborn.ipynb
```
En esta sección se agregan los archivos `.ipynb` que necesita agregar a su documentación.
### Otros
#### [`pyproject.toml`](pyproject.toml)
```
[tool.poetry]
name = "docs"
version = "0.1.0"
description = "mkdocs - courses"
authors = ["Francisco Alfaro "]
license = "MIT"
readme = "README.md"
```
Cambiar `authors` por su nombre y correo personal.
#### [`index.md`](docs/index.md)
```
# Home
Introducción básica a Python
## Material
El material está disponible en el siguiente [repositorio](https://github.com/fralfaro/DS-Python-Course), para obtener el código de fuente basta con que ejecutes el siguiente comando:
> `https://github.com/fralfaro/DS-Python-Course`
## Contenidos temáticos
* Introducción a Python
* Nomenclatura
* Introducción Pandas
* Introducción Seaborn
```
Debe cambiar:
* **fralfaro**: nombre de usuario en github.
* **DS-Python-Course**: nombre del curso.
> **Nota**: Si necesita customizar su repositorio, se recomienda leer el siguiente [link](https://squidfunk.github.io/mkdocs-material/).
## Recomendaciones
Para efectos prácticos, se recomienda tener sus datos (*datasets* e *imágenes*) en **Google Drive**,
en donde tenga la información separada en dos carpetas:
* `datasets`: carpeta con los datasets del curso.
* `images`: carpeta con las imágenes del curso.
> **Nota**: Ver la siguiente [carpeta](https://drive.google.com/drive/folders/1A9uGb7heCV-b8AsFgumhWcRy1SAG8_Ru?usp=sharing) a modo de ejemplo.
Debe habilitar la opción `Share -> General access -> Anyone whit the link`, para que otras personas pudan leer
los datasets y las imágenes de su carpeta.
1. En Jupyter notebook, para mostrar una imagen, se utiliza la siguiente sequencia:
```markdown
```
donde `` corresponde al id de su imagen a compartir desde Google Drive.
2. En Jupyter notebook, para leer un dataframe con `pandas`, se utiliza la siguiente sequencia:
```python
import pandas as pd
url=''
url='https://drive.google.com/uc?id=' + url.split('/')[-2]
df = pd.read_csv(url, sep="," )
```
donde `` corresponde a la URL de su dataset a compartir desde Google Drive.