README.md 1.55 KB
Newer Older
mrodzis's avatar
mrodzis committed
1
# Ahiqar Frontend
Mathias Goebel's avatar
Mathias Goebel committed
2

mrodzis's avatar
mrodzis committed
3
This repository is a project specific customization of TIDO.
Michelle Weidling's avatar
Michelle Weidling committed
4
TIDO is integrated as git submodule.
5

mrodzis's avatar
mrodzis committed
6
7
The viewer can be reached at <https://ahikar.sub.uni.goettingen.de>.

mrodzis's avatar
mrodzis committed
8
It is integrated during the build of the backend, cf. <https://gitlab.gwdg.de/subugoe/ahiqar/backend#get-the-frontend>.
Mathias Goebel's avatar
Mathias Goebel committed
9

mrodzis's avatar
mrodzis committed
10
11
12
13
## Project Configuration

The project specific configuration of the viewer is done in `index.html`. This file replaces TIDO's default settings in `index.template.html`. The replacement is done in the CI.

Mathias Goebel's avatar
Mathias Goebel committed
14
## Text Styling
mrodzis's avatar
mrodzis committed
15

mrodzis's avatar
mrodzis committed
16
17
18
19
To add a specific styling of the text in accordance with the project's requirements a
specific stylesheet, `ahikar.css`, is available.
The file is going to be included in the build of the QViewer application.
For local development copy the two files like shown below.
mrodzis's avatar
mrodzis committed
20
21

```bash
Mathias Goebel's avatar
Mathias Goebel committed
22
cp --force index.html Qviewer/src/index.template.html
Mathias Goebel's avatar
Mathias Goebel committed
23
cp --force ahikar.css Qviewer/src/statics/support.css
Mathias Goebel's avatar
Mathias Goebel committed
24
25
```

mrodzis's avatar
mrodzis committed
26
You do not have to track the copied files in the version control system.
Mathias Goebel's avatar
Mathias Goebel committed
27
28
29

## Auto-update

mrodzis's avatar
mrodzis committed
30
31
### Upstream

mrodzis's avatar
mrodzis committed
32
The submodule Qviewer (= TIDO) will receive updates from its upstream project automatically.
mrodzis's avatar
mrodzis committed
33
34
The pipeline will be triggered by the upstream and passes the necessary upstream commit SHA.
For convinence we MAY add a manual job trigger in the upstream repository.
mrodzis's avatar
mrodzis committed
35
36
37
38
39
40
41
The upstream currently is: [subugoe/emo/Qviewer](https://gitlab.gwdg.de/subugoe/emo/Qviewer).

### Downstream

Each time a commit is done on `develop`, this repository's CI triggers a new pipeline on
the back end repository's `develop` branch so that the changes in the viewer are visible
shortly after.