Manual till APA. En instruktionsmanual för användare av APA Advanced Publication Application

Manual till APA En instruktionsmanual för användare av APA Advanced Publication Application

Versionshistoria 2005-10-13 början Anders Nilsson 2007-05-12 slutversion Adam Boman Vid frågor om APA eller denna manual, kontakta webmaster@rfsl.se 2

1. Introduktion Välkommen till denna manual till RFSL:s webbpubliceringssystem APA Advanced Publication Application APA är utvecklat av och för RFSL och dess avdelningar och vidareutvecklas med tiden då behov och funktioner dyker upp. Systemet är webb-baserat vilket innebär att vem som helst som har tillgång till en dator som är ansluten till Internet kan logga in och arbeta i programmet. För dig som ska redigera sidor i en redan existerande webbplats och vill lära dig hur man lägger in text, bilder och annat innehåll rekommenderar vi kapitel 3: Redigera webbplatsens innehåll. För dig som ska bygga en webbplats från grunden och vill lära dig hur man hanterar mallar och användare rekommenderar vi att börja med kapitel 2: Bygga en webbplats från grunden. Vad denna dokumentation inte kommer att ta upp är hur man bygger egna funktioner för APA eller hur man hanterar Apariumet. Dokumentationens upplägg Denna dokumentation är uppbyggd för att passa så väl nybörjare som vana HTML-kodare eller webbredaktörer. För att visa text eller kod som ger ett resultat delar vi upp sidan i två kolumner: Texten och resultatet. Texten skrivs då på vänster sida med grå bakgrund och svart text och resultatet på höger sida i det format som det resulterar i. Om vi vill att du ska uppmärksamma något speciellt i texten har vi markerat det mindre relevanta genom att skriva det i mörkgrå text medan det viktiga i texten kvarstår i svart text. Exempelvis vill vi här att du ska uppmärksamma texten @@CHANGED Text: Sidan uppdaterades senast @@CHANGED Sidan uppdaterades senast 25 Aug 2005 När vi tipsar eller visar exempel på något som just nämnts markerar vi detta med en vit text med svart bakgrund. 3

Genomgång av programmet APA består av 5 delar (se bild 1.1). Bild 1.1 1 2 3 4 1. Meny 2. Snabböversikten 3. Publicera webbplatsen 4. Huvudfönstret 5. Detaljfältet 5 Menyn Snabböversikten Publicera webbbplatsen Visningsfönstret Detaljfältet Här är de grundläggande funktioner som finns i APA. En snabb lista över de sidor du har skapat. Välj den sida du vill granska. I äldre webbläsare får du klicka på knappen Visa sidan för att verkställa. För att publicera de ändringar du gjort på webbplatsen får du klicka på knappen Publicera webbplatsen. I visnings-/redigeringsfönstret ser du större delen av dina möjligheter i APA. Sidor, artiklar, större inställningar och förhandsvisningar syns här. När du valt att förhandsvisa eller redigera olika objekt ser du alternativ och inställningar här. Grundläggande funktioner APA har för närvarande två grundfunktioner: Att skapa sidor och att hantera artiklar. Sidor Istället för att behöva kunna svår HTML och FTP och allehanda saker för att uppdatera din hemsida räcker det med att du nu använder APA. APA:s grafiska gränssnitt gör det mycket lättare att lägga in bilder, länkar och text på din hemsida och framför allt att få sidan att se enhetlig ut. Du bygger lätt upp strukturer över din webbplats och menyerna anpassar sig i stort sett automatiskt efter din vilja. Artiklar Artiklar är till för att hantera nyheter, listor, kalendarier och liknande information som uppdateras kontinuerligt. För att visa artiklar kan webbplatsens huvudredaktör skapa listor med olika artiklar och en visning där besökaren kan läsa valda delar av innehållet från artiklarna. Alla webbredaktörer kan sendan enkelt redigera och lägga till nya artiklar. Vanligtvis används funktionen till nyheter, bloggar, att lista personer, kalender beroende på hur man använder artikellistorna. Artiklar delas upp i olika kategorier beroende på vad du väljer att artiklarna ska tillhöra. För att kunna läsa mer om artiklarna används en artikelvisning. Den visar också artikeltexten från artikeln men till skillnad från listorna så visar den alltid en (1) artikel. 4

2. Bygga en webbplats från grunden Förberedelser Innan du startar det tekniska arbetet föreslår vi att du och kanske några fler sätter er ner och tänker igenom hur ni vill att sidan ska se ut. Vilken menystruktur ska sidan ha? Vad är det besökarna vill se först när de besöker din webbplats Vad vill du uppnå med webbplatsen, vilken information vill du ge ut? Vad tror du att besökarna vill finna på webbplatsen? Sådana saker varierar från webbplats till webbplats vad man känner att man vill uppnå samt vad man tror att besökarna vill se. Det finns även vissa riktlinjer för att få webbplatsers struktur och uppbyggnad bra. Bild 1.2 Ett förslag till sidstruktur: Skapa en enkel struktur så att besökarna inte ska behöva tänka och slita sina grå för att hitta det de söker. Se bild 1.2 Alla sidor bör ha ett enhetligt utseende så att besökaren känner igen sig och vet att den bläddrar på Din webbplats. Det är ungefär som att alla som arbetar i en butik har samma kläder på sig. Om du länkar till en e-postadress, låt gärna e-postadressen vara den klickbara ytan. I många fall uppfattas det att man ska komma till en sida med kontaktuppgifter om det bara står kontakta oss. Om du ska länka till PDF-filer, lägg gärna en PDF-ikon framför länken eller påpeka intill att det är en PDF-fil. Informera även var man kan få tag på Acrobat Reader. Hem Om oss Stadgar Styrelsen Arbetsgrupper Ev. historik Webplatsen Nyheter Medlemskap Bli medlem Medlemsservice Verksamhet Kalender Lokalens namn Café Klubb Medlemsbladet Ev. projekt Kontakta oss Karta 5

Mallar Olika sorts mallar I APA finns det tre sorters textmallar: Sidmallar, Artikelvisningsmallar och Artikellistningsmallar. Dessa tre används i olika delar av webblatsen. Sidmallarna för själva innehållet och sidorna, Artikelvisningsmallarna för att definiera hur artiklarna ska formateras och visas samt Artikellistningsmallarna för att formatera listorna där artiklarna listas. Dessa mallar formateras med vanlig HTML och stilmallar (style sheets) samt speciella nyckelord, så kallade AP-öron som APA omvandlar till dynamisk information. AP-öronen läggs in i texten och ersätts med den respektive funktion som respektive öra har. Sidmallar Sidmallarna delar vi upp i två grupper: kompletta mallar och inkluderane mallar. De kompletta mallarna är mallar som bestämmer hur hela sidan ser ut medan de inkluderade mallarna är små delar av en sida som inkluderas för att se likadana ut överallt. Den största skillnaden på dem är att de kompletta mallarna ser ut som en vanlig hemsida. Komplett mall: <html> <head> <title>rfsl</title> </head> <body> Text @@CONTENT </body> </html> Inkluderande mall: <img src= bild.jpg >Rubrik Text Rubrik Den inkluderande mallen infogas i sidan och bildar: <html> <head><title></title></head> <body> Text <img src= bild.jpg >Rubrik </body> </html> Text Rubrik 6

AP-öron för sidmallar @@CONTENT @@PAGETITLE @@PUBLIC_PATH @@CHANGED @@MENU Här sätts ett innehållsområde in. I varje innehållsområde kan du lägga in text, bilder, länkar, artikelvisningar, artikelbilder etc med APA:s sidredigeringsfunktion. Detta tar vi upp i kapitel 3. Där du använder detta AP-öra kommer sidans titel, eller namn skrivas. Kortkommando till mappen där bilder och publika filer finns. Exempelvis <img src= @@PUBLI C_PATH/bild.jpg > för att hämta den bilden bild.jpg. Skriver ut när sidan uppdaterades senast. Lägger in en meny automatiskt. Artikellistningsmallar För att formatera dina artikellistor skapar du en HTML-fil på samma sätt som med de inkluderande mallar. De innehåll du kan välja att visa i en lista är artikelns datum då datumet gäller genom att använda @TIME, rubriken genom koden @TITLE, för att visa artikelns eventuella bild skriver du @IMAGE. En sidmall är uppdelad i 2 delar. Första artikeln i listan och resten av artiklarna i listan. Du har möjligheten att formatera första artikeln annorlunda mot resten av artiklarna genom. Mall med samma formatering på alla artiklar: @TIME @TITLE 12 aug 2005 Rubrik1 11 aug 2005 Rubrik2 10 aug 2005 Rubrik3 Mall med annorlunda formatering på första artikeln: @@FIRST @TIME @TITLE @INTRO @TIME @TITLE 12 aug 2005 Rubrik1 Ingress1 11 aug 2005 Rubrik2 10 aug 2005 Rubrik3 Du har även möjlighet att lägga in text och formatering före och efter listan utan att den behöver upprepas genom att lägga in det före @@FIRST respektive och efter. Mall med formatering före och efter listan: <HR> @TIME @TITLE <HR> 12 aug 2005 Rubrik1 11 aug 2005 Rubrik2 10 aug 2005 Rubrik3 Du kan ställa in hur många artiklar du vill visa åt gången men om du får fler artiklar än vad du valt att visa kan du använda @PREV och @NEXT för att kunna bläddra fram och tillbaks i listan. Dessa används utanför @@FIRST respektive och 7

Formatering där man kan bläddra mellan sidorna: @TIME @TITLE @PREV @NEXT 12 aug 2005 Rubrik4 11 aug 2005 Rubrik5 10 aug 2005 Rubrik6 Föregående sida Nästa sida Detta listar bara artiklarna och besökaren har inget tillgång att läsa detaljerna om artiklarna. Du måste då lägga upp en sida som innehåller en artikelvisning men förutsatt att vi redan gjort det så använder du @LS och @LE för att välja var besökaren ska klicka för att kunna läsa mer om din artikel. LS står för Link Start (Start på länk) respektive LE står för Link End (Slut på länk) @LS och @LE kan du lägga både runt text eller bilder, eller runt ett annat AP-öra. Formatering där man klickar på text för att läsa detaljer: @TIME @TITLE @LSLäs mer@le 12 aug 2005 Rubrik1 Läs mer 11 aug 2005 Rubrik2 Läs mer 10 aug 2005 Rubrik3 Läs mer Formatering där man klickar på en bild för att läsa detaljer: @TIME @TITLE @LS<img src= bild.jpg >@LE 12 aug 2005 Rubrik1 11 aug 2005 Rubrik2 10 aug 2005 Rubrik3 Formatering där man klickar på AP-öra för att läsa detaljer: @TIME @LS@TITLE@LE 12 aug 2005 Rubrik1 11 aug 2005 Rubrik2 10 aug 2005 Rubrik3 AP-öron för artikelvisningsmallar @@FIRST @PREV, @NEXT @TITLE @TIME @INTRO @LS, @LE Startar formateringen av artiklar i listningen. Mellan och formateras artiklarna i listningen, innehållet upprepas alltså för varje artikel som visas i listningen. Slutar formateringen av artiklarna. Om du vill att första artikeln i listan ska ha en annorlunda formatering mot resten av artiklarna formaterar du detta mellan @@FIRST och. Lägger in länkar till att visa senare respektive tidigare artiklar i listningen. Visar artikelns rubrik Visar tiden artikeln ändrades Visar artikelns ingress Definierar klickbar yta för att komma till artikelvisning. 8

Artikelvisningsmallar Artikelvisningsmallarna fungerar även de som inkluderande mallar och är väldigt lika artikelvisningsmallarna. Du lägger in lämpligt AP-öra för det innehåll du vill använda tillsammans med text och HTML eller Stylesheet formatering för att få det utseende du vill ha. De AP-öron som inte fungerar är @FIRST, @START, @SLUT, @LS/@LE, @NEXT och @PREV. Det finns däremot några fler innehåll att välja på här mot vad artikellistningarna kan använda. @AUTHOR, @GROUP och @TEXT. För att visa vem som har skrivit texten eller varifrån texten är hämtad skriver du @AUTHOR i formateringen. För att visa vilken artikelkategori artikeln tillhör använder du dig av @GROUP. Och för att kunna läsa hela artikeln visar du dess text med koden @TEXT. Komplett artikelvisningsmall: @TIME, @GROUP <H2>@TITLE</H2> @INTRO @TEXT @AUTHOR 24 nov 2005, Nyheter Rubrik1 Ingress1 Text1 Författare AP-öron för artikellistningsmallar @TITLE @TIME @INTRO @TEXT @AUTHOR @GROUP Skriver ut artikelns rubrik Skriver ut tiden artikeln ändrades Skriver ut artikelns ingress Skriver ut artikelns text Skriver ut artikelns författare Skriver ut artikelns kategori 9

Ladda upp mallar Mallarna sparas som vanliga textfiler och laddas sedan upp till APA med funktionen Textmallar som du hittar under Mallar & Filer. Bild 1.2 Uppbyggnad av funktionen textmallar Högst upp finns ett formulär för att skapa nya textmallar. Under formuläret listas alla existerande mallar. De fält du ser är Beskrivning Det namn som valts så att du lätt känner igen mallen via dess namn. Typ Om det är en artikellistningsmall, artikelvisningsmall eller sidmall. Preview Om du klickar på förstoringsglaset får du en förhandsvisning på mallen. Redigera När du klickar på Redigera får du fram mallens detaljer i detaljfältet. Ladda ner Om du vill se mallkoden klickar du på knappen under Ladda ner. Du får då se koden i blaha. För att ladda ner filen till din dator (pc:) högerklickar (mac:) controlklickar du på knappen och väljer att du vill spara länken. Ladda upp mall Fyll i ett passande namn för din nya mall i rutan Beskrivning/Namn, tänk efter om du kan använda den mallen till fler saker så du kan ge den ett så generellt namn som möjligt. T.ex. om du ska lista styrelsen och valberedningen i två likadana listor så är rekommenderar vi att du kommer på något annat namn på mallen än styrelselista eller valberedningslista. I listan under väljer du vad det är för sorts mall som ska laddas upp. Och i fältet längst ner anger du sökvägen på datorn till den fil du vill använda. För underlätta kan du klicka på bläddra och leta upp filen själv. Klicka till slut på Skapa! 10

Redigera mall Som vi nämnde ovan så ser du mallarnas detaljer när du klickar på Redigera. I detaljfältet ser du då följande detaljer: Mallapsart De olika sorts mallar som du kan välja på. Kommentar/Namn Namn eller kommentar så att du vet vilken mall som är vilken. Ladda upp ny fil Om du vill byta ut filen som används som mall. Du ser även lite information om när mallen skapades respektive senast ändrades och vem som kan anses skyldig för dessa. Om du vill göra ändringar i själva mallen så ser du till att ha den senaste versionen av den. Gör de ändringar du vill göra och klicka på knappen bläddra under Ladda upp ny fil. Leta upp den fil som du vill ladda upp och klicka sedan på knappen Ändra! 11

3. Redigera webbplatsens innehåll Sidor Sidornas och dess struktur kan du se på Översiktskartan som du kan hitta på Visa översikt under Sidor i menyn - det är också den sidan som dyker upp när du gått in på Din webbplats. Skapa sida Om webbplatsen är helt ny så kommer du bara se namnet på webbplatsen i Översiktskartan, denna sida bör du inte röra förutom när du ska skapa undersidor. Dessa sidor blir då första steget i den hierarkiska sidstrukturen. För att skapa en undersida klickar du på den sida som din nya sida ska vara undersida till. I formuläret som dyker upp väljer du vilken av dina uppladdade mallar som du vill använda och vad du vill kalla din sida. Detta namn blir även den rubrik som sidan får i eventuella menyer. Lägg upp den struktur som du har kommit fram till att du vill använda och med de mallar som passar varje sida. Detaljer för sida När du klickar på dina sidor så får du upp dess information i detaljfältet: Beskrivning Det namn eller beskrivning som du valt till sidan. Malldokument Mallen som du valt att sidan ska ha. Prioritet Vilken prioritet på grenen i strukturen sidan har - ju högre siffra desto högre upp hamnar sidan. Visa i meny Här kryssar du i om du vill att sidan ska synas i menyn. Om du inte kryssar i så markeras den första sida uppåt som valts att visas i meny. Sidan externa URL Den adress som sidan får när allt är publicerat. Du kan även här se vem som skapat och senast ändrat sidan samt när det senast gjordes. Du kan även se funktionerna Förhandsvisa Här ser du ungefär hur sidan kommer att se ut när den publicerats. Redigera Du får upp en förhandsvisning av sidan men med Apor där sidans innehållsfält finns. Vi kommer till detta under Lägga in innehåll. Rättigheter Om du själv har rättigheter så kan du ge ut rättigheter till vilka som får läsa, skriva och radera sidor. Flytta innehåll BLAHA! Flytta sida Om du inte är nöjd var du har lagt sidan så använder du Flytta sida för att lägga sidan på en annan gren i strukturen. Klicka på den sida som du vill att din sida ska vara undersida till. Lägg till undersida På samma sätt som när du skapade din sida så kan du lägga till undersidor. Radera Här raderar du sidan. Du kan inte få tillbaks din sida om du använder den här funktionen. Lägga in innehåll Just nu är sidan helt tom. För varje ställe där du kan lägga in ett objekt ser du ett gult Ap-huvud ( ), dessa kallar vi innehållsområde och de numreras i den ordning de har i mallkoden. Klicka på ett Ap-huvud så får du upp detaljerna för detta innehållsområde. I detaljfältet ser du nu tre kolumner. I första ser du en lista på de objekt som finns i innehållsområdet och funktioner för denna. Varje objekttyp har en egen ikon: Text Artikellista Bild Artikelvisning Länk Quicktime filmvisning Inkludering av sida Lösenordsskydd (Fungerar ej för närvarande) E-postformulär Meny 12