76 lines
2.4 KiB
Markdown
76 lines
2.4 KiB
Markdown
|
Hackmeeting 2025
|
||
|
|
==================
|
||
|
|
|
||
|
|
Sources for Italian Hackmeeting 0x1C (2025) website.
|
||
|
|
|
||
|
|
Il sito viene gestito - in massima parte - dalla commissione comunicazione di hackmeeting. Se vuoi metterti in
|
||
|
|
contatto con loro, scrivi nella [mailing list](https://hackmeeting.org/hackit24/contact.html) per coordinarti
|
||
|
|
con loro. Se vuoi provare lo stesso a metterci le mani, fai pure... noi ti abbiamo avvertito!
|
||
|
|
|
||
|
|
Schema di massima
|
||
|
|
--------------------
|
||
|
|
|
||
|
|
Questo repository git viene automaticamente "sincronizzato" (continous deployment) e il risultato va a finire
|
||
|
|
su https://hackmeeting.org/hackit25/
|
||
|
|
|
||
|
|
Per fare modifiche al sito:
|
||
|
|
|
||
|
|
- fatti un account personale su git.lattuga.net
|
||
|
|
- fai una modifica al sito
|
||
|
|
- apri una pull request
|
||
|
|
- quando la pull request viene approvata, e il tutto finisce in "master", la modifica è online
|
||
|
|
|
||
|
|
|
||
|
|
HowTo
|
||
|
|
-------
|
||
|
|
|
||
|
|
So you want to contribute, nice! You'll need a UNIX (Linux, BSD...) system and some proficiency with the terminal and with
|
||
|
|
[Git-based workflows](https://git-scm.com/book/en/v2).
|
||
|
|
|
||
|
|
### Setup your development environment
|
||
|
|
|
||
|
|
Clona questo repository sul tuo computer
|
||
|
|
|
||
|
|
Installa mkvirtualenv (`apt install virtualenvwrapper`, su sistemi Debian-based)
|
||
|
|
|
||
|
|
```
|
||
|
|
mkvirtualenv -p `which python3` hackmeeting-website
|
||
|
|
pip install -r requirements.txt
|
||
|
|
make all serve
|
||
|
|
firefox http://localhost:8000/
|
||
|
|
```
|
||
|
|
|
||
|
|
Also, `make help` is your friend.
|
||
|
|
|
||
|
|
For debug, `make DEBUG=1`
|
||
|
|
|
||
|
|
### Change content
|
||
|
|
|
||
|
|
Most content is in `content/pages/`. Just go there, find the relevant file, change it.
|
||
|
|
|
||
|
|
Now, `make all serve`, see the result in your browser
|
||
|
|
|
||
|
|
repeat until you like it
|
||
|
|
|
||
|
|
### Commit and push
|
||
|
|
|
||
|
|
usual git workflow
|
||
|
|
|
||
|
|
Griglia dei seminari
|
||
|
|
----------------------
|
||
|
|
|
||
|
|
I talk compaiono in questo repository come cartelle all'interno della cartella `talks/`. Tuttavia, la cosa
|
||
|
|
corretta da fare **NON** è modificare i contenuti direttamente lì, ma modificare un calendario nextcloud da cui
|
||
|
|
queste informazioni provengono.
|
||
|
|
Infatti il calendario viene gestito dalla commissione griglia: [coordinati con
|
||
|
|
loro](https://hackmeeting.org/hackit24/contact.html) se vuoi toccare questa parte del sito.
|
||
|
|
|
||
|
|
Altre modifiche al sito
|
||
|
|
-------------------------
|
||
|
|
|
||
|
|
Il sito è un'istanza di [pelican](https://docs.getpelican.com/en/latest/), più alcuni plugin custom:
|
||
|
|
- `langmenu`, per avere un menu che punta alle versioni localizzate della pagina
|
||
|
|
- `talks`, per gestire i talk in modo "speciale" per hackmeeting
|
||
|
|
|
||
|
|
Puoi quindi riferirti alla documentazione di pelican per fare delle prove e capire come modificare il sito.
|