-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathcolophon.html
More file actions
149 lines (136 loc) · 9.52 KB
/
Copy pathcolophon.html
File metadata and controls
149 lines (136 loc) · 9.52 KB
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
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Colophon — Venice Summer School in Digital and Public Humanities 2026</title>
<meta name="description" content="How this site was made: author, method and technologies.">
<meta name="theme-color" content="#b01e28">
<meta name="color-scheme" content="light">
<link rel="icon" href="icons/icon-192.png" sizes="192x192">
<link rel="stylesheet" href="assets/style.css">
</head>
<body>
<a class="skip" href="#main">Skip to the content</a>
<div class="topbar"></div>
<header class="sitehead"><div class="wrap">
<a class="brandlock" href="index.html"><img src="assets/logos/site-lockup.png" alt="Venice Centre for Digital and Public Humanities"></a>
<nav class="sitenav" aria-label="Site">
<a href="index.html">Home</a>
<a href="programme.html">Programme</a>
<a href="people.html">People</a>
<a href="journal.html">Journal</a>
<a href="partners.html">Partners</a>
<a class="on" aria-current="page" href="colophon.html">Colophon</a>
<a href="about.html">About</a>
</nav>
</div></header>
<header class="masthead">
<div class="wrap">
<p class="eyebrow kicker"><a href="programme.html">← Back to the programme</a></p>
<h1 class="title">Colophon<em>how this site was made</em></h1>
<div class="title-rule"></div>
</div>
</header>
<main id="main">
<section class="colo wrap">
<p class="colo-lead">This site was developed for the Venice Centre for Digital and Public
Humanities under the responsibility of Emmanuela Carbé, using a static,
version-controlled workflow. AI coding assistants were used for pair programming, code review
and debugging; all programme data, textual content, structural decisions and final
implementation were manually reviewed before publication.</p>
<p>The programme itself — its sessions, speakers and scholarly content — is the work of the
Venice Centre for Digital and Public Humanities and its contributors.</p>
<p>Further details on the AI-assisted development workflow are available in the
<a href="https://github.com/vedph/vessdph2026/blob/main/README.md" target="_blank" rel="noopener">project README</a>.</p>
<h2>Method</h2>
<p>One structured data file holds the programme: from it the site generates the schedule, the
per-session pages, venue information, calendar files, open data and machine-readable
metadata, so they stay consistent with one another. The Journal — short reflections and
photographs contributed during the school — is a separate, live feature. The work was carried
out iteratively and reviewed at each stage.</p>
<h2>Technical structure</h2>
<p>The site is a buildless static website: no framework, no build step, only HTML, CSS and vanilla
JavaScript, hosted on <a href="https://pages.github.com/" target="_blank" rel="noopener">GitHub Pages</a>.
The programme — its schedule, the dedicated per-session pages (<code>session.html?s=…</code>), the
teacher listing and the aggregate figures — is rendered client-side from a canonical object in
<code>data/program.js</code>. The Journal is contributory and is served by a small backend
(described below) rather than from a static file.</p>
<p>Typography uses <a href="https://fonts.google.com/specimen/EB+Garamond" target="_blank" rel="noopener">EB Garamond</a>
and <a href="https://www.ibm.com/plex/" target="_blank" rel="noopener">IBM Plex Mono</a>, self-hosted under
the <a href="https://openfontlicense.org/" target="_blank" rel="noopener">SIL Open Font License</a>.
The visual identity is proper to this project: it does not reproduce the University’s
coordinated image, nor its logo system.</p>
<p>The venue list is available without external requests. Two interactive maps — the venue map on the
programme page and the Journal map — share the same
self-hosted <a href="https://leafletjs.com/" target="_blank" rel="noopener">Leaflet</a> library with
<a href="https://carto.com/basemaps/" target="_blank" rel="noopener">CARTO</a> tiles based on
<a href="https://www.openstreetmap.org/copyright" target="_blank" rel="noopener">OpenStreetMap</a> data,
and each one opens automatically when its page loads. Calendar files are generated in iCalendar format,
both for individual sessions and for the full week. The programme is also available as JSON, embedded as
<a href="https://json-ld.org/" target="_blank" rel="noopener">JSON-LD</a> structured data, and published
as an <a href="https://github.com/GoogleCloudPlatform/knowledge-catalog/tree/main/okf" target="_blank" rel="noopener">Open
Knowledge Format</a> bundle — a directory of cross-linked markdown concepts, in the repository’s
<a href="https://github.com/vedph/vessdph2026/tree/main/okf" target="_blank" rel="noopener"><code>/okf/</code></a> folder.
This bundle is kept up to date automatically: whenever the programme data or session materials change in
the repository, a <a href="https://github.com/vedph/vessdph2026/actions" target="_blank" rel="noopener">GitHub
Action</a> rebuilds it and commits the result back, so the JSON, JSON-LD and OKF formats always match the
site with no manual step.</p>
<p>Two contributory features extend the programme, both handled by a single small serverless function — a
<a href="https://workers.cloudflare.com/" target="_blank" rel="noopener">Cloudflare Worker</a>, the only
server-side component. Teachers add or update their own session content — abstract, links and reading —
through a personal login: the Worker checks the credentials, validates the input, and commits the materials
to the repository through the <a href="https://docs.github.com/rest" target="_blank" rel="noopener">GitHub
REST API</a>, from where they publish like any other change. The
<a href="journal.html">Journal & Field Notes</a> page gathers short reflections, field notes and
photographs contributed during the school, with optional geolocation on a shared map. Journal entries use
the same personal login and are stored in a database (<a href="https://developers.cloudflare.com/d1/" target="_blank" rel="noopener">Cloudflare
D1</a>), so they appear immediately; a photograph is resized and stripped of its metadata in the browser
before upload, with consent confirmed for any recognizable people, and an entry can be removed at any time
by its author or an organiser. Everything else on the site remains static.</p>
<h2>Accessibility and offline use</h2>
<p>The site supports keyboard navigation and reduced-motion preferences, and degrades gracefully:
when a map cannot load, the underlying information stays accessible — the venue list and the Journal
entries remain readable without it. The site can also be installed as
a Progressive Web App and cached for offline reading.</p>
<h2>Credits and licences</h2>
<p>Fonts are used under the <a href="https://openfontlicense.org/" target="_blank" rel="noopener">SIL Open Font License</a>.
Map data © <a href="https://www.openstreetmap.org/copyright" target="_blank" rel="noopener">OpenStreetMap</a>
contributors; tiles © <a href="https://carto.com/" target="_blank" rel="noopener">CARTO</a>.
Mapping library: <a href="https://leafletjs.com/" target="_blank" rel="noopener">Leaflet</a>, BSD-2-Clause.
Institutional and partner marks are reproduced solely to identify the bodies involved in the
school; all rights remain with their respective owners.
Programme content © the school and its contributors.</p>
<h2>Acknowledgements</h2>
<p>The VeDPH warmly thanks everyone whose work behind the scenes made the Summer School
possible: the administrative office of the Department of Humanities (DSU) — in particular
Alessandra Bertazzolo and Alessio Parpagiola; the teaching office — in particular
Francesca Cibin and Laura Principi; the Development and Promotion unit, in particular Piera
Bordignon; the Department of Linguistics and Comparative Cultural Studies (DSLCC) for its
contribution to the School — and in particular Alberto Parolo for the administrative side; and
Daniele Baglioni, Director of the Department of
Humanities. Thanks also to the EUTOPIA DigIn connected community, and to all the keynote
speakers and teachers who generously gave their time to the School. A special thank-you goes
to the VeDPH’s technologist and DH facilitator, Elisa Corrò.</p>
</section>
</main>
<footer class="foot">
<div class="wrap">
<h2>Venice Centre for Digital and Public Humanities</h2>
<p>Organised by the VeDPH at the Department of Humanities, Ca’ Foscari University of Venice,
with the Department of Linguistics and Comparative Cultural Studies.</p>
<p class="foot-link"><a href="partners.html">Partners & funders →</a></p>
<p class="addr">Ca’ Foscari University of Venice · Dorsoduro 3246, 30123 Venice (Italy)<br>
VeDPH · Malcanton Marcorà, Dorsoduro 3484/D · vedph@unive.it</p>
</div>
</footer>
<script src="data/program.js"></script>
<script src="assets/app.js"></script>
<script>
if ('serviceWorker' in navigator &&
(location.protocol === 'https:' || location.hostname === 'localhost' || location.hostname === '127.0.0.1')) {
window.addEventListener('load', function () { navigator.serviceWorker.register('sw.js').catch(function(){}); });
}
</script>
</body>
</html>