docs(wiki): commandes d'installation reparees — les noms d'assets ont change en rc.4
Les guides donnaient des commandes `wget` avec les URL de rc.3. Bumper le
seul numero de version ne suffisait pas : les fichiers publies portent
desormais un prefixe de plateforme (`Linux.AppImage.-.`, `Mac.Silicon.-.`),
si bien qu'une URL construite a l'ancienne rend un 404. C'est exactement ce
sur quoi un nouvel utilisateur bute, et rien dans la page ne le lui dirait.
Les trois URL de telechargement du wiki sont verifiees : elles repondent en
200. Un commentaire dans chaque bloc explique le prefixe, pour que la
prochaine mise a jour ne refasse pas l'erreur.
Tailles d'installeurs mesurees sur les fichiers reellement publies, plutot
que reconduites : 262 Mo (AppImage), 158 Mo (deb), 263 et 268 Mo (DMG
Silicon et Intel).
En-tetes `**Version**` des neuf pages concernees passes en 1.0.0-rc.4.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
docs(wiki): RC4 — notes de version, et 23 defauts documentes qui n'existent plus
Le wiki citait 23 issues comme ouvertes. Toutes sont fermees : chaque
« voir issue #N » decrivait donc un defaut corrige, et le wiki decrivait
une application qui n'existe plus.
Nouvelles notes de version (3.4), sur le modele des RC3 : orientees
utilisateur, ordonnees par ce qu'on perdait ou voyait de faux plutot que
par famille technique. La section 1 s'ouvre sur les deux defauts qui
retiraient du texte d'un livre exporte, parce que c'est ce qu'un auteur
doit lire en premier.
Dix-huit pages corrigees. Le plus souvent, un long paragraphe decrivant un
bug verifie dans le code est remplace par sa resolution — d'ou un diff qui
retire plus de lignes qu'il n'en ajoute. Les affirmations les plus
trompeuses etaient :
- les reglages d'ouvrage « n'ont aucune UI » (ils en ont une depuis la RC4)
- l'export Word d'un livre cite « sort vide » (corrige)
- le corpus manuscrit sans interface (elle existe)
- le compresseur de contexte « jamais appele » (cable, et ses trois
distorsions corrigees)
- `embeddingProvider` sans controle (section Embeddings)
- le filtre par collection absent, le bouton OCR manuel injoignable, le
toggle des noeuds auteurs desactive en dur
Home annonce la RC4 ; Features passe en 1.0.0-rc.4 et gagne deux sections
— corpus manuscrit et accessibilite — qui n'avaient nulle part ou vivre.
Les limitations connues des notes RC4 sont argumentees, pas subies :
pdfjs-dist renvoie a #77, et le mode de detection seule de l'inspecteur
explique pourquoi une source primaire contenant des imperatifs ne doit pas
etre tronquee.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
docs(wiki): treizième passe — embeddingProvider toujours sans UI (contradiction avec #18), variable d'environnement Wayland inexistante
Aucun nouveau bug applicatif filé — uniquement des corrections de
documentation, dont deux contradictions inter-pages qui avaient
survécu 12 passes précédentes :
- Technical Architecture : affirmait que embeddingProvider est
sélectionnable depuis Settings → LLM au même titre que
generationProvider — faux, aucune UI n'existe pour ce réglage
(contredit directement l'issue #18 et le propre texte du guide LLM
embarqué). Corrigé, et documentation du garde-fou réel découvert au
passage : le repli automatique Ollama→embarqué pour les embeddings
ne s'active que si les deux modèles partagent la même dimension de
vecteur, sinon échec volontaire plutôt que corruption silencieuse
de la recherche par similarité.
- Export Presentations : les réglages de style de notes/bibliographie
du livre étaient présentés sans réserve alors qu'ils sont
entièrement figés (issue #24, documentée ailleurs mais pas liée
ici) — lien ajouté.
Autres corrections :
- Installation Linux : `ELECTRON_NO_SANDBOX` n'est pas une variable
d'environnement Electron réelle — le vrai nom est
`ELECTRON_DISABLE_SANDBOX` ; commande de suppression de
~/.local/share/cliodeck retirée (l'app n'y écrit jamais, chemin
Electron par défaut confirmé).
- MCP Integration Guide : la nouvelle bannière de retry MCP a été
qualifiée à tort de « silencieuse » — la transition par l'état
`degraded` est en fait visible en temps réel dans l'UI (même code
couleur que `failed`) ; seule la tentative elle-même est
automatique, pas son affichage.
- Zotero Integration Guide : documentation d'un comportement réel non
documenté jusqu'ici — le mode local copie zotero.sqlite (+ le WAL)
dans un fichier temporaire en lecture seule, donc sûr même avec
Zotero ouvert en parallèle.
Deux clusters entièrement propres cette passe (aucune correction) :
meta & notes de version (méthode de vérification contre les tags git
appliquée à un nouvel échantillon, tout confirmé), feature pages &
home (balayage complet contre les issues #16-#28, rien trouvé).
docs(wiki): l'export Word d'un livre est cassé dans le cas courant, pas juste "peu fiable"
En creusant pourquoi {content} ne recevait pas le manuscrit assemblé sur
la route pandoc (déjà noté), la trace complète du code a révélé un vrai
bug applicatif, pas seulement une nuance documentaire :
- WordExportModal.tsx:167 envoie un content vide pour un livre —
l'assemblage se fait censément côté main.
- word-export.ts:643-646 retourne immédiatement vers exportWithPandoc()
dès que bibliographie + pandoc + pas de moteur de citation (le cas le
plus courant pour un livre avec citations).
- assembleManuscript() n'a qu'UN SEUL point d'appel dans tout le fichier
(ligne 667), à l'intérieur du chemin natif — inatteignable depuis la
branche pandoc qui vient de renvoyer.
- exportWithPandoc() n'a aucune référence à manuscript/assembleManuscript
et écrit options.content (vide) tel quel dans le fichier d'entrée
pandoc (lignes 503-505). Pandoc réussit silencieusement sur un contenu
vide : le .docx produit a une page de titre et aucun texte de chapitre.
- pdf-export.ts fait ça correctement (assemblage inconditionnel avant
tout branchement bibliographie) — la route Word/pandoc est l'anomalie.
Signalé en issue #19 (bug applicatif réel, pas seulement un problème de
doc). Trois pages corrigées pour refléter la vraie gravité :
- 1.3-Guide-for-Using-Word-Templates.md : l'avertissement portait
uniquement sur {content} via un template ; élargi pour dire que
l'export sans template est tout autant affecté.
- 1.15-Books-and-Chapters.md : « Word produces one section per chapter »
était affirmé sans réserve — précisé que ça casse justement dans le
cas bibliographie + pandoc + pas de moteur de citation.
- 1.10-Export-Presentations.md : pointeur ajouté vers la mise en garde,
en précisant que le PDF n'est pas affecté.
Au passage, lien mort corrigé sur 1.4-Keyboard-Shortcuts.md : README.md
n'existe pas dans ce dépôt wiki.
docs(wiki): la garantie « jamais perdre son export » ne couvre qu'un des deux mécanismes
Word Templates : « You'll never lose your export! » s'appliquait comme
si les deux mécanismes avaient un filet de sécurité. Faux — vérifié
dans word-export.ts : seul le mécanisme 2 (docxtemplater) a un
try/catch qui retombe sur la génération native. Le mécanisme 1
(pandoc + reference-doc) a son propre try/catch qui renvoie
{success: false, error} directement, sans repli — aucune relance côté
docx natif. Précisé.
Export-Presentations : la réserve ajoutée en passe 3 ne citait que 2
des 3 conditions du guide Word Templates (bibliographie absente OU
moteur de citation demandé) — il manquait « bibliographie présente
mais pandoc introuvable ». Reformulé pour renvoyer au guide plutôt que
de paraphraser une liste à trois conditions qui a déjà changé trois
fois sur l'autre page.
docs(wiki): troisième passe — contradiction laissée par ma propre réécriture, et une recommandation de la deuxième passe jamais appliquée
- Word Templates : la section « Creating a Template with Placeholders »
renvoyait encore à une « route 3 » — numérotation à trois routes que
ma propre réécriture de la deuxième passe avait pourtant remplacée
par deux mécanismes. La phrase contredisait donc l'aperçu corrigé
quatre lignes au-dessus. Reformulée pour dire explicitement à quel
mécanisme la section s'applique.
- Même page : « premier trouvé, ordre alphabétique » pour plusieurs
templates .dotx — faux, findTemplate() utilise fs.readdir() sans
aucun tri, l'ordre dépend du système de fichiers. Libellé du bouton
corrigé aussi (« Export to Word », pas « Export Word (.docx) »).
- Keyboard Shortcuts : Ctrl/Cmd+R et Ctrl/Cmd+Shift+R (reload/force
reload) existent réellement dans menu.ts mais n'étaient documentés
nulle part — un raccourci standard d'Electron, facile à déclencher
par erreur en écrivant, avec un effet réel (recharge la fenêtre).
- Export-Presentations : la deuxième passe avait explicitement
recommandé d'ajouter une réserve ici (« styles ou placeholders selon
la bibliographie ») après avoir corrigé le guide Word Templates —
recommandation jamais appliquée. Faite maintenant.
docs(wiki): corriger la liste des styles CSL réellement livrés
La page annonçait cinq styles (Chicago, APA, MLA, Harvard, IEEE).
Vérifié via resources/csl/ et le handler citation:listStyles
(citation-handlers.ts) : seuls deux sont réellement embarqués — Chicago
notes-bibliography (le défaut, note de bas de page, pas auteur-date) et
MLA. Table remplacée, avec rappel qu'un CSL personnalisé reste possible
pour tout le reste.
Précisé aussi que le CSL personnalisé se sélectionne dans le panneau
Project (réglage cslPath), pas dans un vague « settings ».
docs: seconde passe du wiki — vérifications, traductions, parcours débutant
La relecture adverse a rattrapé, entre autres, une erreur introduite par
la première passe : le guide des LLM embarqués affirmait désormais que
ClioDeck pouvait produire ses embeddings sans Ollama, au motif que le
catalogue propose un modèle embarqué et que le réglage existe. En traçant
l'appel jusqu'au registre de providers, il n'y a aucune branche
embarquée : le réglage ne change rien. La page dit maintenant la vérité,
écart entre catalogue et câblage compris.
Autres rattrapages :
- vingt liens vers l'ancien dépôt inactinique/cliodeck, dans sept pages
dont les deux guides d'installation ;
- la page journal décrivait .cliodeck/history.db et un dossier
conversations/, vestiges d'avant la fusion : tout vit dans brain.db ;
- six pages en français dans un wiki anglophone, et non deux comme la
première passe l'avait cru — les deux nommées sont traduites, quatre
restent ;
- quatre imprécisions dans les pages créées à la première passe (plan
derrière un dépliant, libellés réels des boutons, troncature de la
recherche, message d'un fichier manquant).
Créé : 1.0-Getting-Started, qui comblait le trou entre « installer » et
« écrire » — rien n'expliquait comment créer un projet ni ce que le choix
du type implique.
Les cinq pages laissées sous bandeau à la première passe ont été reprises
ligne à ligne : une était fausse, quatre exactes. Plus aucun bandeau.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
docs: wiki à jour pour la 1.0.0-rc.3
Les 33 pages ont été confrontées au code, pas réécrites de mémoire.
Créées : « Writing a Book — Chapters Guide » (la nouveauté majeure de
cette version : manifeste, navigateur, plan, recherche d'ouvrage,
renumérotation, réglages, exports), « The Editor » (CodeMirror 6 en rendu
live, notes et citations pandoc, fidélité octet pour octet, propositions
adjudicables) et les notes de version RC3.
Corrigées, entre autres :
- Features et Technical Architecture annonçaient encore l'éditeur
Milkdown, retiré depuis ;
- trois raccourcis documentés n'existent pas (Ctrl+Shift+S, Ctrl+Shift+L,
Alt+4) et Ctrl+J n'était pas documenté — vérifié dans menu.ts ;
- « Export Presentations » ne parlait pas des présentations malgré son
titre : ni reveal.js, ni modes en ligne/hors ligne/PDF, ni Beamer ;
- Electron 28 dans deux pages, alors que le projet est en 40.9.2 ;
- le journal d'usage IA distingue désormais ses deux couches et
enregistre les adjudications de propositions.
Cinq pages anciennes (Tropy, LLM embarqués, analyse de corpus,
similarité, stratégie d'embeddings) portent un bandeau signalant qu'elles
n'ont pas été revérifiées ligne à ligne : elles ne contiennent rien de
manifestement faux, mais leur horodatage est ancien.
Aucune page supprimée. Le wiki ne contient aucune capture d'écran : rien
à refaire de ce côté.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
first commit after move from inactinique