Skip to content

README.md

Latest commit

 

History

History
161 lines (112 loc) · 4.59 KB

README.md

File metadata and controls

161 lines (112 loc) · 4.59 KB
source-git-commit workflow-type source-wordcount ht-degree
65313a91d28d199c142e33f9b77b7e59bbb512ac
tm+mt
417
0%

Förimplementera kopplingar för bildoptimering

Den här katalogen innehåller förimplementerade kopplingar som automatiskt optimerar bilder innan de implementeras i databasen.

Vad krokarna gör

  • Identifiera mellanlagrade bildfiler automatiskt (PNG, JPG, JPEG, GIF)
  • Körimage_optim för att komprimera och optimera bilder
  • Ordna om optimerade bilder automatiskt
  • Kontrollera att alla implementerade bilder är korrekt optimerade

Fördelar

  • Minskad databasstorlek
  • Snabbare sidinläsning för dokumentation
  • Enhetlig bildkvalitet för alla deltagare
  • Ingen manuell optimering krävs

Förutsättningar

  • Ruby 3.0 eller senare
  • Bundler
  • Git

Inställningar

Automatisk installation (rekommenderas)

.githooks/setup-hooks.sh

Manuell konfiguration

git config core.hooksPath .githooks
chmod +x .githooks/*

Slutför projektkonfiguration

  1. Klona databasen:

    git clone <repository-url>
cd commerce-admin.en

  2. Aktivera förimplementerade kopplingar:

    .githooks/setup-hooks.sh

  3. Installera Jekyll-beroenden:

    cd _jekyll
bundle install

Testa krokarna

  1. Lägga till en bildfil i databasen
  2. Stega den: git add <image-file>
  3. Försök att genomföra: git commit -m 'test'
  4. Haken bör automatiskt optimera bilden

Förväntade utdata

Found 1 staged image(s). Running optimization...
Optimizing: path/to/your/image.png
Re-staged optimized image: path/to/your/image.png
Image optimization complete!

Bildriktlinjer

  • PNG: Används för skärmbilder och gränssnittselement (optimeras automatiskt)
  • JPEG: Används för foton (optimeras automatiskt)
  • GIF: Används för animeringar (optimeras automatiskt)
  • SVG: Använd för ikoner och enkel grafik (inte bearbetad av krokar, använd som den är)

De förimplementerade hookarna optimerar automatiskt PNG-, JPEG- och GIF-bilder vid implementering.

Manuell optimering

För manuell bildoptimering:

cd _jekyll
bundle exec rake images:optimize path=../path/to/images

Konfiguration

Hokarna använder konfigurationsfilen _jekyll/.image_optim.yml för att anpassa optimeringsinställningarna:

  • PNG: Använder advpng, optipng och pngquant
  • JPEG: Använder jhead, jpegoptim och jpegtran
  • GIF: Använder gifsicle
  • SVG: Inte bearbetad (exkluderad från identifiering för att bevara vektorgrafik och animeringar)

Felsökning

Hook körs inte

  • Kontrollera krokkonfiguration: git config core.hooksPath
  • Kontrollera att krokfilen är körbar: chmod +x .githooks/pre-commit
  • Kontrollera att du finns i rätt databas med katalogen _jekyll

Optimeringsfel

  • Verifiera att bundle install har körts i katalogen _jekyll
  • Kontrollera att adobe-comdox-exl-rake-tasks-grammet är installerat (tillhandahåller image_optim)
  • Granska konfigurationsfilen .image_optim.yml

Prestandaproblem

  • Justera antalet trådar i _jekyll/.image_optim.yml
  • Ange miljövariabeln DEBUG=1 för detaljerad felinformation

Så här fungerar det

  1. Pre-commit trigger: När du kör git commit körs kroken automatiskt
  2. Bildidentifiering: Söker igenom mellanlagrade filer efter bildtillägg
  3. Optimering: Kör image_optim på varje mellanlagrad bild
  4. Mellanlagring: Lägger automatiskt till optimerade bilder i mellanlagringsområdet igen
  5. Genomför fortsätter: Om optimeringen lyckas fortsätter implementeringen normalt

Bildformat som stöds

  • PNG (.png) - förlustfri och förstörande komprimering
  • JPEG (.jpg, .jpeg) - Förstörande komprimering med rensning av metadata
  • GIF (.gif) - Animering och statisk optimering
  • SVG (.svg) - Bearbetas inte av krokar (spara i befintligt skick för att bevara kvaliteten)

God praxis

  1. Testa kroken: Prova att implementera en liten bild först för att se till att den fungerar
  2. Granska ändringar: Kontrollera Git-differensen för att se optimeringsresultat
  3. Bildskärmsprestanda: Det kan ta tid att optimera stora bilder
  4. Versionskontroll: Anrop lagras i den här .githooks/-katalogen

Support

Om du har problem med krokarna före implementering:

  1. Kontrollera krokutdata för felmeddelanden
  2. Kontrollera att din image_optim-konfiguration fungerar
  3. Testa med de manuella penselåtgärderna först
  4. Granska krockloggarna och konfigurationen
  5. Kontrollera krokkonfigurationen: git config core.hooksPath