Ce site a été construit comme un atlas cognitif et analytique fondé sur des fichiers Markdown, un réseau de liens internes, et des couches éditoriales et programmatiques qui permettent de transformer une vaste matière intellectuelle en parcours de lecture navigables et révisables. Le site ne repose pas sur une base de données éditoriale fermée, mais sur des fichiers texte vérifiables et reconstructibles, ensuite convertis en pages statiques et en fichiers de données publics.
Cette page présente les ressources techniques, visuelles et méthodologiques qui ont servi à la construction du site. Son objectif est la transparence : qu’a-t-on utilisé pour l’interface ? qu’a-t-on utilisé pour la construction ? et quelles sont les limites du rôle des outils par rapport au travail éditorial humain ? La mention de tout outil ou plateforme ici ne signifie pas qu’il ou elle est responsable du contenu de l’atlas ou qu’il ou elle l’approuve ; elle précise seulement son emplacement dans le flux de travail.
Le système utilisé
Le site repose sur Quartz, un cadre open source permettant de transformer des notes Markdown en un site cognitif navigable.
Quartz a été modifié et personnalisé pour s’adapter à la nature de cet atlas, en termes de structure, d’affichage, de langue arabe, de liens internes, de pages de concepts et de parcours, ainsi que d’index des sources et des données.
Les pages sont construites à partir de fichiers Markdown locaux, puis publiées sous forme de pages statiques consultables et recherchables.
La personnalisation comprend :
- la prise en charge d’une expérience de lecture arabe en RTL.
- l’organisation de l’explorateur latéral selon la structure de l’atlas et non selon le seul ordre des fichiers.
- la construction de pages Markdown d’accompagnement pour l’usage de recherche.
- la génération de données publiques téléchargeables sur les pages et les relations.
- le maillage des pages de concepts, de livres, de parcours et de versets par des liens internes traçables.
Des couches propres à l’atlas ont également été ajoutées et ne proviennent pas de Quartz seul, notamment des pages de sources, des pages d’atomes et d’agrégations, des pages de relations conceptuelles, des pages d’axes de versets, ainsi que des outils de lecture et de citation. Le cadre de base est donc Quartz, tandis que la structure de l’atlas, sa méthode et ses liens constituent une construction personnalisée par-dessus.
Les polices
Le site utilise les polices suivantes :
Les polices sont utilisées uniquement à des fins d’affichage et de lecture, selon leurs licences ou conditions propres. Elles ont été choisies parce qu’elles offrent à la langue arabe un espace de lecture plus clair entre les titres, le corps du texte et les marges techniques.
Le site repose sur une séparation fonctionnelle entre les polices :
- une police pour l’interface et les éléments brefs.
- une police pour le long corps de texte.
- une police pour les titres et les principaux repères visuels.
Cette séparation aide à maintenir les longues pages de recherche lisibles sans les transformer en interface décorative ou en simple page d’exposition.
Lorsque les polices ne peuvent pas être chargées, le site revient à des polices système appropriées afin que les pages demeurent lisibles. L’accès au contenu ne dépend donc pas du chargement d’une police particulière, même si l’identité visuelle complète apparaît lorsque les polices sont disponibles.
Les outils
Des outils d’édition et d’analyse ont été utilisés pour organiser la matière et construire les couches de connaissance, notamment Obsidian, des scripts locaux, des outils OCR et des modèles linguistiques via OpenAI API, avec une relecture et une édition humaines avant publication.
Ces outils interviennent à différentes étapes :
- organisation des fichiers, des liens et des notes initiales.
- transformation de la matière en pages, concepts et parcours.
- vérification de la cohérence interne et des liens.
- construction de données publiques pour les pages et les relations.
- révision des brouillons et des alertes éditoriales avant publication.
Obsidian est utilisé comme environnement d’édition et d’organisation pour les fichiers Markdown et les liens internes, non comme plateforme de publication. Les scripts locaux servent, quant à eux, à construire les index et les données, et à vérifier l’intégrité des liens et des pages avant publication.
Les modèles linguistiques via OpenAI API ne sont pas traités comme une source cognitive autonome dans l’atlas, mais comme des outils d’aide à l’analyse, à la formulation, à la révision et à la détection des lacunes. Leurs sorties ne sont pas publiées comme un jugement final et ne remplacent pas le recours aux sources originales ni la révision éditoriale.
Distillary est également mentionnée dans les crédits techniques et méthodologiques comme l’un des outils ou méthodologies d’appui utilisés pour transformer certains matériaux en structures indexables, interconnectables et révisables. Cette mention n’en fait pas une source du contenu original, ni un substitut aux livres de Muhammad Shahrur et à ses matériaux publiés, ni une entité responsable des conclusions et analyses éditoriales figurant dans l’atlas.
Les données et les scripts
Le projet utilise des scripts locaux pour construire des parties du site et de ses données, notamment :
- la construction des index publics des pages.
- la génération de données RAG et de fichiers JSONL vérifiables.
- la construction de relations initiales entre concepts et versets.
- la génération de pages Markdown d’aide pour la lecture de recherche.
- la vérification de la sécurité de la publication avant la mise en ligne du site.
Ces scripts ne changent pas la nature du site en tant que site statique, mais ils rendent la structure cognitive vérifiable et reconstructible, au lieu de simples pages séparées sans trace de données.
La construction produit un certain nombre de fichiers publics légers dans la section des données, tels que l’index des pages, les données du graphe et les indicateurs de récupération. Ces fichiers n’ont pas vocation à constituer une base de données complète du projet, mais une fenêtre technique permettant d’examiner ce qui a été construit : quelles pages existent ? comment sont-elles reliées ? et quels sont les points qui nécessitent une révision ou un meilleur maillage ?
Des détails supplémentaires se trouvent dans Données de l’atlas, ainsi que dans la représentation graphique pour quiconque souhaite lire la structure des liens et non pas seulement les textes.
Les sources et la conversion initiale
L’atlas s’appuie sur le retour aux sources originales lors de la construction des parcours et des analyses. Des outils OCR, de transcription ou d’indexation initiale peuvent être utilisés pour préparer la matière, mais ces sorties sont traitées comme des matériaux de travail nécessitant une révision.
Les pages de l’atlas ne reposent pas uniquement sur une transcription automatique dans les endroits sensibles, en particulier pour les titres de livres, les versets, les termes et les renvois. C’est pourquoi il existe une couche éditoriale qui sépare la préparation automatique de la publication publique.
Lorsqu’un matériau provient d’une source écrite ou audiovisuelle, l’objectif est la citation, l’organisation et l’analyse, et non la republication de la source ni sa transformation en substitut de l’original. C’est pourquoi les pages relatives aux droits et à l’usage sont distinctes de la page des crédits techniques : la première concerne les limites d’utilisation du matériau, tandis que la présente page concerne les outils et la structure.
L’hébergement
Le site est publié via Cloudflare Pages en tant que site statique. L’hébergement est utilisé pour servir le site et améliorer les performances et l’accès, sans modifier la nature du contenu en tant qu’atlas analytique indépendant.
Certaines services Cloudflare d’appui sont utilisés selon les besoins, tels que :
- la publication de pages statiques.
- la gestion des redirections et des liens.
- la protection des formulaires de contact lorsqu’ils sont activés.
- l’exécution de certains points API liés à la recherche ou à la récupération lorsque c’est nécessaire.
Le choix d’une publication statique est délibéré : les pages principales doivent rester téléchargeables directement et fonctionner sans dépendre entièrement d’une application interactive ou d’un tableau de bord d’administration. Les fonctions dynamiques, comme les formulaires de contact ou certains outils de récupération, demeurent une couche d’appui au-dessus du site et non une condition de lecture de ses pages.
Services d’appui
- Cloudflare Turnstile : pour la vérification de sécurité dans les formulaires de contact, lorsqu’il est activé.
- Google Analytics : pour mesurer un trafic général et limité conformément à la politique de confidentialité et des cookies.
Ces services sont mentionnés parce que le lecteur peut les rencontrer dans les formulaires de contact ou dans la politique de confidentialité. Leur usage est limité à des fonctions opérationnelles : la protection contre les messages automatiques, la compréhension de l’usage général et l’amélioration de l’accessibilité des pages.
Confidentialité et mesure
Le site utilise une mesure limitée des visites avec le consentement du lecteur, comme expliqué dans la politique de confidentialité et des cookies.
L’objectif de cette mesure est de comprendre les pages les plus utilisées, d’améliorer l’expérience de lecture et de repérer les dysfonctionnements ou les parcours peu clairs. Ces données ne sont pas utilisées pour modifier le contenu de l’atlas selon un profil individuel du lecteur.
Limites de l’appui
Les outils mentionnés ici aident à la construction, mais ils ne transfèrent pas la responsabilité éditoriale à une quelconque entité extérieure.
Le contenu de l’atlas, les choix de maillage, la formulation des parcours, l’organisation des concepts et les limites de publication restent sous la responsabilité de ce projet. Les cadres techniques et les services externes aident à l’affichage, à la construction et à la vérification, mais ils ne sont ni une source du contenu ni une instance d’approbation intellectuelle ou juridique.
Quant aux droits relatifs aux livres, aux matériaux audio et visuels, et aux sources originales, ils demeurent réservés à leurs titulaires, comme indiqué dans les droits d’auteur et d’usage.