Alŝuti kaj uzi bildojn kaj dosierojn

Kio estas la medioteko

Alŝutitaj dosieroj loĝas en sitelo de Cloudflare R2 kaj estas liverataj el https://jenksguo.pages.dev/media/…. Subtenataj: bildoj WebP, JPEG, PNG, GIF, AVIF kaj SVG, filmetoj MP4 kaj WebM, kaj PDF — ĝis 25 MB ĉiu. La vera tipo estas legata el la dosiero mem, do renomita dosiero ne povas sin prezenti kiel bildo.

Ĉiu dosiero ricevas konstantan adreson kiel ekzemple /media/2026/10/acme-workshop-3f9a1c2b7d.webp. La lasta parto estas fingrospuro de la bajtoj, do adreso neniam montras al alia enhavo kaj retumiloj povas kaŝmemori ĝin dum jaro. Re-alŝuti la saman dosieron kun la sama nomo denove reutiligas la ekzistantan kopion.

Dosieroj iĝas publikaj tuj post alŝuto, eĉ antaŭ ol iu paĝo ilin uzas. Alŝutu nur tion, kion ĉiu vizitanto rajtas vidi — neniam resumojn kun telefonnumeroj, identigilojn aŭ privatajn dokumentojn.

En la konzolo

1. Malfermu https://admin.jenksguo.xyz/admin (ensaluto per Google) kaj elektu Media en la supra breto.
2. Trenu dosierojn sur la paĝon, algluu ekrankopion, aŭ elektu Upload. Kun Optimise photos ŝaltita (defaŭlte), fotoj unue estas regrandigitaj al 2400 px kaj konvertitaj al WebP en via retumilo — 6 MB telefona foto kutime iĝas 300–600 KB. iPhone-ajn HEIC-fotojn oni konvertas kiam la retumilo povas legi ilin (Safari povas).
3. Elektu dosieron por aldoni alt-tekston — unu frazo pri tio, kion la bildo montras. Ekrankurigiloj kaj la asistanto Ask Jenks ĝin uzas.

Poste uzu dosierojn el la Content-redaktilo:

• Cover image — en Details, elektu Choose or upload a cover image. Ĝi aperas supre de la enirpaĝo.
• Gallery — Add photo or video aldonas erojn montratajn apud la priskribo, ĉiu kun alt-teksto kaj nedeviga klarigo.
• Proof file — en pruvvico, la paperklipo alfiksas alŝutitan PDF-on (ekzemple artikolon).
• Inside the text — la bildbutono en la ilobreto de la redaktilo enmetas bildon; vi ankaŭ povas treni aŭ alglui bildon rekte en la tekston. Elektu enmetitan bildon por redakti ĝian alt-tekston.

Konservi la eniron publikigas la ŝanĝon kiel kutime. La redaktilo rifuzas konservi enhavon, kiu referencas /media/…-dosieron kiu ne ekzistas.

El la 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

La CLI alŝutas dosierojn tiajn, kiaj ili estas (sen regrandigo), do unue elportu grandajn fotojn je prudenta grandeco. Poste referencu la presitan URL-on en la eniro:

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

El AI-agento (MCP)

La administra MCP-servilo havas admin_upload_media, admin_list_media, admin_update_media kaj admin_delete_media.

• Local (jenks mcp --admin): pasu path kun dosiero en via komputilo — la loka servilo legas ĝin por la agento.
• Remote (/mcp/admin): pasu url (https-adreso por importi) aŭ data (base64) kun filename.

Tipa peto al agento: "Alŝutu ~/Desktop/xero-talk.jpg kun alt-teksto 'Jenks parolante ĉe Xerocon', poste faru ĝin la kovrilan bildon de xero-developer-evangelist."

Per REST

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

GET, PATCH kaj DELETE ĉe /api/admin/media listigas, ĝisdatigas kaj forigas. Vidu la admin API referencon.

Forigu sekure

Forigo estas definitiva: male al enhavo, dosieroj ne havas Git-historion. La konzolo kaj API rifuzas forigi dosieron, kiun ankoraŭ uzas publikigita enhavo, kaj montras kie ĝi estas uzata. Unue forigu la referencojn, aŭ devigu la forigon se vi akceptas rompitan bildigon.

La kontrolo used by legas la enhavon, kiun ĉi tiu medio laste deplojis. dev kaj production kundividas unu mediotekon (do dosieroj alŝutitaj dum antaŭrigardo en dev daŭre funkcias post via promociado), tiel ke dosiero uzata nur de nepromociita dev-enhavo povas aspekti neuzata en la konzolo de production.