Frameworks

Retype

Retype es un generador de sitios estáticos, desarrollado en Canadá, que convierte una carpeta de archivos Markdown en un sitio de documentación completo. El resultado es HTML estático que usted aloja donde quiera, como GitHub Pages, Netlify o su propio servidor. Por defecto no instala cookies de seguimiento y solo guarda preferencias de visualización en el almacenamiento local; la analítica aparece únicamente si activa una integración.

Bloquear Retype hasta el consentimiento Escanear mi sitio

Presentación

¿Qué hace Retype?

¿Qué es Retype?

Retype es un generador de sitios estáticos pensado para documentación. Basta con indicarle una carpeta de archivos Markdown y ejecutar retype build o retype start para obtener un sitio completo con navegación, búsqueda de texto completo, modo claro y oscuro y sección de blog. El proyecto se desarrolla en Canadá y se ofrece en una edición gratuita y en la edición de pago Retype Pro, con funciones adicionales. El propio sitio retype.com está construido con Retype.

Desde el punto de vista de la privacidad, lo esencial es que Retype se ejecuta en su equipo o en su sistema de integración continua. El resultado es HTML, CSS y JavaScript que publica en el alojamiento que elija: GitHub Pages, Netlify, Cloudflare Pages, un proveedor europeo o su propio servidor. Retype no aloja su documentación ni recibe datos de sus visitantes.

Datos y cookies que utiliza un sitio Retype

Por defecto, un sitio Retype carga sus propios scripts desde el mismo origen (resources/js/retype.js y un índice de búsqueda Lunr local) y no instala cookies de seguimiento. Guarda algunas preferencias en el navegador: la clave de localStorage retype_scheme recuerda el modo claro u oscuro elegido, claves como doc_history conservan el historial de navegación reciente y claves de sessionStorage como doc_sidebar recuerdan el estado del menú lateral durante la sesión. El servidor de desarrollo local usa además una cookie reloadPosition de cinco segundos para recuperar la posición de desplazamiento tras una recarga.

Los demás tratamientos solo aparecen si usted los activa. El ajuste integrations permite añadir Google Analytics, Google Tag Manager o Plausible Analytics. Los avatares de autores pueden cargarse desde Gravatar, opción activada por defecto, lo que hace que el navegador del visitante contacte con gravatar.com. Su proveedor de alojamiento registra además logs del servidor con direcciones IP.

Implicaciones del RGPD y la LSSI CE

El artículo 5(3) de la Directiva ePrivacy 2002/58/CE y el artículo 22.2 de la LSSI CE exigen consentimiento para almacenar o leer información en el dispositivo, salvo que sea estrictamente necesario para un servicio solicitado expresamente por el usuario. Recordar el tema elegido, el historial o el estado del menú encaja claramente en esa excepción, como confirman la guía de cookies de la AEPD, las directrices de la CNIL y el § 25 TDDDG alemán. Un sitio Retype por defecto puede funcionar sin banner de cookies.

La situación cambia con Google Analytics o Google Tag Manager. Estas herramientas instalan identificadores como _ga, siguen al visitante entre páginas y envían datos a Google en Estados Unidos, por lo que requieren consentimiento previo conforme al artículo 6(1)(a) del RGPD.

¿Cuándo se necesita consentimiento?

No hace falta consentimiento para el sitio Retype básico, el índice de búsqueda local ni el almacenamiento de preferencias. Sí es obligatorio antes de cargar Google Analytics o cualquier etiqueta desplegada mediante Google Tag Manager. Plausible funciona sin cookies y algunas autoridades admiten, en condiciones estrictas, una medición de audiencia exenta, pero la AEPD aplica un criterio prudente, así que revise su configuración. Las imágenes de Gravatar exponen la dirección IP del visitante a Automattic, por lo que muchos equipos desactivan integrations.gravatar.enabled.

Transferencias internacionales de datos

Retype no genera transferencias porque nunca recibe datos de visitantes. Las transferencias dependen de sus decisiones: GitHub Pages y Netlify son empresas estadounidenses, Google Analytics envía datos a Google LLC y Gravatar lo opera Automattic en Estados Unidos. Pueden ampararse en el Data Privacy Framework UE EE. UU. cuando el destinatario está certificado, o en las cláusulas contractuales tipo 2021/914 con una evaluación de transferencias tras Schrems II. Un alojamiento europeo combinado con Plausible mantiene toda la cadena en Europa.

Pasos prácticos para cumplir

Revise su archivo retype.yml: mantenga solo las integraciones necesarias y valore poner integrations.gravatar.enabled en false. Si usa Google Analytics o Google Tag Manager, cárguelos mediante una plataforma de gestión del consentimiento como FlowConsent para que ninguna etiqueta se active antes de una elección explícita, y active Google Consent Mode v2. Elija un proveedor de alojamiento con un contrato de encargo claro y, preferiblemente, centros de datos en la UE.

Por último, publique en el sitio una política de privacidad y una política de cookies que identifiquen retype_scheme y doc_history como estrictamente necesarios, mencionen los logs del alojamiento y describan cada herramienta de analítica con su finalidad, plazo de conservación y garantías de transferencia.

Cumplimiento

Retype y el RGPD

Base jurídica: The core Retype site only uses local storage for preferences requested by the visitor (colour scheme, navigation state), which falls under the strictly necessary exemption of ePrivacy Directive art. 5(3), so no consent is needed and hosting logs rely on legitimate interest under GDPR Art. 6(1)(f). If the owner enables Google Analytics or Google Tag Manager, prior consent under Art. 6(1)(a) is required for those tags. Plausible is generally treated as consent exempt audience measurement depending on the national authority.
Nivel de riesgo: low
Normativa aplicable: GDPR (Regulation (EU) 2016/679), ePrivacy Directive 2002/58/EC art. 5(3), French CNIL guidelines on cookies and trackers, German TDDDG § 25, Spanish LSSI CE art. 22.2 and AEPD guide on cookies. When US based integrations are enabled: EU US Data Privacy Framework, SCC 2021/914 and the Schrems II ruling.

Evaluación de impacto (EIPD)

Un sitio de documentación Retype estándar no requiere una EIPD: no trata datos personales más allá de los registros del proveedor de alojamiento y solo guarda preferencias de interfaz en el navegador. La valoración cambia si activa Google Analytics o Google Tag Manager, que perfilan a los visitantes y transfieren datos a Estados Unidos. Incluso entonces, una EIPD rara vez es obligatoria para una documentación pública, pero el tratamiento debe figurar en su registro de actividades. Revise también el contrato de encargo del tratamiento de su proveedor de alojamiento, que es su verdadero encargado.

Texto de ejemplo para su banner

Usamos nuestro propio almacenamiento para recordar sus preferencias de visualización, como el modo oscuro. Con su consentimiento, también medimos la audiencia para saber qué páginas de la documentación se leen y mejorarlas. Puede aceptar o rechazar la analítica en cualquier momento sin que cambie su acceso a la documentación.

Cookies y rastreadores

Lo que Retype instala y contacta

Método de seguimiento: Retype is a static site generator: it builds plain HTML, CSS and JavaScript files from Markdown at build time, and the output is hosted wherever the owner chooses (GitHub Pages, Netlify, Cloudflare Pages, any web server). The generated site runs its own bundled script (resources/js/retype.js) from the same origin and contains no tracking by default. It stores interface preferences in the browser (localStorage key retype_scheme for the colour scheme, doc_history and similar keys for navigation state) and only adds analytics when the owner enables an integration such as Google Analytics, Google Tag Manager or Plausible.
Ubicación de los servidores: Retype itself does not host content: the site is served by the hosting provider chosen by the owner, so the server location is that of the host (for example GitHub Pages on a global CDN, or an EU host). The Retype project is developed in Canada. Optional integrations send data to their own servers, for example Google in the United States or Plausible in the EU.
Modo sin cookies disponible: Sí

Cookies instaladas (4)

Nombre	Tipo	Duración	Finalidad
retype_scheme	Local storage	Persistent until cleared	Stores the light or dark colour scheme explicitly chosen by the visitor with the theme toggle. Removed when the visitor selects the system scheme. Strictly necessary preference.
doc_history	Local storage	Persistent until cleared	Keeps the list of recently visited documentation pages for in site navigation features. Stored only in the visitor's browser, never sent to Retype.
doc_sidebar	Local storage	Session (sessionStorage)	Session storage entry remembering the sidebar navigation state and scroll position (doc_sidebar, doc_sidebar_scroll) while the tab is open. Strictly necessary for the interface.
reloadPosition	HTTP cookie (first party)	5 seconds	Very short lived cookie written by the Retype script to restore the scroll position after a page reload, mainly during live reload with the local development server. Contains only scroll coordinates.

Dominios de terceros contactados (5)

retype.com
gravatar.com
googletagmanager.com
google-analytics.com
plausible.io

Preguntas

Preguntas frecuentes sobre Retype

¿No encuentra su pregunta? Escríbanos, respondemos rápido.

Escríbanos

¿Qué cookies instala un sitio Retype?

Un sitio Retype por defecto no instala cookies de seguimiento. Usa claves de almacenamiento local como retype_scheme (tema elegido) y doc_history (navegación reciente), además de almacenamiento de sesión para el menú lateral. El servidor de desarrollo local usa brevemente una cookie reloadPosition de cinco segundos. Las demás cookies proceden de su alojamiento o de integraciones activadas, como Google Analytics.

¿Necesito consentimiento de cookies para una documentación Retype?

No para el sitio básico: guardar las preferencias que pide el visitante es estrictamente necesario según el artículo 22.2 de la LSSI CE y la guía de la AEPD. Necesita consentimiento previo en cuanto active Google Analytics o Google Tag Manager. Plausible puede funcionar a veces sin consentimiento, según el criterio de cada autoridad.

¿Cuál es la base jurídica del tratamiento en un sitio Retype?

Los logs de alojamiento y el almacenamiento de preferencias se basan en el interés legítimo del artículo 6(1)(f) del RGPD y en la excepción de lo estrictamente necesario. La analítica con herramientas de Google se basa en el consentimiento del artículo 6(1)(a). Documente ambos en su registro de actividades de tratamiento.

¿Retype transfiere datos a Estados Unidos?

Retype no recibe datos de visitantes, ya que solo se ejecuta al generar el sitio. Las transferencias dependen de su alojamiento (GitHub Pages y Netlify son estadounidenses), de Google Analytics o Google Tag Manager y de los avatares Gravatar que sirve Automattic. Apóyese en el Data Privacy Framework UE EE. UU. o en las cláusulas contractuales tipo 2021/914, o elija un alojamiento europeo.

¿Hace falta una EIPD para un sitio Retype?

Normalmente no. Una documentación pública con almacenamiento de preferencias y logs de servidor presenta un riesgo bajo. Si añade Google Analytics, documente ese seguimiento, pero una EIPD completa rara vez es obligatoria.

¿Cómo cumplir la normativa con Retype?

Mantenga en retype.yml solo las integraciones necesarias y desactive Gravatar con integrations.gravatar.enabled si no lo necesita. Cargue Google Analytics o Google Tag Manager únicamente mediante una plataforma de gestión del consentimiento como FlowConsent, con Google Consent Mode v2. Aloje el sitio con un proveedor que ofrezca un contrato de encargo claro, idealmente en la UE.

¿Qué alternativas respetuosas con la privacidad existen?

MkDocs con el tema Material for MkDocs, Sphinx y Hugo son generadores de código abierto que puede alojar en cualquier proveedor europeo. Para la analítica, herramientas europeas como Plausible, Matomo o Pirsch encajan bien con cualquier documentación estática.

¿Cómo actualizar mi política de cookies para Retype?

Incluya retype_scheme, doc_history y las claves de almacenamiento de sesión como almacenamiento de preferencias estrictamente necesario, y mencione los logs del alojamiento. Añada cada integración activada, como Google Analytics o Gravatar, con su finalidad, plazo de conservación y garantías de transferencia. Revise la política cada vez que cambie retype.yml.

Haga que su sitio cumpla la normativa hoy mismo.

Gratis hasta 25.000 sesiones al mes. Sin tarjeta de crédito, sin compromiso.

Crear mi banner Escanear mi sitio