xgalleri Mulige filtyper Installation web-version

Transkript

1 xgalleri xgalleri opstod ud fra ønsket om at lægge en større samling billeder på nettet. Der findes mange programmer, som kan bruges til at lægge da- tafiler på nettet; men de fungerer typisk på den måde, at de enkelte filer lægges ind i programmet, f.eks. i en database. Hvis man bare har et par tusinde filer, bliver det hurtigt uoverkommeligt. Programmet fungerer derfor istedet på den måde, at datafilerne simpelt- hen placeres i et antal mapper og undermapper. xgalleri vil så automatisk registrere mapper, undermapper og filer og ud fra det dynamisk danne og vise passende HTML-sider. Når programmet er installeret, er det dermed hurtigt og nemt, at tilføje, flytte eller fjerne filer. Programmet er skrevet i php og JavaScript. Dermed er det beregnet til at installeres og køres på en hjemmeside; men det findes også i en version, som er integreret i opensource-projektet phpdesktop af Czarek Tomc- zak, og som dermed kan køre lokalt på en almindelig Windows-computer. Mulige filtyper xgalleri kan pt. bruges til følgende filtyper: Billeder - jpg, png og gif Tekst - html og pdf Video -- mp4 Lyd - mp3 Dataarkiver - zip Billedfiler (jpg, png og gif ) vises som thumbnails. Hvis disse ikke findes, dannes de automatisk. Andre filtyper vises med ikoner, passende til filty- pen. Til alle filer kan der vises en beskrivelse. Installation web-version Programmet til brug på en hjemmeside ligger i arkivet xgalleri-web.zip. Zip-filen indeholder alle de filer, som skal bruges. Filerne pakkes ud og placeres i en mappe på web-serveren, dvs. et sted i www-mappen. Web-

2 serveren eller hjemmesiden skal understøtte php. Når du har placeret alle filerne på serveren, åbnes siden i din browser. Hvis du f.eks. har et domæne med navnet og du har placeret filerne i en mappe ved navn img, skal du altså i din browser åbne siden Installation lokal version Programmet ligger i arkivet xgalleri-lokal.zip. Zip-filen indeholder alle de filer, som skal bruges. Placer dem i en mappe på din egen Windows-com- puter. Når du har placeret alle filerne i den ønskede folder, startes programmet xgalleri.exe med dobbeltklik. Du kan evt. lave en genvej til denne fil ved at højreklikke på den. Videre installation, fælles Uanset om man bruger den lokale eller web-versionen, vil man første gang programmet startes komme ind i kontrolpanelet. Det ser således ud:

3 I første omgang er det nok at udfylde feltet med password, Resten kan komme senere. Hvis du bruger programmet lokalt på din Windows-com- puter, kan du udmærket bruge det kendte standard-password Bruges programmet derimod på en hjemmeside, er det vigtigt at bruge et sikkert password. Dvs, et, der indeholder både store og små bogstaver samt cifre og har mindst 8 tegn. Tryk på Gem, når du er færdig. Programmet opretter nu filen settings.php i hovedmappen. Den indehol- der alle dine indstillinger. Det opretter også filen index.php i data-map- pen. Standardsidens opbygning Når man har trykket på Gem, kommer man til den allerførste billedside. Så længe du ikke har tilføjet dine egne billeder eller andre filer, vises her som standard 6 billeder fra den gamle by i Århus. Det kan selvfølgelig nemt ændres; men lad os i første omgang se på, hvordan denne side er opbygget. Øverst til venstre står sidens titel. Det er den tekst, som man har indtastet på den øverste linie i kontrolpanelet.

4 Øverst til højre er der to menuer. Med den øverste vælges sidens skabelon og dermed udseende. Med den nederste bestemmes, om undermapper skal vises som en liste, i en dropdown-menu eller som thumnails. Nederst til venstre er der et zip-ikon. Hvis en gæst på siden trykker på det, downloader han dermed en zip-fil indeholdende alle de billeder, der vises på siden. Nederst til højre er der tre ikoner. Med ikonet til venstre kommer man til sidens kontrolpanel, hvis man altså indtaster det korrekte password. Med ikonet i midten sendes en mail til den mailadresse, som er angivet på næstnederste linie i kontrolpanelet. Mailadressen gemmes krypteret i sidens kildekode, så den skulle ikke tiltrække spam. Med det højre ikon vises den hjælpetekst, der findes i mappen lang. Øverst vises undermapper. I dette tilfælde en lille bog og til højre for det et af baggrundsbillederne i mappen image/baggrunde. Nederst på siden vises så billederne i tre spalter. Tilføje flere billeder Du tilføjer dine billeder og andre filer til galleriet ved at kopiere dem ind i mappen data eller en undermappe under denne. Websiderne dannes dynamisk ud fra mappernes indhold. Dermed er det altid let, at tilføje, fjerne eller flytte billeder og andre datafiler. Billederne vises som sagt i tre spalter. De vises i alfabetisk orden efter fil- navnene. Oven over billederne vises en liste med evt. undermapper. Ved at klikke på en af dem, kommer man ind i den og ser indholdet. Øverst til venstre er der nu en pil, der peger opad. Med et tryk på den kommer man tilbage til den overordnede mappe. I mappen data ligger en fil ved navn index.php. Den vises ikke, men pro- grammet bruger den til at registrere mappens indhold. Hvis man opretter nye undermapper, skal denne fil derfor kopieres til hver enkelt af dem. Det kan gøres automatisk. Gå ind i kontrolpanelet og tryk på det ikonet nederst til venstre. Derved kopieres index.php ind i hver enkelt undermappe under data.

5 Navne til filer og undermapper Hvis man endnu ikke bruger php 7.0, er der nogle begrænsninger for navngivning af filer og undermapper. Filnavne må ikke indeholde særtegn som æ, ø og å og de må heller ikke indeholde mellemrum. Men filnavnene vises ikke nogen steder. De bruges kun til den alfabetiske sortering. Derfor burde det ikke være noget problem. Navnene på undermapper må heller ikke indeholder særtegn som æ, ø og å; men de må godt indeholde mellemrum. Når indholdet af en undermappe vises, ses navnet på undermappen som overskrift øverst på skærmen. Derfor kan der være behov for at bruge særtegn, og hvis man vil det, kan det klares ved at indsætte følgende ko- der i navnet på mappen: Tegn Kode Tegn Kode æ a_e Æ A_e ø o_e Ø O_e å a_a Å A_a ä a..e Ä A..e ö o..e Ö O..e ü u..e Ü U..e Hvis man vil lave en mappe med billeder af børnene, som leger på græs- plænen, kan man altså kalde mappen Bo_ernene pa_a gra_espla_enen. Det vil så blive vist som Børnene på græsplænen, både i listen med un- dermapper og som overskrift i denne undermappe. Men denne begrænsning findes altså ikke i php 7.0. Fælles beskrivelser Der kan også indsættes en generel beskrivelse i en mappe. Den vises så øverst på siden umiddelbart under titlen og over listen med undermap- per. Denne beskrivelse placeres i en tekstfil med navnet folder.php. Det er en simpel tekstfil, som dog også kan indeholde html-koder. Beskrivelsen skal gemmes i formatet UTF-8, ellers vises æ, ø og å forkert. Man kan også placere et titelbillede i en mappe. Billedet vises til højre for listen med undermapper. Billedet gemmes i mappen i png-format, og det

6 skal have titlen folder.pns. Billedet vises i 100% størrelse. Man skal altså gemme det i den størrelse, som det ønskes vist med. Filen folder.php kan skrives med Windows Notepad; men det er nemme- re, at bruge et lidt mere avanceret program, som f.eks. den gratis Note- pad++, som kan hentes på adressen En af fordelene ved dette program er, at man nemt kan vælge det rigtige format til teksten. Gå ind i menuen Format og sæt mærke ved Indkod i UTF-8 (uden BOM). Beskrivelser til enkelte billeder/filer Hver datafil vises med en thumbnail eller et ikon. Til højre for det vises en overskrift/titel og en beskrivelse/billedtekst. Hvis der er tale om en jpg-fil, skrives overskrift og beskrivelse som IP- TC-data direkte i filen. Det kan bl.a. gøres med det gratis program xnview, som kan hentes på Fordelen ved denne metode er, at beskrivelsen står direkte i billedfilen. Hvis filen senere flyttes til en anden mappe, vil beskrivelsen derfor automatisk komme med.

7 Find billedet i xnview. Højreklik på det og vælg Rediger IPTC-data.... I det viste dialogfelt vælges fanebladet Billedtekst. Her udfyldes felterne Billedtekst og Overskrift. Tryk på Skriv og derefter på Luk. Ved andre filtyper skrives overskrift og beskrivelse i en fil ved navn le- gend.php. Denne fil placeres i samme mappe som datafilerne. Filen le- gend.php er en simpel tekstfil. Hver linie i filen indeholder beskrivelsen til en datafil. En sådan linie består af filnavnet på datafilen, overskriften og beskrivelsen adskilt af semikolon. Her er et eksempel på sådan en fil. Aage-Helbo.pdf;Aage Helbo;Skrevet af hans mor. hans-helbo.pdf;hans Helbo;Hans Helbos erindringer. Sven-Helbo.pdf;Sven Helbo;Skolelæge, Dr. Med. erindringer. sjolte.pdf;rasmus Hansen Sjolte;Deltager i krigen Denne metode er mere besværlig, fordi filen legend.php skal gemmes i samme mappe som billed- eller datafilerne. Hvis en fil senere skal flyttes til en anden undermappe, skal beskrivelsen altså også flyttes. Ligesom fol-

8 der.php skal legend.php gemmes i formatet UTF-8, og dermed er det også her en fordel at bruge en lidt bedre editor som Notepad++. Visning af scannet bog Hvis man ønsker at scanne og vise en hel bog, kan det gøres således: Bo- gens sider eller opslag scannes og gemmes som jpg-filer. Filerne kan frit navngives, men de vises i alfabetisk orden. Alle siderne lægges i en undermappe med navn bog. Når websiden åbnes, vises bogens første side. Brugeren kan derefter bladre gennem bogen ved at klikke på de viste pilikoner eller ved at bruge pil- tasterne på tastaturet. Søgefunktion Nederst på hver side vises et søgefelt. Hvis man anvender web-versio- nen til en hjemmeside, laves søgefunktionen nemmest vha. Google si- te-search. Gå til Klik på Sign in to custom search engine, og log på med en almindelig gmail-konto. Dermed kommer man ind på denne side:

9 Klik på Add og følg vejledningen. Dvs. her skal man angive adressen til den hjemmeside, hvor billederne ligger og tilpasse udseendet af søgefeltet samt visningen af resultaterne. Når alt er, som det skal være klikker man på knappen Get code. Dermed kommer man til en side, der ser ud noget i stil med denne her: Kopier nu hele teksten fra det grå felt. Denne kode indsættes i filen search.php mellem anførselstegnene, istedet for den tekst, der står her i forvejen. Det kan igen gøres med Notepad++. Vær opmærksom på, at der går et stykke tid, før søge-funktionen virker fuldt ud. Google skal simpelthen have tid til at læse og indeksere siden med alle undersider. Vedligeholdelse I kontrolpanelet er der nederst 4 ikoner. De har (regnet fra venstre) følgende funktion: 1. Kopierer filen index.php fra mappen data til alle undermapper. 2. Opdaterer indholdet af mappen data fra version 1.0 til version 2.0. Det betyder at mappen med siderne i en bog omdøbes fra b til bog, og navnene på billedfiler i mapperne thumbs ændres. Tegnene tn_ i starten fjernes, så billede og thumbnail nu har samme navn. 3. Bruges på en Windows-server. Funktionen forsøger at fjerne alle filer med navnet Thumbs.db 4. Opretter thumbnails til alle billeder, hvis de ikke allerede findes. Alternativt oprettes de automatisk første gang siden vises.