Modif URL gitea: git.scodoc.org

This commit is contained in:
Emmanuel Viennet 2024-05-27 12:58:01 +02:00
parent 833a35a037
commit f9caeb90f3
11 changed files with 46 additions and 39 deletions

View File

@ -33,7 +33,7 @@ permet d'indiquer le semestre et l'étudiant à regarder.
Vous trouverez les sources du projet, les tickets (*issues*) et autres outils sur Vous trouverez les sources du projet, les tickets (*issues*) et autres outils sur
* [gitea](https://scodoc.org/git/) * [gitea](https://git.scodoc.org)
Vous pouvez demander un compte sur cette plate-forme pour ajouter des tickets, Vous pouvez demander un compte sur cette plate-forme pour ajouter des tickets,
proposer votre code (*pull requests*). proposer votre code (*pull requests*).

View File

@ -7,7 +7,7 @@ collègues, ou en développant ou testant le logiciel.
Les canaux de communication entre développeurs sont Les canaux de communication entre développeurs sont
[indiqués sur cette page](Contact.md). Vous pouvez demander un compte sur le [git du [indiqués sur cette page](Contact.md). Vous pouvez demander un compte sur le [git du
projet](https://scodoc.org/git), consulter/ajouter des tickets, proposer votre projet](https://git.scodoc.org), consulter/ajouter des tickets, proposer votre
code (*pull requests*). code (*pull requests*).
## Contribuer à la documentation ## Contribuer à la documentation
@ -21,11 +21,11 @@ La documentation est constituée de deux parties:
- Les pages Web comme celle que vous lisez actuellement. La documentation est - Les pages Web comme celle que vous lisez actuellement. La documentation est
générée via `MkDocs`, un système très simple basé sur le format générée via `MkDocs`, un système très simple basé sur le format
[Markdown](https://www.markdownguide.org/basic-syntax/). Toutes les sources [Markdown](https://www.markdownguide.org/basic-syntax/). Toutes les sources
sont sur le [dépôt git DocScoDoc](https://scodoc.org/git/viennet/DocScoDoc). sont sur le [dépôt git DocScoDoc](https://git.scodoc.org/viennet/DocScoDoc).
## Contribuer au logiciel ## Contribuer au logiciel
Le [dépôt principal](https://scodoc.org/git/viennet/ScoDoc) comporte plusieurs Le [dépôt principal](https://git.scodoc.org/viennet/ScoDoc) comporte plusieurs
branches. Voir le [guide pour les développeurs](GuideDeveloppeurs.md). branches. Voir le [guide pour les développeurs](GuideDeveloppeurs.md).

View File

@ -1,6 +1,6 @@
# Utilisation de git pour ScoDoc # Utilisation de git pour ScoDoc
Le dépôt est <https://scodoc.org/git/viennet/ScoDoc> Le dépôt est <https://git.scodoc.org/viennet/ScoDoc>
La branche `master` est celle de ScoDoc 9, d'où sont issues les paquets La branche `master` est celle de ScoDoc 9, d'où sont issues les paquets
distribués (*releases*). Les développements ont lieu sur d'autres branches distribués (*releases*). Les développements ont lieu sur d'autres branches
@ -48,7 +48,7 @@ mises à jour de `master` (remote), faire:
Vous travaillez sur un clone du dépôt principal ("origin"), obtenu par exemple via Vous travaillez sur un clone du dépôt principal ("origin"), obtenu par exemple via
```bash ```bash
git clone https://scodoc.org/git/ScoDoc/ScoDoc.git git clone https://git.scodoc.org/ScoDoc/ScoDoc.git
``` ```
remplacer par l'URL de votre dépôt sur gitea au besoin. Si vous avez votre remplacer par l'URL de votre dépôt sur gitea au besoin. Si vous avez votre
@ -57,12 +57,12 @@ nommé `mon_origin`), l'autre pour le dépôt principal ScoDoc (ici nommé
`origin`). `origin`).
```bash ```bash
git remote add origin https://scodoc.org/git/viennet/ScoDoc.git git remote add origin https://git.scodoc.org/viennet/ScoDoc.git
git remote -v git remote -v
mon_origin https://xxx.xxx (fetch) mon_origin https://xxx.xxx (fetch)
mon_origin https://xxx.xxx (push) mon_origin https://xxx.xxx (push)
origin https://scodoc.org/git/viennet/ScoDoc.git (fetch) origin https://git.scodoc.org/viennet/ScoDoc.git (fetch)
origin https://scodoc.org/git/viennet/ScoDoc.git (push) origin https://git.scodoc.org/viennet/ScoDoc.git (push)
``` ```
Ensuite, tout est prêt, vous créez votre branche: Ensuite, tout est prêt, vous créez votre branche:
@ -154,14 +154,14 @@ la mise en place, le suivi et la livraison.
#### L'installation #### L'installation
Il est pratique d'avoir en ligne les deux dépôts git distants que vous pouvez Il est pratique d'avoir en ligne les deux dépôts git distants que vous pouvez
utiliser : votre dépôt personnel (`https://scodoc.org/git/<user>/<dépôt>.git`) et utiliser : votre dépôt personnel (`https://git.scodoc.org/<user>/<dépôt>.git`) et
le dépôt officiel (`https://scodoc.org/git/ScoDoc/ScoDoc.git`). le dépôt officiel (`https://git.scodoc.org/ScoDoc/ScoDoc.git`).
pour ajouter une référence (et lui donner un nom) vers un dépôt distant, entrez pour ajouter une référence (et lui donner un nom) vers un dépôt distant, entrez
la commande: la commande:
```bash ```bash
git remote add nom_remote https://scodoc.org/git/ScoDoc/<dépôt>.git git remote add nom_remote https://git.scodoc.org/ScoDoc/<dépôt>.git
``` ```
Par la suite vous aurez donc une référence vers votre dépôt personnel (`perso`) Par la suite vous aurez donc une référence vers votre dépôt personnel (`perso`)
@ -384,7 +384,7 @@ soit refusé (car le rebase a modifié des commits qui avaient déjà été pous
Dans ce cas l'option `--force` du push vous permette de passer outre, mais Dans ce cas l'option `--force` du push vous permette de passer outre, mais
assurez-vous avant d'être le seul à travailler sur cette branche. assurez-vous avant d'être le seul à travailler sur cette branche.
#### Etape 5 : La dernière étape se passe sur le site [scodoc.org/git](https://scodoc.org/git/) #### Etape 5 : La dernière étape se passe sur le site [git.scodoc.org](https://git.scodoc.org/)
- Identifiez-vous - Identifiez-vous

View File

@ -132,7 +132,7 @@ http GET http://localhost:5000/ScoDoc/api/formsemestres/query "Authorization:Bea
### Côté programmation serveur ### Côté programmation serveur
Reprenons le même exemple (voir `app/api/formsemestres.py`` ligne 91, Reprenons le même exemple (voir `app/api/formsemestres.py`` ligne 91,
<https://scodoc.org/git/ScoDoc/ScoDoc/src/branch/master/app/api/formsemestres.py#L91>): <https://git.scodoc.org/ScoDoc/ScoDoc/src/branch/master/app/api/formsemestres.py#L91>):
```py ```py
@bp.route("/formsemestres/query") @bp.route("/formsemestres/query")

View File

@ -19,7 +19,9 @@ qui peuvent être négatives).
compte dans les moyennes même si l'évaluation n'est pas affichée. compte dans les moyennes même si l'évaluation n'est pas affichée.
- **Prise en compte immédiate**: si coché, les notes saisies dans l'évaluation - **Prise en compte immédiate**: si coché, les notes saisies dans l'évaluation
seront prises en compte dans le calcul des moyennes avant même que les notes seront prises en compte dans le calcul des moyennes avant même que les notes
de tous les étudiants ne soit saisies. de tous les étudiants ne soit saisies. Ne pas utiliser pour les évaluations de
rattrapage ou de deuxième session (qui sont prises en compte quand elles
existent).
### Pourquoi éviter d'utiliser "prise en compte immédiate" ? ### Pourquoi éviter d'utiliser "prise en compte immédiate" ?
@ -61,12 +63,13 @@ l'évaluation est dite *en attente*. Elle est prise en compte.
## Modalité d'une évaluation ## Modalité d'une évaluation
- **Normale**: produit une note utilisée dans le calcul des moyennes du module. - **Normale**: produit une note utilisée dans le calcul des moyennes du module.
- **Rattrapage**: la note d'une évaluation de "rattrapage" remplacera la moyenne
du module de l'étudiant *si et seulement si elle est meilleures que celles
calculées*.
- **Deuxième session**: la note remplace, lorsqu'elle est saisie, la moyenne de - **Deuxième session**: la note remplace, lorsqu'elle est saisie, la moyenne de
l'étudiant à ce module, même si sa note de deuxième session est plus faible l'étudiant à ce module, même si sa note de deuxième session est plus faible
que sa moyenne normale. que sa moyenne normale.
- **Rattrapage**: la note d'une évaluation de "rattrapage" remplacera la moyenne
du module de l'étudiant *si et seulement si elle est meilleure que celles
calculées*. S'il y a des évaluations de deuxième session, celles de
rattrapage sont ignorées.
- **Bonus**: la valeur est ajoutée à la moyenne du module, voir détail ci-dessous. - **Bonus**: la valeur est ajoutée à la moyenne du module, voir détail ci-dessous.
### Évaluations de "bonus" ### Évaluations de "bonus"
@ -75,10 +78,13 @@ Les évaluations bonus sont particulières:
- la valeur est ajoutée à la moyenne du module; - la valeur est ajoutée à la moyenne du module;
- le bonus peut être négatif (malus); - le bonus peut être négatif (malus);
- le bonus ne s'applique pas aux notes de rattrapage et deuxième session; - le bonus s'applique après utilisation des notes de rattrapage ou de deuxième session;
- le coefficient est ignoré, mais en BUT le bonus vers une UE est multiplié par le poids correspondant (par défaut égal à 1); - le coefficient est ignoré, mais en BUT le bonus vers une UE est multiplié par le poids correspondant (par défaut égal à 1);
- les notes de bonus sont prises en compte même si incomplètes. - les notes de bonus sont prises en compte même si incomplètes.
Note 1: la conformité des évaluations au programme (coefficients vers les UEs) ne
prend pas en compte les évaluations bonus.
## Bloquage et date de prise en compte ## Bloquage et date de prise en compte
Ceci permet d'empêcher la prise en compte (et éventuellement la publication) de Ceci permet d'empêcher la prise en compte (et éventuellement la publication) de

View File

@ -6,7 +6,7 @@
ScoDoc a été conçu et développé par Emmanuel Viennet, puis complété par ScoDoc a été conçu et développé par Emmanuel Viennet, puis complété par
plusieurs contributeurs, enseignants ou BIATSS dans les IUT et universités. Son plusieurs contributeurs, enseignants ou BIATSS dans les IUT et universités. Son
développement est toujours actif, voir le dépôt git <https://scodoc.org/git>. développement est toujours actif, voir la plateforme gitea <https://git.scodoc.org>.
En 2020, une association a été créée pour soutenir et pérenniser le projet: par En 2020, une association a été créée pour soutenir et pérenniser le projet: par
exemple pour acquérir services et équipements pour le développement exemple pour acquérir services et équipements pour le développement

View File

@ -4,7 +4,7 @@ Informations pour les développeurs souhaitant étendre ou modifier ScoDoc.
Pour le développement de logiciels externes, [utiliser l'API](ScoDoc9API.md). Pour le développement de logiciels externes, [utiliser l'API](ScoDoc9API.md).
Accès à la [plate-forme Gitea](https://scodoc.org/git). Accès à la [plate-forme Gitea](https://git.scodoc.org).
## Informations générales ## Informations générales
@ -146,7 +146,7 @@ Note: la mise à jour par `apt` recrée le virtualenv à chaque fois.
## Roadmap ## Roadmap
* [voir les tickets](https://scodoc.org/git/viennet/ScoDoc/issues) * [voir les tickets](https://git.scodoc.org/viennet/ScoDoc/issues)
!!! note "Voir aussi" !!! note "Voir aussi"

View File

@ -1,5 +1,8 @@
# Utilisation de ScoDoc # Utilisation de ScoDoc
Les [principaux objets de ScoDoc](IntroObjetsScoDoc.md) sont présentés sur
[cette page](IntroObjetsScoDoc.md).
ScoDoc contrôle les opérations via un mécanisme de permissions facile à mettre ScoDoc contrôle les opérations via un mécanisme de permissions facile à mettre
en œuvre et permettant de bien répartir les rôles entre les utilisateurs: en œuvre et permettant de bien répartir les rôles entre les utilisateurs:
responsables, enseignants, secrétariats. responsables, enseignants, secrétariats.

View File

@ -25,7 +25,7 @@ une action de formation continue d'une semaine que d'une formation sur un an.
Saisie des dates de début et fin d'un semestre: Saisie des dates de début et fin d'un semestre:
![sco-dates-semestre.png](screens/sco-dates-semestre.png) ![sco-dates-semestre.png](screens/sco-dates-semestre.png)
Les semestre a un ou plusieurs (co)responsables, utilisateurs ayant des droits Chaque semestre a un ou plusieurs (co)responsables, utilisateurs ayant des droits
particuliers, dont ceux de modifier la liste des modules d'enseignement à particuliers, dont ceux de modifier la liste des modules d'enseignement à
suivre, de nommer les enseignants, etc. Les responsables de semestres sont suivre, de nommer les enseignants, etc. Les responsables de semestres sont
souvent appelés *directeurs ou directrices des études*. souvent appelés *directeurs ou directrices des études*.
@ -103,7 +103,7 @@ Exemple: extrait de la fiche d'un étudiant
Les étudiants d'un semestre peuvent être répartis dans des groupes. Les étudiants d'un semestre peuvent être répartis dans des groupes.
Chaque *partition* d'un semestre défini un ensemble de groupes: par exemple, les Chaque *partition* d'un semestre défini un ensemble de groupes: par exemple,
la partition des groupes de TD, ou la partition des projets tuteurés. la partition des groupes de TD, ou la partition des projets tuteurés.
On peut à tout moment créer une partition, y créer des groupes, y placer ou On peut à tout moment créer une partition, y créer des groupes, y placer ou

View File

@ -1546,16 +1546,14 @@ mais pas JSON compliant à cause des `NaN`.
* **Permission: `ScoView`** * **Permission: `ScoView`**
* **Paramètres:** `formsemestre_id` * **Paramètres:** `formsemestre_id`
* **Query string**: `format` * **Query string**: `format`
* **Route:** `/formsemestres/resultats` * **Route:** `/formsemestre/<int:formsemestre_id>/resultats`
* **Exemple d'utilisation:** `/api/formsemestre/1/resultats` * **Exemple d'utilisation:** `/api/formsemestre/1/resultats`
* **Résultat:** [formsemestre-resultats.json](samples/sample_formsemestre-resultats.json.md) * **Résultat:** Récapitulatif par étudiant (état, groupe(s), moyennes d'UEs et de modules)
Récapitulatif par étudiant (état, groupe(s), moyennes d'UEs et de modules)
pour un formsemestre spécifié par son id. pour un formsemestre spécifié par son id.
Par défaut les valeurs numériques sont formatées en chaînes. Si format=raw, Par défaut les valeurs numériques sont formatées en chaînes. Si format=raw,
valeurs numériques mais pas JSON compliant à cause des `NaN`. valeurs numériques mais pas JSON compliant à cause des `NaN`.
* **Exemple de résultat:** * **Exemple de résultat:** [formsemestre-resultats.json](samples/sample_formsemestre-resultats.json.md)
#### **`moduleimpl-evaluations`** #### **`moduleimpl-evaluations`**

View File

@ -62,7 +62,7 @@ nav:
- "Utilisateurs": UtilisateursScoDoc.md - "Utilisateurs": UtilisateursScoDoc.md
- Développement: - Développement:
- "Guide Développeurs": GuideDeveloppeurs.md - "Guide Développeurs": GuideDeveloppeurs.md
- "Gitea": https://scodoc.org/git - "Gitea": https://git.scodoc.org
- "API": ScoDoc9API.md - "API": ScoDoc9API.md
- "Introduction": DevInternals.md - "Introduction": DevInternals.md
- "Utiliser Git": DevGit.md - "Utiliser Git": DevGit.md