Skip to main content

Bæta við viðfangsefni

Svona bætist nýtt textílverkefni við vefinn

Vefurinn er gerður fyrir mörg textílverkefni. Prjónavélin, Sjónabók og mynsturgerðin eru fyrstu viðfangsefnin. Nýtt viðfangsefni, hvort sem það er önnur vél, vefnaður eða útsaumur, fylgir sama sniði.

Reglurnar

  1. Ekkert er fundið upp. Allt efni kemur úr skýrslu, kóða eða annarri heimild sem hægt er að vísa í.
  2. „Unnið af“ á hverri síðu. Neðst er kassi með nafni nemandans sem vann verkið og úr hvaða kafla eða geymslu efnið er. Heimildir eru í texta og í heimildaskrá.
  3. Opnar geymslur. Vísað er skýrt í kóðann og sagt hvernig á að nota hann.
  4. Einfalt mál. Skrifað fyrir almenning: stuttar setningar, skref fyrir skref.
  5. Sjálfstætt en tengt. Hvert viðfangsefni stendur eitt og sér, með hlekkjum í tengd viðfangsefni.

Skrefin

  1. Tengdu heimildina. Ef verkefnið á skýrslu í eigin geymslu, bættu henni við sem submodule með https slóð:

    git submodule add https://github.com/HiDefTextiles/<geymsla>.git
  2. Veldu myndir og þjappaðu þeim. Bættu myndunum við scripts/sync-assets.sh. Aðeins skrár sem eru taldar upp þar fara á vefinn, og skriftan breytir þeim í WebP, mest 1200 punkta á lengri hliðina.

    Allar myndir á vefnum eru þjappaðar í WebP áður en þær fara í geymsluna. Myndir sem eru settar beint í img/ þjappar þú með

    make images FILES="img/vefnadur/mynd.jpg"

    sem setur mynd.webp í stað frumritsins (mest 1200 punktar, gæði 78). Fyrir skjámyndir, rafrásir og mynsturreiti, þar sem hver punktur skiptir máli, notar þú LOSSLESS=1 sh scripts/compress-images.sh <skrá>. Myndir á síðunum hlaðast sjálfkrafa þegar lesandinn nálgast þær (loading="lazy").

    Myndir og myndbönd af Instagram má sækja auðveldlega með tólinu instagram-archiver. Þjappaðu myndunum með MAX=1080 sh scripts/compress-images.sh, settu þær í img/instagram/<viðfangsefni>/ og skráðu færslurnar í scripts/instagram.py, sem setur myndasafn með hlekk á hverja færslu neðst á síðuna. Upprunalega safnið þarf ekki að geyma.

  3. Settu myndbönd á YouTube, ekki í geymsluna. Myndbönd eru aldrei vistuð í git. Hladdu þeim upp á YouTube-rásina (tungufoss?) og bættu þeim í spilunarlistann HiDEF textiles. Í lýsingu myndbandsins kemur textinn úr færslunni og hlekkur á upprunalegu færsluna á Instagram. Skráðu svo auðkenni myndbandsins (11 stafirnir á eftir v= eða shorts/ í slóðinni) í YOUTUBE í scripts/instagram.py, til dæmis "C7JRfAQAhQk_01": "abcDEF12345". Skriftan fellir myndbandið inn með iframe frá youtube-nocookie.com með loading="lazy", svo síðan helst létt og engar vafrakökur eru settar fyrr en smellt er á spilun. Myndbönd sem eru ekki á Instagram eru felld inn á sama hátt:

    <iframe src="https://www.youtube-nocookie.com/embed/<auðkenni>" title="<lýsing>"
      loading="lazy" allowfullscreen></iframe>
  4. Búðu til möppu fyrir viðfangsefnið, til dæmis vefnadur/, með index.qmd sem forsíðu: hvað þetta er, kaflarnir sem kort og tengd viðfangsefni. Notaðu prjonavel/index.qmd sem fyrirmynd.

  5. Skrifaðu kaflana eftir sniðmátinu hér að neðan.

  6. Skráðu heimildir í heimildir.bib og vísaðu í þær á hverri síðu.

  7. Bættu viðfangsefninu við valmyndirnar í _quarto.yml (navbar og nýtt sidebar) og korti á forsíðuna.

  8. Skoðaðu vefinn á eigin tölvu og sendu inn breytinguna.

    make preview

Þegar breytingin er komin á main greinina byggir GitHub Actions vefinn og birtir hann á GitHub Pages.

Sniðmát fyrir kafla

---
title: "Heiti kafla"
subtitle: "Ein setning um hvað lesandinn lærir"
---

::: {.hnotskurn}
**Í hnotskurn**

Tvær til þrjár setningar um aðalatriðin.
:::

## Það sem þú þarft

- Tæki, efni og hugbúnaður

## Skref fyrir skref

::: {.skref}
1. **Fyrsta skref.** Hvað á að gera.
2. **Annað skref.** Hvað á að gera.
:::

## Algeng vandamál

| Hvað gerist? | Af hverju? | Hvað hjálpaði? |
|---|---|---|
| | | |

## Kóðinn

Hlekkur á geymslu og skipanir til að keyra.

::: {.hofundur}
Nafn nemandans sem vann verkið. Úr skýrslu verkefnisins [@lykill-i-heimildaskra]; kóði í [geymsla](https://github.com/...).
:::

Hugmyndir og verkáætlun vefsins eru í verkbeiðnum á GitHub.