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
|
||||
|
||||
* [gitea](https://scodoc.org/git/)
|
||||
* [gitea](https://git.scodoc.org)
|
||||
|
||||
Vous pouvez demander un compte sur cette plate-forme pour ajouter des tickets,
|
||||
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
|
||||
[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*).
|
||||
|
||||
## 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
|
||||
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
|
||||
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
|
||||
|
||||
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).
|
||||
|
||||
|
||||
|
||||
@ -1,6 +1,6 @@
|
||||
# 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
|
||||
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
|
||||
|
||||
```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
|
||||
@ -57,12 +57,12 @@ nommé `mon_origin`), l'autre pour le dépôt principal ScoDoc (ici nommé
|
||||
`origin`).
|
||||
|
||||
```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
|
||||
mon_origin https://xxx.xxx (fetch)
|
||||
mon_origin https://xxx.xxx (push)
|
||||
origin https://scodoc.org/git/viennet/ScoDoc.git (fetch)
|
||||
origin https://scodoc.org/git/viennet/ScoDoc.git (push)
|
||||
origin https://git.scodoc.org/viennet/ScoDoc.git (fetch)
|
||||
origin https://git.scodoc.org/viennet/ScoDoc.git (push)
|
||||
```
|
||||
|
||||
Ensuite, tout est prêt, vous créez votre branche:
|
||||
@ -103,7 +103,7 @@ Lint tous les fichiers modifiés:
|
||||
Affiche les variables non définies dans un fichier:
|
||||
|
||||
```bash
|
||||
pylint --disable=all -e E sco_parcours_dut.py | grep undefined-variable | awk '{print $4;}' | sort | uniq | tr -d \'
|
||||
pylint --disable=all -e E sco_parcours_dut.py | grep undefined-variable | awk '{print $4;}' | sort | uniq | tr -d \'
|
||||
```
|
||||
|
||||
Prépare un sed pour renommer les variables non définies:
|
||||
@ -154,14 +154,14 @@ la mise en place, le suivi et la livraison.
|
||||
#### L'installation
|
||||
|
||||
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
|
||||
le dépôt officiel (`https://scodoc.org/git/ScoDoc/ScoDoc.git`).
|
||||
utiliser : votre dépôt personnel (`https://git.scodoc.org/<user>/<dépôt>.git`) et
|
||||
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
|
||||
la commande:
|
||||
|
||||
```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`)
|
||||
@ -186,7 +186,7 @@ suivantes par `git stash` (avant) et `git stash apply` (après) :
|
||||
|
||||
```bash
|
||||
git reset --hard officiel/master
|
||||
git checkout -b ma_modif
|
||||
git checkout -b ma_modif
|
||||
```
|
||||
|
||||
À partir de là, vous pouvez modifier, tester, développer et commit votre travail.
|
||||
@ -249,7 +249,7 @@ l'équivalent sous *pyCharm*).
|
||||
for fn in $(git diff --name-only officiel/master)
|
||||
do
|
||||
python3 -m black $fn
|
||||
done
|
||||
done
|
||||
```
|
||||
|
||||
Faire une première lecture rapide pour vérifier qu'il ne reste pas de fichiers
|
||||
@ -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
|
||||
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
|
||||
|
||||
|
||||
@ -132,7 +132,7 @@ http GET http://localhost:5000/ScoDoc/api/formsemestres/query "Authorization:Bea
|
||||
### Côté programmation serveur
|
||||
|
||||
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
|
||||
@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.
|
||||
- **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
|
||||
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" ?
|
||||
|
||||
@ -61,12 +63,13 @@ l'évaluation est dite *en attente*. Elle est prise en compte.
|
||||
## Modalité d'une évaluation
|
||||
|
||||
- **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
|
||||
l'étudiant à ce module, même si sa note de deuxième session est plus faible
|
||||
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.
|
||||
|
||||
### Évaluations de "bonus"
|
||||
@ -75,10 +78,13 @@ Les évaluations bonus sont particulières:
|
||||
|
||||
- la valeur est ajoutée à la moyenne du module;
|
||||
- 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);
|
||||
- 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
|
||||
|
||||
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
|
||||
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
|
||||
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).
|
||||
|
||||
Accès à la [plate-forme Gitea](https://scodoc.org/git).
|
||||
Accès à la [plate-forme Gitea](https://git.scodoc.org).
|
||||
|
||||
## Informations générales
|
||||
|
||||
@ -146,7 +146,7 @@ Note: la mise à jour par `apt` recrée le virtualenv à chaque fois.
|
||||
|
||||
## Roadmap
|
||||
|
||||
* [voir les tickets](https://scodoc.org/git/viennet/ScoDoc/issues)
|
||||
* [voir les tickets](https://git.scodoc.org/viennet/ScoDoc/issues)
|
||||
|
||||
|
||||
!!! note "Voir aussi"
|
||||
|
||||
@ -1,5 +1,8 @@
|
||||
# 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
|
||||
en œuvre et permettant de bien répartir les rôles entre les utilisateurs:
|
||||
responsables, enseignants, secrétariats.
|
||||
@ -13,9 +16,9 @@ département.
|
||||
* [Guide pour le responsable de formation](GuideAdminFormation.md)
|
||||
* [Modification d'un programme pédagogique et versions](Formations.md)
|
||||
* [Exemples et partages de programmes pédagogiques entre établissements](ExemplesProgrammesPedagogiques.md)
|
||||
|
||||
|
||||
* [Importation des étudiants](ImportationEtuds.md)
|
||||
|
||||
|
||||
* [Synchronisation des inscrits avec Apogée](SynchroApogee.md)
|
||||
* [Procédure d'inscription des étudiants via Apogée](InscriptionsEtudApogee.md)
|
||||
* [Données sur l'origine des étudiants](DonneesAdmissions.md)
|
||||
@ -30,7 +33,7 @@ département.
|
||||
|
||||
* [Édition des bulletins de notes](BulletinsNotes.md)
|
||||
* [paramétrage des bulletins pdf](ParametrageBulletins.md)
|
||||
|
||||
|
||||
* [Édition des PV de jury](ParametragePV.md)
|
||||
* Comment sont calculées les moyennes : [Calcul des notes](CalculNotes.md)
|
||||
|
||||
|
||||
@ -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:
|
||||
|
||||
|
||||
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 à
|
||||
suivre, de nommer les enseignants, etc. Les responsables de semestres sont
|
||||
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.
|
||||
|
||||
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.
|
||||
|
||||
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`**
|
||||
* **Paramètres:** `formsemestre_id`
|
||||
* **Query string**: `format`
|
||||
* **Route:** `/formsemestres/resultats`
|
||||
* **Route:** `/formsemestre/<int:formsemestre_id>/resultats`
|
||||
* **Exemple d'utilisation:** `/api/formsemestre/1/resultats`
|
||||
* **Résultat:** [formsemestre-resultats.json](samples/sample_formsemestre-resultats.json.md)
|
||||
|
||||
Récapitulatif par étudiant (état, groupe(s), moyennes d'UEs et de modules)
|
||||
* **Résultat:** Récapitulatif par étudiant (état, groupe(s), moyennes d'UEs et de modules)
|
||||
pour un formsemestre spécifié par son id.
|
||||
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`.
|
||||
|
||||
* **Exemple de résultat:**
|
||||
* **Exemple de résultat:** [formsemestre-resultats.json](samples/sample_formsemestre-resultats.json.md)
|
||||
|
||||
#### **`moduleimpl-evaluations`**
|
||||
|
||||
@ -1733,16 +1731,16 @@ Cette API est disponible à partir de ScoDoc 9.6 et remplace les absences.
|
||||
* **Exemple d'utilisation:** `/api/assiduite/1`
|
||||
* **Résultat:** Retourne un objet assiduité ou une erreur si l'id n'est pas connu
|
||||
* **Exemple de résultat:** [assiduite.json](samples/sample_assiduite.json.md)
|
||||
*
|
||||
*
|
||||
#### **assiduite-justificatifs[-long]**
|
||||
|
||||
* **Méthode:** GET
|
||||
* **Permission: `ScoView`**
|
||||
* **Paramètres:** `assiduite_id`
|
||||
* **Routes:**
|
||||
* **Routes:**
|
||||
* `/assiduite/<int:assiduite_id>/justificatifs`
|
||||
* `/assiduite/<int:assiduite_id>/justificatifs/long`
|
||||
* **Exemple d'utilisation:**
|
||||
* **Exemple d'utilisation:**
|
||||
* `/api/assiduite/123/justificatifs`
|
||||
* `/api/assiduite/123/justificatifs/long`
|
||||
* **Résultat:** Retourne une liste de justificatifs. des objets en utilisant la route `long` sinon les justif_id
|
||||
|
||||
@ -62,7 +62,7 @@ nav:
|
||||
- "Utilisateurs": UtilisateursScoDoc.md
|
||||
- Développement:
|
||||
- "Guide Développeurs": GuideDeveloppeurs.md
|
||||
- "Gitea": https://scodoc.org/git
|
||||
- "Gitea": https://git.scodoc.org
|
||||
- "API": ScoDoc9API.md
|
||||
- "Introduction": DevInternals.md
|
||||
- "Utiliser Git": DevGit.md
|
||||
|
||||
Loading…
Reference in New Issue
Block a user