Skip to content

Migrate Pelican setup to Python 3.14 + uv #233

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
alehpineda merged 2 commits into from
Feb 15, 2026
Merged

Migrate Pelican setup to Python 3.14 + uv #233

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
4405f19
build: migrate CI and dependencies to Python 3.14 with uv
alehpineda Feb 14, 2026
b0c6a41
docs: refresh setup and local development commands for uv
alehpineda Feb 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 9 additions & 9 deletions .github/workflows/build.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,19 +10,19 @@ jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Set up Python 3.10
uses: actions/setup-python@v4
- uses: actions/checkout@v4
- name: Set up Python 3.14
uses: actions/setup-python@v5
with:
python-version: '3.10'
cache: 'pip'
python-version: '3.14'
- name: Set up uv
uses: astral-sh/setup-uv@v4
- name: Install dependencies
run: |
python -m pip install --upgrade pip
pip install -r requirements.txt
uv sync --frozen
- name: Install theme
run: |
pelican-themes -i pelican-themes/bs5
uv run pelican-themes -i pelican-themes/bs5
- name: Build site
run: |
pelican content -o output -s pelicanconf.py
uv run pelican content -o output -s pelicanconf.py
20 changes: 10 additions & 10 deletions .github/workflows/publish.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,25 +10,25 @@ jobs:
publish:
runs-on: ubuntu-latest
steps:
Comment on lines 10 to 12
Copy link

Copilot AI Feb 14, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This workflow pushes back to the repo (git push -f origin master). To make that reliable across org/repo settings, explicitly set job/workflow permissions: contents: write (otherwise GITHUB_TOKEN is often read-only by default and the push can fail).

Copilot uses AI. Check for mistakes.
- uses: actions/checkout@v3
- name: Set up Python 3.10
uses: actions/setup-python@v4
- uses: actions/checkout@v4
- name: Set up Python 3.14
uses: actions/setup-python@v5
with:
python-version: '3.10'
cache: 'pip'
python-version: '3.14'
- name: Set up uv
uses: astral-sh/setup-uv@v4
- name: Install dependencies
run: |
python -m pip install --upgrade pip
pip install -r requirements.txt
uv sync --frozen
- name: Install theme
run: |
pelican-themes -i pelican-themes/bs5
uv run pelican-themes -i pelican-themes/bs5
- name: Build site
run: |
pelican content -o output -s pelicanconf.py
uv run pelican content -o output -s pelicanconf.py
- name: Update local site branch
run: |
ghp-import output -b master
uv run ghp-import output -b master
- name: Push local site to remote
run: |
git push -f origin master
11 changes: 6 additions & 5 deletions CONTRIBUTING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,8 @@ category: Junta Ordinaria
### Prerequisitos
1. Tener git instalado y cuenta de github.
2. Editor de texto favorito.
3. Python 3.8+ instalado.
3. Python 3.14+ instalado.
4. uv instalado.


Sigue estos pasos para aportar a este repositorio.
Expand All @@ -71,10 +72,10 @@ git clone https://github.com/GULAG/gulag.github.io.git
cd gulag.github.io
```

4. Instalar las librerias en `requirements.txt`
4. Instalar las librerias

```bash
pip install -r requirements.txt
uv sync --frozen
```

5. Crea un branch con el numero del issue.
Expand All @@ -92,10 +93,10 @@ git checkout -b issue_09/migracion_01

```bash
# construir el sitio
pelican content -o output -s pelicanconf.py
uv run pelican content -o output -s pelicanconf.py

# correr el sitio en server local
pelican -l -r
uv run pelican -l -r

# presiona ctrl+c para salir del server local
```
Expand Down
12 changes: 6 additions & 6 deletions CONTRIBUTING_en_US.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,8 @@ category: Junta Ordinaria
### Prerequisites
1. Have git installed and a github account.
2. Use your favorite text editor.
3. Have Python 3.8+ installed.
3. Have Python 3.14+ installed.
4. Have uv installed.


Follow these steps to contribute to this repository.
Expand All @@ -71,10 +72,10 @@ git clone https://github.com/GULAG/gulag.github.io.git
cd gulag.github.io
```

4. Install the libraries found in `requirements.txt`
4. Install the libraries

```bash
pip install -r requirements.txt
uv sync --frozen
```

5. Create a branch with the issue number.
Expand All @@ -92,10 +93,10 @@ git checkout -b issue_09/migration_01

```bash
# build the site
pelican content -o output -s pelicanconf.py
uv run pelican content -o output -s pelicanconf.py

# run the site in the local server
pelican -l -r
uv run pelican -l -r

# press ctrl+c to exit the local server
```
Expand Down Expand Up @@ -137,4 +138,3 @@ Title: Issue 9 | Migration 01
16. Click the button `Create PR`. This launches the site's CI process. If it goes through the checks, congratulations! Your PR will be ready to `merge`. Wait for someone in the team to review it.

17. If it doesn't go through the checks, don't worry. Review the log and try again. Leave a comment and we'll help you.

11 changes: 6 additions & 5 deletions CONTRIBUTING_es_MX.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,8 @@ category: Junta Ordinaria
### Prerequisitos
1. Tener git instalado y cuenta de github.
2. Editor de texto favorito.
3. Python 3.8+ instalado.
3. Python 3.14+ instalado.
4. uv instalado.


Sigue estos pasos para aportar a este repositorio.
Expand All @@ -71,10 +72,10 @@ git clone https://github.com/GULAG/gulag.github.io.git
cd gulag.github.io
```

4. Instalar las librerias en `requirements.txt`
4. Instalar las librerias

```bash
pip install -r requirements.txt
uv sync --frozen
```

5. Crea un branch con el numero del issue.
Expand All @@ -92,10 +93,10 @@ git checkout -b issue_09/migracion_01

```bash
# construir el sitio
pelican content -o output -s pelicanconf.py
uv run pelican content -o output -s pelicanconf.py

# correr el sitio en server local
pelican -l -r
uv run pelican -l -r

# presiona ctrl+c para salir del server local
```
Expand Down
11 changes: 6 additions & 5 deletions CONTRIBUTING_pr_BR.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,8 @@ Categoria: Reunião Ordinaria
### Pré-requisitos
1. Ter git instalado e conta no github;
2. Editor de texto favorito;
3. Python 3.8+ instalado.
3. Python 3.14+ instalado.
4. uv instalado.


Siga estes passos para contribuir com este repositorio.
Expand All @@ -71,10 +72,10 @@ git clone https://github.com/GULAG/gulag.github.io.git
cd gulag.github.io
```

4. Instale as bibliotecas em `requirements.txt`
4. Instale as bibliotecas

```bash
pip install -r requirements.txt
uv sync --frozen
```

5. Crie um branch com o numero do issue.
Expand All @@ -92,10 +93,10 @@ git checkout -b issue_09/migracion_01

```bash
# construa o site
pelican content -o output -s pelicanconf.py
uv run pelican content -o output -s pelicanconf.py

# execute o site em um server local
pelican -l -r
uv run pelican -l -r

# pressiona ctrl+c para sair do server local
```
Expand Down
43 changes: 35 additions & 8 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,35 @@

Website for the GNU/Linux Users Group of la Laguna (Grupo de Usuarios GNU/Linux de la Laguna)

[http://www.gulag.org.mx/](http://www.gulag.org.mx/)

## Participation Guides for HacktoberFest 2022
[http://www.gulag.org.mx/](http://www.gulag.org.mx/)

## Local development

### 1) Install uv

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

Alternative installers are available at: https://docs.astral.sh/uv/getting-started/installation/

### 2) Install repository dependencies

```bash
uv sync --frozen
```

### 3) Run Pelican commands

```bash
# build the site
uv run pelican content -o output -s pelicanconf.py

# run local development server with autoreload
uv run pelican -l -r
```

## Participation Guides for HacktoberFest 2022

Our guides about how to contribute to this `hacktoberfest` in this repository.

Expand All @@ -20,7 +46,8 @@ Our guides about how to contribute to this `hacktoberfest` in this repository.

- Having a GitHub account and Git installed in your device.
- Use your favorite text editor.
- Have Python 3.8+ installed in your device.
- Have Python 3.14+ installed in your device.
- Have uv installed in your device.

Follow these steps to contribute to this repository.

Expand All @@ -40,10 +67,10 @@ git clone https://github.com/GULAG/gulag.github.io.git
cd gulag.github.io
```

3. Install the libraries found in `requirements.txt`
3. Install the libraries

```bash
pip install -r requirements.txt
uv sync --frozen
```

4. Create a branch with the date and the name of the article.
Expand Down Expand Up @@ -75,10 +102,10 @@ If your article has images, create a folder with the same name as your article a

```bash
# build the site
pelican content -o output -s pelicanconf.py
uv run pelican content -o output -s pelicanconf.py

# run the site in local server
pelican -l -r
uv run pelican -l -r

#press ctrl+c to exit the local server
Copy link

Copilot AI Feb 14, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Minor formatting in the shell comment: add a space after # so it renders/readability matches the other comments.

Suggested change
#press ctrl+c to exit the local server
# press ctrl+c to exit the local server

Copilot uses AI. Check for mistakes.
```
Expand Down
11 changes: 6 additions & 5 deletions README_es_MX.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,8 @@ Nuestras guias de como aportar en este `hacktoberfest` en este repositorio.

- Tener git instalado y cuenta de github.
- Editor de texto favorito.
- Python 3.8+ instalado.
- Python 3.14+ instalado.
- uv instalado.

Sigue estos pasos para aportar a este repositorio.

Expand All @@ -40,10 +41,10 @@ git clone https://github.com/GULAG/gulag.github.io.git
cd gulag.github.io
```

3. Instalar las librerias en `requirements.txt`
3. Instalar las librerias

```bash
pip install -r requirements.txt
uv sync --frozen
```

4. Crea un branch con la fecha y el nombre del articulo.
Expand Down Expand Up @@ -75,10 +76,10 @@ Si tu articulo tiene imagenes, crea una carpeta con el mismo nombre que tu artic

```bash
# construir el sitio
pelican content -o output -s pelicanconf.py
uv run pelican content -o output -s pelicanconf.py

# correr el sitio en server local
pelican -l -r
uv run pelican -l -r

# presiona ctrl+c para salir del server local
```
Expand Down
14 changes: 14 additions & 0 deletions pyproject.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
[project]
name = "gulag-blog"
version = "0.1.0"
description = "Pelican site for GULAG"
requires-python = ">=3.14"
dependencies = [
"ghp-import",
"markdown",
"pelican",
"typogrify",
]

[tool.uv]
required-version = ">=0.5.0"
4 changes: 0 additions & 4 deletions requirements.txt
View file
Open in desktop

This file was deleted.

Loading