Alŝutu kaj uzu bildojn kaj dosierojn

Kio estas la aŭdvida biblioteko

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

Ĉiu dosiero ricevas konstantan adreson kiel /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 unu jaro. Re-alŝuti la saman dosieron kun la sama nomo ree uzas la ekzistantan kopion.

Dosieroj estas publikaj tuj kiam ili estas alŝutitaj, eĉ antaŭ ol iu paĝo uzas ilin. Alŝutu nur tion, ĉion kion ĉiu vizitanto rajtas vidi — neniam vivresumojn kun telefonnumeroj, identigilojn aŭ privatajn dokumentojn.

En la konzolo

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

Poste uzu dosierojn el la redaktilo Content:

• 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 skribaĵo, ĉiu kun alt-teksto kaj nedeviga klarigo.
• Proof file — en pruv-vico, la paperklipo alfiksas alŝutitan PDF-on (ekzemple artikolon).
• Ene de la teksto — la bilda butono 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 montras al /media/… dosiero 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 (neniu regrandigo), do unue eksportu grandajn fotojn je prudenta grandeco. Poste referencu la presitan url 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

De AI-agento (MCP)

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

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

Tipa peto al agento: "Upload ~/Desktop/xero-talk.jpg with alt text 'Jenks speaking at Xerocon', then make it the cover image of 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.xyz/api/admin/media

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

Forigu sekure

Forigo estas konstanta: malsame ol enhavo, dosieroj ne havas git-historion. La konzolo kaj API rifuzas forigi dosieron kiun publikigita enhavo ankoraŭ uzas, kaj montras kie ĝi estas uzata. Unue forigu la referencojn, aŭ devigu la forigon se vi akceptas rompita(j)n bildo(j)n.

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