Frameworks

Retype

Retype est un générateur de sites statiques, développé au Canada, qui transforme un dossier de fichiers Markdown en site de documentation complet. Le résultat est du HTML statique que vous hébergez où vous voulez : GitHub Pages, Netlify ou votre propre serveur. Par défaut, il ne dépose aucun cookie de suivi et ne conserve que des préférences d'affichage dans le stockage local ; l'analyse d'audience n'apparaît que si vous activez une intégration.

Bloquer Retype jusqu'au consentement Scanner mon site

Présentation

Que fait Retype ?

Qu'est ce que Retype ?

Retype est un générateur de sites statiques pensé pour la documentation. Vous lui donnez un dossier de fichiers Markdown, vous lancez la commande retype build ou retype start, et il produit un site complet avec navigation, recherche plein texte, bascule clair ou sombre et section blog. Le projet est développé au Canada et proposé en édition gratuite ainsi qu'en édition payante Retype Pro, qui débloque des fonctions supplémentaires. Le site retype.com est lui même construit avec Retype.

Pour la protection des données, le point clé est que Retype s'exécute sur votre poste ou dans votre chaîne d'intégration continue. Le résultat est du HTML, du CSS et du JavaScript que vous publiez chez l'hébergeur de votre choix : GitHub Pages, Netlify, Cloudflare Pages, un hébergeur européen ou votre propre serveur. Retype n'héberge pas votre documentation et ne reçoit aucune donnée de vos visiteurs.

Données et cookies utilisés par un site Retype

Par défaut, un site Retype charge ses propres scripts depuis la même origine (resources/js/retype.js et un index de recherche Lunr local) et ne dépose aucun cookie de suivi. Il conserve quelques préférences dans le navigateur : la clé localStorage retype_scheme mémorise le mode clair ou sombre choisi, des clés comme doc_history gardent l'historique de navigation récent, et des clés sessionStorage comme doc_sidebar retiennent l'état du menu latéral pendant la session. Le serveur de développement local utilise aussi un cookie reloadPosition de cinq secondes pour restaurer la position de défilement après un rechargement.

Les autres traitements n'apparaissent que si vous les activez. Le paramètre integrations permet d'ajouter Google Analytics, Google Tag Manager ou Plausible Analytics. Les avatars d'auteurs peuvent être chargés depuis Gravatar, option active par défaut, ce qui fait contacter gravatar.com par le navigateur du visiteur. Votre hébergeur enregistre en outre des journaux serveur contenant les adresses IP.

Enjeux RGPD et ePrivacy

L'article 5(3) de la directive ePrivacy 2002/58/CE impose le consentement pour tout stockage ou lecture d'informations sur le terminal, sauf s'il est strictement nécessaire au service demandé par l'utilisateur. Mémoriser le thème choisi, l'historique de navigation ou l'état du menu entre clairement dans cette exemption, comme le rappellent les lignes directrices de la CNIL, le § 25 TDDDG allemand et le guide de l'AEPD. Un site Retype par défaut peut donc fonctionner sans bandeau cookies.

La situation change avec Google Analytics ou Google Tag Manager. Ces outils déposent des identifiants comme _ga, suivent les visiteurs de page en page et envoient des données à Google aux États Unis. Il faut alors un consentement préalable au sens de l'article 6(1)(a) du RGPD.

Quand le consentement est il requis ?

Aucun consentement n'est nécessaire pour le site Retype de base, l'index de recherche local ou le stockage des préférences. Il est requis avant tout chargement de Google Analytics ou d'une balise déployée via Google Tag Manager. Plausible fonctionne sans cookie et la CNIL admet, sous conditions strictes, une mesure d'audience exemptée, mais vérifiez les règles de chaque pays ciblé. Les images Gravatar exposent l'adresse IP du visiteur à Automattic : beaucoup d'équipes désactivent donc integrations.gravatar.enabled.

Transferts de données hors de l'EEE

Retype ne crée aucun transfert puisqu'il ne reçoit aucune donnée de visiteur. Les transferts découlent de vos choix : GitHub Pages et Netlify sont des sociétés américaines, Google Analytics envoie les données à Google LLC et Gravatar est exploité par Automattic aux États Unis. Ces transferts peuvent s'appuyer sur le Data Privacy Framework UE États Unis lorsque le destinataire est certifié, ou sur les clauses contractuelles types 2021/914 accompagnées d'une analyse d'impact post Schrems II. Un hébergeur européen associé à Plausible garde toute la chaîne en Europe.

Mettre votre documentation en conformité

Relisez votre fichier retype.yml : ne gardez que les intégrations réellement utiles et envisagez de passer integrations.gravatar.enabled à false. Si vous utilisez Google Analytics ou Google Tag Manager, chargez les via une plateforme de gestion du consentement comme FlowConsent pour qu'aucune balise ne se déclenche avant un choix explicite, et activez Google Consent Mode v2. Privilégiez un hébergeur doté d'un DPA clair et de centres de données dans l'UE.

Enfin, publiez sur le site une politique de confidentialité et une politique cookies qui listent les entrées retype_scheme et doc_history comme strictement nécessaires, les journaux d'hébergement et chaque outil d'analyse avec sa finalité, sa durée de conservation et ses garanties de transfert.

Conformité

Retype et le RGPD

Base légale: 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.
Niveau de risque: low
Textes applicables: 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.

Analyse d'impact (AIPD)

Un site de documentation Retype standard ne nécessite pas d'AIPD : il ne traite pas de données personnelles hormis les journaux de l'hébergeur et ne stocke que des préférences d'interface dans le navigateur. L'analyse change si vous activez Google Analytics ou Google Tag Manager, qui suivent les visiteurs et transfèrent des données vers les États Unis. Même dans ce cas, une AIPD est rarement obligatoire pour une documentation publique, mais le traitement doit figurer dans votre registre. Vérifiez aussi le DPA de votre hébergeur, qui est votre véritable sous traitant.

Exemple de texte pour votre bannière

Nous utilisons notre propre stockage pour mémoriser vos préférences d'affichage, comme le mode sombre. Avec votre accord, nous mesurons aussi l'audience pour savoir quelles pages de la documentation sont lues et les améliorer. Vous pouvez accepter ou refuser la mesure d'audience à tout moment, sans conséquence sur l'accès à la documentation.

Cookies et traceurs

Ce que Retype dépose et contacte

Méthode de suivi: 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.
Localisation des serveurs: 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.
Mode sans cookie disponible: Oui

Cookies déposés (4)

Nom	Type	Durée	Finalité
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.

Domaines tiers contactés (5)

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

Questions

Questions fréquentes sur Retype

Une question qui n'est pas dans la liste ? Écrivez-nous, on répond vite.

Nous écrire

Quels cookies un site Retype dépose t il ?

Un site Retype par défaut ne dépose aucun cookie de suivi. Il utilise des clés de stockage local comme retype_scheme (thème choisi) et doc_history (navigation récente), ainsi que le stockage de session pour le menu latéral. Le serveur de développement local utilise brièvement un cookie reloadPosition de cinq secondes. Les autres cookies proviennent de votre hébergeur ou des intégrations activées, comme Google Analytics.

Faut il un bandeau de consentement pour une documentation Retype ?

Pas pour le site de base : le stockage des préférences demandées par le visiteur est strictement nécessaire au sens de l'article 5(3) de la directive ePrivacy et des lignes directrices de la CNIL. Un consentement préalable devient obligatoire dès que vous activez Google Analytics ou Google Tag Manager. Plausible peut souvent bénéficier de l'exemption de mesure d'audience, sous conditions.

Quelle base légale pour les traitements d'un site Retype ?

Les journaux d'hébergement et le stockage des préférences reposent sur l'intérêt légitime (article 6(1)(f) du RGPD) et sur l'exemption des traceurs strictement nécessaires. La mesure d'audience via les outils Google repose sur le consentement (article 6(1)(a)). Documentez ces traitements dans votre registre.

Retype transfère t il des données vers les États Unis ?

Retype ne reçoit aucune donnée de visiteur, car il ne s'exécute qu'au moment de la génération. Les transferts dépendent de votre hébergeur (GitHub Pages et Netlify sont américains), de Google Analytics ou Google Tag Manager et des avatars Gravatar servis par Automattic. Appuyez vous sur le Data Privacy Framework UE États Unis ou les clauses contractuelles types 2021/914, ou choisissez un hébergement européen.

Une AIPD est elle nécessaire pour un site Retype ?

En général non. Une documentation publique avec stockage de préférences et journaux serveur présente un risque faible. Si vous ajoutez Google Analytics, documentez ce suivi dans votre registre, mais une AIPD complète n'est que rarement exigée.

Comment rendre un site Retype conforme ?

Ne gardez dans retype.yml que les intégrations utiles et désactivez Gravatar via integrations.gravatar.enabled si vous n'en avez pas besoin. Chargez Google Analytics ou Google Tag Manager uniquement via une plateforme de gestion du consentement comme FlowConsent, avec Google Consent Mode v2. Hébergez le site chez un prestataire doté d'un DPA clair, idéalement dans l'UE.

Quelles alternatives respectueuses de la vie privée à Retype ?

MkDocs avec le thème Material for MkDocs, Sphinx et Hugo sont des générateurs open source que vous pouvez héberger chez n'importe quel prestataire européen. Côté mesure d'audience, des outils européens comme Plausible, Matomo ou Pirsch s'intègrent bien à toute documentation statique.

Comment mettre à jour ma politique cookies pour Retype ?

Listez retype_scheme, doc_history et les clés de stockage de session comme stockage de préférences strictement nécessaire, et mentionnez les journaux de l'hébergeur. Ajoutez chaque intégration activée, comme Google Analytics ou Gravatar, avec sa finalité, sa durée de conservation et ses garanties de transfert. Révisez la politique à chaque modification de retype.yml.

Mettez votre site en conformité aujourd'hui.

Gratuit jusqu'à 25 000 sessions par mois. Sans carte bancaire, sans engagement.

Créer ma bannière Scanner mon site