Skip to content

Commit f10ca7f

Browse files
xiaohanyuxiaohanyu
committed
docs: blog post for yamlresume/action
1 parent fa139e1 commit f10ca7f

File tree

7 files changed

+950
-0
lines changed

7 files changed

+950
-0
lines changed

‎content/blog/yamlresume-action.mdx‎

Lines changed: 148 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,148 @@
1+
---
2+
title: Automate Resume Builds with YAMLResume GitHub Action
3+
description:
4+
"Build and deploy your resumes automatically using the new YAMLResume GitHub
5+
Action"
6+
author: Xiao Hanyu
7+
profile: https://x.com/xiaohanyu1988
8+
date: 2026-03-12
9+
---
10+
11+
I am thrilled to announce the official
12+
[YAMLResume GitHub Action](https://github.com/marketplace/actions/yamlresume)!
13+
14+
This new action brings the "Resume as Code" philosophy to its natural conclusion
15+
by seamlessly integrating YAMLResume into your CI/CD pipelines.
16+
17+
## Why use a GitHub Action?
18+
19+
YAMLResume has been
20+
[adopted by people on GitHub](https://github.com/yamlresume/yamlresume/discussions/50)
21+
from all over the world. Each has figured out their own workflow to build and
22+
deploy their resumes—some use Makefiles, some use shell scripts, some use GitHub
23+
Actions, some publish to GitHub Pages, etc.
24+
25+
For example:
26+
27+
- [@drzero42](https://github.com/drzero42) use
28+
[docker and gh-relase](https://github.com/drzero42/resume/blob/main/.github/workflows/build-resume.yaml)
29+
to build and host resumes
30+
- [@mortezaPRK](https://github.com/mortezaPRK) use
31+
[Makefile](https://github.com/mortezaPRK/mortezaPRK.github.io/blob/main/Makefile)
32+
- [@shamrt](https://github.com/shamrt) installed
33+
[npm, yamlresume and TinyTeX on GitHub runner](https://github.com/shamrt/yamlresume/blob/main/.github/workflows/deploy.yml)
34+
and use shell script to build and publish resumes )
35+
36+
It is time for us to provide a unified way to do this.
37+
38+
With `yamlresume/action`, you can automate this entirely. By pushing your
39+
updated `resume.yml` to GitHub, the action can automatically:
40+
41+
1. Validate your resume against the YAMLResume schema.
42+
2. Build the PDF, LaTeX, HTML, and Markdown outputs.
43+
3. Attach the generated PDFs to a GitHub Release, upload them as workflow
44+
artifacts, or publish them to GitHub Pages.
45+
46+
Theoretically you never have to build your resume locally again.
47+
48+
## Quick Start
49+
50+
Using the action is incredibly straightforward. Here is a minimal
51+
`.github/workflows/build.yml` example that builds your resume and uploads the
52+
generated PDF as a GitHub Actions artifact:
53+
54+
```yaml
55+
name: Build Resume
56+
57+
on:
58+
push:
59+
branches: [main]
60+
61+
jobs:
62+
build:
63+
runs-on: ubuntu-latest
64+
steps:
65+
- name: Checkout
66+
uses: actions/checkout@v4
67+
68+
- name: Build resume
69+
id: build
70+
uses: yamlresume/action@v0.1.1
71+
with:
72+
resumes: resume.yml
73+
74+
- name: Upload PDF
75+
uses: actions/upload-artifact@v4
76+
with:
77+
name: resume
78+
path: ${{ steps.build.outputs.pdf-files }}
79+
```
80+
81+
## Key Features
82+
83+
The GitHub Action isn't just a simple wrapper; it comes with powerful features
84+
designed for real-world resume management:
85+
86+
### Multiple Resumes in One Go
87+
88+
Many users maintain multiple versions of their resume (e.g., an English version
89+
and a translated version, or a Frontend vs. Backend focused version). You can
90+
build all of them simultaneously by passing a newline-separated list:
91+
92+
```yaml
93+
- uses: yamlresume/action@v0.1.1
94+
with:
95+
resumes: |
96+
resume-en.yml
97+
resume-zh.yml
98+
```
99+
100+
### Customizable Builds
101+
102+
If you have a custom PDF generation pipeline and only need the LaTeX output, or
103+
if you want to skip schema validation for a quick draft, the action provides
104+
`no-pdf` and `no-validate` inputs to tailor the workflow to your needs.
105+
106+
#### Skip PDF Generation
107+
108+
Generate only LaTeX files (useful for custom PDF pipelines):
109+
110+
```yaml
111+
- uses: yamlresume/action@v0.1.1
112+
with:
113+
resumes: resume.yml
114+
no-pdf: true
115+
```
116+
117+
#### Skip Validation
118+
119+
Skip schema validation during build:
120+
121+
```yaml
122+
- uses: yamlresume/action@v0.1.1
123+
with:
124+
resumes: resume.yml
125+
no-validate: true
126+
```
127+
128+
## Under the Hood
129+
130+
The `yamlresume/action` leverages the
131+
[YAMLResume Docker image](https://hub.docker.com/r/yamlresume/yamlresume) that
132+
we [introduced previously](/blog/yamlresume-docker).
133+
134+
Because LaTeX distributions are notoriously large and time-consuming to install
135+
(often taking 20–30 minutes on a GitHub runner), building the resume directly on
136+
the runner would drastically slow down your CI pipeline. By using our
137+
pre-packaged Docker image, the action pulls the necessary environment in a
138+
fraction of the time, resulting in fast, reliable, and consistent builds.
139+
140+
## Try It Out!
141+
142+
Ready to automate your career? Check out the
143+
[yamlresume/action repository](https://github.com/marketplace/actions/yamlresume) to get
144+
started, or read the detailed
145+
[GitHub Action Ecosystem Documentation](/docs/ecosystem/action) for more
146+
configuration options and advanced usage examples.
147+
148+
Happy automating!

‎content/es/blog/yamlresume-action.mdx‎

Lines changed: 152 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,152 @@
1+
---
2+
title: Automatiza las Builds de Currículums con la GitHub Action de YAMLResume
3+
description:
4+
"Construye y despliega tus currículums automáticamente usando la nueva GitHub
5+
Action de YAMLResume"
6+
author: Xiao Hanyu
7+
profile: https://x.com/xiaohanyu1988
8+
date: 2026-03-12
9+
---
10+
11+
¡Me emociona anunciar la oficial
12+
[GitHub Action de YAMLResume](https://github.com/marketplace/actions/yamlresume)!
13+
14+
Esta nueva acción lleva la filosofía de "Currículum como Código" a su
15+
conclusión natural al integrar a la perfección YAMLResume en tus pipelines de
16+
CI/CD.
17+
18+
## ¿Por qué usar una GitHub Action?
19+
20+
YAMLResume ha sido
21+
[adoptado por personas en GitHub](https://github.com/yamlresume/yamlresume/discussions/50)
22+
de todo el mundo. Cada uno ha descubierto su propio flujo de trabajo para crear
23+
y desplegar sus currículums: algunos usan Makefiles, algunos usan scripts de
24+
shell, algunos usan GitHub Actions, algunos publican en GitHub Pages, etc.
25+
26+
Por ejemplo:
27+
28+
- [@drzero42](https://github.com/drzero42) usa
29+
[docker y gh-release](https://github.com/drzero42/resume/blob/main/.github/workflows/build-resume.yaml)
30+
para construir y alojar currículums
31+
- [@mortezaPRK](https://github.com/mortezaPRK) usa
32+
[Makefile](https://github.com/mortezaPRK/mortezaPRK.github.io/blob/main/Makefile)
33+
- [@shamrt](https://github.com/shamrt) instaló
34+
[npm, yamlresume y TinyTeX en el runner de GitHub](https://github.com/shamrt/yamlresume/blob/main/.github/workflows/deploy.yml)
35+
y usa un script de shell para construir y publicar currículums
36+
37+
Es hora de que proporcionemos una forma unificada de hacer esto.
38+
39+
Con `yamlresume/action`, puedes automatizar esto por completo. Al empujar tu
40+
`resume.yml` actualizado a GitHub, la acción puede automáticamente:
41+
42+
1. Validar tu currículum contra el esquema de YAMLResume.
43+
2. Construir las salidas en PDF, LaTeX, HTML y Markdown.
44+
3. Adjuntar los PDFs generados a una GitHub Release, subirlos como artefactos
45+
del flujo de trabajo, o publicarlos en GitHub Pages.
46+
47+
Teóricamente, nunca más tendrás que construir tu currículum localmente.
48+
49+
## Inicio Rápido
50+
51+
Usar la acción es increíblemente sencillo. Aquí tienes un ejemplo mínimo de
52+
`.github/workflows/build.yml` que construye tu currículum y sube el PDF generado
53+
como un artefacto de GitHub Actions:
54+
55+
```yaml
56+
name: Build Resume
57+
58+
on:
59+
push:
60+
branches: [main]
61+
62+
jobs:
63+
build:
64+
runs-on: ubuntu-latest
65+
steps:
66+
- name: Checkout
67+
uses: actions/checkout@v4
68+
69+
- name: Build resume
70+
id: build
71+
uses: yamlresume/action@v0.1.1
72+
with:
73+
resumes: resume.yml
74+
75+
- name: Upload PDF
76+
uses: actions/upload-artifact@v4
77+
with:
78+
name: resume
79+
path: ${{ steps.build.outputs.pdf-files }}
80+
```
81+
82+
## Características Clave
83+
84+
La GitHub Action no es solo un simple envoltorio; viene con características
85+
poderosas diseñadas para la gestión de currículums en el mundo real:
86+
87+
### Múltiples Currículums a la Vez
88+
89+
Muchos usuarios mantienen múltiples versiones de su currículum (por ejemplo,
90+
una versión en inglés y una versión traducida, o una versión enfocada en
91+
Frontend frente a Backend). Puedes construirlas todas simultáneamente pasando
92+
una lista separada por saltos de línea:
93+
94+
```yaml
95+
- uses: yamlresume/action@v0.1.1
96+
with:
97+
resumes: |
98+
resume-en.yml
99+
resume-zh.yml
100+
```
101+
102+
### Builds Personalizables
103+
104+
Si tienes un pipeline de generación de PDF personalizado y solo necesitas la
105+
salida LaTeX, o si quieres omitir la validación del esquema para un borrador
106+
rápido, la acción proporciona las entradas `no-pdf` y `no-validate` para
107+
adaptar el flujo de trabajo a tus necesidades.
108+
109+
#### Omitir la Generación de PDF
110+
111+
Generar solo archivos LaTeX (útil para pipelines de PDF personalizados):
112+
113+
```yaml
114+
- uses: yamlresume/action@v0.1.1
115+
with:
116+
resumes: resume.yml
117+
no-pdf: true
118+
```
119+
120+
#### Omitir la Validación
121+
122+
Omitir la validación de esquemas durante la construcción:
123+
124+
```yaml
125+
- uses: yamlresume/action@v0.1.1
126+
with:
127+
resumes: resume.yml
128+
no-validate: true
129+
```
130+
131+
## Bajo el Capó
132+
133+
`yamlresume/action` aprovecha la
134+
[imagen de Docker de YAMLResume](https://hub.docker.com/r/yamlresume/yamlresume)
135+
que [presentamos anteriormente](/es/blog/yamlresume-docker).
136+
137+
Debido a que las distribuciones de LaTeX son notoriamente grandes y tardan en
138+
instalarse (a menudo tomando de 20 a 30 minutos en un runner de GitHub),
139+
construir el currículum directamente en el runner ralentizaría drásticamente tu
140+
pipeline de CI. Al usar nuestra imagen de Docker preempaquetada, la acción
141+
obtiene el entorno necesario en una fracción del tiempo, resultando en builds
142+
rápidas, confiables y consistentes.
143+
144+
## ¡Pruébalo!
145+
146+
¿Listo para automatizar tu carrera? Echa un vistazo al
147+
[repositorio yamlresume/action](https://github.com/marketplace/actions/yamlresume) para
148+
empezar, o lee la
149+
[Documentación del Ecosistema de la GitHub Action](/es/docs/ecosystem/action)
150+
detallada para más opciones de configuración y ejemplos de uso avanzados.
151+
152+
¡Feliz automatización!

0 commit comments

Comments
 (0)