mirror of
https://codeberg.org/PostERG/xamxam.git
synced 2026-05-06 19:19:19 +02:00
Updated the README
This commit is contained in:
50
README.md
50
README.md
@@ -1,6 +1,6 @@
|
|||||||
# XAMXAM
|
# XAMXAM
|
||||||
|
|
||||||
(Anciennement *[Posterg](https://wiki.erg.be/m/#Posterg)*
|
(Anciennement *[Posterg](https://wiki.erg.be/m/#Posterg))*
|
||||||
|
|
||||||
Répertoire des travaux de fin d'études de l'[ERG](https://erg.be) (École de Recherche Graphique).
|
Répertoire des travaux de fin d'études de l'[ERG](https://erg.be) (École de Recherche Graphique).
|
||||||
|
|
||||||
@@ -12,14 +12,29 @@ Répertoire des travaux de fin d'études de l'[ERG](https://erg.be) (École de R
|
|||||||
|
|
||||||
## Development
|
## Development
|
||||||
|
|
||||||
```bash
|
|
||||||
just setup # first-time: installs dev dependencies
|
|
||||||
just serve # http://localhost:8000 (public) and /admin/
|
|
||||||
just test # run test suite
|
|
||||||
```
|
|
||||||
|
|
||||||
Admin credentials in development are set via `config/admin_credentials.php`
|
### MacOS
|
||||||
(see `config/admin_credentials.example.php`).
|
|
||||||
|
Logiciels:
|
||||||
|
|
||||||
|
- un IDE pour éditer → VSCode
|
||||||
|
- git (ou une interface graphique) pour partager les modifications → git-gui (officiel) ou Github Desktop
|
||||||
|
- un server web avec PHP pour visualiser le project dans le navigateur → MAMP
|
||||||
|
|
||||||
|
|
||||||
|
### Workflow
|
||||||
|
|
||||||
|
0. Faire un changement dans ton IDE
|
||||||
|
1. Démarrer le site via MAMP, en sélectionnant le dossier `public`
|
||||||
|
2. Vérifier que ça marche sur le site en local, depuis ton navigateur
|
||||||
|
3. Une fois qu'un changement spécifique est fait, `commit` les changements sur les fichiers qui sont relatif à ce changement
|
||||||
|
4. Vérifier que vous avez syncroniser avec le `remote` → `pull` + `rebase` ! pas merge
|
||||||
|
5. `push` les changements vers le remote
|
||||||
|
|
||||||
|
|
||||||
|
```bash
|
||||||
|
just serve # http://localhost:8000 (public) and /admin/
|
||||||
|
```
|
||||||
|
|
||||||
## Deployment
|
## Deployment
|
||||||
|
|
||||||
@@ -65,23 +80,4 @@ ssh posterg "sudo bash /tmp/manage-admin-users.sh"
|
|||||||
- Rate limiting on public search (`src/RateLimit.php`)
|
- Rate limiting on public search (`src/RateLimit.php`)
|
||||||
- See `nginx/docs/SECURITY_HEADERS.md` for security headers reference
|
- See `nginx/docs/SECURITY_HEADERS.md` for security headers reference
|
||||||
|
|
||||||
## Mise en place Dev
|
|
||||||
|
|
||||||
|
|
||||||
### MacOS
|
|
||||||
|
|
||||||
Logiciels:
|
|
||||||
|
|
||||||
- un IDE pour éditer → VSCode
|
|
||||||
- git (ou une interface graphique) pour partager les modifications → git-gui (officiel) ou Github Desktop
|
|
||||||
- un server web avec PHP pour visualiser le project dans le navigateur → MAMP
|
|
||||||
|
|
||||||
|
|
||||||
### Workflow
|
|
||||||
|
|
||||||
0. Faire un changement dans ton IDE
|
|
||||||
1. Démarrer le site via MAMP, en sélectionnant le dossier `public`
|
|
||||||
2. Vérifier que ça marche sur le site en local, depuis ton navigateur
|
|
||||||
3. Une fois qu'un changement spécifique est fait, `commit` les changements sur les fichiers qui sont relatif à ce changement
|
|
||||||
4. Vérifier que vous avez syncroniser avec le `remote` → `pull` + `rebase` ! pas merge
|
|
||||||
5. `push` les changements vers le remote
|
|
||||||
|
|||||||
Reference in New Issue
Block a user