-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathnew_language.html
213 lines (174 loc) · 10.3 KB
/
new_language.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
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-GB" xml:lang="en-GB" xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8"/>
<title>Start a new language/treebank</title>
<link rel="root" href=""/> <!-- for JS -->
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.4.0/css/font-awesome.min.css">
<link rel="stylesheet" type="text/css" href="css/jquery-ui-redmond.css"/>
<link rel="stylesheet" type="text/css" href="css/style.css"/>
<link rel="stylesheet" type="text/css" href="css/style-vis.css"/>
<link rel="stylesheet" type="text/css" href="css/hint.css"/>
<script type="text/javascript" src="lib/ext/head.load.min.js"></script>
<script type="text/javascript" src="lib/ext/jquery.timeago.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/anchor-js/3.2.2/anchor.min.js"></script>
<script>document.addEventListener("DOMContentLoaded", function(event) {anchors.add();});</script>
<!-- <link rel="shortcut icon" href="favicon.ico"/> -->
</head>
<body>
<div id="main" class="center">
<div id="hp-header">
<span class="header-text"><a href="http://universaldependencies.org/#language-">home</a></span>
<span class="header-text"><a href="https://github.com/universaldependencies/docs/edit/pages-source/new_language.md" target="#">edit page</a></span>
<span class="header-text"><a href="https://github.com/universaldependencies/docs/issues">issue tracker</a></span>
</div>
<hr/>
<div class="v2complete">
This page pertains to UD version 2.
</div>
<div id="content">
<noscript>
<div id="noscript">
It appears that you have Javascript disabled.
Please consider enabling Javascript for this page to see the visualizations.
</div>
</noscript>
<h1 id="getting-a-repository">Getting a repository</h1>
<p>Make sure you have a github account and contact a member of our release and documentation task force:
ginter@cs.utu.fi, sampo.pyysalo@gmail.com, zeman@ufal.mff.cuni.cz. They will get you going.</p>
<h1 id="coding-metadata-for-the-front-page">Coding metadata for the front page</h1>
<p>The table on the front page is automatically generated from special lines in the <code>README.txt</code> or <code>README.md</code> file for every language. This means that in order to add a new language, also its repository must be created, minimally with the readme file. Here is an example of the language metadata block from the <a href="https://github.com/UniversalDependencies/UD_Finnish/blob/master/README.txt">Finnish README file</a></p>
<pre><code>Documentation status: complete
Data source: semi-automatic
Data available since: UD v1.0
License: CC BY-SA 4.0
Genre: blog wiki legal news fiction
Contributors: Ginter, Filip; Kanerva, Jenna; Laippala, Veronika; Missilä, Anna; Pyysalo, Sampo
Contact: email1@example.com, email2@example.com
</code></pre>
<p>This block can be anywhere in the readme file. The properties are as follows:</p>
<ul>
<li><code>Documentation status</code> can be <code>complete</code>, <code>partial</code>, or <code>stub</code>.</li>
<li><code>Data source</code> can be <code>automatic</code>, <code>semi-automatic</code>, or <code>manual</code>. Here, as a rough guidance, <code>manual</code> means that every word of every sentence has been manually checked, whereas <code>semi-automatic</code> means an automatic conversion with major manual checks of various types of constructions.</li>
<li><code>Data available since</code> can be <code>UD v1.0</code>, <code>UD v1.1</code>, or <code>UD v1.2</code>. As the current release is 1.1, new languages which will be included in 1.2 should set this property accordingly, so that they are included in the upcoming automatic validation runs.</li>
<li><code>License</code>: anything containing the string <code>BY-NC-SA</code> will be given the CC non-commercial logo, <code>BY-SA</code> or <code>BY</code> the CC logo, and <code>GNU</code> the GNU logo. To add any other license, please provide a suitable icon to ginter@cs.utu.fi and sampo.pyysalo@gmail.com.</li>
<li><code>Genre</code>: this is simply a space-separated list of genres which gets mapped into symbols in the table. The possible genres are listed in <a href="https://github.com/UniversalDependencies/docs/blob/pages-source/gen_index/genre_symbols.json">this file</a> in the repository. If you don’t see yours, just edit the file on GitHub and add your genre, choosing one of the symbols from <a href="https://fortawesome.github.io/Font-Awesome/icons/">the <em>FontAwesome</em> list</a>. Please make sure you get the syntax right, since this is a machine-readable JSON file. It is also possible to not add the genre to the <code>genre_symbols.json</code> file, in which case the default symbol will be used automatically. The genre name will still remain visible in the mouse-over tooltip.</li>
<li><code>Contributors</code>: the list of contributors to be included with the data release and in the LINDAT download page. This is a semi-colon separated list where every name is in the <code>Last, First</code> form and the readme file should be utf-8 encoded to make sure special characters are preserved correctly.</li>
<li><code>Contact</code>: e-mail address(es) of contact person(s) for the treebank (typically a subset of the contributors). The address may be used for inquiries about the treebank, such as questions that are not answered in documentation and/or issue trackers. More importantly, it may be used by people who want to contribute to the treebank and need to coordinate with the maintainers, and by the UD release task force to discuss issues that need to be fixed before the release. Warning: the addresses listed here may be exposed to spamming robots.</li>
</ul>
<h1 id="making-a-release">Making a release</h1>
<p>When you are ready to contribute to a release, please read the <a href="release_checklist.html">release checklist</a>.</p>
</div>
<!-- support for embedded visualizations -->
<script type="text/javascript">
var root = ''; // filled in by jekyll
head.js(
// External libraries
root + 'lib/ext/jquery.min.js',
root + 'lib/ext/jquery.svg.min.js',
root + 'lib/ext/jquery.svgdom.min.js',
root + 'lib/ext/jquery.timeago.js',
root + 'lib/ext/jquery-ui.min.js',
root + 'lib/ext/waypoints.min.js',
root + 'lib/ext/jquery.address.min.js',
// brat helper modules
root + 'lib/brat/configuration.js',
root + 'lib/brat/util.js',
root + 'lib/brat/annotation_log.js',
root + 'lib/ext/webfont.js',
// brat modules
root + 'lib/brat/dispatcher.js',
root + 'lib/brat/url_monitor.js',
root + 'lib/brat/visualizer.js',
// embedding configuration
root + 'lib/local/config.js',
// project-specific collection data
root + 'lib/local/collections.js',
// NOTE: non-local libraries
'https://spyysalo.github.io/annodoc/lib/local/annodoc.js',
'https://spyysalo.github.io/conllu.js/conllu.js'
);
var webFontURLs = [
// root + 'static/fonts/Astloch-Bold.ttf',
root + 'static/fonts/PT_Sans-Caption-Web-Regular.ttf',
root + 'static/fonts/Liberation_Sans-Regular.ttf'
];
var setupAccordions = function() {
// preserve state in URL hash, following in part
// http://www.boduch.ca/2011/05/remembering-jquery-ui-accordion.html
var accordionChange = function(event, ui) {
var context = ui.newHeader ? ui.newHeader.context : null;
if (context) {
var languageCode = context.getAttribute('data-lc');
if (languageCode !== null) {
window.location.hash = languageCode;
}
}
}
// jQuery UI "accordion" element initialization
$(".jquery-ui-accordion").accordion({
collapsible: true,
active: false,
change: accordionChange
});
if ($(".jquery-ui-accordion").length) {
var matches = window.location.hash.match(/^\#(.*)$/);
console.log(matches);
if (matches !== null) {
var languageCode = matches[1];
var tab = $('[data-lc="'+languageCode+'"]');
// the following will only work after accordion is initialized
var index = $('.jquery-ui-accordion div.ui-accordion-header').index(tab);
if (index !== -1) {
$(".jquery-ui-accordion").accordion({ active: index });
}
}
}
};
var setupTimeago = function() {
jQuery("time.timeago").timeago();
};
var setupTabs = function() {
// standard jQuery UI "tabs" element initialization
$(".jquery-ui-tabs").tabs({ heightStyle: "auto" });
// use jQuery address to preserve tab state
// (see https://github.com/UniversalDependencies/docs/issues/65,
// http://stackoverflow.com/a/3330919)
if ($(".jquery-ui-tabs").length > 0) {
$.address.change(function(event){
$(".jquery-ui-tabs").tabs("select", window.location.hash)
});
$(".jquery-ui-tabs").bind("tabsselect", function(event, ui) {
window.location.hash = ui.tab.hash;
});
}
};
head.ready(function() {
// set up UI tabs on page
setupTabs();
setupAccordions();
setupTimeago();
// mark current collection (filled in by Jekyll)
Collections.listing['_current'] = '';
// perform all embedding and support functions
Annodoc.activate(Config.bratCollData, Collections.listing);
});
</script>
<!-- google analytics -->
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-55233688-1', 'auto');
ga('send', 'pageview');
</script>
<div id="footer">
<p class="footer-text">© 2014
<a href="http://universaldependencies.org/introduction.html#contributors" style="color:gray">Universal Dependencies contributors</a>.
Site powered by <a href="http://spyysalo.github.io/annodoc" style="color:gray">Annodoc</a> and <a href="http://brat.nlplab.org/" style="color:gray">brat</a></p>.
</div>
</div>
</body>
</html>