From 5816f987a4f53c08bdb83a0eddc7b4fa532bf15f Mon Sep 17 00:00:00 2001 From: Shulhan Date: Sun, 18 Sep 2022 22:39:17 +0700 Subject: all: gabungkan semua berkas dokumentasi ke dalam direktori doc Catatan perubahan: * Format README diganti dari Markdown ke Asciidoc * Catat sejarah perubahan pada rilis sebelumnya dalam berkas CHANGELOG.adoc * Makefile: tambah perintah untuk melihat dokumentasi menggunakan ciigo --- .gitignore | 1 + Makefile | 5 +- README | 116 +++++++++++++++++++++++++++++ README.adoc | 1 + README.md | 91 ----------------------- doc/CHANGELOG.adoc | 214 +++++++++++++++++++++++++++++++++++++++++++++++++++++ doc/README.adoc | 1 + doc/index.adoc | 17 +++++ 8 files changed, 354 insertions(+), 92 deletions(-) create mode 100644 README create mode 120000 README.adoc delete mode 100644 README.md create mode 100644 doc/CHANGELOG.adoc create mode 120000 doc/README.adoc create mode 100644 doc/index.adoc diff --git a/.gitignore b/.gitignore index 01169f6..7e4fe06 100644 --- a/.gitignore +++ b/.gitignore @@ -1,5 +1,6 @@ ## SPDX-FileCopyrightText: 2015 hunspell-id Authors ## SPDX-License-Identifier: LGPL-3.0-only +*.html hunspell-id.oxt vim/.utf-8.spl vim/en.utf-8.add diff --git a/Makefile b/Makefile index 20f57c0..2e89fe6 100644 --- a/Makefile +++ b/Makefile @@ -1,7 +1,10 @@ ## SPDX-FileCopyrightText: 2022 M. Shulhan ## SPDX-License-Identifier: LGPL-3.0-only -.PHONY: vim-mkspell +.PHONY: vim-mkspell serve-doc vim-mkspell: vim -c "mkspell! ./vim/id id_ID | q" + +serve-doc: + ciigo serve doc diff --git a/README b/README new file mode 100644 index 0000000..5f9302c --- /dev/null +++ b/README @@ -0,0 +1,116 @@ += hunspell-id +:toc: +:sectanchors: +:sectlinks: + +Proyek ini adalah kelanjutan dari ekstensi Kamus Indonesia pada +https://extensions.libreoffice.org/extension-center/indonesian-dictionary-kamus-indonesia-by-benitius/releases/2.0[LibreOffice^]. + +== Pembuatan + +Unduh arsip zip yang terbaru lewat tautan berikut +https://github.com/shuLhan/hunspell-id/archive/master.zip[master.zip^], +atau gandakan dengan `git` + +---- +$ git clone git@github.com:shuLhan/hunspell-id.git +---- + +Jika mengunduh arsip zip, ekstrak berkas zip tersebut. + + +=== Extensi LibreOffice + +Pindah ke direktori sumber repositori, + +---- +$ cd hunspell-id +---- + +Eksekusi skrip `build.sh` pada direktori sumber + +---- +$ ./build.sh +---- + +Skrip tersebut akan menghasilkan berkas `hunspell-id.oxt`. +Buka pengatur berkas, dan klik dua kali pada berkas `hunspell-id.oxt`, nanti +layanan pemasangan ekstensi LibreOffice akan muncul. + + +== Pemasangan + +=== Sistem Operasi GNU/Linux + +Langkah pemasangan secara manual, + +* Login sebagai root. + +* Buat `symlink` dari hasil ekstraksi ke folder sistem hunspell Anda. Contoh, ++ +-- +---- +$ cd /usr/share/hunspell +$ ln -s ~/Downloads/hunspell-id/id_ID.aff +$ ln -s ~/Downloads/hunspell-id/id_ID.dic +---- + +atau buat salinan langsung menggunakan `cp`. +-- + + +=== Paket GNU/Linux + +Arch Linux:: Penggunan Arch dapat memasang paket ini lewat +https://aur.archlinux.org/packages/hunspell-id-git/[AUR^]. + +Solus:: Paket ini dapat dipasang dengan cara, ++ +-- +---- +$ sudo eopkg it hunspell-id` +---- +-- + + +=== Vim + +Buat direktori `$HOME/.vim/spell`, kemudian salin atau buat _symlink_ dari +berkas `vim/id.utf-8.spl` ke dalam direktori tersebut. + + +== Sejarah Pembuatan + +Versi 1.0, 1.1, dan 1.2 diciptakan tahun 2004 dengan bantuan Kurniadi dan +Volker Mueller serta Arno Brevoort, yang menyumbangkan daftar kata mereka +sebagai dasar penyusunan berkas tersebut bagi program MySpell, yang dipakai +oleh OpenOffice.org. +Sesudah itu bertahun-tahun lamanya tidak dikerjakan lagi. + +Tanggal 05 Mei 2009 Ammar Shadiq menuangkan berkas-berkas lama itu dalam +bentuk ekstensi bagi OpenOffice dan mengunggahnya ke sana. +Ekstensi yang sama ini diunggah ke LibreOffice pada tanggal 19 Mei 2012 +sebagai Indonesian dictionary - Kamus Indonesia 1.0. +Viko Adi Rahmawan kemudian menguji ekstensi ini kembali dan pada tanggal 16 +Mei 2014 diterbitkan sebagai Indonesian dictionary - Kamus Indonesia 1.1 bagi +LibreOffice 4.0. + +Versi 2.0 merupakan pengerjaan ulang dari kedua berkas `id_ID.dic` dan +`id_ID.aff` agar lebih sesuai dengan sifat Bahasa Indonesia. +Berkas .aff (affiks) diperbaharui sama sekali, sehingga jauh lebih sesuai +dengan sifat bahasa Indonesia dengan awalan, akhiran dan imbuhan. +Berkas .dic (daftar kata) diperiksa dengan semua lemma dari Kamus Besar Bahasa +Indonesia, edisi 3. +Berkas hyphenator tidak mengalami perubahan. + +== Kredit + +* Benitius Brevoort +* Viko Adi Rahmawan +* Ammar Shadiq +* Arno Brevoort +* Volker Mueller +* Kurniadi + +// SPDX-FileCopyrightText: 2015 hunspell-id Authors +// SPDX-License-Identifier: LGPL-3.0-only diff --git a/README.adoc b/README.adoc new file mode 120000 index 0000000..100b938 --- /dev/null +++ b/README.adoc @@ -0,0 +1 @@ +README \ No newline at end of file diff --git a/README.md b/README.md deleted file mode 100644 index 0202576..0000000 --- a/README.md +++ /dev/null @@ -1,91 +0,0 @@ -Proyek ini adalah kelanjutan dari ekstensi Kamus Indonesia pada -[Libre Office](http://extensions.libreoffice.org/extension-center/indonesian-dictionary-kamus-indonesia-by-benitius/releases/2.0). - -# Pembuatan - -* Unduh sumber repositori lewat - * https://github.com/shuLhan/hunspell-id/archive/master.zip, atau - * gandakan dengan git - ``` - $ git clone git@github.com:shuLhan/hunspell-id.git - ``` -* Jika mengunduh zip, ekstrak berkas zip tersebut. - - -## Extensi untuk LibreOffice - -* Pindah ke direktori sumber repositori -``` -$ cd hunspell-id -``` -* Eksekusi skrip `build.sh` pada direktori sumber -``` -$ ./build.sh -``` -* Skrip tersebut akan menghasilkan berkas `hunspell-id.oxt` di direktori - sekarang. -* Buka pengatur berkas, dan klik dua kali pada berkas `hunspell-id.oxt` - tersebut, maka nanti layanan pemasangan ekstensi LibreOffice akan muncul. - - -# Pemasangan - -## Sistem Operasi GNU/Linux - -* Login sebagai root -* Buat `symlink` dari hasil ekstraksi ke folder sistem hunspell Anda. Contoh, -``` -$ cd /usr/share/hunspell -$ ln -s ~/Downloads/hunspell-id/id_ID.aff -$ ln -s ~/Downloads/hunspell-id/id_ID.dic -``` -* atau buat salinan langsung. - - -## Paket GNU/Linux - -* Arch Linux: https://aur.archlinux.org/packages/hunspell-id-git/ -* Solus: `sudo eopkg it hunspell-id` - - -## Vim - -Buat direktori `$HOME/.vim/spell`, kemudian salin atau buat _symlink_ dari -berkas `vim/id.utf-8.spl` ke dalam direktori tersebut. - - -# Sejarah Pembuatan - -Versi 1.0, 1.1, dan 1.2 diciptakan tahun 2004 dengan bantuan Kurniadi dan -Volker Mueller serta Arno Brevoort, yang menyumbangkan daftar kata mereka -sebagai dasar penyusunan berkas tersebut bagi program MySpell, yang dipakai -oleh OpenOffice.org. -Sesudah itu bertahun-tahun lamanya tidak dikerjakan lagi. - -Tanggal 05 Mei 2009 Ammar Shadiq menuangkan berkas-berkas lama itu dalam -bentuk ekstensi bagi OpenOffice dan mengunggahnya ke sana. -Ekstensi yang sama ini diunggah ke LibreOffice pada tanggal 19 Mei 2012 -sebagai Indonesian dictionary - Kamus Indonesia 1.0. -Viko Adi Rahmawan kemudian menguji ekstensi ini kembali dan pada tanggal 16 -Mei 2014 diterbitkan sebagai Indonesian dictionary - Kamus Indonesia 1.1 bagi -LibreOffice 4.0. - -Versi 2.0 merupakan pengerjaan ulang dari kedua berkas `id_ID.dic` dan -`id_ID.aff` agar lebih sesuai dengan sifat Bahasa Indonesia. -Berkas .aff (affiks) diperbaharui sama sekali, sehingga jauh lebih sesuai -dengan sifat bahasa Indonesia dengan awalan, akhiran dan imbuhan. -Berkas .dic (daftar kata) diperiksa dengan semua lemma dari Kamus Besar Bahasa -Indonesia, edisi 3. -Berkas hyphenator tidak mengalami perubahan. - -# Kredit - -* Benitius Brevoort -* Viko Adi Rahmawan -* Ammar Shadiq -* Arno Brevoort -* Volker Mueller -* Kurniadi - -// SPDX-FileCopyrightText: 2015 hunspell-id Authors -// SPDX-License-Identifier: LGPL-3.0-only diff --git a/doc/CHANGELOG.adoc b/doc/CHANGELOG.adoc new file mode 100644 index 0000000..a0c1927 --- /dev/null +++ b/doc/CHANGELOG.adoc @@ -0,0 +1,214 @@ +// SPDX-FileCopyrightText: 2022 M. Shulhan +// SPDX-License-Identifier: LGPL-3.0-only += hunspell-id Change log +:toc: + +[#v2_2_0] +== Release v2.2.0 (2020-03-03) + +[#v2_2_0_peningkatan_kamus] +=== Peningkatan kamus + +dic: pembaruan semua daftar kata ke versi KBBI Oktober 2019:: +Daftar kata terakhir diambil yaitu 2 Maret 2020. + +Kata dasar baru, + +* binari +* direktori +* ekspektasi: (n) pengharapan +* fitur +* independen: +** (a) yang berdiri sendiri; yang berjiwa bebas +** (a) tidak terikat; merdeka; bebas +* individu +* influen +* instruksi +* jejaring: +** (n) jaring-jaring; jaringan (komunikasi) +** (n Komp) sistem komputer terminal dan pangkalan data yang dihubungkan + dengan saluran telekomunikasi untuk pertukaran data; jaringan +* karakter +* karakteristik +* kueri +* kustomisasi +* milis +* minimalis +* optimasi +* peladen: +** (n) orang yang meladeni; pelayan +** (n Komp) komputer dalam jejaring yang berfungsi sebagai penyedia + layanan ke komputer lain +* peramban +* piksel +* portabilitas +* replikasi +* repositori +* reset +* rinci +* server: (n) peladen +* surel +* templat: (n) format (ukuran, pola, dan sebagainya) yang diacu dalam + pembuatan sesuatu + +Imbuhan baru, + +* abstraksi: di--kan +* acu: di- +* akhir: di- +* analisis: -nya +* argumen: -nya +* autentikasi: di- +* baru: ter--kan +* bulat: di--kan +* definisi: ter-, -kan +* deklarasi: di--kan, pen-, pen--an +* dekode: di-, men-, pen- +* dekompresi: di-, me- +* dependensi: -nya +* efek: -nya +* eja: di- +* eksekusi: di- +* eksekusi: meng- +* eksperimen: ber- +* ekspose: di-, meng-, -nya +* ekspresi: -nya +* ekspresi: di--kan +* elemen: -nya +* fakta: -nya +* format: mem-, -nya +* gabung: di- +* guna:-nya +* hubung: ter- +* ideal: -nya +* identifikasi: meng- +* identifikasi: meng--kan, peng-, ter- +* implemen: di- +* implementasi: di-, di--kan, peng-, -nya +* impor: di- +* indeks: peng--an +* inisiasi: di- +* inisiasi: meng- +* inspeksi: di- +* integrasi: di--kan +* interpretasi: di- +* iring: se- +* iterasi: di-, meng- +* jadwal: pen- +* jalan: -nya +* kapasitas:-nya +* karakteristik: -nya +* kategorisasi: meng- +* kembang: -kan +* kenal: memper--kan +* kompensasi: di-, meng- +* kompilasi: ber-, meng-, peng- +* kompilasi: di-, contoh: sumber kode -- dengan +* komposisi: meng- +* kompres: di-, meng- +* komputasi: di-, meng- +* konstruksi: di-, meng- +* konsumsi: di- +* kontribusi: ber- +* konversi: -nya +* koreksi: di- +* kunci: peng--an +* lacak: di- +* lantun: pe- +* lipat ganda: -kan +* lokasi: -nya +* mampat: pe--an +* migrasi: me-, contoh: saya -- data +* model: pe--an, per--an +* monitor: di- +* normalisasi: di-, me- +* pasti: -kan +* pecah: di- +* perilaku: -nya +* pola: -nya +* prediksi: di- +* program: -nya +* promosi: di--kan +* proses: -nya +* rata: pe--an +* register: di- +* reproduksi: di-, contoh: langkah-langkah yang dapat -- +* rilis: me-, contoh: band itu -- album pertamanya +* senandung: di--kan +* spesifikasi: di--kan, men--kan +* struktur: -nya +* tampil: -an +* tingkat: -kan +* tipe: ber-, -nya +* unduh: di-, peng-, ter-, -an +* unggah: di-, meng- +* urai: meng- +* urut: se--an +* verifikasi: di- +* visualisasi: di--kan + +[#v2_2_0_perubahan_lainnya] +=== Perubahan lainnya + +aur: paket untuk pengguna Arch Linux:: + +aff: move the comment to the top in CIRCUMFIX and NEEDAFFIX:: ++ +-- +On Lucene, the parser for affix file does not allow inline comment in +the options, for example "OPT # comment". + +Fix #6. +-- + +id_ID.aff: tambah dot "." untuk sintaks prefiks dan sufiks tanpa kondisi:: + +vim: berkas spell untuk vim:: ++ +-- +Berkas ini dibuat dengan menggunkan perintah mkspell [1], + + :mkspell ~/.vim/spell/id ~/src/github.com/shuLhan/hunspell-id/id_ID + +Untuk menggunakannya, buat direktori $HOME/.vim/spell, kemudian salin +atau buat tautan dari berkas tersebut ke dalam direktori itu. + +[1] http://vimdoc.sourceforge.net/htmldoc/spell.html#:mkspell +-- + +id_ID.dic: hapus beberapa kata ganda dan urutkan berdasarkan abjad:: + +Add Ubuntu packaging:: + +Tambah cara memasang paket di Solus:: + + +[#v2_1_0] +== Release v2.1.0 (2015-05-24) + +[#v2_1_0_peningkatan_kamus] +=== Peningkatan kamus + +Kata dasar baru: + +* daring +* Jawa +* konten +* unggah + +Imbuhan baru, + +* lulus: ke--an + +[#v2_1_0_perubahan_lainnya] +=== Perubahan lainnya + +Pindahkan berkas id_ID ke root direktori:: + +Ganti nama direktori 'src' menjadi 'libreoffice-extension':: + +Penambahan cara pemasangan di Linux:: + +Perbaikan prefiks untuk awalan pe- yang melebur jadi pem- bila diawali p:: +Sebelumnya kata dengan dua konsonan 'pr' tidak dilebur. +Contoh: pemrograman, bukan pemprograman. diff --git a/doc/README.adoc b/doc/README.adoc new file mode 120000 index 0000000..59a23c4 --- /dev/null +++ b/doc/README.adoc @@ -0,0 +1 @@ +../README \ No newline at end of file diff --git a/doc/index.adoc b/doc/index.adoc new file mode 100644 index 0000000..ea7f88b --- /dev/null +++ b/doc/index.adoc @@ -0,0 +1,17 @@ +// SPDX-FileCopyrightText: 2022 M. Shulhan +// SPDX-License-Identifier: LGPL-3.0-only += hunspell-id + +== Documentation + +link:README.html[README^]:: Documentation about the project and development. + +link:CHANGELOG.html[CHANGELOG^]:: History of changes on each release. + +== Development + +https://github.com/shuLhan/hunspell-id[Repository^]:: +Link to the source code. + +https://github.com/shuLhan/hunspell-id/issues[Issues^]:: +Link to open an issue or request for new feature. -- cgit v1.3