Noul website RMI

Acesta este, în primul rând, un exemplu al temei RMS Theme.

Site-ul este generat static folosind Hugo. El se instalează foarte ușor, este doar un singur fișier executabil. Se folosește la linia de comandă.

Făcătorii acestui site sunt Tudor Roman și Ciprian Ionescu. Faimă și recunoștință eternă pentru ei!

Testing and deploying

Folosește comanda hugo serve -D pentru a testa site-ul în dezvoltarea lui. Flag-ul -D înseamnă că Hugo va lua în considerare și paginile marcate ca draft. Testează apoi cu hugo serve ca să vezi cum va arăta de fapt.

Pentru a genera site-ul, șterge folder-ul public și execută hugo. Doar atât, fără alt parametru.

Pentru a face modificările live, pune conținutul folder-ului public pe server.

Instrucțiuni de operare pentru site

Vine o nouă ediție a RMI / RMM, ce faci?

Modifici fișierul config.toml

Acest fișier ține informații precum titlul site-ului, numărul ediției și perioada în care se desfășoară. În general, trebuie să modifici anul și data.

Modifici pagina principala în content/_index.md

Ca și în cazul fișierului de configurare, aici ar trebui să modifici anul și data.

Resetează paginile

Resetarea unei pagini constă în ștergerea conținutului (nu șterge fișierul!) și înlocuirea lui cu un mesaj ("There are no news currently." ar fi un exemplu pentru pagina de noutăți). După ce ai înlocuit conținutul, setează pagina ca draft.

Fiecare pagină are un antet de forma:

---
title: "News"
date: 2019-10-02T15:00:00+03:00
menu:
  main:
    parent: "root"
    weight: 1
---

Ca să marchezi pagina ca un draft, pui o linie nouă, fără indentare: draft: true:

---
title: "News"
date: 2019-10-02T15:00:00+03:00
menu:
  main:
    parent: "root"
    weight: 1
draft: true
---

Pagini care trebuiesc resetate sunt paginile cu noutăți, poze, programul concursului, regulament, rezultate și subiecte. Paginile de noutăți, poze și programul concursului nu trebuie marcate ca draft totuși.

Schimbă logo-ul

Logo-ul trebuie să fie un fișier .png în static/assets/logo.png. Dacă ai și un roll-up, cum am avut la ediția din 2019, pune-l în static/assets/rollup.png.

Actualizează sponsorii

Logo-urile sponsorilor sunt în static/assets/sponsors. Ele vor fi afișate în ordinea alfabetică a filename-urilor.

Actualizează pagina cu comisiile (csv/*_committee.csv)

Fiecare fișier .csv are 4 coloane, fără antet. Fiecare rând are următoarea formă:

Titulatură,Prenume,Nume,Funcție

Titulatura este de obicei "Prof." sau nimic. Funcția este "PRESIDENT", "VICE PRESIDENT" sau nimic.

Mai este și fișierul cu voluntari, în csv/guides.csv. El are altă structură:

Prenume,Nume,Clasa

Nici fișierul cu voluntari nu are antet.

Actualizează participanții

Participanții sunt în fișierul csv/participants.csv. Acesta este tot un fișier .csv, fără antet, cu 4 coloane. Fiecare rând are următoarea formă:

Echipă,Prenume,Nume,Profesor

Echipele ar trebui să fie în ordine alfabetică. Membrii unei echipe trebuie să fie mereu pe rânduri adiacente, iar profesorii să fie primii. Câmpul "Profesor" are valoarea "DA" dacă este profesor, respectiv "NU" dacă nu este.

Echipa trebuie să fie de forma "Țară", "Țară 1", "Țară - Regiune" sau "Țară - Regiune 1", unde "1" este numărul echipei, dacă sunt mai multe din aceeași țară sau aceeași regiune. În cazul în care o țară are echipă de juniori, aceasta poate fi exprimată ca "Țară - juniors" sau "Țară - Regiuni juniors".

Exemple de nume de echipe: "Israel", "Czech Republic", "Bulgaria - Gabrovo", "Romania - Vianu 1", "Romania - Vianu juniors", "Poland 2", "Romania - juniors".

Țara cât și regiunea trebuie să fie în engleză.

De asemenea, fiecare țară trebuie să aibă un steag în folder-ul themes/rms-theme/static/assets/flags. Filename-ul este de forma tara.svg. Aceste steaguri pot fi găsite aici. Dacă numele țării are mai mult de un cuvânt, fișierul va avea spațiile dintre cuvinte in filename: Czech Republic -> czech republic.svg.

Actualizează paginile cu documente

Acestea sunt: content/organisation/programme.md, content/organisation/rules.md și content/contest/results.md.

Fiecare din aceste fișiere are conținut de forma:

{{< section title="Competition Rules" link="/rules.pdf" >}}
{{< pdf file="/rules.pdf" >}}

Cred că se înțelege ce valori trebuie să modifci pentru fiecare caz. S-ar putea ca aceste linii să fie cuprinse într-un comentariu, de forma:

<!--
{{< section title="Programme" link="/program.pdf" >}}
{{< pdf file="/programme.pdf" >}}
-->

Când vine momentul, scoți liniile cu <!-- și -->, evident.

Fișierele aferente se pun in static/. De exemplu, fișierul din exemplul de mai sus cu calea /programme.pdf trebuie pus in static/programme.pdf.

Pagina cu rezultate s-ar putea să aibă mai multe astfel de documente afișate, pentru diferite tipuri de clasamente.

Actualizează pagina cu concursul online

Acesta ar trebui să fie actualizat cu perioada în care se va ține, link către CMS, și document pdf cu rezultatele la final.

Nu uita să publici draft-urile!

După ce lucrezi la pagini marcate ca draft, nu uita să setezi draft: false ca să apară.

Actualizează noutățile și pozele

Pe măsură ce actualizezi aceste două pagini, nu uita să schimbi și data!