Wondering what’s next for npm?Check out our public roadmap! »

    akarata
    TypeScript icon, indicating that this package has built-in type declarations

    0.2.1 • Public • Published

    Akarata

    Build Status codecov npm

    README English version

    Akarata adalah pustaka JavaScript untuk mengambil akar kata/suku kata(stem) dari kata yang berimbuhan awal ataupun akhir pada bahasa Indonesia. Akarata diambil dari kata "akar kata", agar lebih pendek saat penyebutannya.

    Akarata diilhami dari stem kata bahasa Indonesia berdasarkan Porter Stemmer, dengan menggunakan algoritma yang dipaparkan dalam paper A Study of Stemming Effects on Information Retrieval in Bahasa Indonesia, oleh Fadillah Z Tala.

    Akarata dibuat secara umum bisa berjalan di server menggunakan Node.js maupun di browser terbaru bahkan di react-native -pun bisa. Namun perlu memperhatikan kompatibilitas dari platform tersebut. Cek di Kompatibilitas fungsi

    Dibutuhkan

    tslib >= 1.9.0

    Instalasi

    npm:

    npm install --save tslib akarata
    

    yarn:

    yarn add tslib akarata
    

    Kompatibilitas fungsi

    Karena akarata di dalam fungsinya menggunakan Array.includes. Maka jika anda menggunakan akarata pada Node.js versi 4, browser Edge < v14, IE, Chrome < v47, Firefox < 43, Safari < v9 dan lain-lain(lihat tabel) maka membutuhkan polyfill. Untuk caranya bisa lihat di bagian Menambah polyfill

    Menambah polyfill

    Lewati langkah ini jika platform didukung.

    Menggunakan npm:

    npm i ts-polyfill
    

    Menggunakan yarn:

    yarn add ts-polyfill
    

    Gunakan polyfill

    Muat ini sebelum memuat pustaka akarata, biasanya taruh diatasnya.

    pada node.js:

    require('ts-polyfill/lib/es2016-array-include');
    

    pada ES2015+ / Babel / TypeScript:

    import 'ts-polyfill/lib/es2016-array-include';
    

    Hanya menggunakan script tag:

    Jika tidak ingin melakukan instalasi ts-polyfill. Maka salin kode yang ada di dokumentasi polyfill

    <script type="javascript">
      // salin kode disini
    <script>
    

    Penggunaan

    Muat pustaka akarata

    ES2015+ / Babel / TypeScript:

    // muat pustakanya
    import * as akarata from 'akarata';
    // or
    import akarata from 'akarata';
    

    CommonJS/ UMD / NodeJS:

    // muat pustakanya
    var akarata = require('akarata');
    

    Michael Jackson script/ MJS / NodeJS experimental-modules:

    // muat pustakanya
    import * as akarata from 'akarata';
    // or
    import akarata from 'akarata';
    

    unpkg.com:

    // sejak akarata versi > 0.1.5
    // unpkg.com/:package@:version/:file
    // catatan `.min` menandakan versi kompres-nya
    // sebagai contoh
    import * as akarata from 'https://unpkg.com/akarata@0.2.0/bundles/index.esm.js';
    // atau
    import akarata from 'https://unpkg.com/akarata@0.2.0/bundles/index.esm.min.js';
    
    // atau url absolut, secara implisit ke bundles/index.umd.js
    import akarata from 'https://unpkg.com/akarata';
    

    Kemudian bisa digunakan:

    // panggil fungsi stem
    akarata.stem('menikah'); // nikah
    

    Atau mencobanya langsung dari web: akarata.netlify.com.

    Masalah

    Karena pustaka ini masih tahap development, jika diketahui ada masalah silakan buat tiket baru

    Berkontribusi

    Awalnya, pustaka ini merupakan implementasi dari sistem penganalisis untuk Bahasa Indonesia, dari proyek Apache Lucene, ke dalam bahasa JavaScript.

    Referensi

    1. Situs Resmi Kamus Bahasa Indonesia
    2. Untuk mencari dan memverifikasi kata Bahasa Indonesia, Kateglo Bahtera
    3. Artikel Wikipedia yang berjudul Prefiks dalam Bahasa Indonesia

    Langkah-langkah

    1. Proyek ini membutuhkan versi Node.js >= 8.5
    2. Fork proyek ini
    3. Buat branch untuk fitur Anda (git checkout -b my-new-feature)
    4. Buat tes kasus untuk fitur anda pada folder __tests__ dan jalankan npm test
    5. Commit perubahan-perubahan yang Anda buat (git commit -am 'Tambahkan fitur baru')
    6. Push ke branch itu (git push origin my-new-feature)
    7. Ajukan Pull Request baru

    Terima kasih

    Setelah bersyukur kepada Allah Subhanahu Wa Ta'ala, kami ingin mengucapkan terima kasih kepada:

    • Fadillah Z Tala & Apache Lucene sehingga kami dapat mulai membuat pustaka ini
    • Penyedia Kateglo Bahtera, karena telah menyediakan API nya sehingga saya bisa memilih & memisahkan kata-kata ambigu, dan akhirnya memeriksa validitas hasil kata.
    • Adinda Praditya & Indonesian Stemmer. Beliau sebagai coach dan berkat pustakanya maka pustaka ini bisa diimplementasi ke dalam bahasa JavaScript.

    Install

    npm i akarata

    DownloadsWeekly Downloads

    12

    Version

    0.2.1

    License

    MIT

    Unpacked Size

    1.56 MB

    Total Files

    135

    Last publish

    Collaborators

    • avatar