forked from ScoDoc/DocScoDoc
Modif URL gitea: git.scodoc.org
This commit is contained in:
parent
833a35a037
commit
f9caeb90f3
@ -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*).
|
||||||
|
@ -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).
|
||||||
|
|
||||||
|
|
||||||
|
@ -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
|
||||||
|
|
||||||
|
@ -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")
|
||||||
|
@ -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
|
||||||
|
@ -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
|
||||||
|
@ -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"
|
||||||
|
@ -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.
|
||||||
|
@ -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
|
||||||
|
@ -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`**
|
||||||
|
|
||||||
|
@ -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
|
||||||
|
Loading…
Reference in New Issue
Block a user