You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+18Lines changed: 18 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -8,6 +8,24 @@ The MANGO model proposes a flexible way to expose data related to astronomical s
8
8
- Parameters are modeled by the IVOA MCT DM reusing both native and extended classes. Parameters' roles are given by UCDs and semantic tags.
9
9
- Associated data can be simple URLs, VO service endpoints or VO data model instances. Their roles are also qualified by semantic tags.
10
10
11
+
# Document Building
12
+
13
+
The process of creating the document is a bit complex due to the following facts:
14
+
15
+
- The model is maintained with Modelio which does not support any version control.
16
+
- It is designed in a way to make sure that the diagrams keep in sync with the UML.
17
+
- As the text Modelio edition is quite painful, it has been decided to store the description
18
+
of all model elements in individual files (`vodml/desc`).
19
+
- The VODML (without description) is generated by an XSLT
20
+
- The transformation of the VODML into Latex is done by another XSLT
21
+
- The items of the generated Latex are ordered following the VODML elements order,
22
+
this must be corrected to have a consistent table of content
23
+
24
+
This process is achieved by scripts located in `utils`. Please read `utils/README.rst`.
25
+
26
+
If you want to contribute, please have a look at this workflow or ask the editor.
27
+
This will prevent your work to be overridden by some script.
28
+
11
29
# PDF preview
12
30
13
31
The PDF preview can be seen [here](https://github.com/ivoa-std/MANGO/releases/download/auto-pdf-preview/MANGO-draft.pdf) thanks to the ADQL team who has written a workflow generating it automatically.
0 commit comments