-
Notifications
You must be signed in to change notification settings - Fork 6
/
Copy pathReadme.html
342 lines (275 loc) · 15 KB
/
Readme.html
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
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta charset="utf-8"/>
</head>
<body>
<img src="https://dedalo.render.es/dedalo/images/logos/dedalo_logo.png" alt="Dédalo logo" />
<p><strong>README</strong></p>
<p><em>Dédalo</em></p>
<p><strong>IMPORTANT: V6 ontology compatibility for V4 and V5</strong>
<em>Starting at 21–05–2020, the ontology in V4 and V5 need to be update with a new column into the “jer_dd” table named “properties”, for compatibility with the upcoming V6, this new column will not affect v4 or V5 normal function but the new exported ontologies files from master will include this column in copy files. If you don’t add this column to jer_dd, Dédalo will can’t import the new files and you will can lost the ontology data, although you can re-build jer_dd making the import process manually.
Read the update V5.6.0</em></p>
<p><strong>ATENTION: New v6_developer branch is added, the v6 is in beta state, the deverloper branch is freeze for new features and only update for bugs or errors</strong></p>
<p>Dédalo is a knowledge management system for Cultural Heritage (tangible and intangible), Natural Heritage and Oral History/Memory.</p>
<p><a href="https://dedalo.dev" target="_blank">Oficial Dédalo webpage</a></p>
<p>Dédalo is a Open Source software based in a new paradigm of programing: develop objects with a ontology model. The ontology control the app flow with the descriptors, related terms, no descriptors, TG, TE, etc. The objects are builded with a MVC structure and are linked to the ontology. The database use a NoSQL model, all data is stored in JSONB (binary).</p>
<p>Dédalo use the structured Ontology for three things:</p>
<pre><code>1. Make the data structured. (user data is stored without fixed structure)
2. Build the programing objects in the execution time (in real time).
3. Interpret the code and the data and translate to multiple formats (RDF, JSON-LD, SQL, CSV, XML, Dublin Core, HTML, PDF, etc)
</code></pre>
<p>The ontology can be changed by the time and this will change the data and the programing code; you can develop new functionalities without change the data, and you can change the metadata without change the code or the data.</p>
<p>Dédalo is based in linked data model, and use a relative, multireference and universal locator. The locator can find:
entity, section, component, and tag. In other words, the locator can find, archives (in others entities), records, fields, and part of the fields (sub-field data).</p>
<p>Dédalo is a real multilingual app (Dédalo can use any language) in the interface and the managed data, has a multi-thesaurus engine and manage multiple resources and resolutions for video, image, pdf, notation scores, etc.</p>
<p>Dédalo has a geo-reference for the cultural properties, interviews, etc. with points, areas, paths, etc and have a indexation and related model of multiple data sources with the thesaurus.</p>
<p>Dédalo can handle and cut video in real time for find thematic parts of interviews or cultural goods (fragments of interviews / cultural goods), for 4k, HD 1080, 720, 404 resolutions.</p>
<p><strong>DEMO</strong></p>
<p>You can see Dédalo in action:</p>
<p><a href="https://dedalo.render.es/" target="_blank">Dédalo demo</a></p>
<p>Some projects using Dédalo to manage their Cultural Heritage or Oral Archive:</p>
<p><strong>Projects: </strong>
<p><a href="http://www.occupation-memories.org/de/archive/index.html" target="_blank">Freie Universität Berlin</a></p>
<p><a href="https://monedaiberica.org" target="_blank">Moneda Ibérica catalog</a></p>
<p><a href="http://museoprehistoriavalencia.org/web_mupreva/?q=en" target="_blank">Museu de Prehistòria de València</a></p>
<p><a href="https://arxiu.memoria.gencat.cat/en/app/#/" target="_blank">Memorial Democràtic</a> (Banco audiovisual de Memoria Colectiva)</p>
<p><a href="https://www.mujerymemoria.org" target="_blank">Mujer y Memoria</a> (Woman and Memory - Mothers and daughters of the Spanish transition. An oral history project)</p>
<p><a href="http://memoriahistorica.paiporta.es" target="_blank">Arxiu de la Memòria Històrica de Paiporta</a> Delegación de Memoria Histórica de la Diputación de Valencia </p>
<p><a href="http://memoriahistorica.dival.es/recursos/archivo-memoria-historica/" target="_blank">Nuestra Memoria. Archivo de historia oral</a></p>
<p><a href="https://exhumacionestempranas.navarra.es" target="_blank"> Lur Azpian, Desobiratze Goiztiarrak Nafarroan| Bajo tierra, Exhumaciones tempranas en Navarra </a> (Underground Early exhumations in Navarra - Instituto Navarro de Memoria)</p>
<p><a href="http://www.museudelaparaula.es" target="_blank">Museu de la Paraula</a> (Archivo de la Memoria Oral Valenciana)</p>
<p><a href="http://www.museudelaparaula.es/colecciones/?lang=es" target="_blank">Collection of funds from MUVAET</a> (Museu Valencià d'Etnologia)</p>
<p><strong>DEPENDENCES</strong></p>
<p><em>Required for the OS</em></p>
<ul>
<li>PHP 7.4+</li>
<li>Apache 2.4.6+</li>
<li>Postgres 10.1+</li>
<li>MySQL 5.6+ (NOT REQUIRED, only if you want use it for publication).</li>
</ul>
<p><em>libs required for the Dédalo</em></p>
<p>Note: If you want install a basic libs dependences pre-builded and tested, you can use the pack in:
/install/library_packs/Dedalo_basic_library_pack_2019.zip
un zip the file and move th libraries to:
/dedalo/lib/</p>
<ul>
<li>Jquery 2.2.3</li>
<li>bootstrap 3.1.1</li>
<li>calendar 1.25</li>
<li>Captionator 0.5.1</li>
<li>FullCalendar v2.3.1</li>
<li>geoip2</li>
<li>jshash md5 v2.2</li>
<li>json-logic</li>
<li>leaflet 1.0</li>
<li>lessphp v0.4.0</li>
<li>nvd3 1.7.1</li>
<li>paper 0.9.25</li>
<li>pdfjs 1.1.1</li>
<li>pdfkit</li>
<li>PdfParser (2014)</li>
<li>tcpdf 6.2.5</li>
<li>tinymce 4.3.10</li>
<li>wexflow 1.2</li>
</ul>
<p>Some libraries like ffmpeg or ImageMagick need to be install directly in the system (Ubuntu, Debian, MacOs X, etc)</p>
<p>SO libraries:</p>
<ul>
<li>Ffmpeg 4.0+</li>
<li>Ffprobe 2.6.1+</li>
<li>qtfaststart 1.0</li>
<li>ImageMagick 6.9+</li>
<li>NodeJS 5.10.1</li>
<li>Xpdf command line tools 4.00.01+</li>
<li>wkhtmltopdf 0.12.1–08b0817</li>
</ul>
<p><strong>INSTALLATION</strong></p>
<p>You can use our ready to use VM for develop:</p>
<p><a href="https://dedalo.dev/v5" target="_blank">Dedalo V5</a></p>
<p>Or follow the install video:</p>
<p><a href="https://dedalo.dev/v5_install" target="_blank">Dedalo V5 install video on CentOS</a></p>
<p>Or do it manually:</p>
<ol>
<li><p>Download Dédalo and copy to the httpdocs of web server</p></li>
<li><p>Create a DB in PostgreSQL and name it to: dedalo_xx (you can change the xx with own name).</p></li>
<li><p>Restore the plain sql file /install/db/dedalo4_install.pgsql (from zip version) to the postgres created DB.</p>
<pre><code>Basic psql command:
psql --dbname=XXX --file "/install/db/dedalo4_install.pgsql"
Example of actual use:
psql --echo-errors --dbname=XXX --file "/install/db/dedalo4_install.pgsql"
</code></pre></li>
<li><p>Download the dependences and libs for Dédalo and install it into the /lib/ folder. In some cases you need see the /lib/dedalo/config/sample.config4.php file in order to change or customize the installation.</p></li>
<li><p>Rename the /lib/dedalo/config/sample.config4.php to /lib/dedalo/config/config4.php.</p></li>
<li><p>Change the file /lib/dedalo/config/sample.config4_db.php with your DB configuration.</p></li>
<li><p>Rename the /lib/dedalo/config/sample.config4_db.php to /lib/dedalo/config/config4_db.php.</p></li>
<li><p>Run Dédalo into the browser.</p></li>
<li><p>Fix your root password (you can change it only once), the default account is: root (this user is a superuser and only for development or debuger the application).</p></li>
<li><p>Create one Administrator user account with all access to the system. This user will be the administrator of the system.</p></li>
<li><p>Logout and login with the Administrator acount.</p></li>
<li><p>Create Users and Projects as you need.
Optional: Import the toponymy that you will need (Dédalo install DB will not provide specific toponymy by default anymore).</p></li>
</ol>
<p><strong>UPDATE</strong></p>
<p><em>Please read the “Updates.md” file for specific notes, procedures, etc, of the versions.</em></p>
<p>Dédalo have three main updates procedures:</p>
<ol>
<li><p>Update the code files (php, js, css, html, etc)</p>
<ul>
<li>Make backup of all files.</li>
<li>Download the new files and change the files in your server</li>
<li>You will need see the new config files and put the changes into your own config files (/lib/dedalo/config4.php and /lib/dedalo/config4_db.php) is not possible change this files automatically because are the configuration files and it has specific pw and paths of the users. If you don’t change the config files, Dédalo will require the new “define” variables and will stop the app.</li>
</ul></li>
<li><p>Update the ontology structure with the sections, components, list, etc</p>
<ul>
<li>Do the first update step</li>
<li>Log-in with any “developer” user.</li>
<li>You will see the menu in “orange” or “red” (in red, if you have the debugger active) and a “grey” sub-menu with a “tool administrator” (or in translation version of the app language) button, press it to go to the “admin utils” page.</li>
<li>Press the “import structure” button, if all go well you will see a “green” alert.</li>
<li>Log-out and log-in with a normal admin user.</li>
</ul></li>
<li><p>Update the data in your instalation</p>
<ul>
<li>Do the first and second update steps</li>
<li>Log-in with any “developer” user.</li>
<li>You will see the menu in “orange” or “red” (in red, if you have the debugger active) and a “grey” sub-menu with a “tool administrator” (or in translation version of the app language) button, press it to go to the “admin utils” page.</li>
<li>If your data version is different that the “code files” version, Dédalo will show that you need update, press the «update» link and wait for notifications.</li>
<li>If all go well you will see a repport with the changes.</li>
<li>Reload the page ‘Administration Tools’. Sometimes, if the update differs in several versions, you will need to update the data to each of the intermediate versions (v4.0.9 pass from v4.0.9 to -> v4.0.10, v4.0.10 to -> v4.0.11, etc) when the data and “code files” are in the same version, Dédalo will show that is consistent and stop the upgrade process.</li>
<li>Log-out and log-in with normal admin user.</li>
<li>Optional: in the inventory pages (OH, PCI, etc) press the “Update Cache” into the list of the sections for update some changes into the components (this task force to update all components with the new model no 1 to 1), and will apply the changes to the data into the databases.</li>
</ul></li>
</ol>
<p><strong>IMPORT TOPONYMY</strong></p>
<ol>
<li><p>first create the toponymy into the Hierarchy menu into Thesaurus:</p>
<ul>
<li>Login in Dédalo</li>
<li>Go to “Thesaurus -> Hierarchy” section</li>
<li>Find the country that you want import</li>
<li>Edit the country</li>
<li>Change the “active” field to “Yes”</li>
<li>Press the “Generate” button</li>
</ul></li>
<li><p>Now the toponymy is ready for import the data in SQL.</p>
<pre><code>- Logout Dédalo
- Go to: /dedalo/install/import/hierarchy
- Select the hierarchies to be imported with the postgreSQL copy comand, similar to:
- psql dedalo4_XXX -U YYY -p 5432 -h localhost -c "\copy matrix_hierarchy(section_id, section_tipo, datos) from es1.copy "
- XXX: the name of your installation
- YYY: the name of your user
</code></pre>
<ul>
<li>You can list all exported tables and change the “es1.copy” to the hierarchies that you want import</li>
<li>When you are import the toponymy data, you will need change the counters of the tables that you were imported.</li>
<li>Login to Dédalo with developer user</li>
<li>Go to the “administation tool” and see the:
<ul>
<li>DEDALO COUNTERS STATE</li>
</ul></li>
<li>You will see the diferences and Dédalo show the SQL command to apply into the postgreSQL, similar to this:
<ul>
<li>UPDATE “matrix_counter” SET dato = 75845 WHERE tipo = ‘es1’;</li>
</ul></li>
<li>This command will change the counters to the new imported values in SQL</li>
<li>Change the profiles to acces users to the new hierarchy.</li>
</ul>
<p>Done! you new hierarchy was imported and ready to use.</p></li>
</ol>
<p><strong>SERVER SYSTEM</strong></p>
<p>Dédalo in the server part is tested into the next Operating Systems:</p>
<ul>
<li>Ubuntu Server 20.04+</li>
<li>Debian 9.0+</li>
<li>MacOsX 11.0+</li>
<li>CentOS, Fedora and RedHat situation. We are stoping Dédalo testing into RedHat/CenOS/Fedora model due CentOS project focus was changed. The main OS will be Ubuntu to test Dédalo. RedHat/CentOS/Fedora will become to the category of “all other linux that we don’t test it”.</li>
</ul>
<p><a href="https://blog.centos.org/2020/12/future-is-centos-stream/?utm_source=rss&utm_medium=rss&utm_campaign=future-is-centos-stream" target="_blank">CentOS blog</a></p>
<p>All other Linux will be compatible but we don’t test it.</p>
<p>Windows: is possible that Dédalo can run, but we NO TESTED.</p>
<p><strong>USE</strong></p>
<p>Dédalo version v4+, is only certificated and proved into the chromium or webkit browsers (Chrome, Safari, Edge (77+), …).
Firefox situation: From the 4.8 version of Dédalo is full compatible with Firefox, and can be used in production, but we need more feedback from the users, please comment your experience.</p>
<table>
<colgroup>
<col />
<col />
<col />
</colgroup>
<thead>
<tr>
<th>Browser </th>
<th> Version </th>
<th> certificated</th>
</tr>
</thead>
<tbody>
<tr>
<td>Chrome </td>
<td> 77+ </td>
<td> YES - recomended</td>
</tr>
<tr>
<td>Chrome </td>
<td> 75 to 77 </td>
<td> Deprecated (Please update as soon as posible)</td>
</tr>
<tr>
<td>Chrome </td>
<td> 0 to 74 </td>
<td> NO</td>
</tr>
<tr>
<td>Safari </td>
<td> 11+ </td>
<td> YES</td>
</tr>
<tr>
<td>Safari </td>
<td> 10 </td>
<td> Deprecated (Please update as soon as posible)</td>
</tr>
<tr>
<td>Safari </td>
<td> 0 to 9 </td>
<td> NO</td>
</tr>
<tr>
<td>Firefox </td>
<td> 60+ </td>
<td> YES</td>
</tr>
<tr>
<td>Firefox </td>
<td> 50 </td>
<td> Deprecated (Please update as soon as posible)</td>
</tr>
<tr>
<td>Firefox </td>
<td> 40–49 </td>
<td> NO</td>
</tr>
<tr>
<td>Firefox </td>
<td> 0–40 </td>
<td> NO</td>
</tr>
<tr>
<td>EDGE </td>
<td> 77+ </td>
<td> YES</td>
</tr>
<tr>
<td>EDGE </td>
<td> All before 2019 (v45) </td>
<td> For us NO, we don’t test it. is possible that Dédalo run fine in the previous versions, Microsoft say that EDGE is ECMA and HTML5 standards compatible.</td>
</tr>
<tr>
<td>IExplorer </td>
<td> All </td>
<td> NO</td>
</tr>
</tbody>
</table>
</body>
</html>