Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bluzi/name-db
:rocket: A multilingual collection of names from around the world
https://github.com/bluzi/name-db
data language names translations
Last synced: about 1 month ago
JSON representation
:rocket: A multilingual collection of names from around the world
- Host: GitHub
- URL: https://github.com/bluzi/name-db
- Owner: bluzi
- License: mit
- Created: 2017-10-23T21:57:52.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2024-03-26T16:53:37.000Z (6 months ago)
- Last Synced: 2024-07-17T15:44:06.456Z (2 months ago)
- Topics: data, language, names, translations
- Language: JavaScript
- Homepage:
- Size: 466 KB
- Stars: 59
- Watchers: 7
- Forks: 230
- Open Issues: 100
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://travis-ci.org/bluzi/name-db)
# name-db
> `name-db` is a collection of names in all languages. Our goal is to collect as much data as we can, and to provide an open-source free API for name translations.
## Specs
*name-db* currently stores only **first names**.
Each name is stored in a JSON file, located in `collection/`. The following is the structure of a name file:
**`collection/{lowercase name}.json:`**
```js
{
"name": "", // English name, lowercase, coresponding to the filename
"meaning": "", // The meaning of the name, in English
"aliases": [], // An array of lowercase alias names, such as: richard -> dick, daniel -> dan, etc.
"translations": {
"{lowercase ISO-639-3 language code}": "{translation}"
},
"sex": "" // (Optional) Gender of the name. Use a single, lowercase letter: `m` for male, `f` for female or `u` for unisex (names that can be male or female).
}
```
**Example:**
**`collections/jonathan.json`**
```js
{
"name": "jonathan",
"meaning": "Hebrew for \"YHWH has given\"",
"aliases": [
"johnathan",
"john",
"yonathan"
],
"translations": {
"heb": "ג'ונתן"
},
"sex": "m"
}
```
The language codes are [ISO 639-3](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) codes. For a list of language codes, please see: https://en.wikipedia.org/wiki/List_of_ISO_639-3_codes
> Note that everything except the translations should be in English.
## API
The API is still under development, but you can see the latest stable version [here](http://54.161.117.62/david)
Note that you shouldn't use it in production yet - We still don't have enough data, and the endpoint is running on a cheap machine.
Feel free to [view the code](https://github.com/bluzi/name-db/tree/master/api), suggest features or create new features with a pull request - we're looking for help with the API.
## Contribution (Easy PR, large impact!)
Making a contribution is real easy - just read the specs, and do one of these:
- Add your/a name (if it doesn't exist yet)
- Add a translation to existing name
- Add meanings to existing names
- Correct translations / meanings
- Come up with a way we can do things better, and [create an issue](https://github.com/bluzi/name-db/issues)
**Also, feel free to take a few aliases that doesn't have a file, and create their files.**
**Just fork the repository, do one of the tasks above, make a pull request and we'll approve it.**
## License
This project is licensed under the MIT License.