-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathindex.html
334 lines (279 loc) · 31.4 KB
/
index.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
<!DOCTYPE html>
<html>
<head>
<meta charset='utf-8'>
<meta http-equiv="X-UA-Compatible" content="chrome=1">
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1">
<link href='https://fonts.googleapis.com/css?family=Architects+Daughter' rel='stylesheet' type='text/css'>
<link rel="stylesheet" type="text/css" href="stylesheets/stylesheet.css" media="screen" />
<link rel="stylesheet" type="text/css" href="stylesheets/pygment_trac.css" media="screen" />
<link rel="stylesheet" type="text/css" href="stylesheets/print.css" media="print" />
<!--[if lt IE 9]>
<script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
<![endif]-->
<title>FieldDB</title>
<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-35422317-1','auto');
ga('set', 'page', 'github-organization' + window.location.href.replace(window.location.protocol, "").replace(/^\//,""));
ga('send', 'pageview');
</script>
</head>
<body>
<header>
<div class="inner">
<h1>Fielddb</h1>
<h2>An offline/online field database which adapts to its user's terminology and I-Language. </h2>
<a href="https://github.com/FieldDB/FieldDB" class="button"><small>View project on</small>GitHub</a>
</div>
</header>
<div id="content-wrapper">
<div class="inner clearfix">
<section id="main-content">
<p><a href="https://npmjs.org/package/fielddb"><img src="https://camo.githubusercontent.com/85932a663b3b65d768e7bfc94a420adba7b88d12/68747470733a2f2f62616467652e667572792e696f2f6a732f6669656c6464622e737667" alt="NPM version" data-canonical-src="https://badge.fury.io/js/fielddb.svg" style="max-width:100%;"></a> <a href="https://travis-ci.org/FieldDB/FieldDB"><img src="https://camo.githubusercontent.com/b6333b44529b26df82437ca418ae6d757e056be9/68747470733a2f2f7472617669732d63692e6f72672f4669656c6444422f4669656c6444422e7376673f6272616e63683d6d6173746572" alt="Build Status" data-canonical-src="https://travis-ci.org/FieldDB/FieldDB.svg?branch=master" style="max-width:100%;"></a> <a href="https://david-dm.org/FieldDB/FieldDB"><img src="https://camo.githubusercontent.com/e1a95a27e67b9cd3509c5220e53a581d83c95e1b/68747470733a2f2f64617669642d646d2e6f72672f4f70656e536f757263654669656c646c696e67756973746963732f4669656c6444422e7376673f7468656d653d736869656c64732e696f" alt="Dependency Status" data-canonical-src="https://david-dm.org/FieldDB/FieldDB.svg?theme=shields.io" style="max-width:100%;"></a></p>
<p>FieldDB is a free, modular, open source project developed collectively by field linguists and software developers to make an expandable user-friendly app which can be used to collect, search and share your data, both online and offline. It is fundamentally an app written in 100% Javascript which runs entirely client side, backed by a NoSQL database (we are currently using CouchDB and its offline browser wrapper PouchDB alpha). It has a number of webservices which it connects to in order to allow users to perform tasks which require the internet/cloud (ie, syncing data between devices and users, sharing data publicly, running CPU intensive processes to analyze/extract/search audio/video/text). While the app was designed for "field linguists" it can be used by anyone collecting text/audio/video data or collecting highly structured data where the fields on each data point require encryption or customization from user to user, and where the schema of the data is expected to evolve over the course of data collection while in the "field."</p>
<p>FieldDB was officially launched in Spanish on August 1st 2012 in Patzun, Guatemala as iCampo an app for fieldlinguists. Since then more than 500 users at <a href="https://github.com/FieldDB/FieldDB/issues/1766#issuecomment-67926709">50+ universities</a> that we know of have started using and giving us <a href="https://github.com/FieldDB/FieldDB/milestones?state=closed">feedback</a> about the app. You can find more about the "non-technical" side of the project at <a href="http://lingsync.org">LingSync.org</a> or find "technical" publications about the project on here on this page. You can also watch screencasts which demo how parts of the app & infrastructure work by <a href="https://www.youtube.com/results?search_query=lingsync+">searching on YouTube</a>.</p>
<p><a target="_blank" href="http://lingsync.org">Visit LingSync.org, the site for users...</a></p>
<a name="biblio"></a>
<a name="publications"></a>
<h1>
<a name="citing-fielddb" class="anchor" href="#citing-fielddb"><span class="octicon octicon-link"></span></a>Publications</h1>
<ul>
<li> Dunham, J., A. Bale and J. Coon Feb 28 2015. "LingSync: web-based software for language documentation."
ICLDC 4. <a target="_blank" href="http://icldc4.weebly.com/uploads/2/4/9/6/24963413/icldc4_papers_12_11_14.pdf">abstract</a>
</li>
<li>Dunham, J. Jan 8 2015. "LingSync." LSA 2015. <a target="_blank" href="http://www.linguisticsociety.org/system/files/abstracts/Lingsync.pdf">abstract</a>, <a target="_blank" href="http://jrwdunham.com/files/lsa-lingsync-tutorial-1-what-why.pdf">slides1</a>, <a target="_blank" href="http://jrwdunham.com/files/lsa-lingsync-tutorial-2-how.pdf">slides2</a>, <a target="_blank" href="http://jrwdunham.com/files/lsa-lingsync-tutorial-3-hands-on.pdf">slides3</a>, <a target="_blank" href="http://jrwdunham.com/files/lsa-lingsync-tutorial-4-in-development.pdf">slides4</a>, <a target="_blank" href="https://www.youtube.com/watch?v=eYThTB9gB0o">video1</a>, <a target="_blank" href="https://www.youtube.com/watch?v=eYThTB9gB0o">video2</a>, <a target="_blank" href="https://www.youtube.com/watch?v=R8VmRx6UcCU">video3</a>, <a target="_blank" href="https://www.youtube.com/watch?v=gKAHmomPAQc">video4</a>, <a target="_blank" href="https://www.youtube.com/watch?v=85XZS_feHBE">video5</a>
</li>
<li>Bale, A., J. Coon and M. Wagner. Jan 8 2015. "LingSync and ProsodyLab-Aligner: Tools for Linguistic Fieldwork and Experimentation", LSA Workshop 2015. <a target="_blank" href="http://www.linguisticsociety.org/system/files/abstracts/Lingsync.pdf">abstract</a>
</li>
<li>Little, C-R. Nov 21 2014. "LingSync Fieldwork Software Demo." Cornell Language Documentation Lab.</li>
<li>Dunham, J. Nov 10 2014. "LingSync Tutorial." LRC I’d Like to Know More About ... Workshop. UCalgary. <a target="_blank" href="http://www.ucalgary.ca/events/calendar/lrc-id-know-more-about-workshop">blurb</a>
</li>
<li>Dunham, J and E. McClay. September 12 2014. "LingSync Tutorial." UBC. <a target="_blank" href="https://www.lingsync.org/slides/why_lingsync.pdf">slides</a>
</li>
<li>Chiodo, G., E. Chkhikvadze. August 20 2014. Recognizing Speech on Android: ანდროიდის ქართველი მომხმარებლებისთვის სიტყვის ამოცნობის სისტემის შექმნა. Android Montreal. <a target="_blank" href="https://docs.google.com/presentation/d/1Dg9CbS54yD2WIztUC3pdvM1H25TfyOyEmMO_zn12lLk/edit">slides</a>, <a target="_blank" href="http://youtu.be/XNIS0hTzGIA">video</a>, <a target="_blank" href="https://play.google.com/store/apps/details?id=com.github.opensourcefieldlinguistics.fielddb.speech.kartuli">installer</a>
</li>
<li>Dunham, J, G. Chiodo, and J. Horner. June 26 2014 "LingSync & the Online Linguistic Database: New models for the collection and management of data for language communities, linguists and language learners." ComputEl: The use of computational methods in the study of endangered languages, 52nd Annual Meeting of the Association for Computational Linguistics. <a target="_blank" href="http://acl2014.org/acl2014/W14-22/W14-22-2014.pdf">paper</a>, <a target="_blank" href="http://youtu.be/EpnAYnfPT_Y">video</a>, <a target="_blank" href="https://www.lingsync.org/slides/computel_2014_slides.pdf">slides</a>
</li>
<li>Dunham, J and E. McClay. May 8 2014. "LingSync Tutorial." Presentation at Exploring the Interfaces (ETI) 3. McGill University, Montreal, QC. <a target="_blank" href="http://youtu.be/dwKUxd8jUuE?t=8m18s">video</a>, <a target="_blank" href="https://www.lingsync.org/slides/why_lingsync.pdf">slides</a>
</li>
<li>Bielig, L. Nov 22, 2013. "Linguistic Corpus-building for Low-Resource Languages: an Inuktitut case study." ms McGill, University. <a target="_blank" href="https://raw.githubusercontent.com/FieldDB/FieldDB/master/docs/SupplementingFieldWorkWithCorpora.tex">tex</a>
</li>
<li>McClay, E., H. Noguchi, E. Olson, C. Little, A. Bale, J. Coon & G. Chiodo. Oct 3, 2013. “Using technology to bridge gaps between speakers, learners, and linguists.” Electronic poster and demo at the annual Foundation for Endangered Languages Conference, Ottawa, ON. <a target="_blank" href="http://migmaq.org/wp-content/uploads/2013/10/FEL_slideshow.pdf">slides</a>
</li>
<li>McClay, E., H. Noguchi, E. Olson, C. Little, A. Bale, J. Coon & G. Chiodo. June 3, 2013. “Using technology to bridge gaps between speakers, learners, and linguists.” Poster presented at the Special Session on Indigenous Languages at the annual Canadian Linguistic Association conference, Victoria, BC. <a target="_blank" href="http://homes.chass.utoronto.ca/%7Ecla-acl/ACL-resumes-2013-CLA-abstracts.pdf">abstract</a>
</li>
<li>Bielig, L., J. Horner, C. Little, T. Skinner. May 28, 2013. "Plugging into LingSync." Presentation at Computational Field Workshop, McGill University, Montreal, QC.
<ul>
<li>L. Bielig: <a target="_blank" href="https://github.com/louisa-bielig/FieldDB/blob/e34b72933ff63b628279d212363ca15fd77feea6/backbone_client/glosser/Tree.js">Bare Phrase Structure Tree Generation</a>, </li>
<li>J. Horner: <a target="_blank" href="https://github.com/FieldDB/AudioWebService/blob/a3942ffd612fecb3a5727d922642f44cbb9806a3/service.js">Prosody Lab Aligner WebService</a>, </li>
<li>C. Little: <a target="_blank" href="https://github.com/FieldDB/FieldDB/commit/55b7705a6a40adcf9c79f849feecae1279df10c6">Automating Data Cleaning</a>,</li>
<li>T. Skinner: <a target="_blank" href="https://docs.google.com/presentation/d/1GMRRvA9WLM--DiWyiWj6zlv3m4Cc4a3jcpPZDmi6Zmk/edit?usp=sharing">Collaborative Field Methods</a>.</li>
</ul>
</li>
<li>Noguchi, H., G. McCulloch, G. Chiodo. May 27, 2013. "Why LingSync." Presentation at Computational Field Workshop, McGill University, Montreal, QC. <a target="_blank" href="https://docs.google.com/presentation/d/1KQaq4jbGM9roakDNPuj_jxWPL5v0NXJNBWaLJpqDzHc/edit#slide=id.p">slides</a>.</li>
<li>Manyakina, Y. Feb 20, 2013. "LingSync: an on/offline database app for field linguistics." Brown Bag Presentation at Stony Brook University.</li>
<li>Deering, T., G. Chiodo. Oct 9, 2012. "Taking Javascript into the field: a case study." Presentation at JSMontreal. <a target="_blank" href="https://www.lingsync.org/slides/shells/onstage.html#https://www.lingsync.org/slides/offline_databases.html">slides</a>, <a target="_blank" href="http://youtu.be/p8VjsvXC-tU">video</a>.</li>
<li>McClay, E. "Language Learning App: Learn Mi'gmaq prototype". Oct 5, 2012. <a target="_blank" href="https://drive.google.com/file/d/0BxNNj2I3GhQ5UnhoVE1vaFBDS0U/edit?usp=sharing">whitepaper</a>, <a target="_blank" href="https://play.google.com/store/apps/details?id=com.github.opensourcefieldlinguistics.android.lessons">prototype</a>.</li>
<li>Cathcart, M.E., G. Chiodo, T. Deering, Y. Manyakina, G. McCulloch, H. Noguchi. Aug 1, 2012. "LingSync: A Free Tool For Creating And Maintaining A Shared
Database For Communities, Linguists, And Language Learners.
" Proceedings of FAMLi 2: Formal Approaches to Mayan Linguistics. MITWPL 74. <a target="_blank" href="https://github.com/FieldDB/FieldDB/blob/master/docs/cathcart,et.al-2012-LingSync_A_Free_Tool_For_Creating_And_Maintaining_A_Shared_Database_For_Communities,_Linguists_And_Language_Learners.pdf?raw=true">prepress paper</a>, <a target="_blank" href="http://mitwpl.mit.edu/catalog/mwpl74/">publisher</a>
</li>
<li>Cathcart, M.E., G. Chiodo, T. Deering, Y. Manyakina, G. McCulloch, H. Noguchi. Aug 1, 2012. "iCampo: Un aplicación de colección de datos lingüísticos." MITWPL 74. Presentation at Corpus Approaches to Mayan Languages Workshop, Patzun, Guatemala. <a target="_blank" href="http://www.youtube.com/watch?v=eRTHu-5KvSQ&feature=share&list=PLUrH6CNxFDrMtraL8hTLbLsQwdw1117FT&index=15">demostración</a>
</li>
<li>LingSync WhitePaper <a target="_blank" href="https://github.com/FieldDB/FieldDB/blob/master/docs/WhitePaper.pdf?raw=true">whitepaper</a>
</li>
</ul>
<a name="docs"></a>
<h1>Documentation</h1>
<a name="faq"></a>
<h2>User Documentation</h2>
<ul>
<li><a href="http://lingsync.org" target="_blank">Website</a></li>
<li><a href="http://app.lingsync.org/#/faq" target="_blank">FAQ</a></li>
<li><a href="https://www.youtube.com/results?search_query=lingsync" target="_blank">Videos</a></li>
<li><a href="https://www.lingsync.org/#/tutorial" target="_blank">Tutorial</a></li>
<li><a href="#publications" target="_blank">Publications</a></li>
</ul>
<a name="agile"></a>
<h2>Code Documentation</h2>
<p>We use the Agile/Scrum software development method. Scrum (10 minute) meetings are held almost every day, Monday-Friday at 12:30pm EST (Montreal time) in this <a target="_blank" href ="https://plus.google.com/hangouts/_/calendar/bWRubjgyMGJwaGt2Y3RpaGdscWFtM2QzNGNAZ3JvdXAuY2FsZW5kYXIuZ29vZ2xlLmNvbQ._892kcg9k6ook2b9l60ojcb9k6oq38ba26h33iba68h0j6e21852k8hhn88?authuser=0">Google Hangout</a>. You are welcome to join us.
<a target="_blank" href="https://github.com/FieldDB/FieldDB/search?q=export&ref=cmdform&type=Issues">All features must be documented in the feature/issue tracker,</a> and can be found simply by running a search in the feature tracker or by browsing <a target="_blank" href="https://github.com/FieldDB/fielddb/milestones">in progress and completed Milestones</a>.
</p>
<a name="bdd"></a>
<h2>Behavior Driven Development</h2>
<p><a target="_blank" href="https://github.com/FieldDB/FieldDB/tree/master/tests">All features must also be documented in a Jasmine Specification ('spec')</a> which is a type of documentation which compiles, and can say whether or not the code meets the specification. Specs are useful both when the code is written, but also over time as a project grows in complexity. A spec is a way of detecting a regression, a loss of features as new features break old ones. Specs and feature trackers are a common low-effort way of documenting a decentralized software project.
</p>
<a name="sdd"></a>
<h2>Models and Data Structures (JSDocs) </h2>
<p> If you would like to see the classes/models in FieldDB and how they can interact and be used, you can browse the API documentation which was autogenerated using a tool called 'jsdoc' (documentation generator for JavaScript). Class docs can help software developers/interns who are already know the project understand how to use the source files.<br/>
Class Documentation
<a target="_blank" href="https://github.com/FieldDB/FieldDB/tree/master/api">(src)</a>
<a target="_blank" href="docs/javascript/App.html">(html)</a>
</p>
<a name="ieee"></a>
<h2>IEEE documentation</h2>
<p>
If you are a student of Computer Science/Software Engeering and you would like to help keep the IEEE documentation up to date please contact us on the <a target="_blank" href="https://github.com/FieldDB/FieldDB/issues">issue tracker</a>.
</p>
<a name="whitepaper"></a>
<h3>White Paper</h3>
<p> The white paper was written in April 2012 and discusses how the project will meet E-MELD and DataOne best practices in data management, as well as some of the modules which were planned and estimates of how much time it would take to build them. The White Paper is perhaps interesting to users, and maybe help users situate the project as compared to similar software. <br/>
White Paper
<a target="_blank" href="https://raw.github.com/FieldDB/FieldDB/master/docs/WhitePaper.tex">(.tex)</a>,
<a href="https://github.com/FieldDB/FieldDB/blob/master/docs/WhitePaper.pdf?raw=true">(pdf)</a>
</p>
<a name="sdd"></a>
<h3>Software Design Description (SDD) </h3>
<p> A Software Design Description IEEE 1016-2009 is a representation of a software design to be used for communicating design information to its stakeholders. It generally contains diagrams which help visualize the software system and maybe most useful for SOEN or CompSci interns, or academics who wish to learn more about they can think like a software engineer (both academic and industry). <br/>
Software Design Description
<a target="_blank" href="https://raw.github.com/FieldDB/FieldDB/master/docs/SoftwareDesignDescription.tex">(.tex)</a>,
<a href="https://github.com/FieldDB/FieldDB/blob/master/docs/SoftwareDesignDescription.pdf?raw=true">(pdf)</a>
</p>
<h1>
<a name="interns-and-development-team" class="anchor" href="#interns-and-development-team"><span class="octicon octicon-link"></span></a>Interns and Development Team</h1>
<ul>
<li>
<a target="_blank" href="https://www.lingsync.org/louisabielig">Louisa Bielig</a> (McGill)</li>
<li>
<a target="_blank" href="http://udel.edu/%7Emdotedot/">M.E. Cathcart</a> (U Delaware)</li>
<li>
<a target="_blank" href="http://gina.ilanguage.ca/">Gina Chiodo</a> (iLanguage Lab Ltd)</li>
<li>
<a target="_blank" href="http://trisapeace.angelfire.com/">Theresa Deering</a> (Visit Scotland, Aquafadas)</li>
<li>
<a target="_blank" href="http://lingserver.arts.ubc.ca/linguistics/people/jdunham/">Joel Dunham</a> (Concordia, UBC)</li>
<li>
<a target="_blank" href="http://www.jdhorner.com/">Josh Horner</a> (Amilia)</li>
<li>
<a target="_blank" href="http://ymanyakina.github.io/">Yuliya Manyakina</a> (McGill)</li>
<li>
<a target="_blank" href="https://github.com/Kedersha">Elise McClay</a> (McGill)</li>
<li>
<a target="_blank" href="http://linguistics.concordia.ca/gazette.html">Hisako Noguchi</a> (Concordia)</li>
<li>
<a target="_blank" href="http://jessepollak.me/">Jesse Pollak</a> (Pomona College)</li>
<li>
<a target="_blank" href="http://tobinskinner.com">Tobin Skinner</a> (Amilia, McGill)</li>
<li>
<a target="_blank" href="http://myaamiacenter.org/">Xianli Sun</a> (Miami University)</li>
</ul>
<h1>
<a name="funding" class="anchor" href="#funding"><span class="octicon octicon-link"></span></a>Funding
</h1>
<p>We would like to thank SSHRC Connection Grant (#611-2012-0001) and SSHRC Standard Research Grant (#410-2011-2401) which advocates open-source approaches to knowledge mobilization and partially funded the students who have doubled as fieldwork research assistants and interns on the project. We would like to thank numerous other granting agencies which have funded the RAs and TAs who have also contributed to the project as interns. If you have a student/RA who you would like to customize the project for your needs, contact us at support @ lingsync . org </p>
<h1>
<a name="license" class="anchor" href="#license"><span class="octicon octicon-link"></span></a>License
</h1>
<p>This project is released under the <a href="http://www.apache.org/licenses/LICENSE-2.0.html">Apache 2.0</a> license, which is an very non-restrictive open source license which basically says you can adapt the code to any use you see fit. </p>
<h1>
<a name="how-to-contribute-code" class="anchor" href="#how-to-contribute-code"><span class="octicon octicon-link"></span></a>How to Contribute Code</h1>
<ul>
<li>
<a target="_blank" href="https://github.com/signup/free">Signup for a GitHub account</a> (GitHub is free for OpenSource)</li>
<li>Click on the "Fork" button to create your own copy.</li>
<li>Leave us a note in our <a target="_blank" href="https://github.com/FieldDB/FieldDB/issues">issue tracker</a> to tell us a bit about the bug/feature you want to work on.</li>
<li>You can <a target="_blank" href="http://help.github.com/">follow the 4 GitHub Help Tutorials</a> to install and use Git on your computer.</li>
<li>You can watch the videos on <a target="_blank" href="https://www.youtube.com/playlist?list=PLUrH6CNxFDrO3zLHtHAMW-8u_v7TSvE-H">YouTube dev playlist</a> and/or in the <a target="_blank" href="https://wwwdev.lingsync.org/dev.html">Developer's Blog</a> to find out how the codebase works, and to find where is the code that you want to edit. You might also like the <a target="_blank" href="https://www.youtube.com/playlist?list=PLUrH6CNxFDrMtraL8hTLbLsQwdw1117FT">user tutorial screencasts</a> to see how the app is supposed to behave. Feel free to ask us questions in our <a target="_blank" href="https://github.com/FieldDB/FieldDB/issues">issue tracker</a>, we're friendly and welcome Open Source newbies.</li>
<li>Edit the code on your computer, commit it referencing the issue #xx you created (<code>$ git commit -m "fixes #xxxx i changed blah blah..."</code>) and push to your origin (<code>$ git push origin master</code>).</li>
<li>If you know how, you should also try to run the tests <code>$ npm install</code> and <code>$ grunt test</code> it should say something like <code>Finished in 10.388 seconds 732 tests, 2308 assertions, 0 failures, 0 skipped</code>
<a target="_blank" href="https://cloud.githubusercontent.com/assets/196199/6281625/301ea14c-b8f7-11e4-9682-dfa4a102a722.png" target="_blank"><img src="https://cloud.githubusercontent.com/assets/196199/6281625/301ea14c-b8f7-11e4-9682-dfa4a102a722.png" alt="screen shot 2015-02-20 at 11 53 50 am" style="max-width:100%;"></a>
Then you can also run the entire build <code>$ grunt travis</code> to make sure your changes dont affect other parts of the app. If any of these parts errors, ask us for help in the <a target="_blank" href="https://github.com/FieldDB/FieldDB/issues">issue tracker</a>. </li>
<li>Click on the <a target="_blank" href="https://github.com/FieldDB/FieldDB/pulls">"Pull Request" button</a>, and leave us a note about what you changed. We will look at your changes and help you bring them into the project!</li>
<li>Feel the glow of contributing to OpenSource :)</li>
</ul>
<h1>
<a name="related-repositories" class="anchor" href="#related-repositories"><span class="octicon octicon-link"></span></a>Related repositories</h1>
<p>These are the webservices which the FieldDB clients use, and which make up the complete FieldDB suite. If you fork the project, you might also be intersted in forking these repositories and adapting them to your needs. We created two scripts to simplify the process of downloading and building the FieldDB dependancies into one directory.</p>
<ul>
<li>
<a target="_blank" href="https://raw.githubusercontent.com/FieldDB/FieldDB/master/install_mac_download_and_set_up_fielddb_servers_for_new_developers_quick_start.sh">Mac developer script</a>
<pre>
$ cd $HOME/Downloads && curl -O --retry 999 --retry-max-time 0 -C - <a target="_blank" href="https://raw.githubusercontent.com/FieldDB/FieldDB/master/install_mac_download_and_set_up_fielddb_servers_for_new_developers_quick_start.sh">https://raw.githubusercontent.com/FieldDB/FieldDB/master/install_mac_download_and_set_up_fielddb_servers_for_new_developers_quick_start.sh</a> && bash install_mac_download_and_set_up_fielddb_servers_for_new_developers_quick_start.sh
</pre>
</li>
<li>
<a target="_blank" href="https://raw.githubusercontent.com/FieldDB/FieldDB/master/install_linux_download_and_set_up_fielddb_servers_for_new_developers_quick_start.sh">Linux developer script</a>
<pre>
$ cd $HOME/Downloads && wget <a target="_blank" href="https://raw.githubusercontent.com/FieldDB/FieldDB/master/install_linux_download_and_set_up_fielddb_servers_for_new_developers_quick_start.sh">https://raw.githubusercontent.com/FieldDB/FieldDB/master/install_linux_download_and_set_up_fielddb_servers_for_new_developers_quick_start.sh</a> && bash install_linux_download_and_set_up_fielddb_servers_for_new_developers_quick_start.sh
</pre>
</li>
</ul>
<h2>
<a name="core-webservices" class="anchor" href="#core-webservices"><span class="octicon octicon-link"></span></a>Core webservices:</h2>
<ul>
<li>
<a target="_blank" href="https://github.com/FieldDB/AuthenticationWebService">Authentication webservice</a> (for creation of new users and their accounts on the various webservices)</li>
<li>
<a target="_blank" href="https://github.com/FieldDB/FieldDBWebServer">FieldDB Webserver</a> (for public URLs)</li>
<li>
<a target="_blank" href="http://couchdb.apache.org/">Database webservice</a> (we are using pure CouchDB for this webservice)</li>
</ul><h2>
<a name="optional-webservices" class="anchor" href="#optional-webservices"><span class="octicon octicon-link"></span></a>Optional webservices</h2>
<ul>
<li>
<a target="_blank" href="https://github.com/FieldDB/AudioWebService">Audio webservice</a> (for hosting audio files and running processes such as the ProsodyLab's Aligner)</li>
<li>
<a target="_blank" href="https://github.com/FieldDB/LexiconWebService">Lexicon webservice</a> (for search functionality, and glosser functionality if you are a linguist)</li>
</ul>
<h2>
<a name="client-appslibraries" class="anchor" href="#client-appslibraries"><span class="octicon octicon-link"></span></a>Client apps/libraries:</h2>
<p>You might also be interested in the code for some of the client apps which use FieldDB api/corpora.</p>
<ul>
<li>The <a href="https://github.com/FieldDB/FieldDB/tree/master/backbone_client">Prototype</a><br>
<a href="https://cloud.githubusercontent.com/assets/196199/6283103/08d15ce0-b912-11e4-852c-b4c1d9adb243.png" target="_blank"><img src="https://cloud.githubusercontent.com/assets/196199/6283103/08d15ce0-b912-11e4-852c-b4c1d9adb243.png" height="200" style="max-width:100%;"></a>
<a href="https://cloud.githubusercontent.com/assets/196199/6283117/301332ce-b912-11e4-8b7d-99ea1fc83ddf.png" target="_blank"><img src="https://cloud.githubusercontent.com/assets/196199/6283117/301332ce-b912-11e4-8b7d-99ea1fc83ddf.png" height="200" style="max-width:100%;"></a>
</li>
<li>The <a href="https://github.com/FieldDB/FieldDB/tree/master/angular_client/modules/spreadsheet">Spreadsheet</a>
<a href="https://cloud.githubusercontent.com/assets/196199/6282997/7a9048fc-b910-11e4-90f6-709bfa068f1f.png" target="_blank"><img src="https://cloud.githubusercontent.com/assets/196199/6282997/7a9048fc-b910-11e4-90f6-709bfa068f1f.png" alt="screen shot 2015-01-16 at 08 56 53 pm" style="max-width:100%;"></a>
</li>
<li>
<a href="https://github.com/jrwdunham/dative">Dative</a>
<a href="https://raw.githubusercontent.com/jrwdunham/dative/master/dative-screenshot.png" target="_blank"><img src="https://raw.githubusercontent.com/jrwdunham/dative/master/dative-screenshot.png" alt="dative_screenshot" style="max-width:100%;"></a>
</li>
<li>The <a href="https://github.com/ProjetDeRechercheSurLecriture/DyslexDisorthGame">Psycholinguistics Dashboard</a>
<a href="https://cloud.githubusercontent.com/assets/196199/4587030/b0326662-5023-11e4-91fe-596a4a1aa8d0.png" target="_blank"><img src="https://cloud.githubusercontent.com/assets/196199/4587030/b0326662-5023-11e4-91fe-596a4a1aa8d0.png" alt="screen shot 2014-10-09 at 10 17 51 pm" style="max-width:100%;"></a>
</li>
<li>The <a href="https://github.com/ProjetDeRechercheSurLecriture/oprime-montage">Psycholinguistics MontageJS library</a>
<a href="https://cloud.githubusercontent.com/assets/196199/4506891/8bad9030-4b07-11e4-9643-7a3e1748e633.png" target="_blank"><img src="https://cloud.githubusercontent.com/assets/196199/4506891/8bad9030-4b07-11e4-9643-7a3e1748e633.png" alt="screen shot 2014-10-03 at 10 13 41 am" style="max-width:100%;"></a>
</li>
<li>The <a href="https://github.com/FieldDB/FieldDB/tree/master/angular_client/modules/activity">Activity Feed widget</a><br>
<a href="https://cloud.githubusercontent.com/assets/196199/6282469/527dc6b2-b908-11e4-8790-4df19acbd163.png" target="_blank"><img src="https://cloud.githubusercontent.com/assets/196199/6282469/527dc6b2-b908-11e4-8790-4df19acbd163.png" height="200" style="max-width:100%;"></a>
</li>
<li>The <a href="https://github.com/FieldDB/AndroidLanguageLearningClientForFielddb">Learn X app</a>
<a href="https://camo.githubusercontent.com/6150d14667b07bccacbccc29148c76ae11ee4ace/68747470733a2f2f662e636c6f75642e6769746875622e636f6d2f6173736574732f3139363139392f323438333236312f36633465363434322d623066652d313165332d393364662d6537343330393130303537312e706e67" target="_blank"><img src="https://camo.githubusercontent.com/6150d14667b07bccacbccc29148c76ae11ee4ace/68747470733a2f2f662e636c6f75642e6769746875622e636f6d2f6173736574732f3139363139392f323438333236312f36633465363434322d623066652d313165332d393364662d6537343330393130303537312e706e67" alt="learn_x_tablet" data-canonical-src="https://f.cloud.github.com/assets/196199/2483261/6c4e6442-b0fe-11e3-93df-e74309100571.png" style="max-width:100%;"></a>
</li>
<li>The Android <a href="https://github.com/FieldDB/AndroidFieldDBElicitationRecorder">Elicitation Session Recorder</a>
</li>
<li>The Android <a href="https://github.com/batumi/AndroidSpeechRecognitionTrainer">Speech Recognition Trainer App</a><br>
<a href="https://cloud.githubusercontent.com/assets/196199/3277961/25a67bb0-f39d-11e3-8ff2-917b06069261.png" target="_blank"><img src="https://cloud.githubusercontent.com/assets/196199/3277961/25a67bb0-f39d-11e3-8ff2-917b06069261.png" height="200" style="max-width:100%;"></a>
</li>
<li>The <a href="https://github.com/FieldDB/DictionaryChromeExtension">My Dictionary</a> Chrome extension
<a href="https://cloud.githubusercontent.com/assets/196199/6282739/1cb609a0-b90c-11e4-99c1-03a5c4c519e7.png" target="_blank"><img src="https://cloud.githubusercontent.com/assets/196199/6282739/1cb609a0-b90c-11e4-99c1-03a5c4c519e7.png" alt="screen shot 2014-07-08 at 3 56 40 pm" style="max-width:100%;"></a>
</li>
<li>The <a href="https://github.com/FieldDB/FieldDBLexicon">Lexicon Browser</a>
<a href="https://camo.githubusercontent.com/af1d58b8f391df763a3369fda5f895d1c7b675f5/68747470733a2f2f662e636c6f75642e6769746875622e636f6d2f6173736574732f3139363139392f323336363136342f38353535636237302d613666332d313165332d393365632d3134306663616164323239342e706e67" target="_blank"><img src="https://camo.githubusercontent.com/af1d58b8f391df763a3369fda5f895d1c7b675f5/68747470733a2f2f662e636c6f75642e6769746875622e636f6d2f6173736574732f3139363139392f323336363136342f38353535636237302d613666332d313165332d393365632d3134306663616164323239342e706e67" alt="lexicon_browser_dashboard" data-canonical-src="https://f.cloud.github.com/assets/196199/2366164/8555cb70-a6f3-11e3-93ec-140fcaad2294.png" style="max-width:100%;"></a>
</li>
<li>The <a href="https://github.com/FieldDB/FieldDBWordCloudChromeApp">Word Cloud Visualizer</a>
<a href="https://cloud.githubusercontent.com/assets/196199/6282934/6bc5fb10-b90f-11e4-8e4c-8fb9bbf0799f.png" target="_blank"><img src="https://cloud.githubusercontent.com/assets/196199/6282934/6bc5fb10-b90f-11e4-8e4c-8fb9bbf0799f.png" alt="lexicon_browser2" style="max-width:100%;"></a>
</li>
<li>You can <a href="https://github.com/FieldDB/FieldDB/edit/master/README.md">add others</a> if there any missing in this list...</li>
</ul>
</section>
<aside id="sidebar">
<a href="https://npmjs.org/package/fielddb" class="button">
<small>npm </small>
install fielddb
</a>
<a href="#" class="button">
<small>bower</small>
install fielddb
</a>
<p class="repo-owner"><a href="https://github.com/FieldDB/FieldDB"></a> is maintained by <a href="https://github.com/FieldDB">FieldDB</a>.</p>
<p>This page was generated by <a href="https://pages.github.com">GitHub Pages</a> using the Architect theme by <a href="https://twitter.com/jasonlong">Jason Long</a>.</p>
</aside>
</div>
</div>
</body>
</html>