API för informationsansvarig

Transkript

1 för informationsansvarig API Som informationsansvarig bör man hålla en stadig koll på sektionens webbplats, och (tillsammans med övriga ioriter 1 ) lägga in de nyheter som olika nämnder skickar på förstasidan. Dessutom har det blivit Informationsansvarigs uppgift att trycka upp affischer inför SM och DM, och gärna försöka försöka få andra nämder att använda sektionens affischmallar. Eftersom det kan vara lite tidsödande att sätta upp affischerna, är detta något som övriga D-rektoratet kan hjälpa till med. Se mer nedan. Att göra, i (någorlunda) kronlogisk ordning Juli augusti: Förbered för nøllans ankomst. Information om (och bilder på) främst drifvare kan vara olämpligt för nøllan att titta på, och bör plockas bort. Den information som är lämplig för nøllan att titta på finns på Mottagningens sidor, som kan vara bra att puffa lite extra för. Kolla med webbdaddan som det är något speciellt som behöver ordnas inför nøllningen. Under nøllningen äger Sektionens Dag rum, ett lämpligt tillfälle att få nøllan att inse att ett ior-medlemskap är det som fattas nøllan. Under sektionens dag är det brukligt (kolla upp innan!) att varje nämnd en egen "station" som nøllan besöker. Då kan man passa på att göra något roligt, som att klistra färggladda klistermärken försedda med Datas webbadress på nøllans nøllekort (roligt?). Förutom att värva nya medlemmar är det viktigt att inpräntas som webbplatsen framför andra när det gäller information till d-tenologer. Ett nølle-sm brukar hållas under nøllningen, som också kan vara ett bra tillfälle att berätta vem man är (som Informationsansvarig). September: Under september, när folk börjar komma i ordning, är det dags för det första IOR-mötet. Därefter är ett möte varannan månad brukligt, men om man vill kan det vara trevligt att träffas oftare. IOR har en fikabudget (a.k.a. mötesbidrag) på ~ 1500 kr att använda vid möten, lämna kvitton på inköp till kassören. Vid första mötet kommer förhoppningsvis många blivande medlemmar, och när dessa tar steget till fullvärdiga medlemmar i IOR, finns vissa saker som är bra att tänka på. Mer information om detta återfinns längre ned i detta dokument. September december: Under hösten hålls minst två SM, Revisions-SM och Glögg-SM. Under SM har alla Drekledamöter (och nämndordföranden) en stående rapportpunkt (liksom under alla DM) då man kan passa på att berätta för d-osquarulda hur fin webbplatsen är, eller om IOR har utfört några speciella bravader. 1 Före SM måste dock AFFISCHER göras och sättas upp, och speciellt tillverkningen är Informationsansvarigs ansvar. Enligt stadgarna måste affischer vara uppe minst 10 arbetsdagar före SM, och ju tidigare desto bättre. Ordf meddelar ofta tid och plats i god tid (kolla annars). Det finns färdiga affischmallar som är praktiska att använda, se Affischering nedan. När affischerna är utskrivna är det bara att (tillsammans med övriga D-rektoratet) tapetsera D- och E-husen samt Escapen med dem. Just i D- och E-husen kan det dock vara bra att vara lite återhållsam, och hålla sig till whiteboardtavlor i datasalarna samt glasdörrarna till korridorerna. Notera att man inte får tejpa på glaset till glasdörrarna, utan måste tejpa på den bruna metallen. Ibland plockar städpersonalen ned affischerna, men då är det bara att säga till, eftersom vi faktiskt får sätta upp affischerna. I Escapen gäller dock ingen återhålllsamhet, det är bara att tejpa på... Speciellt på Revisions-SM brukar det vara rätt mycket ettan, så viss riktad marknadsföring mot just ettan kan vara på sin plats. Iorit = medlem i Informationsorganet (IOR)

2 Förutom affischer måste alla SM utannonseras på webbplatsen (under nyheter) och i newsgruppen kth.ths.d. Januari maj: Under våren hålls också två SM, Budget-SM och Val-SM. Också inför dessa är det affischering. Ett trick inför SM är att inte dra på fullt med affischer två veckor före, eftersom folk kan "vänja sig" vid dem då. Ordentligt med affischer två veckor före, men ännu fler ungefär 1 vecka - 3 dagar före mötet. Före Val-SM är det också viktigt att få folk att kandidera till de olika posterna på sektionen, kolla med valnämnden om de behöver hjälp med affischering. Juni juli: Under sommaren kan man 1. Fila på webbplatsen/webbservern, och göra större förändringar man inte annars hinner med, eller 2. Ha semester. Även om alternativ 1 låter väldigt lockande, så är inte alternativ 2 så dumt heller. :) Saker som är bra att veta, i bokstavsordning Affischering: Framförallt inför SM brukar informationsansvarig fixa affischer. Mallar till affischer finns i ~dsekt/public_html/formalia/grafiskprofil/ (kan även ses från webben, kolla under Formalia). Mallarna är i Adobe Illustrator-format, och påpassligt nog finns Illustrator på Nadas Mac:ar. Eftersom stora affischer är mycket roligare är små, kan man om man vill dra upp storleken lite, till t.ex. A3 eller A2. Eftersom skrivarna i datasalarna dock envetet vägrar skriva ut större än A4, kan man antingen be Nada om att få skriva ut på deras A3-skrivare, eller så kan man skriva ut affischerna i småbitar (A4) som man sedan tejpar ihop. Fungerar också, men är kanske något pilligare. Det finns vissa regler för affischering i Nadas lokaler, affischer får enbart sättas på whiteboardtavlor i terminalsalar samt på den bruna metallen på glasdörrarna i korridorerna. Även om inga nämnder måste använda Sektionens affischmallar, så ger det ett enhetligt intryck om de utnyttjas så mycket som möjligt. I ~dsekt/public_html/formalia/grafiskprofil/ finns också många logotyper och liknande, som man kan använda om standardmallen inte passar. Aktuellt: På finns aktuella nyheter på förstasidan och aktuellt-sidan. Dessa nyheter genereras efter en textfil, ~dsekt/public_html/info.txt. Syntaxen i filen är enkel; varje nyhet har en rubrik som ska skrivas på en egen rad, med en stege (#) framför. Efter rubriken skriver man nyheten, som får innehålla HTML-kod (även om om man bör vara lite försiktig med det). När alla ändringar är gjorda i info.txt, kör man ~dsekt/public_html/newinfo.pl, så uppdateras både förstasidan och aktuellt-sidan. Budget för materielinköp: Det finns för IOR:s räkning budgeterade medel för inköp av hårdvara och annan materiel, som verksamhetsåret 1999/2000 uppgick till 4000 kr. Kassören administrerar dessa medel (liksom mötesbidraget), och betalar ut ersättning mot uppvisande av kvitto. Vid större inköp kan man lösa betalningsfrågan på andra sätt, rådgör med Kassören. Digitalkameran: IOR administrerar utlåning av Sektionens digitalkamera. En utlåningslista finns uppsatt i styrelserummet, och på denna lista ska alla lån skrivas upp. Det finns i dagsläget ingen uttalad policy angående vem som kan låna digitalkameran, men alla nämndordföranden och motsvarande sektionsfunktionärer bör ha rätt att låna den, samt Doqumenteriet. Till

3 digitalkameran finns batteri och laddare, och batteriet ska alltid laddas efter användning. Kameran använder vanliga disketter för att lagra bilderna på, och IOR ska se till det finns tillräckligt med disketter för normal användning. Eftersom endast en bild får plats på en diskett (med hög kvalitet vald) kan det gå åt en del disketter. Använda disketter bör naturligtvis återlämnas i styrelserummet, där också kameran förvaras. Dokumentation: Detta API är för tilfället den enda IOR-specifika dokumentation som är tillgänglig, undantaget IOR:s PM. All dokumentation som rör IOR finns dock alltid i ~dsekt/ior/dokument/. Fil/katalogrättigheter: Alla kataloger (i AFS-filsystemet) har en åtkomstkontrollista (ACL, Access Control List) som styr rättigheterna för katalogen. Förutom enstaka användare, kan man också ge grupper rättigheter. För Datasektionen finns ett par grupper som kan vara bra att ha koll på. Exakt vem som ska vara med i vilka grupper är inte speciellt väldefinierat, men så här ser det ut idag: Grupp Ägare (av gruppen) Vem är med? dsekt dsekt Datasektionens ordförande (och gamla ordf) dsekt:admin dsekt D-ordf, Infoansv. dsekt:ior-adm dsekt Infoansv dsekt:ior dsekt:ior-adm Alla IOR-medlemmar För att administrera grupper använder man pts. För att t.ex. lägga till en användare i en grupp, skriv: > pts adduser <användarnamn> <gruppnamn> För att lista användare i en grupp: > pts membership <gruppnamn> För att kolla ägare till en grupp: > pts examine <gruppnamn> Fler kommandon kan man se genom att skriva > pts help eller > pts help <kommando> Det finns en snabbguide till pts och AFS på < Grafisk profil: Sektionen har en grafisk profil, som inbegriper logotyper, mallar för anslag, brevpapper, färger, tysnitt osv. Ännu är inte alla delar helt klara, men det material som finns hittas lättast under Formalia på (se även affischering.) Uppmuntra gärna användning av de tillgängliga mallarna, så får Sektionens dokument en mer enhetlig och därmed tydligare profil. Se även Affischering. Mailalias: Medlemmar i mailalias på sektionen läggs till/tas bort/ändras genom att ändra i motsvarande fil i ~dsekt/groups+lists/. Varje nämnd har en egen katalog, och i den finns en eller flera *.maillist-filer, som innehåller användarnamn/ adresser till folk som är men i mailaliaset.

4 Mailalias på webbplatsen På finns en lista på alla mailalias och deras medlemmar. Varje gång man har ändrat i något mailalias bör man uppdatera denna lista, och detta gör man genom att köra ett skript som automatgenererar sidan. Skriptet finns i katalogen ~dsekt/public_html/src/mail-alias/, och så här använder man det (hämtat från README-filen): För att uppdatera: Lägg till/ta bort listor från include.list Kör > cd ~dsekt/public_html/src/mail-alias >./build.sh >./install.sh Nu läggs en ny mail-alias.html i ~dsekt/public_html/namnder/! Om designen på webbplatsen skulle ändras behöver man inte ändra något av skriptet, utan man ändrar bara mail-alias-mall-top.html respektive mail-alias-mallbottom.html. Nya ioriter: När en ny medlem ska välkomnas till IOR, så bör han eller hon få en egen kopia av KTH:s dator-, webb- och ansvarsregler. Detta inte för att IOR ska agera polis, eller för att misstänkliggöra nya medlemmar, utan för att det är bra att som iorit ha koll på vilka regler som finns. Därefter är det dags att lägga till personen ifråga i IOR-gruppen, se avsnittet Fil/katalogrättigheter, och slutligen lägga till vederbörande till IOR:s mailalias. Detta mailalias ligger i ~dsekt/groups+lists/ior/, se vidare Mailalias. Då Sektionens egna webbserverar börjar användas i produktionsmiljö behöver nya konton sättas upp på dessa för nya användare. Det är en god praxis att inte ha ett gemensamt login, utan att alla ioriter får sin egen användare. PHP: PHP är det skriptspråk som ska användas/används på sektionens nya webbserver. PHP liknar konceptuellt ASP, men språket är mer en blandning avperl och C. IOR har inköpt en bok som behandlar programmering i PHP, som fungerar både som en introduktion och som en referens. Denna finns, då den inte är utlånad till någon, i styrelserummet. Dokumentation som behandlar PHP finns också på < Webbservrar: Följande information är tämligen dynamisk, och kanske inte stämmer när du läser detta. Datasektionen har två egna webbservrar, #1 och #2. Ingen av dessa används för för tillfället, men tanken är att webbplatsen ska köras på en av dem, så fort de fungerar ordentligt. Webbserver #1: #1 kallas också "quben" och är den trevliga lilla blåa burken som nu står i styrelserummet. I Informationsansvarigs fack i styrelserummet finns teknisk dokumentation för maskinen, här följer ett kort samandrag: Quben är en MIPS-maskin, dvs. den är inte Intel-kompatibel. Den har 16 Mb RAM och 2 Gb hårddisk. Det går inte att ansluta en skärm eller att tangentbord, utan quben administreras via nätverket, genom att man loggar in på den med ett terminalprogram

5 (med SSH 2 ). För att starta och ansluta quben till nätverket, följ de instruktioner som finns i den tekniska dokumentationen. Quben kör en specialversion av Linux. Quben används inte just för tillfället, detta beror främst på att hårddisken är lite speciellt partitionerad, och vissa programvaror är inte korrekt installerade. Detta är inget man inte kan lösa, men det krävs en del tid och kunskap för att göra det. Rootlösenord till quben hanteras av Informationsansvarig, och bör endast innehas av IORmedlemmar som specifikt behöver det. Mer information om quben, såsom supportinformation, finns på tillverkarens webbplats: < Webbserver #2: Den andra webbservern, som egentligen är tänkt som databasserver, är en mer traditionell server. Det är en Pentium 60, med ~1 Gb SCSI disk (2 diskar om 500 Mb), och 64 Mb RAM. Den är alltså inte speciellt snabb, men utrustad med något mera disk duger den som webbserver. Operativsystemet är Linux (distribution Mandrake). För att slippa logga in på webbservern varje gång ett dokument ska ändras körs en AFSklient, Arla, på servern. Detta gör att servern använder samma webbträd som Nada:s webbserver (som i dagsläget kör På webbserver #2 körs Apache (webbserver) med PHP 3 som skriptspråk. MySQL (databas) körs också. För att ansluta till databasen krävs användarnamn och lösenord, som Informationsansvarig förfogar över. Rootlösenord hanteras av Informationsansvarig, och bör endast innehas av IORmedlemmar som specifikt behöver det. Detta API är sammanställt av: Adam Blomberg, Informationsansvarig 1999/2000 Senast uppdaterad: [Adam Blomberg] 2 SSH är ett protokoll för att överföra data på ett säkert, krypterat sätt. Man kan använda det istället för telnet (som inte är krypterat), när man ska ansluta till någon annan maskin, som en webbserver exempelvis. För att köra SSH på en Nada-burk skriver man: module add ssh ssh <servernamn> -l<användarnamn> Då du ansluter för första gången till en maskin kan ett varningsmeddelande komma att visas, men det är helt normalt.