Téléverser et utiliser des images et des fichiers

Ce qu’est la médiathèque

Les fichiers téléversés résident dans un bucket Cloudflare R2 et sont servis depuis https://jenksguo.xyz/media/…. Pris en charge : images WebP, JPEG, PNG, GIF, AVIF et SVG, vidéos MP4 et WebM, et PDF — jusqu’à 25 Mo chacune. Le type réel est lu dans le fichier lui‑même, donc un fichier renommé ne peut pas se faire passer pour une image.

Chaque fichier reçoit une adresse permanente telle que /media/2026/10/acme-workshop-3f9a1c2b7d.webp. La dernière partie est une empreinte des octets, donc une adresse ne pointe jamais vers un contenu différent et les navigateurs peuvent le mettre en cache pendant un an. Téléverser à nouveau le même fichier avec le même nom réutilise la copie existante.

Les fichiers sont publics dès qu’ils sont téléversés, même avant qu’une page ne les utilise. Téléversez uniquement ce que tout visiteur peut voir — jamais de CV avec numéros de téléphone, de pièces d’identité ou de documents privés.

Dans la console

1. Ouvrez https://jenksguo.xyz/admin et choisissez Media dans la barre du haut.
2. Faites glisser des fichiers sur la page, collez une capture d’écran ou choisissez Upload. Avec Optimiser les photos activé (par défaut), les photos sont redimensionnées à 2400 px et converties en WebP dans votre navigateur d’abord — une photo de 6 Mo devient généralement 300–600 Ko. Les photos HEIC d’iPhone sont converties lorsque le navigateur peut les lire (Safari le peut).
3. Sélectionnez un fichier pour ajouter un texte alternatif — une phrase décrivant ce que montre l’image. Les lecteurs d’écran et l’assistant Ask Jenks l’utilisent.

Utilisez ensuite les fichiers depuis l’éditeur Content :

• Image de couverture — dans Détails, choisissez Choisir ou téléverser une image de couverture. Elle apparaît en haut de la page de l’entrée.
• Galerie — Ajouter une photo ou une vidéo ajoute des éléments affichés à côté du texte, chacun avec texte alternatif et une légende facultative.
• Fichier de preuve — dans une ligne de preuve, le trombone joint un PDF téléversé (par exemple un article).
• Dans le texte — le bouton image dans la barre d’outils de l’éditeur insère une image ; vous pouvez aussi faire glisser ou coller une image directement dans le texte. Sélectionnez une image insérée pour modifier son texte alternatif.

Enregistrer l’entrée publie la modification comme d’habitude. L’éditeur refuse d’enregistrer un contenu qui pointe vers un fichier /media/… qui n’existe pas.

Depuis le CLI

jenks admin media upload ~/Pictures/acme-workshop.jpg --alt "Jenks running an AI workshop at Acme"
jenks admin media upload https://example.com/talk-poster.png     # the server fetches it
jenks admin media ls                                            # newest first, with "used by"
jenks admin media alt 2026/10/acme-workshop-3f9a1c2b7d.jpg "New alt text"
jenks admin media rm 2026/10/acme-workshop-3f9a1c2b7d.jpg

Le CLI téléverse les fichiers tels quels (sans redimensionnement), donc exportez d’abord les grandes photos à une taille raisonnable. Référencez ensuite l’URL affichée dans l’entrée :

image: /media/2026/10/acme-workshop-3f9a1c2b7d.jpg
imageAlt: Jenks running an AI workshop at Acme
gallery:
  - src: /media/2026/10/acme-team-0c1d2e3f4a.webp
    alt: The Acme leadership team at the kick-off
    caption: Kick-off, October 2026

Depuis un agent IA (MCP)

Le serveur MCP admin dispose de admin_upload_media, admin_list_media, admin_update_media et admin_delete_media.

• Local (jenks mcp --admin) : passez path avec un fichier sur votre ordinateur — le serveur local le lit pour l’agent.
• Remote (/mcp/admin) : passez url (une adresse https à importer) ou data (base64) avec un filename.

Une requête typique à un agent : "Téléverse ~/Desktop/xero-talk.jpg avec le texte alternatif 'Jenks speaking at Xerocon', puis fais-en l’image de couverture de xero-developer-evangelist."

Depuis REST

curl -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" \
  -F file=@acme-workshop.jpg -F alt="Jenks running an AI workshop at Acme" \
  https://jenksguo.xyz/api/admin/media

GET, PATCH et DELETE sur /api/admin/media listent, mettent à jour et suppriment. Voir la référence de l’API admin.

Supprimer en toute sécurité

La suppression est définitive : contrairement au contenu, les fichiers n’ont pas d’historique git. La console et l’API refusent de supprimer un fichier encore utilisé par du contenu publié, et indiquent où il est utilisé. Retirez d’abord les références, ou forcez la suppression si vous acceptez des images cassées.

La vérification used by lit le contenu que cet environnement a déployé en dernier. dev et production partagent une seule médiathèque (ainsi, les fichiers téléversés lors d’un aperçu sur dev continuent de fonctionner après promotion), donc un fichier utilisé uniquement par du contenu dev non promu peut sembler inutilisé dans la console de production.