kamus-banjar-api

README

Kamus Banjar API

Tujuan dari proyek ini adalah membuat API untuk kamus Bahasa Banjar-Indonesia, yang memberikan pengguna kemampuan untuk menerjemahkan kata dari Bahasa Banjar ke Bahasa Indonesia.

Baca dengan bahasa lain: English.

Tentang Bahasa Banjar

Salah satu provinsi di pulau Kalimantan adalah Kalimantan Selatan (Kalsel). Hampir seluruh wilayah Kalsel dihuni oleh orang Banjar. Bahasa Banjar (BB) bagi masyarakat Banjar merupakan bahasa pengantar yang berfungsi sebagai alat komunikasi sehari-hari.

Bahasa Banjar dalam penyebarannya tidak hanya dikenal di wilayah Kalsel saja, tetapi juga di pesisir Kalimantan Tengah (Kalteng) dan Kalimantan Timur (Kaltim) bahkan sampai di sebagian kecil daerah Sumatera, seperti Muara Tungkal, Sapat, dan Tambilahan.

Bahasa Banjar memiliki dua dialek, yaitu Banjar Dialek Hulu dan Banjar Kuala. Ada sebagian fonem maupun kosakata Bahasa Banjar Dialek Hulu (BBDH) yang memiliki persamaan dan kemiripan dengan Bahasa Indonesia (BI) meski kedudukannya berbeda.

Persamaan fonem dan kosakata antara BBDH dan BI, contohnya,

BI	BBDH
lambat	lambat
kayu	kayu
malam	malam
makan	makan

Kemiripan fonem dan kosakata antara BBDH dan BI, contohnya,

BI	BBDH
beri	bari
hari	ari
lubang	luwang
meja	mija

Berdasarkan pengamatan di atas, antara BBDH dan BI sama-sama mengenal vokal [a], [i], dan [u]. Selain itu, kemiripan dari segi pengungkapan mengarah kepada fonem tertentu yang terdapat pada kosakata BBDH dan BI, contohnya makna hari yang dalam BI tulisan dan pengungkapannya hari sedang dalam BBDH ari.

Selain hal-hal yang telah dikemukakan, antara BBDH dan BI sebagai dua buah bahasa memiliki perbedaan, contohnya,

BI	BBDH
cantik	bungas
mampu	kawa
arah	ampah
luas	ligar

Sebagian besar kosakata yang terdapat dalam BI memang tidak terdapat dalam BBDH begitu pula sebaliknya. Tentu saja perbedaan antara BBDH dan BI ini tidak terhitung banyaknya selain persamaan dan kemiripan yang juga tidak bisa diindahkan keberadaannya.

Abjad dan Ejaan

Penulisan entri dalam kamus ini disusun secara alfabetis, berurutan dari kata dasar, kata berimbuhan, kata berulang, dan frasa (gabungan kata). Pemenggalan suku kata berdasarkan Pedoman Umum Ejaan Bahasa Indonesia yang Disempurnakan. Ditambah dengan sebagian contoh penggunaan kosakatanya, serta penjelasan secara singkat mengenai fonologi dan morfologi BBDH. Bagi huruf yang dimasukkan ke dalam tanda kurung (...) menunjukkan bahwa huruf tersebut tidak dipakai dalam penulisan BBDH. Adapun abjadnya sebagai berikut,

• a
• b
• c
• d
• (e)
• (f)
• g
• h
• i
• j
• k
• l
• m
• n/ng-ny
• (o)
• p
• (q)
• r
• s
• t
• u
• (v)
• w
• y
• (z)

Fonem Bahasa Banjar

Jenis Nomor	Simbol Fonetis	Ejaan	Contoh Pemakaian Dalam Tiga Posisi
			Awal	Tengah	Akhir
Vokal
1	[a]	a	abut `ribut`	baang `azan`	tatamba `obat`
2	[i]	i	isuk `besok`	kipit `sempit`	jariji `jemari`
3	[u]	u	umpat `ikut`	juhut `tarik`	sangu `bekal`
Vokal Rangkap
4	[au]	aw	-	-	silau `silau`
5	[ai]	ay	-	saitan `setan`	wadai `kue`
6	[ui]	uy	-	-	rupui `keropos`
Konsonan
7	[p]	p	payu `laku`	supan `malu`	sumap `kukus`
8	[b]	b	balu `janda`	hupan `uban`	-
9	[t]	t	talu `tiga`	matan `dari`	kipit `sempit`
10	[d]	d	dawa `tuduh`	padu `dapur`	-
11	[c]	c	caluk `rogoh`	pacang `bakal`	-
12	[j]	j	jangkau `raih`	jajak `injak	-
13	[k]	k	katup `tutup`	lakas `cepat`	patak `kubur`
14	[g]	g	gampir `kembar`	aga `gagap`	-
15	[m]	m	muar `benci`	ampun `milik`	anum `muda`
16	[n]	n	nahap `mantap`	kanas `nanas`	karangan `pasir`
17	[ŋ]	ng	ngalih `susah`	tangguh `tebak`	lading `pisau`
18	[ɲ]	ny	nyiru `nyiru`	hanyar `baru`	-
19	[s]	s	surui `sisir`	rasuk `cocok`	batis `kaki`
20	[h]	h	halar `sayap`	muha `muka`	lapah `capek`
21	[l]	l	licak `becek`	talah `habis`	ganal `besar`
22	[r]	r	rumbis `bocor`	sarak `cerai`	kitar `geser`
23	[w]	w	wadah `tempat`	kawa `mampu`	-
24	[y]	y	yuta `juta`	uyah `garam`	-

Bentuk Persukuan

Maksud bentuk persukuan di sini adalah struktur suku kata (silabel) dalam BBDH. Bentuk persukuan entri pokok, imbuhan atau reduplikasi adalah sebagai berikut:

• Entri Pokok

  V = Vokal | K = Konsonan

  Yang bersuku dua:

  Susunan	Kata
  VKV	una 'sentuh'
  VKVK	amun 'jika'
  KVKV	saku 'mungkin'
  KVKVK	tagal 'tetapi'
  KVKKVK	limbui 'kuyup'

  Yang bersuku tiga:

  Susunan	Kata
  KVKVKV	wahini 'sekarang'
  KVKVKVK	karukut 'cakar'
  KVKVKKV	kalambu 'kelambu'
  KVKKVKV	hintalu 'telur'
  KVKKVKVK	tantaran 'jorang'
  KVKVKKVK	karamput 'bohong'
  KVKKVKVK	bungkalang 'keranjang buah'

• Imbuhan

  Bentuk imbuhan BBDH terdiri atas KV-, dan -KVK, -VK, -V, -VKVK seperti awalan ma-, ba-, ta-, sa-, ka-, pa-, misalnya:

  Imbuhan	Kata Dasar	Kata Berimbuhan
  ma-	bari 'beri'	mambari 'memberi'
  ba-	jariji 'jemari'	bajariji 'berjemari'
  ta-	rumpak 'tabrak'	tarumpak 'tertabrak'
  sa-	bujur 'benar'	sabujurnya 'sebenarnya'
  ka-	handak 'pendek'	kehandapan 'kependekan'
  pa-	uncit 'terakhir'	pauncitnya 'paling terakhir'

  Imbuhan ka-an memiliki makna superlatif, misalnya:

  Imbuhan	Kata Dasar	Kata Berimbuhan
  ka-an	handak 'ingin'	kahandakan 'terlalu ingin'

  ta- bisa melekati verba, adjektifa, dan nomina, misalnya

  Imbuhan	Kata Dasar	Kata Berimbuhan
  ta-	pukul 'pukul'	tapukul 'terpukul'
  ta-	bungas 'cantik'	tabungas 'lebih cantik'
  ta-	unjun 'kail'	taunjun 'terpancing'
  ta-	akal 'akal'	taakal 'lebih berakal'

  pa-+-nya dan pa-+nasal+-nya memiliki makna superlatif, misalnya

  Imbuhan	Kata Dasar	Kata Berimbuhan
  pa-+-nya	lambat 'lambat'	palambatnya 'paling lambat'
  pa-+-nya	pintar 'pintar'	pamintarnya 'paling pintar'
  pa-+-nya	dikit 'dikit'	pandikitnya 'paling sedikit'
  pa-+-nya	sabak 'berantakan'	panyabaknya 'paling berantakan'
  pa-+-nya	kurus 'kurus'	pangurusnya 'paling kurus'

  dan seperti akhiran: -an, -i, -akan, misalnya

  Imbuhan	Kata Dasar	Kata Berimbuhan
  -an	bulik 'pulang'	bulikan 'pada pulang'
  -i	parak 'dekat'	paraki 'dekati'
  -akan	surui 'sisir'	suruiakan 'sisirkan'

• Reduplikasi

  Bentuk reduplikasi dalam BBDH berbentuk dwipurwa atau pengulangan sebagian atau seluruh suku kata awal sebuah kata, misalnya

  Kata Dasar	Reduplikasi
  ranai 'diam'	raranai 'diam-diam'
  handap 'pendek'	hahandap 'pendek-pendek'

  selain itu ada sebagian yang harus berakhiran -an, sehingga memiliki makna jamak, misalnya

  Kata Dasar	Reduplikasi
  umpat 'ikut'	uumpatan 'ikut-ikutan'
  ingat 'ingat'	iingatan 'yang diingat-ingat'

Singkatan

Singkatan	Kepanjangan
a	adjektiva
n	nomina
pro	pronomina
adv	adverbia
v	verba
p	partikel

Prasyarat

Proyek ini dibangun menggunakan Go version 1.22.2, dan diharapkan untuk dikembangkan menggunakan versi Golang yang serupa untuk mendapatkan hasil sesuai harapan.

Cara Menjalankan

• Instalasikan dependensi proyek menggunakan perintah go mod download.
• Jalankan proyek dengan perintah go run . atau go run main.go.

Cara Membuat File Biner

Jalankan perintah berikut untuk membuat file biner:

go build -ldflags "-s -w" -o ./out .

Kemudian jalankan menggunakan perintah ./out.

Penggunaan

[GET] /api/v1/alphabets

Mengembalikan semua daftar alfabet.

Respon sukses

Respon akan dikembalikan dalam bentuk JSON. Contohnya:

{
  "code": 200,
  "data": [
    {
      "letter": "a",
      "total": 3
    }
  ],
  "message": "All alphabets successfully retrieved.",
  "status": "success"
}

Error response

Respon akan dikembalikan dalam bentuk JSON juga jika terdapat eror. Contohnya:

{
    "code": 500,
    "message": "Internal Server Error",
    "status": "error"
}

[GET] /api/v1/alphabets/{letter}

Mengembalikan daftar kosakata bahasa Banjar berdasarkan alfabet yang diberikan.

Parameters

Name	Keberadaan	Tipe	Deskripsi
letter	wajib	param	Huruf alfabet

Respon sukses

Respon akan dikembalikan dalam bentuk JSON. Contohnya:

{
  "code": 200,
  "data": {
    "letter": "a",
    "total": 3,
    "words": [
      "abadan",
      "abah",
      "abat"
    ]
  },
  "message": "All words with letter 'a' successfully retrieved.",
  "status": "success"
}

Error response

Respon akan dikembalikan dalam bentuk JSON juga jika terdapat eror. Contohnya:

{
  "code": 400,
  "message": "alphabet only has one character",
  "status": "error"
}

[GET] /api/v1/entries/{word}

Mengembalikan definisi dan arti dari kosakata bahasa Banjar yang diberikan.

Parameters

Name	Keberadaan	Tipe	Deskripsi
word	wajib	param	kosakata bahasa Banjar.

Respon sukses

Respon akan dikembalikan dalam bentuk JSON. Contohnya:

{
  "code": 200,
  "data": {
    "word": "abah",
    "alphabet": "a",
    "meanings": [
      {
        "definitions": [
          {
            "definition": "ayah",
            "partOfSpeech": "n"
          },
          {
            "definition": "mertua laki-laki",
            "partOfSpeech": "n"
          }
        ]
      }
    ],
    "derivatives": [
      {
        "word": "baabah",
        "syllables": "ba.a.bah",
        "definitions": [
          {
            "definition": "berayah; menyebut ayah",
            "partOfSpeech": "v",
            "examples": [
              {
                "bjn": "inya kada baabah",
                "id": "dia tidak berayah"
              }
            ]
          }
        ]
      }
    ]
  },
  "message": "Definition of word 'abah' successfully retrieved.",
  "status": "success"
}

Error response

Respon akan dikembalikan dalam bentuk JSON juga jika terdapat eror. Contohnya:

{
  "code": 404,
  "message": "the word is not found",
  "status": "error"
}

Daftar Pustaka

• Departemen Pendidikan Nasional, Pusat Bahasa, Balai Bahasa Banjarmasin. 2008. Kamus Bahasa Banjar Dialek Hulu-Indonesia. Banjarbaru.
• Pusat Pembinaan dan Pengembangan Bahasa, Departemen Pendidikan dan Kebudayaan. 1977. Kamus Banjar-Indonesia. Jakarta.

Lisensi

Kamus Banjar API adalah perangkat lunak open-source yang dilisensikan di bawah lisensi MIT license.