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
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
Visar:
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.
Genomgång av programmet
APA består av 5 delar (se bild 1.1).
Menyn Här är de grundläggande funktioner som finns i APA.
Snabböversikten 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.
Publicera webbbplatsen För att publicera de ändringar du gjort på webbplatsen får du klicka på knappen Publicera webbplatsen.
Visningsfönstret 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.
Detaljfältet 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.
1. Meny
2. Snabböversikten 3. Publicera webbplatsen 4. Huvudfönstret
5. Detaljfältet Bild 1.1
1 2 3
4
5
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.
• 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.
Café
Klubb Hem
Om oss
Kontakta oss Medlemskap
Verksamhet
Styrelsen Stadgar
Arbetsgrupper
Ev. historik
Webplatsen
Karta Bli medlem
Medlemsservice Nyheter
Medlemsbladet Lokalens namn Kalender
Ev. projekt
Ett förslag till sidstruktur:
Bild 1.2
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:
Kod:
<html>
<head>
<title>RFSL</title>
</head>
<body>
Text
@@CONTENT
</body>
</html>
Visar:
Text
Inkluderande mall:
Kod:
<img src=”bild.jpg”>Rubrik
Visar:
Rubrik
Den inkluderande mallen infogas i sidan och bildar:
Kod:
<html>
<head><title></title></head>
<body>
Text
<img src=”bild.jpg”>Rubrik </body>
</html>
Visar:
Text Rubrik
AP-öron för sidmallar
@@CONTENT 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.
@@PAGETITLE Där du använder detta AP-öra kommer sidans titel, eller namn skrivas.
@@PUBLIC_PATH 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.
@@CHANGED Skriver ut när sidan uppdaterades senast.
@@MENU 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:
Kod:
@@START
@TIME <B>@TITLE</B><BR>
@@SLUT
Visar:
12 aug 2005 Rubrik1 11 aug 2005 Rubrik2 10 aug 2005 Rubrik3
Mall med annorlunda formatering på första artikeln:
Kod:
@@FIRST
@TIME<BR>
<B>@TITLE</B><BR><BR>
@INTRO
@@START
@TIME <B>@TITLE</B><BR>
@@SLUT
Visar:
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 @@START och efter @@SLUT.
Mall med formatering före och efter listan:
Kod:
<HR>
@@START
@TIME <B>@TITLE</B><BR>
@@SLUT
<HR>
Visar:
____________________________________
12 aug 2005 Rubrik1 11 aug 2005 Rubrik2 10 aug 2005 Rubrik3
____________________________________
Formatering där man kan bläddra mellan sidorna:
Kod:
@@START
@TIME <B>@TITLE</B><BR>
@@SLUT
@PREV @NEXT
Visar:
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:
Kod:
@@START
@TIME <B>@TITLE</B> @LSLäs mer@LE<BR>
@@SLUT
Visar:
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:
Kod:
@@START
@TIME <B>@TITLE</B> @LS<img src=”bild.jpg”>@LE<BR>
@@SLUT
Visar:
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:
Kod:
@@START
@TIME <B>@LS@TITLE@LE</B><BR>
@@SLUT
Visar:
12 aug 2005 Rubrik1 11 aug 2005 Rubrik2 10 aug 2005 Rubrik3
AP-öron för artikelvisningsmallar
@@START Startar formateringen av artiklar i listningen. Mellan @@START och
@@SLUT formateras artiklarna i listningen, innehållet upprepas alltså för varje artikel som visas i listningen.
@@SLUT Slutar formateringen av artiklarna.
@@FIRST Om du vill att första artikeln i listan ska ha en annorlunda formatering mot resten av artiklarna formaterar du detta mellan @@FIRST och @@START.
@PREV, @NEXT Lägger in länkar till att visa senare respektive tidigare artiklar i listningen.
@TITLE Visar artikelns rubrik
@TIME Visar tiden artikeln ändrades
@INTRO Visar artikelns ingress
@LS, @LE Definierar klickbar yta för att komma till artikelvisning.
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:
Kod:
@TIME, @GROUP
<H2>@TITLE</H2>
<I>@INTRO</I>
@TEXT
<P ALIGN=”right”>@AUTHOR</P>
Visar:
24 nov 2005, Nyheter Rubrik1
Ingress1 Text1
Författare
AP-öron för artikellistningsmallar
@TITLE Skriver ut artikelns rubrik
@TIME Skriver ut tiden artikeln ändrades
@INTRO Skriver ut artikelns ingress
@TEXT Skriver ut artikelns text
@AUTHOR Skriver ut artikelns författare
@GROUP Skriver ut artikelns kategori
Ladda upp mallar
Mallarna sparas som vanliga textfiler och laddas sedan upp till APA med funktionen Textmallar som du hittar under Mallar & Filer.
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:) control- klickar 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!
Bild 1.2
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!
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