Home

Spectral Lab — open-source publishing tools documentation

Spectral Cloud

Unified platform for editorial and publishing tools. Single sign-on, secure API key management, and one-click access to all Spectral Lab applications.

Preparo

Markdown editor for manuscript preparation and publishing. WYSIWYG editing with Pandoc extensions, Zotero bibliography integration, and multi-format export (EPUB, DOCX, PDF).

Refero

Web client for Zotero. Three-pane interface for managing bibliographic references with catalog search, file import, ISBN barcode scanner, and multi-format export.

AutomaticBook

Automated book creation suite for Adobe InDesign. Import manuscripts from YAML + Markdown, apply templates, generate complete books with micro-typography correction.

Spectral Lab — MIT / AGPL v3

Home

Spectral Lab — documentation des outils open-source pour l'édition

Spectral Cloud

Plateforme unifiée pour les outils d’édition et de publication. Authentification unique, gestion sécurisée des clés API et accès en un clic à toutes les applications Spectral Lab.

Preparo

Éditeur Markdown pour la préparation et la publication de manuscrits. Édition WYSIWYG avec extensions Pandoc, intégration bibliographique Zotero et export multi-formats (EPUB, DOCX, PDF).

Refero

Client web pour Zotero. Interface à trois panneaux pour gérer les références bibliographiques avec recherche dans les catalogues, import de fichiers, scanner ISBN et export multi-formats.

AutomaticBook

Suite de création automatisée de livres pour Adobe InDesign. Import de manuscrits depuis YAML + Markdown, application de gabarits, génération de livres complets avec correction micro-typographique.

Spectral Lab — MIT / AGPL v3

Spectral Cloud

Unified platform for editorial and publishing tools

Quick Start

1. Go to the Spectral Cloud portal in your browser
2. Create an account (email and password)
3. Add your Zotero API key in Settings > API Keys
4. Launch Preparo or Refero from the dashboard
5. You are automatically authenticated in each application via SSO

Overview

Spectral Cloud is the central hub that connects all Spectral Lab publishing tools. It provides:

• Single sign-on across all applications
• Secure API key storage for external services (Zotero)
• One-click access to Preparo (manuscript editor) and Refero (bibliography manager)
• Secure proxying of all external API requests

Dashboard

After signing in, the dashboard shows:

Application Launcher

Launch integrated applications with a single click:

Clicking an application opens it in a new window. Your session is transferred automatically — no need to log in again.

Getting Started Checklist

A checklist guides you through the initial setup:

1. Create an account — completed once you sign up
2. Configure your API keys — add your Zotero key in Settings
3. Create your first document — links to Preparo

The checklist updates in real time as you complete each step.

Authentication

Creating an Account

1. Click Sign Up on the login page
2. Enter your email, display name, and password
3. Confirm your password
4. Your account is created and you are signed in

Signing In

• Enter your email and password
• Check Remember me to keep your session active across browser restarts
• If you forget your password, click Forgot password? to receive a reset link by email

Single Sign-On (SSO)

When you launch Preparo or Refero from the dashboard, Spectral Cloud handles authentication automatically:

1. The portal generates a secure URL containing your session tokens
2. The application opens and detects the tokens
3. A session is established — you are instantly authenticated
4. Your Zotero API key is available to the application through the secure proxy

You never need to enter your credentials in Preparo or Refero separately.

API Key Management

Spectral Cloud stores your external API keys securely so that applications can use them without exposing them in the browser.

Adding a Zotero Key

1. Go to Settings > API Keys
2. Click Add a key next to Zotero
3. Obtain your key from zotero.org/settings/keys
4. Paste the key and save

Once validated, Spectral Cloud stores the key along with your Zotero username and user ID. The connection status is shown on the dashboard checklist.

Supported Services

Security Model

• API keys are encrypted server-side using pgcrypto before storage
• The client never sees the actual key after submission
• All external API requests go through Supabase Edge Functions that decrypt the key on the server
• Keys can be updated or deleted at any time from Settings

Settings

Access settings from the navigation bar.

Profile

• Display name — change the name shown in the dashboard greeting
• Email address — update your account email

API Keys

Manage your external service connections (see API Key Management above).

Preferences

Theme and language can also be toggled from the header bar at any time. Preferences are saved and persist across sessions.

Secure Proxies

All communication between the applications and external services passes through Spectral Cloud’s secure proxy layer.

How It Works

Application → Supabase Edge Function → External API
                    ↓
            Decrypts API key
            on the server

The browser sends a request with your Supabase JWT token. The Edge Function verifies your identity, retrieves and decrypts your API key from the database, then makes the request to the external service on your behalf. The response is forwarded back to the application.

Available Proxies

Mobile Support

The portal interface adapts to mobile devices:

• Navigation collapses into a hamburger menu
• Application cards stack vertically
• Settings panels adapt to smaller screens
• Full-screen mobile menu with navigation, applications, and account sections

Spectral Cloud — Spectral Lab

Spectral Cloud

Plateforme unifiée pour les outils d'édition et de publication

Démarrage rapide

1. Rendez-vous sur le portail Spectral Cloud dans votre navigateur
2. Créez un compte (e-mail et mot de passe)
3. Ajoutez votre clé API Zotero dans Réglages > Clés API
4. Lancez Preparo ou Refero depuis le tableau de bord
5. Vous êtes automatiquement authentifié dans chaque application via SSO

Présentation

Spectral Cloud est le hub central qui connecte tous les outils de publication Spectral Lab. Il offre :

• L’authentification unique (SSO) sur toutes les applications
• Le stockage sécurisé des clés API pour les services externes (Zotero)
• L’accès en un clic à Preparo (éditeur de manuscrits) et Refero (gestionnaire de bibliographie)
• Le proxy sécurisé de toutes les requêtes API externes

Tableau de bord

Après connexion, le tableau de bord affiche :

Lanceur d’applications

Lancez les applications intégrées en un clic :

Cliquer sur une application l’ouvre dans une nouvelle fenêtre. Votre session est transférée automatiquement — pas besoin de vous reconnecter.

Liste de démarrage

Une checklist vous guide dans la configuration initiale :

1. Créer un compte — validé dès l’inscription
2. Configurer vos clés API — ajouter votre clé Zotero dans les Réglages
3. Créer votre premier document — lien vers Preparo

La checklist se met à jour en temps réel à mesure que vous complétez chaque étape.

Authentification

Créer un compte

1. Cliquez sur S’inscrire sur la page de connexion
2. Entrez votre e-mail, votre nom d’affichage et votre mot de passe
3. Confirmez votre mot de passe
4. Votre compte est créé et vous êtes connecté

Se connecter

• Entrez votre e-mail et votre mot de passe
• Cochez Se souvenir de moi pour maintenir votre session active entre les redémarrages du navigateur
• Si vous oubliez votre mot de passe, cliquez sur Mot de passe oublié ? pour recevoir un lien de réinitialisation par e-mail

Authentification unique (SSO)

Lorsque vous lancez Preparo ou Refero depuis le tableau de bord, Spectral Cloud gère l’authentification automatiquement :

1. Le portail génère une URL sécurisée contenant vos jetons de session
2. L’application s’ouvre et détecte les jetons
3. Une session est établie — vous êtes instantanément authentifié
4. Votre clé API Zotero est disponible pour l’application via le proxy sécurisé

Vous n’avez jamais besoin de saisir vos identifiants dans Preparo ou Refero séparément.

Gestion des clés API

Spectral Cloud stocke vos clés API externes de manière sécurisée afin que les applications puissent les utiliser sans les exposer dans le navigateur.

Ajouter une clé Zotero

1. Allez dans Réglages > Clés API
2. Cliquez sur Ajouter une clé à côté de Zotero
3. Obtenez votre clé depuis zotero.org/settings/keys
4. Collez la clé et enregistrez

Une fois validée, Spectral Cloud stocke la clé avec votre nom d’utilisateur et identifiant Zotero. Le statut de connexion est affiché dans la checklist du tableau de bord.

Services supportés

Modèle de sécurité

• Les clés API sont chiffrées côté serveur avec pgcrypto avant stockage
• Le client ne voit jamais la clé réelle après soumission
• Toutes les requêtes API externes passent par les Edge Functions Supabase qui déchiffrent la clé sur le serveur
• Les clés peuvent être mises à jour ou supprimées à tout moment depuis les Réglages

Réglages

Accédez aux réglages depuis la barre de navigation.

Profil

• Nom d’affichage — modifier le nom affiché dans le message de bienvenue du tableau de bord
• Adresse e-mail — mettre à jour l’e-mail de votre compte

Clés API

Gérez vos connexions aux services externes (voir Gestion des clés API ci-dessus).

Préférences

Le thème et la langue peuvent aussi être basculés depuis la barre d’en-tête à tout moment. Les préférences sont sauvegardées et persistent entre les sessions.

Proxys sécurisés

Toute communication entre les applications et les services externes passe par la couche de proxy sécurisé de Spectral Cloud.

Fonctionnement

Application → Edge Function Supabase → API externe
                    ↓
            Déchiffre la clé API
            sur le serveur

Le navigateur envoie une requête avec votre jeton JWT Supabase. L’Edge Function vérifie votre identité, récupère et déchiffre votre clé API depuis la base de données, puis effectue la requête au service externe pour votre compte. La réponse est retransmise à l’application.

Proxys disponibles

Support mobile

L’interface du portail s’adapte aux appareils mobiles :

• La navigation se replie dans un menu hamburger
• Les cartes d’applications s’empilent verticalement
• Les panneaux de réglages s’adaptent aux petits écrans
• Menu mobile plein écran avec navigation, applications et sections du compte

Spectral Cloud — Spectral Lab

Preparo

Markdown editor for manuscript preparation and publishing

Quick Start

1. Open Preparo in your browser
2. Create a new project (book or article)
3. Import a document or start writing in the editor
4. Structure your manuscript into chapters
5. Configure metadata and export to EPUB, DOCX, or PDF

Interface

Preparo uses a three-panel layout:

Project Types

Importing Documents

Click the Import button in the Documents panel to convert files into Markdown:

• Supported formats: DOCX, EPUB, PDF, HTML, ODT, LaTeX, and more
• Files are converted via Pandoc and stored locally
• After import, use Split by H1 (✂) to separate a large document into individual chapters

Each split chapter receives only the footnotes it references, with automatic renumbering.

The Editor

Preparo features a WYSIWYG Markdown editor based on Milkdown, with full Pandoc Markdown support.

Toolbar

The toolbar provides quick access to formatting:

• Text: Bold, italic, underline, strikethrough, superscript, small caps
• Structure: Headings (H1–H6), blockquotes, bullet and ordered lists
• Insert: Images, footnotes, citations, bibliography block
• Code: Inline code, code blocks

Footnotes

Insert footnotes with the toolbar button. Preparo manages footnote numbering automatically:

• References are inserted at the cursor position
• Definitions are added at the end of the document
• Numbering updates automatically when footnotes are added or removed

Navigator

The Navigator panel (in the editor sidebar) provides three tabs:

• TOC — Table of contents generated from headings
• Blocks — Document structure overview (headings, paragraphs, lists, images)
• Styles — Active formatting styles at the cursor position

Pandoc Extensions

The editor supports Pandoc-specific Markdown syntax:

• Bracketed spans: [text]{.class #id key="value"}
• Fenced divs: ::: {.class} blocks
• Superscript: ^superscript^
• Heading attributes: # Heading {#id .class epub:type=chapter}
• Smart typography: Automatic curly quotes, em dashes, ellipsis

Document Types

Each document in a book project can be assigned a type that maps to EPUB structural semantics:

Frontmatter

Preface, foreword, introduction, title page, copyright page, dedication, table of contents, etc.

Bodymatter

Chapters, parts.

Backmatter

Bibliography, appendix, afterword, glossary, index, etc.

Document types are used to:

• Generate structured filenames for export (e.g., 00-preface.md, 02-chapter-1.md)
• Automatically apply epub:type attributes for EPUB compliance
• Order documents correctly in the exported manuscript

Bibliography & Citations

Preparo integrates with Zotero for bibliography management when connected to Spectral Cloud.

Connecting to Zotero

1. Log in via Spectral Cloud Portal
2. Store your Zotero API key in the Portal settings
3. Link a Zotero collection to your project

Working with Citations

• Open the Bibliography panel to browse your references
• Double-click an item to insert a citation ([@citekey]) at the cursor
• Citations render as formatted badges in the editor (Chicago Author-Date style)
• Click a citation badge to edit its fields (title, authors, date, etc.)

Bibliography Block

Insert a {{bibliography}} placeholder to render a dynamic bibliography in your document. The bibliography collects all cited references across all project documents.

Sync

• Local changes to references are automatically pushed to Zotero
• Remote changes are pulled every 60 seconds
• Conflict resolution is based on modification timestamps
• Cross-chapter citation formatting (ibid., op. cit.) is fully supported

Project Configuration

Open the project configuration panel to manage metadata and export settings.

Metadata (YAML)

Book metadata is stored as YAML and passed to Pandoc during export:

title: "My Book Title"
author: "Author Name"
lang: fr
publisher: "Publisher"
isbn-print: "978-..."
rights: "© 2026 Author Name"

EPUB Settings

Exporting

Preparo supports multiple export formats from the Documents panel.

EPUB

• EPUB 2 and EPUB 3 are exported via separate buttons
• Chapters are assembled in the order defined by document types and position
• Images, fonts, and CSS templates are embedded automatically
• The {{bibliography}} placeholder is resolved before export
• If a title page document exists, Pandoc’s auto-generated title page is disabled

Other Formats

Multi-chapter exports use --file-scope to isolate footnote numbering per chapter.

Templates

Upload CSS stylesheets and CSL citation styles in the Templates tab of the Documents panel. Templates are automatically filtered by EPUB version during export.

Auto-Save

Preparo automatically saves your work to the browser’s local storage (IndexedDB):

• Changes are saved after a short delay (1 second by default)
• A status indicator shows the current state: saving, saved, or error
• Use Export/Import in project settings to back up your data

Supported Markdown

The editor handles the following Markdown syntax:

• # Heading 1 through ###### Heading 6
• **bold**, *italic*, ***bold italic***
• ~~strikethrough~~, ^superscript^
• [underline]{.underline}, [small caps]{.smallcaps}
• > blockquote
• - bullet list, 1. ordered list
• ![alt](image.jpg) — images with captions
• | table | syntax | — Markdown tables
• [^1]: footnote — footnotes with auto-numbering
• [@citekey] — Pandoc citations
• [text]{.class} — bracketed spans
• ::: {.class} — fenced divs
• # Heading {#id .class epub:type=chapter} — heading attributes

Preparo — Spectral Lab

Preparo

Éditeur Markdown pour la préparation et la publication de manuscrits

Démarrage rapide

1. Ouvrez Preparo dans votre navigateur
2. Créez un nouveau projet (livre ou article)
3. Importez un document ou commencez à écrire dans l’éditeur
4. Structurez votre manuscrit en chapitres
5. Configurez les métadonnées et exportez en EPUB, DOCX ou PDF

Interface

Preparo utilise une disposition en trois panneaux :

Types de projets

Importer des documents

Cliquez sur le bouton Importer dans le panneau Documents pour convertir des fichiers en Markdown :

• Formats supportés : DOCX, EPUB, PDF, HTML, ODT, LaTeX, et plus
• Les fichiers sont convertis via Pandoc et stockés localement
• Après l’import, utilisez Scinder par H1 (✂) pour séparer un document volumineux en chapitres individuels

Chaque chapitre issu de la scission reçoit uniquement les notes de bas de page qu’il référence, avec renumérotation automatique.

L’éditeur

Preparo dispose d’un éditeur Markdown WYSIWYG basé sur Milkdown, avec un support complet du Markdown Pandoc.

Barre d’outils

La barre d’outils offre un accès rapide au formatage :

• Texte : Gras, italique, souligné, barré, exposant, petites capitales
• Structure : Titres (H1–H6), citations, listes à puces et numérotées
• Insertion : Images, notes de bas de page, citations bibliographiques, bloc bibliographie
• Code : Code en ligne, blocs de code

Notes de bas de page

Insérez des notes de bas de page avec le bouton de la barre d’outils. Preparo gère la numérotation automatiquement :

• Les appels de note sont insérés à la position du curseur
• Les définitions sont ajoutées à la fin du document
• La numérotation se met à jour automatiquement lors de l’ajout ou la suppression de notes

Navigateur

Le panneau Navigateur (dans la barre latérale de l’éditeur) propose trois onglets :

• TDM — Table des matières générée à partir des titres
• Blocs — Vue d’ensemble de la structure du document (titres, paragraphes, listes, images)
• Styles — Styles de formatage actifs à la position du curseur

Extensions Pandoc

L’éditeur supporte la syntaxe Markdown spécifique à Pandoc :

• Spans entre crochets : [texte]{.classe #id clé="valeur"}
• Divs délimités : blocs ::: {.classe}
• Exposant : ^exposant^
• Attributs de titres : # Titre {#id .classe epub:type=chapter}
• Typographie intelligente : Guillemets courbes, tirets cadratins, points de suspension automatiques

Types de documents

Chaque document d’un projet livre peut se voir attribuer un type correspondant à la sémantique structurelle EPUB :

Pages liminaires (frontmatter)

Préface, avant-propos, introduction, page de titre, page de copyright, dédicace, table des matières, etc.

Corps du texte (bodymatter)

Chapitres, parties.

Annexes (backmatter)

Bibliographie, annexe, postface, glossaire, index, etc.

Les types de documents servent à :

• Générer des noms de fichiers structurés pour l’export (ex. : 00-preface.md, 02-chapitre-1.md)
• Appliquer automatiquement les attributs epub:type pour la conformité EPUB
• Ordonner correctement les documents dans le manuscrit exporté

Bibliographie et citations

Preparo s’intègre à Zotero pour la gestion bibliographique lorsqu’il est connecté à Spectral Cloud.

Connexion à Zotero

1. Connectez-vous via le portail Spectral Cloud
2. Enregistrez votre clé API Zotero dans les paramètres du portail
3. Associez une collection Zotero à votre projet

Travailler avec les citations

• Ouvrez le panneau Bibliographie pour parcourir vos références
• Double-cliquez sur un élément pour insérer une citation ([@cléref]) à la position du curseur
• Les citations s’affichent sous forme de badges formatés dans l’éditeur (style Chicago Author-Date)
• Cliquez sur un badge de citation pour modifier ses champs (titre, auteurs, date, etc.)

Bloc bibliographie

Insérez un champ {{bibliography}} pour afficher une bibliographie dynamique dans votre document. La bibliographie rassemble toutes les références citées dans l’ensemble des documents du projet.

Synchronisation

• Les modifications locales des références sont automatiquement poussées vers Zotero
• Les modifications distantes sont récupérées toutes les 60 secondes
• La résolution des conflits est basée sur les horodatages de modification
• Le formatage des citations inter-chapitres (ibid., op. cit.) est entièrement pris en charge

Configuration du projet

Ouvrez le panneau de configuration du projet pour gérer les métadonnées et les paramètres d’export.

Métadonnées (YAML)

Les métadonnées du livre sont stockées en YAML et transmises à Pandoc lors de l’export :

title: "Titre de mon livre"
author: "Nom de l'auteur"
lang: fr
publisher: "Éditeur"
isbn-print: "978-..."
rights: "© 2026 Nom de l'auteur"

Paramètres EPUB

Export

Preparo prend en charge plusieurs formats d’export depuis le panneau Documents.

EPUB

• EPUB 2 et EPUB 3 sont exportés via des boutons distincts
• Les chapitres sont assemblés dans l’ordre défini par les types de documents et leur position
• Les images, polices et feuilles de style CSS sont intégrées automatiquement
• Le champ {{bibliography}} est résolu avant l’export
• Si un document de page de titre existe, la page de titre auto-générée par Pandoc est désactivée

Autres formats

Les exports multi-chapitres utilisent --file-scope pour isoler la numérotation des notes par chapitre.

Gabarits

Téléchargez des feuilles de style CSS et des styles de citation CSL dans l’onglet Gabarits du panneau Documents. Les gabarits sont automatiquement filtrés par version EPUB lors de l’export.

Sauvegarde automatique

Preparo sauvegarde automatiquement votre travail dans le stockage local du navigateur (IndexedDB) :

• Les modifications sont enregistrées après un court délai (1 seconde par défaut)
• Un indicateur d’état affiche l’état actuel : en cours, sauvegardé ou erreur
• Utilisez Export/Import dans les paramètres du projet pour sauvegarder vos données

Markdown supporté

L’éditeur prend en charge la syntaxe Markdown suivante :

• # Titre 1 jusqu’à ###### Titre 6
• **gras**, *italique*, ***gras italique***
• ~~barré~~, ^exposant^
• [souligné]{.underline}, [petites capitales]{.smallcaps}
• > citation
• - liste à puces, 1. liste numérotée
• ![alt](image.jpg) — images avec légendes
• | tableau | syntaxe | — tableaux Markdown
• [^1]: note — notes de bas de page avec numérotation automatique
• [@cléref] — citations Pandoc
• [texte]{.classe} — spans entre crochets
• ::: {.classe} — divs délimités
• # Titre {#id .classe epub:type=chapter} — attributs de titres

Preparo — Spectral Lab

Refero

Web client for Zotero — manage, import, and export your bibliographic references

Quick Start

1. Open Refero in your browser
2. Log in via Spectral Cloud Portal
3. Select a Zotero library (personal or group)
4. Browse your collections and references
5. Add, edit, import, or export items

Interface

Refero uses a three-pane layout:

The interface is fully responsive — on smaller screens the panels adapt to a single-column layout.

Toolbar

The toolbar at the top provides access to:

• Library selector (personal or group libraries)
• New item creation
• Import and export
• ISBN scanner
• Settings
• Language switcher (French / English)

Authentication

Refero connects to Zotero securely through Spectral Cloud:

1. Log in via the Spectral Cloud Portal
2. Your Zotero API key is stored encrypted on the server
3. All requests are proxied through Supabase Edge Functions — your API key is never exposed to the browser

Collections

Collections are displayed as a tree view in the left panel.

• Create a new collection or sub-collection via the context menu
• Rename or delete collections from the context menu
• Navigate by clicking a collection to display its items
• My Library shows all items across all collections

Working with Items

Browsing

• Click a collection to display its items
• Use the search bar to filter items by title, author, or year
• Click a column header to sort (title, creator, date, item type)
• Virtual scrolling handles large collections efficiently

Creating Items

Click the + button in the toolbar and choose an item type (book, article, thesis, report, etc.). A new empty item is created in the current collection.

Editing Items

Select an item to view its details in the right panel. Click Edit to modify fields:

• Standard fields: title, authors/creators, date, publisher, ISBN, DOI, URL, etc.
• Each item type has its own set of relevant fields
• Creators can have multiple entries with role selection (author, editor, translator, etc.)

Changes are saved to your Zotero library in real time.

Field Configuration

In Settings, you can customize which fields appear for each item type:

• Enable/disable fields to show only what you need
• Custom fields are stored in Zotero’s “Extra” field and synchronized across devices

Importing References

Refero offers multiple ways to add references to your library.

Catalog Search

Search external library catalogs directly from Refero:

Search by title, author, ISBN, or keyword. Select one or more results and import them into your Zotero collection.

File Import

Drag and drop or browse to import bibliography files:

• BibTeX (.bib)
• RIS (.ris)
• CSL JSON (.json)

ISBN Scanner

Click the barcode icon to open the camera-based ISBN scanner:

1. Point your camera at a book’s barcode
2. Refero searches multiple catalogs automatically (Sudoc, BnF, Swisscovery, Harvard, Open Library)
3. The best result is selected via quality scoring
4. Confirm to add the reference to your library

Exporting References

Select items and click Export to generate bibliographic output.

Export Formats

Bibliography Generation

Generate formatted bibliographies using citation styles:

• APA, MLA, Chicago, and many more
• Preview the formatted output
• Copy to clipboard or download as a file

Settings

Access settings from the toolbar:

Preferences are saved locally in the browser and persist across sessions.

Supported Item Types

Refero supports all Zotero item types, including:

• Book, book section, edited book
• Journal article, magazine article, newspaper article
• Thesis, dissertation
• Conference paper, presentation
• Report, document
• Web page, blog post
• Film, video recording, audio recording
• Map, artwork, patent
• And many more

Refero — Spectral Lab

Refero

Client web pour Zotero — gérez, importez et exportez vos références bibliographiques

Démarrage rapide

1. Ouvrez Refero dans votre navigateur
2. Connectez-vous via le portail Spectral Cloud
3. Sélectionnez une bibliothèque Zotero (personnelle ou de groupe)
4. Parcourez vos collections et références
5. Ajoutez, modifiez, importez ou exportez des éléments

Interface

Refero utilise une disposition en trois panneaux :

L’interface est entièrement responsive — sur les petits écrans, les panneaux s’adaptent en disposition mono-colonne.

Barre d’outils

La barre d’outils en haut de l’écran donne accès à :

• Sélecteur de bibliothèque (personnelle ou de groupe)
• Création d’un nouvel élément
• Import et export
• Scanner ISBN
• Réglages
• Sélecteur de langue (français / anglais)

Authentification

Refero se connecte à Zotero de manière sécurisée via Spectral Cloud :

1. Connectez-vous via le portail Spectral Cloud
2. Votre clé API Zotero est stockée chiffrée sur le serveur
3. Toutes les requêtes passent par les Edge Functions Supabase — votre clé API n’est jamais exposée au navigateur

Collections

Les collections s’affichent sous forme d’arborescence dans le panneau gauche.

• Créez une nouvelle collection ou sous-collection via le menu contextuel
• Renommez ou supprimez des collections depuis le menu contextuel
• Naviguez en cliquant sur une collection pour afficher ses éléments
• Ma bibliothèque affiche tous les éléments de toutes les collections

Travailler avec les éléments

Navigation

• Cliquez sur une collection pour afficher ses éléments
• Utilisez la barre de recherche pour filtrer par titre, auteur ou année
• Cliquez sur un en-tête de colonne pour trier (titre, créateur, date, type)
• Le défilement virtuel gère efficacement les grandes collections

Création d’éléments

Cliquez sur le bouton + de la barre d’outils et choisissez un type d’élément (livre, article, thèse, rapport, etc.). Un nouvel élément vide est créé dans la collection courante.

Édition d’éléments

Sélectionnez un élément pour voir ses détails dans le panneau droit. Cliquez sur Modifier pour changer les champs :

• Champs standards : titre, auteurs/créateurs, date, éditeur, ISBN, DOI, URL, etc.
• Chaque type d’élément possède ses propres champs pertinents
• Les créateurs peuvent avoir plusieurs entrées avec sélection du rôle (auteur, éditeur scientifique, traducteur, etc.)

Les modifications sont enregistrées dans votre bibliothèque Zotero en temps réel.

Configuration des champs

Dans les Réglages, vous pouvez personnaliser les champs affichés pour chaque type d’élément :

• Activer/désactiver des champs pour n’afficher que le nécessaire
• Les champs personnalisés sont stockés dans le champ « Extra » de Zotero et synchronisés entre vos appareils

Importer des références

Refero offre plusieurs moyens d’ajouter des références à votre bibliothèque.

Recherche dans les catalogues

Recherchez dans des catalogues de bibliothèques externes directement depuis Refero :

Recherchez par titre, auteur, ISBN ou mot-clé. Sélectionnez un ou plusieurs résultats et importez-les dans votre collection Zotero.

Import de fichiers

Glissez-déposez ou parcourez pour importer des fichiers bibliographiques :

• BibTeX (.bib)
• RIS (.ris)
• CSL JSON (.json)

Scanner ISBN

Cliquez sur l’icône code-barres pour ouvrir le scanner ISBN par caméra :

1. Pointez votre caméra vers le code-barres d’un livre
2. Refero interroge automatiquement plusieurs catalogues (Sudoc, BnF, Swisscovery, Harvard, Open Library)
3. Le meilleur résultat est sélectionné par score de qualité
4. Confirmez pour ajouter la référence à votre bibliothèque

Exporter des références

Sélectionnez des éléments et cliquez sur Exporter pour générer une sortie bibliographique.

Formats d’export

Génération de bibliographies

Générez des bibliographies formatées avec des styles de citation :

• APA, MLA, Chicago, et bien d’autres
• Prévisualisez le résultat formaté
• Copiez dans le presse-papiers ou téléchargez en fichier

Réglages

Accédez aux réglages depuis la barre d’outils :

Les préférences sont sauvegardées localement dans le navigateur et persistent entre les sessions.

Types d’éléments supportés

Refero prend en charge tous les types d’éléments Zotero, notamment :

• Livre, chapitre de livre, livre édité
• Article de revue, article de magazine, article de journal
• Thèse, mémoire
• Communication de colloque, présentation
• Rapport, document
• Page web, billet de blog
• Film, enregistrement vidéo, enregistrement audio
• Carte, œuvre d’art, brevet
• Et bien d’autres

Refero — Spectral Lab

AutomaticBook

Automated book creation for Adobe InDesign

Quick Start

1. Drop a manuscript folder (or ZIP) into the app
2. The folder must contain a manifest.yaml and a metadata.yaml
3. Choose your InDesign version in Settings
4. Click Generate Book

The app will launch InDesign, create all documents from your templates, inject Markdown content, and assemble the final book.

Manuscript Structure

Your manuscript folder should follow this layout:

manuscript/
  manifest.yaml
  metadata.yaml
  assets/
    cover.jpg
  texts/
    01-titlepage.md
    02-copyright-page.md
    03-chapter-1.md
    ...

manifest.yaml

Defines the order and type of each text file:

version: 1
metadata: metadata.yaml
texts:
  - file: texts/01-titlepage.md
    type: frontmatter
  - file: texts/03-chapter-1.md
    type: bodymatter
  - file: texts/12-bibliography.md
    type: backmatter
output: ../build/InDesign

metadata.yaml

Book metadata (title, author, ISBN, etc.) used to fill template placeholders like {{TITLE}}, {{AUTHOR}}, {{ISBN_PRINT}}.

Templates

InDesign templates (.indd) are auto-detected in a template/ folder near your manuscript:

• titlepage.indd — always first in the book
• frontmatter.indd — fallback for frontmatter entries
• bodymatter.indd — fallback for body entries (chapters)
• backmatter.indd — fallback for backmatter entries
• endpage.indd — always last in the book
• cover.indd — generated separately, outside the book

Specialized templates (e.g. bibliography.indd, toc.indd) are matched by keyword in the Markdown filename.

Template Placeholders

Place these tags in your InDesign templates — BookCreator will replace them with values from metadata.yaml.

Text placeholders

Optional placeholders — the entire line is removed if the field is empty

Special placeholders

In addition, title and author are also created as InDesign text variables (Book Title and Book Author), usable in headers/footers.

Micro-typography

When the micro-typography checkbox is enabled, SuperScript runs automatically after book generation to apply language-specific typographic corrections:

• Thin/non-breaking spaces before punctuation (: ; ! ?)
• Dash normalization (em dash → en dash)
• Smart quotes and apostrophes
• Ellipsis (... → …)
• Century formatting (XIVe), ordinals, number formatting

Select the language profile matching your book’s language.

Install Scripts Manually

Click Install scripts in InDesign to copy the three scripts into InDesign’s Scripts Panel:

• BookCreator Automated book generation from YAML + templates
• Markdown-Import Convert Markdown to styled InDesign text
• SuperScript Multilingual typographic correction

After installation, access them via Window → Utilities → Scripts in InDesign.

Supported Markdown

Markdown-Import handles the following syntax in your text files:

• # Heading 1 through ###### Heading 6
• **bold**, *italic*, ***bold italic***
• ~~strikethrough~~, ^superscript^, ~subscript~
• > blockquote
• - bullet list
• ![alt](image.jpg) — images with optional captions
• | table | syntax | — Markdown tables
• [^1]: footnote — real InDesign footnotes
• Pandoc attributes: [text]{.class}, ::: {.class} :::

AutomaticBook — Spectral Lab

AutomaticBook

Création automatisée de livres pour Adobe InDesign

Démarrage rapide

1. Glissez un dossier manuscrit (ou ZIP) dans l’application
2. Le dossier doit contenir un manifest.yaml et un metadata.yaml
3. Choisissez votre version d’InDesign dans Réglages
4. Cliquez sur Générer le livre

L’application lancera InDesign, créera tous les documents à partir de vos gabarits, injectera le contenu Markdown et assemblera le livre final.

Structure du manuscrit

Votre dossier manuscrit doit suivre cette structure :

manuscript/
  manifest.yaml
  metadata.yaml
  assets/
    cover.jpg
  texts/
    01-titlepage.md
    02-copyright-page.md
    03-chapter-1.md
    ...

manifest.yaml

Définit l’ordre et le type de chaque fichier texte :

version: 1
metadata: metadata.yaml
texts:
  - file: texts/01-titlepage.md
    type: frontmatter
  - file: texts/03-chapter-1.md
    type: bodymatter
  - file: texts/12-bibliography.md
    type: backmatter
output: ../build/InDesign

metadata.yaml

Métadonnées du livre (titre, auteur, ISBN, etc.) utilisées pour remplir les champs de remplacement comme {{TITLE}}, {{AUTHOR}}, {{ISBN_PRINT}}.

Gabarits

Les gabarits InDesign (.indd) sont auto-détectés dans un dossier template/ proche de votre manuscrit :

• titlepage.indd — toujours en premier dans le livre
• frontmatter.indd — gabarit par défaut pour les pages liminaires
• bodymatter.indd — gabarit par défaut pour les chapitres
• backmatter.indd — gabarit par défaut pour les annexes
• endpage.indd — toujours en dernier dans le livre
• cover.indd — généré séparément, hors du livre

Les gabarits spécialisés (ex. : bibliography.indd, toc.indd) sont associés par mot-clé dans le nom du fichier Markdown.

Champs de remplacement

Placez ces balises dans vos gabarits InDesign — BookCreator les remplacera par les valeurs de metadata.yaml.

Champs texte

Champs optionnels — la ligne entière est supprimée si le champ est vide

Champs spéciaux

De plus, title et author sont également créés comme variables de texte InDesign (Book Title et Book Author), utilisables dans les en-têtes et pieds de page.

Micro-typographie

Lorsque la case micro-typographie est activée, SuperScript s’exécute automatiquement après la génération pour appliquer les corrections typographiques adaptées à la langue :

• Espaces fines/insécables avant la ponctuation (: ; ! ?)
• Normalisation des tirets (cadratin → demi-cadratin)
• Guillemets et apostrophes typographiques
• Points de suspension (... → …)
• Siècles (XIV^e), ordinaux, mise en forme des nombres

Sélectionnez le profil linguistique correspondant à la langue de votre livre.

Installer les scripts manuellement

Cliquez sur Installer les scripts dans InDesign pour copier les trois scripts dans le panneau Scripts d’InDesign :

• BookCreator Génération automatisée de livres depuis YAML + gabarits
• Markdown-Import Conversion du Markdown en texte InDesign stylisé
• SuperScript Correction typographique multilingue

Après installation, accédez-y via Fenêtre → Utilitaires → Scripts dans InDesign.

Markdown supporté

Markdown-Import prend en charge la syntaxe suivante dans vos fichiers texte :

• # Titre 1 jusqu’à ###### Titre 6
• **gras**, *italique*, ***gras italique***
• ~~barré~~, ^exposant^, ~indice~
• > citation
• - liste à puces
• ![alt](image.jpg) — images avec légendes optionnelles
• | tableau | syntaxe | — tableaux Markdown
• [^1]: note — vraies notes de bas de page InDesign
• Attributs Pandoc : [texte]{.classe}, ::: {.classe} :::

AutomaticBook — Spectral Lab