# Serveur de portfolio de [coh@bit](https://cohabit.fr)

Sert les portfofolio (site static) depuis la branche `main` de
`https://git.cohabit.fr/[user]/.portfolio/`.

> [!NOTE]
>
> La racine par default est `'/dist'` et la page par default `/dist/index.html`
> (mode power user).
>
> Si `/dist/index.html` n'existe pas la racine devient `'/'` et la page par
> defaut `/README.md` (mode
> [WYSIWYG](https://fr.wikipedia.org/wiki/What_you_see_is_what_you_get) user).

Une rediection html peut être utilisée pour "changer la racine" ou rediriger
vers un site externe.

```html
<meta http-equiv="refresh" content="0;URL=${destination}" />
```

> [!IMPORTANT]
>
> Chaque utilisateur (cohabit) se voit attribuer le sous domaine
> `https://[user_subdomain].portfolio.cohabit.fr`.
>
> Chaque portfolio et donc isolé et ne (peut) partager aucune information
> (cookie, scripts, xss, ...) avec les autres portfolios et domaines de
> [cohabit](https://cohabit.fr).

Formats :

- `user` : `${firstname}.${lastname}`
- `user_subdomain` : `${firstname}-${lastname}`

## Usage

1. Cloner le repo.
1. Lancer le serveur.
   - Executer `deno task start` //Serveur sur le port 8000 par default.
   - Ou, executer `PORT=7000 deno task start` //Spécifier le port d'écoute
     désiré.
   - Ou, utiliser le service définit dans
     `cohabit/server_config/portfolio_server`.

## Contribution

1. Install [deno](https://deno.land).
1. Follow
   [deno convention](https://docs.deno.com/runtime/manual/references/contributing/style_guide).
1. Follow
   [conventional commits](https://www.conventionalcommits.org/en/v1.0.0/).
1. Follow [sermver](https://semver.org/lang/fr/).
1. Run and check `deno task check` before any commit.