Preskoči na sadržaj

Izradite svoj web u 4 sata! (radionica)

Nastavak i praktična strana predavanja Zašto i kako izraditi web sjedište istraživačke grupe s Mutimira 2023.

Najava radionice

Penkalin web kaže:

Za koga:

  • Doktorande, poslijedoktorande, voditelje grupa ili bilo koga!
  • Za one kojima nije baš do istraživanja sami kako to napraviti, i žele brzo, jednostavno i besplatno rješenje bez potrebe za kasnijim održavanjem
  • Za one koji ne vole kodirati, niti ih zanimaju postavljanje domena i servera

Od koga: doc. dr. sc. Vedran Miletić i Matea Turalija, GASERI, FIDIT/MedRi, Sveučilište u Rijeci

Kada i gdje: Online, u 2 termina po 2h, 24.4. i 8.5.2024.

Najava radionice (nast.)

Penkalin web dalje kaže:

Zašto:

  • Svi projekti vam ne stanu na CV, a web stranice su pravo rješenje za portfolio vaših istraživanja, projekata, publikacija, kodova itd.
  • Vlastite web stranice povećavanju vašu vidljivost kao znanstvenika
  • Znanstvena komunikacija vam je u planu, ali nikad niste sjeli i smislili kako
  • Osobni web ili web grupe povećava šanse za suradnjama
  • Izrada weba može biti jednostavna i brza ako znate prave alate

Ishod učenja

Imati na javnom webu postavljeno vlastito sjedište slično onome kakvo ima Matea Turalija.

Neishodi učenja

  • Kupnja i konfiguracija vlastite domene.
  • Optimizacija sadržaja za tražilice.
  • Dizajn web sjedišta.
  • Suradnički razvoj i verzioniranje.

CMS ili Jamstack?

  • sustav za upravljanje sadržajem (content management systems, CMS)
  • generator statičkog web sjedišta, kolokvijalno Jamstack

Sadržaj radionice

  • 24. 4. 2024.
    • Stvaranje projekta web sjedišta (Python, MkDocs)
    • Pisanje web stranica u Markdownu (Visual Studio Code i proširenja markdownlint, Markdown Theme Kit i Word Count)
  • 8. 5. 2024.
    • Mogućnosti konfiguracija projekta web sjedišta (Material for MkDocs)
    • Postavljanje sjedišta na web (Git, GitHub, GitHub Pages)

Priprema za radionicu

Potrebno je registrirati korisnički račun na GitHubu.

Potrebni softveri

Upute za instalaciju potrebnih softvera

Preduvjeti za instalaciju potrebnih softvera

  1. Instalirajte sve dostupne nadogradnje putem sustava Windows Update. To može potrajati i do nekoliko sati te može biti potrebno jedno ili više ponovnih pokretanja računala. Ovaj korak je nužan zato što softveri koje koristimo zahtijevaju relativno svježe podverzije Windowsa 10 ili 11.
  2. Putem Microsoft Storea instalirajte Windows Terminal (ako već nije instaliran).

Note

Upute u nastavku odnose se na Linux Mint, Ubuntu i Debian GNU/Linux.

U terminalu upišite naredbu:

sudo apt update && sudo apt upgrade

Po potrebi, ponovno pokrenite računalo.

Naredbe za instalaciju potrebnih softvera

Iskoristit ćemo Windows Package Manager, koji pokrećemo naredbom winget u Terminalu, za jednostavnu instalaciju svih potrebnih softvera. Pokrenite Windows Terminal (putem izbornika Start) i upišite redom naredbe u nastavku.

Skup pomoćnih alata Microsoft PowerToys:

winget install --id Microsoft.PowerToys -e

Iskoristit ćemo APT, koji pokrećemo naredbom apt u terminalu, za jednostavnu instalaciju svih potrebnih softvera. U terminalu upišite redom naredbe:

Radno okruženje Visual Studio Code:

winget install --id Microsoft.VisualStudioCode -e

curl -L -o code.deb 'https://code.visualstudio.com/sha/download?build=stable&os=linux-deb-x64'
sudo apt install ./code.deb

Proširenja markdownlint, Markdown Theme Kit i Word Count:

code --install-extension DavidAnson.vscode-markdownlint
code --install-extension ms-vscode.Theme-MarkdownKit
code --install-extension ms-vscode.wordcount

Python:

winget install --id Python.Python.3.12 -e

Nakon ovog koraka zatvorite Terminal pa ga ponovno pokrenite prije nastavka.

sudo apt install python-is-python3 python3-pip

MkDocs i Material for MkDocs:

pip install mkdocs-material

Git:

winget install --id Git.Git -e

sudo apt install git

U slučaju da imate pitanja, obratite se Vedranu Miletiću putem e-maila.

Osnovna literatura

Visual Studio Code i proširenja:

MkDocs i Material for MkDocs:

Sadržaj prvog dijela radionice

  • Stvaranje projekta web sjedišta (Python, MkDocs)
  • Pisanje web stranica u Markdownu (Visual Studio Code i proširenja markdownlint, Markdown Theme Kit i Word Count)

Započinjanje projekta

U (Windows) Terminalu:

mkdocs new mojnoviweb

U Visual Studio (VS) Code: izbornik File pa Open Folder... pa pronađite mapu mojnoviweb i otvorite ju.

U VS Code ugrađenom terminalu:

mkdocs serve

pa Ctrl i klik na http://127.0.0.1:8000/ u izlazu naredbe za otvaranje pregleda weba.

Pisanje Markdowna

Sadržaj drugog dijela radionice

  • Mogućnosti konfiguracija projekta web sjedišta (Material for MkDocs)
  • Postavljanje sjedišta na web (Git, GitHub, GitHub Pages)

Author: Vedran Miletić, Matea Turalija