Hvordan lage en kursside

Om du trenger en innføring i git, finner du en her (inkluderer innføring i python)

1. Lage en organisasjon

Det første vi må gjøre er å lage en “organisasjon”, som skal eie kurssiden. Du kan gjøre dette som følger:

  1. Logg in på github.com
  2. Gå til https://github.com/organizations/plan
  3. Velg “Create organization”
  4. Velg “Create a free organization”

    image

  5. Bruk følgende oppsett:
    1. Gi navn etter følgende navnekonvensjon

      uit-<kurskode>-<semester><år>.

      <kurskode> kan for eksempel være SOK-1006.
      <semester> kan være enten “h” or “v” (Norsk) or “f” or “s” (Engelsk).
      Bruk de siste to sifferne i <year>.

      For eksempel kan navnet være uit-sok-1006-v23.

    2. Skriv in e-posten din
    3. Velg “A business or institution”
    4. Skriv inn “UiT The Arctic University of Norway” som navn på institusjonen.

    5. Aksepter betingelesene og klikk “Next”

      image

  6. Legg til kollegger som er med på kurset og klikk “Complete setup”

    image
  7. Om nødvendig, skriv inn githubpassordet

    image
  8. Klikk på brukerikonet i øverste høyre hjørne, og klikk på “Your organizations”

    image

  9. Klikk på organisasjonen du akkurat har skapt

2. Lage kursets repositorie (repo)

  1. Gå til dette repositoriet: https://github.com/uit-econ/coursepage_template
  2. Klikk på “Use this template” og “Create new repository” image
  3. VIKTIG! Endre “Owner” til organisasjonen du akkurat har skapt.
    image
  4. Gi repoen akkurat samme navn som organisasjonen, men legg til “.github.io” på slutten av navnet.
    For eksempel, om organisasjonsnavnet var “uit-sok-1006-v23”, blir reponavnet “uit-sok-1006-v23.github.io”.
    Hensikten med denne navngivingen er at denne repoen automatisk skal bli startsiden til organisasjonen.
  5. Velg “Public” og klikk “Create repository”

3. Åpne og se repoens hjemmeside

  1. Finn “github-pages” nede til høyre i repositoriet og klikk på den.

    image

  2. Klikk på “View deployment” på siden du kommer til, og du vil se hjemmesiden til kurset (det kan ta noen minutter før det er ferdig, så du må kanskje oppdatere nettleseren noen ganger)
  3. Om du ikke kan se “github-pages”-lenken, selv etter å ha ventet noen minutter, kan du aktivere nettsiden i “Settings” i repomenyen. Velg “Pages” i venstremenyen og “main” i nedtrekksmenyen “Branch”. Klikk så på “Save”.

4. Rediger repoen

  1. Rediger repoinstillingene i “_config.yml” ved å trykke på filen og så pennikonet oppe mot høyre.

    Du trenger kun redigere de tre første linjene (om du ikke vil endre avanserte instillinger). De første tre linjene er:

    • name: Sok-xxxx Emnetittel:
      Nødvendig. Må endres til gjeldende kurskode.

    • semester: Høst/Vår 20xx:
      Nødvendig. Må endres til gjeldende semester.

    • image: tema.jpg:
      Valgfri. Du kan laste opp et nytt bilde med “Add file”-knappen. Om navet ikke er “tema.jpg”, må du endre navnet over. Du kan imidlertid også bare slette “tema.jpg” og laste opp en ny fil med samme navn. image

  2. Rediger venstremenyen til hjemmesiden ved å redigere “navbar.html”. Begynn med å fjerne lenke til disse dokumentene (“Hvordan sette opp en kursside”). Du kan redigere eksisterende lenker ved å endre på lenkeadressen og lenketeksten. Om du trenger flere lenker, så bare kopier én av lenkene og endre denne.

    MERK! Markupfiler konverteres automatisk til html-filer. Om du ønsker å lenke til en markdown *.md-fil, må du derfor endre filendelsen fra “.md” til “.html”.

    image

  3. Det er allerede maler for startsiden (“index.md”), forelesningsplan (“forelesningsplan.md”), seminarer (“seminarplan.md”) and innleveringer (“innleveringer.md”). Du kan se av disse eksemplene hvordan du lager lenker og tabeller.

    VIKTIG! Om du lager en ny markdownfil (.md), legg alltid inn {\% include navbar.html \%}{\% include top-box.html \%} i toppen av dokumentet. Dette sørger for at venstremenyen og topp-boksen lastes med siden.

5. Redigere hovedsiden for Samfunnsøkonomi med datavitenskap

For å gjøre kurssiden tilgjengelig for studentene fra hovedsiden, må du redigere emnet der.

  1. Gå til \_portfolio-mappen i uit-econ.github.io-repoen under hovedside-organisasjonen uit-econ her: uit-econ/uit-econ.github.io/_portfolio/

    image

  2. Klikk på kurset du er ansvarlig for, og rediger det (klikk på penn-symbolet oppe til høyre).

    image

  3. Dokumentet du nettopp åpnet kan inneholde en kursbeskrivelse, eller ikke. Uansett, skal siden se slik ut nå:

    ---
    title: Sok-xxxx <Navn på kurs>
    subtitle: 10 STP
    image: https://raw.githubusercontent.com/uit-econ/hovedside/main/assets/img/Sok-xxxx.jpg
    category: semesterX

    caption:
      title: Sok-xxxx
      subtitle: <Navn på kurs>
      thumbnail: https://raw.githubusercontent.com/uit-econ/hovedside/main/assets/img/Sok-xxxx.jpg
    ---
    {% include nettsideApnerTop.html %}
    window.open('https://uit-sok-xxxx-<semester><år>.github.io/');

    {% include nettsideApnerMid.html %}
    observer.observe(document.getElementById("Sok-xxxx").children[0], { attributes: true } );

    {% include nettsideApnerBunn.html %}



    • Om det lå en kursbeskrivelse, kan du eventuelt kopiere den og lime innholdet inn i “index.md” i kursets github repositorie.
    • Dersom siden ikke ser ut som ovenfor, så
      • sletter du all tekst som er der
      • limer inn teksten ovenfor
      • bytter sok-xxxx med kurskoden alle steder
      • bytter ut ‘https://uit-sok-xxxx-<semester><år>.github.io/’ med lenken til kursets githubside. Vær obs på at github automatisk legger til kode når du limer inn lenken slik at den kan bli seende ut som [https://uit-sok-1006-v23.github.io/](https://uit-sok-1006-v23.github.io/)'. Du skal imidlertid kun lime inn selve adressen på formen https://uit-sok-1006-v23.github.io/. Husk anførselstegn.
      • bytter ut de to stedene det står <Navn på kurs> med navn på kurset
      • Bytt ut X i semesterX med semesteret som kurset skal gå
  4. Når du lagrer (commit) vil du få opp spørsmål om å lage en “pull request”, om du ikke har skriverettigheter. Trykk på knappen og be kollega med skriverettigheter om å akseptere din “pull request”

6. Bygg kurset inn i hjemmesiden på canvas

Slik bygger du kursets hjemmeside inn i Canvas:

  1. Gå til Canvas og velg kurset som du er ansvarlig for

    image

  2. Klikk “Rediger”-knappen oppe til høyre, og klikk så “< >” symbolet (rediger html) nede til høyre

    image

  3. Slett alt html-innhold og lim inn


    <p><iframe style="overflow: hidden;"
    src="bytt ut med lenken til din kursside"
    width="1500" height="3000"></iframe></p>



    image

  4. Slett bytt ut med lenken til din kursside og lim istedet inn lenken til kurssiden

DU ER I MÅL!!!!