Bygg en me-sida för oophp med Anax

By . Latest revision .

Du skall skapa en me-sida för kursen oophp. Du får en mall, baserat på Anax, som du kan använda och du skall sedan gå in och redigera sidorna så att de passar dig i kursen.

Du skall göra ett Git-repo av din me-sida. När du är klar så publicerar du och taggar ditt repo på GitHub.

Allt eftersom kursen går så kommer du att fylla på innehåll i din me-sida.

Inledningsvis finns inga krav på att du behöver bemästra katalogstrukturen i Anax. Du kommer steg för steg att introduceras i strukturen som används.

Så här kan det se ut när det du har koll på mallen för me-sidan.

Mallen för me-sidan i oophp.

Mallen för me-sidan i oophp.

#Förkunskaper

Du har tidigare (i design-kursen) sett den övergripande katalogstrukturen för ramverket Anax.

Du kan grunderna i Git och GitHub.

Du har PHP i din path och du har installerat composer.

#Introduktion och förberedelse

Gör följande steg för att förbereda dig för uppgiften.

Du kan se hur jag jobbar igenom stegen i videoserien “En me-sida med Anax i kursen oophp”.

Videoserie som ger dig en introduktion till de olika delarna i redovisa-sidan.

#Kopiera från example/redovisa

Det finns en installation av Anax som är specifik för oophp-kursen och dess redovisningssida. Kopiera den och installera det som behövs med composer.

# Stå i rooten av kursrepot
rsync -av example/redovisa me
cd me/redovisa
composer install

Nu kan du öppna en webbläsare och peka mot katalogen redovisa/htdocs.

#Make

Om du får problem med detta stycket så kan du hoppa över det, men gör ett foruminlägg så att det som “är sönder” kan lagas, du behöver det senare i kursen. Det kan finnas saker i Makefilen som skiljer sig mellan olika plattformar.

Dubbelkolla att du har Make installerat och att det fungerar.

Börja med att få en översikt över de kommandon du kan köra med make.

make

Installera sedan en lokal utvecklingsmiljö i repot.

make install

Du kan nu testa vilka verktyg som finns installerade via följande kommando.

make check

Du kan testköra testsuiten som finns.

make test

Du kommer använda kommandot make för att jobba med dina enhetstester, längre fram i kursen.

#Git & GitHub

Gör ett git-repo av katalogen.

git init
git add .
git commit -m "First commit"

Gå till GitHub och skapa ett nytt repository dit du kan ladda upp git-repot.

Ladda upp ditt git-repo till GitHub (byt ut git@github.com:mosbth/oophpv4.git mot länken till ditt eget repo). Använd SSH-nycklar för att identifiera dig, det blir så mycket enklare att slippa skriva lösenord varje gång man laddar upp repot.

git remote add origin git@github.com:mosbth/oophpv4.git
git push -u origin master

Nu har du publicerat din me-sida på GitHub.

#Publicera studentservern

Publicera till studentservern för att se att allt fungerar.

dbwebb publish redovisa

Du behöver ändra sökvägarna i htdocs/.htaccess, annars får du 404 på länkar och 500 på bilderna. Det är samma struktur som fanns i design-kursen.

Glöm inte att det finns dbwebb publishfast och dbwebb publishpure som låter dig publicera snabbt och utan minifiering (nödvändigt vid felsökning).

#Bekanta dig

Bekanta dig med strukturen och vad som finns i ramverket.

Kolla in videoserien för en guidning i ramverkets struktur och filer.

#Krav

  1. Uppdatera första sidan där du ger en presentation av dig tillsammans med en bild.

  2. Uppdatera om-sidan där du skriver en rad om denna kursen samt uppdaterar de länkar som finns, så att de går till rätt ställen. Komplettera med en bild som du själv väljer.

  3. Uppdatera redovisningssidan så att den blir som du vill, här samlas dina redovisningstexter för kursen.

  4. Håll din navbar uppdaterad så man kan navigera mellan sidorna.

  5. Uppdatera header och footer så de passar din personliga me-sida.

  6. Styla sidan så som du finner bäst. Använd LESS/SASS/CSS, återanvänd kunskaper från design-kursen eller använd något ramverk liknande Bootstrap, välj själv.

  7. När du är klar, kör make test för att köra en testsuite på ditt repo. Det gör inget om du får fel, men fråga gärna i forumet för att få rätt på eventuella problem. När man kör make test så bör det passera utan problem, men det är inget krav i nuläget.

  8. Gör en dbwebb publish redovisa för att kolla att allt validerar och fungerar på studentservern.

  9. Committa alla filer och lägg till en ny tagg (1.0.*).

  10. Pusha upp repot till GitHub, inklusive taggarna.

#Extrauppgift

Lös följande extrauppgifter om du har tid och lust.

  1. Snygga till din me-sida lite extra med style. Det är alltid trevliga om det ser snyggt och ordningsamt ut.

  2. Skapa en egen testsida för att leka runt med olika konstruktioner. Det kan vara bra att ha.

#Tips från coachen

Gör små commits och committa ofta, när du väl har din bas. Använd tydliga committ-meddelanden så att historiken ser bra ut.

Var försiktig att använda stora bilder, de tar mycket quota (begränsning av lagringsutrymme) från ditt konto på studentservern.

Lycka till och hojta till i forumet om du behöver hjälp!

#Revision history

  • 2018-03-19: (A, mos) Första utgåvan.

Document source.

Category: kurs oophp, anax.