Formats acceptés¶
Tu déposes, AIM range. Aucune conversion préalable n'est nécessaire, et rien n'est à
installer sur ton poste : pandoc et pdftotext vivent dans l'image du serveur.
Ce qui est lu¶
| Catégorie | Extensions |
|---|---|
| Texte et balisage | .md .markdown .mdx .txt .text .rst .adoc .asciidoc .org .tex .mediawiki .textile |
| Bureautique | .docx .doc .odt .rtf .pptx .odp .epub |
| Web | .html .htm .xhtml |
| Documents | .pdf |
| Messagerie | .eml .msg |
| Données et configuration | .json .csv .yaml .yml .toml .ini .cfg .conf .properties .sql .log .env |
| Notebooks | .ipynb |
Tout autre fichier est ignoré avec un avertissement, jamais bloquant : un dossier contenant des captures d'écran passe sans erreur.
Traitements particuliers¶
Les courriels (.eml, .msg) sont parsés comme tels : sujet, expéditeur et
date sont conservés. La date compte, puisqu'un mail récent l'emporte sur une
documentation ancienne.
Les présentations (.pptx) passent par pandoc, avec extraction directe du
texte des diapositives en repli si la conversion échoue.
Les PDF passent par pdftotext -layout, qui préserve la mise en colonnes.
Dossiers¶
Un dossier est parcouru récursivement. Sont écartés d'office :
- les dossiers de build et de dépendances :
node_modules,.venv,dist,build,target,vendor,.next,.docusaurus,_site,.cache,.git; - les fichiers cachés ;
- le bruit connu :
.DS_Store,package-lock.json,yarn.lock,pnpm-lock.yaml.
Bornes¶
| Borne | Valeur | Raison |
|---|---|---|
| Taille par fichier | 25 Mio | Au-delà, ce n'est plus un document mais un export |
| Contenu minimal | 40 caractères | En dessous, le fichier ne dit rien et dilue l'extraction |
| Contenu maximal | 400 000 caractères | Tronqué avec avertissement |
Identité d'un document¶
Un document est identifié par son nom de fichier, pas par son chemin absolu.
Redéposer une version corrigée depuis un autre dossier, ou depuis une autre machine, met donc à jour le document existant au lieu d'en créer un second. C'est le comportement attendu quand on remplace un guide par sa nouvelle version.
Corollaire
Deux fichiers de même nom venant de dossiers différents se recouvrent. Si tu
ingères README.md de deux dépôts distincts, renomme-les d'abord.
Aider la datation¶
Facultatif. Préfixer une date ISO dans le nom du fichier la rend explicite :
Sans cela, AIM utilise la date de modification du fichier, et le modèle relève une date explicite trouvée dans le contenu.
Dépôts de code¶
Un dépôt ne se dépose pas comme un fichier :
Le CLI en extrait six signaux de structure et n'envoie que ces résumés — le code reste sur ta machine. Voir Onboarder un nouveau client.