| Title: | Plantilla Para Sitios 'pkgdown' De Paquetes De 'rOpenSpain' |
|---|---|
| Description: | Plantilla privada para crear sitios 'pkgdown' de los paquetes de 'rOpenSpain'. Incluye estilos, recursos estáticos y workflows de 'GitHub Actions' para publicar documentación con una identidad visual coherente. |
| Authors: | Diego Hernangómez [aut, cre, cph] (ORCID: <https://orcid.org/0000-0001-8457-4658>, affiliation: rOpenSpain) |
| Maintainer: | Diego Hernangómez <[email protected]> |
| License: | MIT + file LICENSE |
| Version: | 0.2.0.9000 |
| Built: | 2026-07-17 12:51:30 UTC |
| Source: | https://github.com/rOpenSpain/rostemplate |
El workflow de GitHub Actions creado ejecuta R CMD check para tu paquete.
La configuración por defecto ejecuta el check de manera mensual los días 1
de cada mes a las 08:30.
ros_actions_check_cron(pkg = ".", overwrite = TRUE)ros_actions_check_cron(pkg = ".", overwrite = TRUE)
pkg |
Ruta a la raíz del paquete. |
overwrite |
Sobrescribe el workflow si ya se encuentra instalado. |
Puedes aprender cómo configurar la acción cron en el siguiente enlace:
La configuración por defecto es "30 08 1 * *" ("a las 08:30 del día 1 de
cada mes").
Usa crontab.guru para crear tu propia configuración cron.
Se llama por sus efectos secundarios y devuelve NULL de forma
invisible.
pkg <- file.path(tempdir(), "pkgdown-cron") if (!dir.exists(pkg)) { dir.create(pkg) } ros_actions_check_cron(pkg)pkg <- file.path(tempdir(), "pkgdown-cron") if (!dir.exists(pkg)) { dir.create(pkg) } ros_actions_check_cron(pkg)
gh-pages
Instala un workflow de GitHub Actions que crea el sitio pkgdown
de tu paquete en la rama gh-pages de tu repositorio.
ros_actions_pkgdown_branch(pkg = ".", overwrite = TRUE)ros_actions_pkgdown_branch(pkg = ".", overwrite = TRUE)
pkg |
Ruta a la raíz del paquete. |
overwrite |
Sobrescribe el workflow si ya se encuentra instalado. |
Se llama por sus efectos secundarios y devuelve NULL de forma
invisible.
Sitios pkgdown:
ros_actions_pkgdown_docs(),
ros_build()
pkg <- file.path(tempdir(), "pkgdown-branch") if (!dir.exists(pkg)) { dir.create(pkg) } ros_actions_pkgdown_branch(pkg)pkg <- file.path(tempdir(), "pkgdown-branch") if (!dir.exists(pkg)) { dir.create(pkg) } ros_actions_pkgdown_branch(pkg)
/docs
Este workflow de GitHub Actions genera tu sitio pkgdown en la
carpeta docs de tu repositorio.
ros_actions_pkgdown_docs(pkg = ".", overwrite = TRUE)ros_actions_pkgdown_docs(pkg = ".", overwrite = TRUE)
pkg |
Ruta a la raíz del paquete. |
overwrite |
Sobrescribe el workflow si ya se encuentra instalado. |
El resultado final es equivalente a ejecutar ros_build(), con la diferencia
de que este comando se ejecuta en GitHub en lugar de ejecutarse localmente.
Se llama por sus efectos secundarios y devuelve NULL de forma
invisible.
Sitios pkgdown:
ros_actions_pkgdown_branch(),
ros_build()
pkg <- file.path(tempdir(), "pkgdown-docs") if (!dir.exists(pkg)) { dir.create(pkg) } ros_actions_pkgdown_docs(pkg)pkg <- file.path(tempdir(), "pkgdown-docs") if (!dir.exists(pkg)) { dir.create(pkg) } ros_actions_pkgdown_docs(pkg)
README
Añade una insignia de rOpenSpain que redirige a https://ropenspain.es/
en tu archivo README:
ros_badge_ropenspain(install = TRUE)ros_badge_ropenspain(install = TRUE)
install |
Valor lógico. Si es |
Se llama por sus efectos secundarios. Si install es FALSE,
muestra el código markdown de la insignia.
ros_badge_ropenspain(install = FALSE)ros_badge_ropenspain(install = FALSE)
Esta función envuelve pkgdown::build_site().
ros_build(pkg = ".", ...)ros_build(pkg = ".", ...)
pkg |
Path to package. |
... |
Arguments passed on to
|
La única diferencia con pkgdown::build_site() es que te recuerda los pasos
a seguir para configurar rostemplate y pide confirmación antes de
ejecutar pkgdown::build_site(). El resultado se genera en la carpeta
/docs.
Al contrario que ros_actions_pkgdown_branch(), este workflow se ejecuta
localmente.
Se llama por sus efectos secundarios y devuelve NULL de forma
invisible.
Sitios pkgdown:
ros_actions_pkgdown_branch(),
ros_actions_pkgdown_docs()
ros_build()ros_build()
Paletas de colores basadas en el tema de rOpenSpain.
ros_green_pal(n = 4, alpha = 0.9, rev = FALSE) ros_violet_pal(n = 4, alpha = 0.9, rev = FALSE) ros_gradient_pal(n = 4, alpha = 0.9, rev = FALSE) ros_qualitative_pal(n = 6, alpha = 0.9, rev = FALSE) ros_metro_madrid_pal(n = 4, alpha = 0.9, rev = FALSE)ros_green_pal(n = 4, alpha = 0.9, rev = FALSE) ros_violet_pal(n = 4, alpha = 0.9, rev = FALSE) ros_gradient_pal(n = 4, alpha = 0.9, rev = FALSE) ros_qualitative_pal(n = 6, alpha = 0.9, rev = FALSE) ros_metro_madrid_pal(n = 4, alpha = 0.9, rev = FALSE)
n |
Número de colores. |
alpha |
Valor alfa (transparencia) de los colores. |
rev |
Valor lógico. Si es |
Un vector de colores.
scales::show_col(ros_green_pal(9)) scales::show_col(ros_violet_pal(9)) scales::show_col(ros_gradient_pal(9)) scales::show_col(ros_qualitative_pal(9)) scales::show_col(ros_metro_madrid_pal(9))scales::show_col(ros_green_pal(9)) scales::show_col(ros_violet_pal(9)) scales::show_col(ros_gradient_pal(9)) scales::show_col(ros_qualitative_pal(9)) scales::show_col(ros_metro_madrid_pal(9))