/
init_mathPbs.py
188 lines (146 loc) · 7.32 KB
/
init_mathPbs.py
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
"""
Ce module code et présente le *manifeste* du dépôt `math-pbs`.
Modifié le 09/03/23 @author: remy
Le manifeste d'un dépôt décrit
- les conventions de nommage des fichiers permettant leur traitement local avant publication et contextualisation,
- les commandes de traitement local,
- les données du serveur de publication spécifique au dépôt,
- les données du serveur de contextualisation spécifique au dépôt.
Ce module définit un dictionnaire nommé `manifeste`.
- `manifeste['nom']` présente le nom du dépôt : 'math-pbs'
- `manifeste['execloc']` présente les paramètre de traitement local
- `manifeste['espace']` présente les paramètres de publication
- `manifeste['context']` présente les paramètres de contextualisation
### Conventions de nommage
L'élément essentiel de ce dépôt est un problème. Un problème particulier est caractérisé par une chaîne de caractère (appelé ici son titre) qui évoque vaguement son thème.
Le nom des fichiers LateX associés à un problème est formé à partir de son titre:
- précédé par `E` pour un énoncé et `C` pour un corrigé (sources LateX),
- précédé par `A` pour le fichier à compiler en pdf du problème corrigé.
Exemple `alglin15` est le titre d'un problème d'algèbre linéaire.
L'énoncé est `Ealglin15.tex`, le corrigé est `Calglin15.tex`.
Le fichier à compiler présentant le problème corrigé est `Aalglin15.tex`.
Énoncés ou corrigés peuvent utiliser des fichiers annexes (figures, codes,..)
dont le nom est obtenu en ajoutant `_numéro` à la fin avant l'extension.
Exemple `p3impko` est le titre d'un problème portant sur le thème
"période 3 implique chaos". Le corrigé comporte une figure `Cp3impko_1.pdf`
formée à partir de la source `Cp3impko_1.asy` écrit en `asymptote` (langage
de création de figure) compilé en pdf. L'énoncé comporte aussi une figure
`Ep3impko_1.pdf` formée à partir de `Ep3impko_1.asy`
Pour le moment, un fichier dont le nom est `Atitre.tex` est édité à la main.
Remarque, dans le dépôt d'exercices, les fichiers analogues sont formés et mis à jour par la maintenance.
### Traitement local
- Avant publication
- Les fichiers `Atitre.tex` sont compilés en pdf et placés dans `pdfdir`.
- Avant contextualisation
- Les énoncés sources sont scannés pour extraire les descriptions (voir contextualisation).
- Les fichiers `*.idx` sont scannés pour extraire les index (voir contextualisation).
Voir les sous modules [`execlocal`](execlocal.html), [`exl_mathPbs`](exl_mathPbs.html) pour la mise en oeuvre des traitements locaux et les résultats passés aux classes de publication et de contextualisation.
### Publication
Les fichiers images `Atitre.pdf` dans `pdfdir` sont téléchargés dans l'espace associé au dépôt.
Voir le sous-module [`espace`](espace.html) pour la mis en oeuvre de la publication.
Ce sous-module ne définit en clair que les paramètres publics du serveur de publication.
Les credentials secrets sont définis dans le fichier local `~/.aws`.
### Contextualisation
#### Noeuds
À chaque problème correspond un unique noeud dans la base en graphe caractérisé par son label et ses propriétés `typeDoc` et `titre`. L'exemple suivant de requête cypher renvoie l'unique noeud associé au problème de titre "prob4".
MATCH (d:Document {typeDoc:"problème", titre:"prob4"}) RETURN d
#### Descriptions
Chaque problème comporte une *description* codée en dur dans la première ligne de la source de son énoncé entre les tags `%<dscrpt>` et `%</dscrpt>`. Le début de `Eprob4.tex` est
%<dscrpt>Lancers de pièces.</dscrpt>
On dispose de deux pièces de monnaie discernables, désignées dans la suite
de l'exercice par \og pièce 1\fg~ et \og pièce 2\fg. On ...
Le noeud renvoyé par la requête précédente est
{
"identity": 7214,
"labels": [
"Document"
],
"properties": {
"date": "2018-05-06T21:36:11Z",
"titre": "prob4",
"urlSrcEnon": "https://github.com/nicolair/math-pbs/blob/master/Eprob4.tex",
"typeDoc": "problème",
"urlSrcCorr": "https://github.com/nicolair/math-pbs/blob/master/Cprob4.tex",
"description": "Lancers de pièces.",
"url": "https://maquisdoc-math.fra1.digitaloceanspaces.com/maths-pbs/Aprob4.pdf"
},
"elementId": "7214"
}
La description du problème est la propriété `description` de ce noeud.
#### Index
Les index sont définis dans la source LateX par la commande `\index`. Lors de la compilation, un fichier `.idx` est créé qui permet localement d'associer l'index et le problème. Du côté de la base en graphe, un index est un noeud labelisé `Concept`. Une arête labélisée `INDEXE` issue du noeud associé au problème pointe vers le noeud associé à l'index.
Si on considère l'arête dans l'autre sens c'est à dire pointant de l'index vers le problème, un index apparait comme un mot-clé.
Un mot-clé défini par un utilisateur sera défini avec une arète dont la source est le noeud représentant le mot et dont la cible est le noeud représentant le problème. Cette fonctionnalité n'est pas encore implémentée et les labels du noeud représentant le mot et de l'arête ne sont pas fixés.
Voir les sous modules [`graphdb`](graphdb.html), [`bdg_mathPbs`](bdg_mathPbs.html) pour la mise en oeuvre de la contextualisation.
Ce sous-module ne définit en clair que les paramètres publics du serveur de contextualisation.
Les credentials secrets sont définis dans les variables d'environnement `NEO4J_URL` et `NEO4J_PASSWORD`.
### Scénarios de travail admissibles
- suppression d'un problème
- création d'un problème
- modification; texte, description, index
"""
import os
# Nouvelle organisation
execloc = {
'relative_path': '../math-pbs/',
'modulespec': 'exl_mathPbs',
'commandes': [
{'ext': '.tex',
'patterns': ['A*.tex'],
'imgdir': 'pdfdir/',
'imgext': '.pdf',
'command': [
"latexmk",
"-pdf",
"-emulate-aux-dir",
"-auxdir=auxdir",
"-outdir=pdfdir"
]
},
{'ext': '.asy',
'patterns': ['*_fig.asy'],
'imgdir': '',
'imgext':'.pdf',
'command': [
"asy",
"-f",
"pdf"
]
},
{'ext': '.py',
'patterns': ['*_fig.py'],
'imgdir': '', 'imgext': '.pdf',
'command': ["python3"]},
],
'publish_data': {
'patterns': ['pdfdir/A*.pdf'],
},
'context_data': {
'idx_path_pattern': 'auxdir/A*.idx',
'description': {
'path_pattern': 'E*.tex',
'tags': ['%<dscrpt>', '</dscrpt>']
}
}
}
espace = {
'credentials': {
'region_name': 'fra1',
'endpoint_url': 'https://fra1.digitaloceanspaces.com',
'bucket': 'maquisdoc-math',
'prefix': 'maths-pbs/',
},
'uri_esp': 'https://maquisdoc-math.fra1.digitaloceanspaces.com/'
}
context = {
'credentials': {
'URI': os.getenv('NEO4J_URL'),
'user': os.getenv('NEO4J_USERNAME'),
'password': os.getenv('NEO4J_PASSWORD')
},
'modulespec': 'bdg_mathPbs'
}
manifeste = {'nom': 'math-pbs',
'execloc': execloc,
'espace': espace,
'context': context}