This repository has been archived by the owner on Aug 27, 2020. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 0
/
technology.html
268 lines (268 loc) · 19.8 KB
/
technology.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
<!DOCTYPE html>
<!-- This site was created in Webflow. http://www.webflow.com -->
<!-- Last Published: Wed Nov 02 2016 21:48:53 GMT+0000 (UTC) -->
<html data-wf-page="58034e6a5ed475d20faea2aa" data-wf-site="561f5b37cddcd5dc0151e6c7">
<head>
<meta charset="utf-8">
<title>OpenActive Technology</title>
<meta content="OpenActive represents a group of organisations who share a vision for tackling the global problem of physical inactivity." name="description">
<meta content="width=device-width, initial-scale=1" name="viewport">
<meta content="Webflow" name="generator">
<link href="css/normalize.css" rel="stylesheet" type="text/css">
<link href="css/webflow.css" rel="stylesheet" type="text/css">
<link href="css/openactive-demonstrator.webflow.css" rel="stylesheet" type="text/css">
<script src="https://ajax.googleapis.com/ajax/libs/webfont/1.4.7/webfont.js"></script>
<script type="text/javascript">
WebFont.load({
google: {
families: ["Open Sans:300,300italic,400,400italic,600,600italic,700,700italic,800,800italic","Roboto:300,regular,500"]
}
});
</script>
<script src="js/modernizr.js" type="text/javascript"></script>
<link href="images/play-30619_1280.png" rel="shortcut icon" type="image/x-icon">
<link href="images/play-30619_1280.png" rel="apple-touch-icon">
<script type="text/javascript">
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-66225810-1'], ['_trackPageview']);
(function() {
var ga = document.createElement('script');
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();
</script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/marked/0.3.5/marked.min.js" type="text/javascript"></script>
</head>
<body class="white">
<div class="navigation-bar w-nav" data-animation="default" data-collapse="medium" data-contain="1" data-duration="400">
<div class="w-embed w-hidden-tiny">
<a href="https://github.com/openactive/activation">
<img style="position: absolute; top: 0; right: 0; border: 0;" src="https://camo.githubusercontent.com/52760788cde945287fbb584134c4cbc2bc36f904/68747470733a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f77686974655f6666666666662e706e67" alt="Fork me on GitHub" data-canonical-src="https://s3.amazonaws.com/github/ribbons/forkme_right_white_ffffff.png">
</a>
</div>
<div class="w-container"><a class="brand-link w-nav-brand" href="index.html"><h1 class="brand-text">openactive</h1></a>
<nav class="navigation-menu w-nav-menu" role="navigation"><a class="navigation-link w-nav-link" href="index.html">Home</a><a class="navigation-link w-nav-link" href="participate.html">Advocacy</a><a class="navigation-link w-nav-link" href="technology.html">Open My Data</a><a class="navigation-link w-nav-link" href="use-data.html">Use Data</a><a class="navigation-link w-nav-link" href="w3c-community-group.html">W3C</a><a class="navigation-link w-nav-link" href="pioneers.html">Pioneers</a><a class="navigation-link w-nav-link" href="join.html">Join</a>
</nav>
<div class="hamburger-button w-nav-button">
<div class="w-icon-nav-menu"></div>
</div>
</div>
</div>
<div class="hero-image-base open-my-data"></div>
<div class="w-embed">
<style>
.marked table {
border-collapse: separate;
border-spacing: 16px;
text-align: left;
display: block;
overflow-x: auto;
}
.marked th {
white-space: nowrap;
}
.marked li {
font-weight: lighter;
}
</style>
</div>
<div class="section">
<div class="w-container">
<div class="left section-title-group">
<h2 class="centered section-heading">OPEN MY DATA.</h2>
<div class="center section-subheading">READ THROUGH THESE OPTIONS TO FIND THE RIGHT PATH FOR YOU.</div>
<h3>A) YOU HAVE BUILT A BOOKING SYStem</h3>
<p>If you represent a booking system, or are otherwise in control of your own technology, jump straight to the <a href="#the-steps">next section</a>.</p>
<h3>B) YOU USE A BOOKING SYSTEM OR ARE A LEISURE OPERATOR</h3>
<p>To open up your data your booking system needs to be open data compatible. If you do not see the name of your booking system on the <a href="pioneers.html">Pioneers</a> page, it is unlikely to be capable of open data publishing. Help us to let your booking system provider know that this is something their customers are interested in, by <a target="_blank" href="http://goo.gl/forms/D04lFFyAdtiHQMdC2">filling out this form</a>.</p>
<h3>C) YOU CONTRACT TO OTHERS TO PROVIDe ACTIVITIES</h3>
<p>We are working with leisure operators to get their data open. If you do not see the name of your leisure operator on the Pioneers page, they are unlikely to be publishing open data. Help us to let your leisure operator know that this is something their customers are interested in, by <a target="_blank" href="http://goo.gl/forms/D04lFFyAdtiHQMdC2">filling out this form</a>.</p>
<h3>D) YOU DON'T USE A BOOKING SYSTEM</h3>
<p>We are working on a list of open data compatible booking systems help you to make a choice. Please do <a href="mailto:hello@openactive.io">get in touch</a> and we will let you know as soon as the list is available.</p>
<h3>E) YOU ARE GENERALLY INTERESTED IN OPEN DATA</h3>
<p>If you think your organisation can help support the growing ecosystem, why not <a href="join.html">join us</a> to help shape the future of your sector?</p>
</div>
</div>
</div>
<div class="accent section" id="the-steps">
<div class="w-container">
<div class="left section-title-group w-clearfix">
<div class="w-embed">
<style>
/* unvisited link */
.whitetext a:link {
color: white;
}
/* visited link */
.whitetext a:visited {
color: white;
}
/* mouse over link */
.whitetext a:hover {
color: white;
}
/* selected link */
.whitetext a:active {
color: white;
}
</style>
</div>
<h2 class="centered section-heading white">The STEPS</h2>
<div class="center off-white section-subheading">IF YOU HAVE CONTROL OVER thE DATA AND TeCHNOLOGY.</div>
<h3 class="whitetext">1) BUILD YOUR OPENACTIVE API</h3>
<h4>(estimated time to complete: 2-3 developer days)</h4>
<p class="whitetext">Give the information in the <a href="#the-technology">next section</a> to your technical team, and have them work through the details of opening up your session data according to the OpenActive specification. Instruct them to include as many fields as possible, including images and video content if available. Also instruct them to make use of the <a target="_blank" href="https://github.com/openactive/activation">Activation Issue Tracker</a> to reduce uncertainty in their work by posting an example to the community to check their assumptions early. Note this is usually an additional API to any that you may already have, and should be simple to implement</p>
<h3 class="whitetext">2) CHOOSE A LICENSE</h3>
<h4>(estimated time to complete: 5 minutes)</h4>
<p class="whitetext">License your data for anyone to access, use and share. Using the recommended license is low risk and represents no commitment.</p>
<p class="whitetext">The Open Data Institute highly recommends the <a href="https://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution License (cc-by) version 4</a> for data published by the OpenActive community. The license is the most common in use for publishing open data, and importantly version 4 includes specific provision for database rights. Generic <a href="https://theodi.org/guides/publishers-guide-open-data-licensing">open data licensing guidance</a> is also available.</p>
<p class="whitetext">If your legal department needs to be consulted, reassure them that this is the same licence that Wikipedia uses for its content, and is the most common license in use for open data published on the internet. The license can also be replaced or revoked at any time and represents no commitment from you.</p>
<h3 class="whitetext">3) AMEND Terms AND BUILD OPT-OUT</h3>
<h4>(<strong>booking systems only</strong> - estimated time to complete: 30 minutes / 1 developer day)</h4>
<p class="whitetext">If you <strong>do not</strong> own the data (e.g. in the case of a booking system provider), then you need to amend your terms and conditions to indicate that your users' sessions will be published openly. You may also give your users an option to opt-out of session publishing, while sending them an e-mail notifying them that you are turning data sharing on.</p>
<p class="whitetext">A simple addition to your Terms and Conditions similar to the following:</p>
<p class="quote whitetext"><strong>Publishing Sessions Openly</strong>
<br>Information about your session that is already available publicly (e.g. title, location, description, date/time, price, images) will be published as open data for anyone to access, use and share, licensed under the <a target="_blank" href="https://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution License (cc-by) version 4</a>. This gives your sessions more visibility by publishing them openly to apps and websites that will help you promote your sessions, including but not limited to those listed <a target="_blank" href="/pioneers.html">here</a>. This will help more people find your sessions, and will not incur any additional cost to you. [You may opt-out of this free service in your settings page.]</p>
<p class="whitetext">A simple opt-out checkbox visible in your application as below:</p><img class="tickbox" src="images/tick.png">
<p class="whitetext"><strong>Publish Sessions Openly</strong>
<br>Information about your sessions that is already available publicly (e.g. title, location, description, date/time, price, images) is published for anyone to access, use and share. This helps more people find your sessions, by making them visible on other apps and websites such as the ones listed <a target="_blank" href="/pioneers.html">here</a>. This does not incur any additional cost to you.</p>
<p class="whitetext">A simple e-mail alert similar to the following:</p>
<p class="quote whitetext"><strong>Publishing Sessions Openly</strong>
<br>We are now giving your sessions more visibility by publishing information about them that is already available publicly (e.g. title, location, description, date/time, price, images) openly to apps and websites that will help you promote your sessions, such as the ones listed <a target="_blank" href="/pioneers.html">here</a>. This will help more people find your sessions, and will not incur any additional cost to you. If you want to opt-out of this free service, <a href="#">click here</a> to go to your settings page.</p>
<h3 class="whitetext">4) CREATE A DATASET HOMEPAGE</h3>
<h4>(estimated time to complete: 1.5 hours)</h4>
<p class="whitetext">To publish open data for anyone to freely access, use and share, you must create a webpage that describes the data you are publishing. You must include relevant human and machine readable licensing information, documentation, a mailing list, and ideally an issue tracker. You must also specify how dataset users (innovators who want to build on top of/use your data) should attribute your data.</p>
<p class="whitetext">The <a href="https://github.com/openactive/dataset-site-generator/wiki">Dataset Site Generator</a> includes a template site, and complete step-by-step guides designed for non-technical users, to quickly and easily create a subsite that contains all of the above. Although it is possible to do this without the generator by following the ODI guides for <a target="_blank" href="https://theodi.org/guides/marking-up-your-dataset-with-dcat">metadata</a> and <a target="_blank" href="https://theodi.org/guides/publishers-guide-to-the-open-data-rights-statement-vocabulary">rights statements</a>, we recommend using the <a href="https://github.com/openactive/dataset-site-generator/wiki">Dataset Site Generator</a> to save you time and to benefit from additional updates - it's free and open source!</p>
<p class="whitetext">As with all of OpenActive, your feedback would be hugely appreciated. Please create an issue on this <a target="_blank" href="https://github.com/openactive/dataset-site-generator/issues">issue tracker</a> with any feedback, or comment on the guides directly.</p>
<h3 class="whitetext">5) CREATE AN OPEN DATA CERTIFICATE</h3>
<h4>(estimated time to complete: 30 minutes)</h4>
<p class="whitetext">The Open Data Institute encourage all publishers to create an <a href="https://certificates.theodi.org/">Open Data Certificate</a> for any open data published. If your Dataset Site has been set up correctly, it should automatically populate much of the Open Data Certificate form.</p>
</div>
</div>
</div>
<div class="section" id="the-technology">
<a class="cg-logo w-hidden-tiny w-inline-block" href="https://www.w3.org/community/openactive/" target="_blank"><img src="images/back-cg-group.png">
</a>
<div class="w-embed w-hidden-tiny">
<a href="https://github.com/openactive/activation">
<img style="position: absolute; top: 0; right: 0; border: 0;" src="https://camo.githubusercontent.com/52760788cde945287fbb584134c4cbc2bc36f904/68747470733a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f77686974655f6666666666662e706e67" alt="Fork me on GitHub" data-canonical-src="https://s3.amazonaws.com/github/ribbons/forkme_right_white_ffffff.png">
</a>
</div>
<div class="w-container">
<div class="left section-title-group">
<h2 class="centered section-heading">THE TECHNOLOGY</h2>
<div class="center section-subheading">THE SPECIFICATION IS OPEN, AS IS THE SUPPORT.</div>
<h3>A SENTENCE FOR YOUR TECH TEAM</h3>
<p>All you need to do is create a JSON endpoint that conforms to the <a href="https://github.com/openactive/realtime-paged-data-exchange/blob/master/README.md">OpenActive RTPE specification</a>. We recommend that you create a new endpoint for this purpose. The specification is designed to be simple to implement, take a look at the examples in the <a href="https://github.com/openactive/activation/blob/master/README.md">Activation Issue Tracker</a> to get an idea.</p>
</div>
</div>
</div>
<div class="footer">
<div class="w-container">
<div class="w-row">
<div class="spc w-col w-col-6">
<h5>about openactive</h5>
<p>We are a group of organisations who believe that open data will help to get more people more active, supported by the <a target="_blank" href="http://opendata.institute">Open Data Institute</a>.</p>
</div>
<div class="spc w-col w-col-6">
<h5>CONTACT</h5>
<p>We'd love to hear from you. Whatever's on your mind, send us a note on <a href="mailto:hello@openactive.io">hello@openactive.io</a>
</p>
<p>Want to be kept up to date on all that's happening?</p>
<div class="email-form-wrapper w-form">
<form class="email-form" data-name="Email Form" id="email-form" name="email-form">
<div class="w-row">
<div class="w-col w-col-9">
<input class="w-input" data-name="Email" id="email" maxlength="256" name="email" placeholder="Enter your email address" required="required" type="email">
</div>
<div class="button-column w-col w-col-3">
<input class="w-button" data-wait="Please wait..." type="submit" value="Submit">
</div>
</div>
</form>
<div class="w-form-done">
<p>Thank you! Your submission has been received!</p>
</div>
<div class="w-form-fail">
<p>Oops! Something went wrong while submitting the form</p>
</div>
</div>
</div>
</div>
</div>
</div>
<div alt="Creative Commons License" class="center footer">
<div class="w-container">
<p>Supported by the Open Data Institute</p><img class="odi-logo" src="images/odi_logo_white.png" width="149">
</div>
<div class="w-container">
<div class="footer-text">
<a class="w-inline-block" href="http://creativecommons.org/licenses/by-sa/4.0/" target="_blank"><img src="images/88x31.png">
</a>
<p class="icon-attribution">With the exception of icons and brand images, this work is licensed under a <a class="footer-link-2" target="_blank" href="http://creativecommons.org/licenses/by-sa/4.0/">Creative Commons Attribution-ShareAlike 4.0 International License</a>. All source code is licensed under
<a class="footer-link-2" target="_blank" href="http://www.gnu.org/licenses/gpl-3.0.en.html">GNU GPL v3</a>.
<br>Icons used here made by Freepik from www.flaticon.com is licensed under CC BY 3.0</p>
</div>
</div>
</div>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.2.0/jquery.min.js" type="text/javascript"></script>
<script src="js/webflow.js" type="text/javascript"></script>
<!-- [if lte IE 9]><script src="https://cdnjs.cloudflare.com/ajax/libs/placeholders/3.0.2/placeholders.min.js"></script><![endif] -->
<script>
function loadJSON(url, cb) {
$.support.cors = true;
$.getJSON(url, function(data) {
cb(data);
}).fail(function( jqxhr, textStatus, error ) {
var err = textStatus + ", " + error;
console.log( "Error accessing GitHub: " + err );
});
}
function addRow(metadata) {
console.log("Metadata for!: " + metadata["dataset-site-url"] );
var newRow = $( "#use-data-template" ).clone();
newRow.removeAttr("id");
newRow.find( "[data-field='image']" ).attr("src", metadata["dataset-site-url"] + "images/logo.png");
newRow.find( "[data-field~='link']" ).attr("href", metadata["dataset-site-url"]);
newRow.find( "[data-field~='title']" ).text(metadata["title"]);
newRow.find( "[data-field='description']" ).text(metadata["description"]);
//Add row to list
newRow.appendTo( "#pioneers-section-list" );
newRow.show();
}
/*
* On Page Load
*/
$(function() {
$( "#use-data-template" ).each(function() {
$( this ).hide();
$.getJSON( "/datasets/directory.json", function( body ) {
for(var i = 0; i < body.length; i++) {
var metadata = body[i];
console.log("Metadata for: " + metadata["dataset-site-url"] + " (Publish: " + metadata["publish"] + ")");
if (metadata["publish"]) {
addRow(metadata);
}
}
});
});
$( "#metric-live" ).each(function() {
$.getJSON( "/datasets/directory.json", function( data ) {
$( "#metric-live" ).text(data.length)
});
});
});
$(function() {
$(".marked").each(function() {
var element = $( this );
var id = element.attr('id');
console.log("HI " + id);
$.get( "https://raw.githubusercontent.com/openactive/" + id + "/master/README.md", function( data ) {
var dataSansHeader = data.replace(/[\s\S]*?\(\_SNIP\_\)[\s\S][\s\S]/,"");
element.html( marked(dataSansHeader) );
});
});
});
</script>
</body>
</html>