Wednesday, August 26, 2015

4.3 Features (1) – Partial sync

I was surprised that some of you have so many bookmarks, notes, highlights or labels! I saw some with more than 20000 items. Seeing that the data are so many, it made us happy because it means that the app is used so frequently.

When we tried to create the syncing feature, we didn't expect that users create so much data on the Quick Bible app. Every time a sync is performed, all unsynced data is sent from the device to the server. The data transferred becomes so large, reaching 1 to 3 MB. But the worst thing is, after the server receives the data, since there are so many items, the server times out before all data is stored, or the database on the server reports error because there are too many things written in a single transaction.

So we tried to overcome this by using another approach from the client side. Instead of sending all unsynced data, it sends them in chunks. Each time a sync is performed, the device only sends maximum of 100 new markers or labels.

So, if you already have so many data on your device, and you just signed up for Sync, you will see on the Sync settings that the revision number goes up by 100 at a time. Hopefully this makes sync better. Please let us know if it still fails.


Ternyata ada beberapa orang yang pembatas buku, catatan, sorotan atau labelnya banyak sekali! Saya pernah melihat ada yang memiliki hingga 20000 lebih. Kami senang melihat banyaknya data itu, karena berarti aplikasi Alkitab digunakan begitu sering.

Ketika kami membuat fitur sync, kami tidak menyangka ada pengguna yang membuat sebegitu banyak data di dalam aplikasi Alkitab. Setiap kali sync berjalan, semua data yang belum disync dikirim dari perangkat ke server. Jumlah data yang ditransfer menjadi sangat besar, mencapai 1–3 MB. Hal yang terburuk adalah ketika server menerima data yang banyak itu, server tidak dapat memprosesnya dalam waktu yang ditetapkan (1 menit) atau database di server menolak menyimpan data karena ada terlalu banyak operasi tulis dalam satu transaksi.

Maka kami berusaha mengatasi ini dengan cara lain dari sisi klien. Daripada mengirim semua data yang belum disync sekaligus, klien mengirim sebagian-sebagian saja, maksimum 100 marka atau label baru.

Jadi, kalau data dalam perangkat Anda sudah banyak sekali, dan Anda baru saja memakai fitur Sync, anda akan melihat nomor revisi pada layar Pengaturan Sync menaik 100 demi 100. Semoga hal ini membuat sync berjalan lebih baik. Kabarkan pada kami jika belum berhasil baik.

Monday, August 3, 2015

Bible Reading Plan

We know that reading and understanding the Bible is very important. To be able to understand the Bible properly, we need to understand the context of the passage that we read. Thus, many people advise to have a planned Bible reading and not to pick only the verses that you want to read. By this Bible reading plan the reader is expected to understand the outline of the Bible more clearly.

In the newly released Bible app, we now have a new reading plan menu. Currently it provides you with several reading plans:
  1. Bible Plan Gospels. Duration: 30 days. Only read all the Gospels.
  2. Bible Plan Psalms. Duration 31 days. Only read Psalms.
  3. Bible Plan Proverbs. Duration 31 days. Only read Proverbs.
  4. Blue Letter One Year Historical Plan, Duration 1 year. OT was ordered by Hebrew canon, NT was ordered by the time they were written.
  5. Blue Letter OT and NT. Duration 2 years. Read OT and NT daily.
  6. Blue Letter One Year Canonical. Duration 1 year. Read from cover to cover.
  7. M’Cheyne Bible Reading Plan. Duration 1 year. Daily read OT, NT, Psalms or Gospels.
  8. ESV Every Day in the Word. Duration: 365 days. Every day you will read Old Testament, New Testament, Psalms and Proverbs.
  9. ESV Daily Reading Bible. Duration 1 year. Every day OT, NT and Psalms.
  10. ESV Through the Bible in a Year Reading Plan. Duration 1 year. Every day OT and NT.
  11. Back To The Bible Chronological Reading Bible. Duration 1 year. Chronologically ordered.

This feature also helps you to save your progress by marking whenever you finish your daily reading.

To start using this reading plan. You need to go to Menu - Reading plan, you will see this screen:

You have to download the reading plan before you start using it. After you click "Download", a dialog will appear:

This is the selection of reading plans available as I already listed above. The list is complete with the description of each plans and its duration. From this dialog, you have to select one plan to start with. Let say you pick M'Cheyne Bible Reading Plan, you will get this screen:


On the title bar, we can see the title of the plan that you selected. You can download as many plans as you want, but it will not allow you to select the same plan you already downloaded. The title is actually a dropdown list, so if you really want to use some plans, you can choose the plan from the dropdown.
The screen above clearly shows that Nov 21 2013 is day 1 and today you have 4 passages you have to read. You can navigate to next day or previous day if you want to see your plan day by day or you can click "Show details" to show you the long list of your plan in one screen.

Now if you want to read today readings, you need to click today passage list (ex: Genesis 1; in the screen above). It will immediately open the Bible with the interface that you already familiar with.

This screen is the same screen that you normally see when you read the Bible. Nothing you need to learn here except that additional floating menu below. This reading plan menu will disappear in a few seconds and you can awake it up by scrolling.
The left and right navigation buttons is for you to go to the next reading in your selection day. If you finish reading it, you may check the check box, if you want to go back to the reading plan screen, you can tap the button in the middle (the one with the description). If you want to close you can tap the cross button.
While you are using this reading mode, you still can navigate to other chapter that are not in the reading plan using the left and right button as normal but the verse will be shaded . For example today reading is Genesis 1, but you are very curious about Genesis 2. It will look like this:

If you insist to read this chapter, you need to close the menu and it will clear the shading.

Lets go back to the reading plan screen, if you mark the reading, it will be reflected in the screen and you can see your progress by looking at the progress bar indicator.

The green is your actual progress. When you mark the reading, the green bar will increase. The red one is indicating how much you are left behind. For example as displayed above you have finished 9.66% from all readings you have to read in this plan. This number is reflected as the green bar. Until today, you have to read around 11.23%. It means you are left behind by 1.58%. This number is reflected as the red bar.

To read the whole bible in one year is not easy. Maybe you need to read around four chapters each day and if for some good reasons you are left behind and cannot catch up the target, you may want to realign your plan. You can do this by select the menu and select "Catch me up". This menu will move your last fully read day to yesterday or in another word your first unread reading will become today. So today you have to read the first unread reading. For example in the figure above today I have to read Genesis 43, Mark 13, Job 9 and Roman 13. But actually I have not started read Job yet. I even was stuck in Nehemiah 10. After I select "Catch me up" menu, I will get this screen.
If you compare the previous screen with this screen, you may notice that initially 21 November 2013 is day 41 but now it become day 20 and only left behind by 0.07%.
However you have to use it sparingly as you may see from the screen above, I reversed 21 days, and for 21 days I will only read 1 chapter. After these 21 days, it will be very hard for you to start reading 4 chapters each day again and maybe you will have forgotten that Genesis 43.

Currently it does not have any reminder for you to read your bible. For now you can use bible reminder from Devotion menu if you really need a reminder.

This reading plan menu is only a feature to keep track what you have read. Make sure you choose the best plan for you and feel comfortable with the plan because reading the whole bible in a year or two will not benefit much if you only read for the sake of finishing the bible. Lastly if you have another good reading plan please share with us so we can add in the future.




Thursday, July 2, 2015

4.2 Features (6) - Reading Plan progress synchronization and other enhancements

Setelah beberapa kali percobaan, kami akhirnya mempublikasikan fitur sync Rencana baca untuk Alkitab/Quick Bible v4.2 Beta 5.

Yang di sync adalah progres kemajuan. yaitu tanggal mulai, dan checkbox yang menunjukkan bagian mana saja yang sudah anda baca. Anda masih perlu mengunduh Rencana baca yang dipakai di segala perangkat anda yang ingin di-sync.

Sekarang anda juga bisa mengubah tanggal mulai Rencana baca semau anda. Ada pengguna yang meminta supaya ia bisa memulai rencana baca tidak dari awal (karena sebelumnya ia sudah melakukannya). Dengan perubahan ini, anda bisa mengatur kapan anda mulai, dan akan di-sync di perangkat anda yang lain.


Jika anda menghapus rencana baca yang sedang dipakai, checkmarks akan tetap disimpan di dalam perangkat. Jadi jika anda mengunduh rencana baca yang sama, anda tetap bisa melanjutkan kembali pembacaan dari hari yang terakhir dibaca. Jika checkmark otomatis dihapus, perangkat lain akan mengira anda dengan sengaja menghapusnya, namun mungkin anda ingin melanjutkan pembacaan.
Jadi apabila anda memang ingin mengulang kembali pembacaan dari awal, anda bisa membuka menu drawer kiri rencana baca, dan pilih Restart.



Apakah mungkin terjadi konflik dalam sync Rencana baca? Ya, mungkin saja terjadi, untuk tanggal mulai, namun tidak untuk checkmarks. Jika anda mengubah tanggal mulai di 2 perangkat yang berbeda (sebelum sync dimulai), data akan ditumpuk, disesuaikan dengan yang paling terakhir disync. Untuk checkmarks, menurut penilaian kami, tidak mungkin terjadi konflik, jika itu berdasarkan revisi yang sama.

Apakah versi BETA itu? Bagaimana cara mengunduhnya?
Lihat di halaman ini untuk penjelasannya.



After some testing, we finally release the Reading plan progress sync in Alkitab/Quick Bible v4.2 Beta 5.

This do not synchronize the reading plan itself, only the progress, which is the starting date, and the checkmarks that indicate which readings you have done. You still need to download the reading plans on all your devices.

Now you can also change the starting date for a reading plan arbitrarily. Once a user asks whether he can start a year-length reading plan from the middle, not starting from Day 1, but starting on the middle as well. With this, you can manually set the starting date to be January 1, and you will start at Day Something according to the day of the year of that day. If you change the starting date, it will be synced to other devices as well.


If you delete a reading plan with some checkmarks, the checkmarks are now still stored in the device. So, the next time you add the same reading plan, you will get the checkmarks again. This is to facilitate syncing the reading plan progress. If the checkmarks were deleted when you delete a reading plan, other devices might receive it as clearing all the checkmarks for all readings of the reading plan, which is incorrect, because you may want to keep the reading plan on the other device. So how do you remove all the checkmarks, in case you want to repeat a reading plan? Open the left drawer, and select Restart. The changes will be synced too, so your other devices will get all checkmarks cleared for this particular reading plan.



Is it possible to have conflicts during sync? The answer is yes, for starting date, but no for the checkmarks. If you change the starting date of a reading plan on two devices separately (before any of them has the chance of syncing), you will get the starting date based on the device that syncs last. As for checkmarks, according to our experiments, you can't have conflicting state, if both devices are based on the same revision. Any time you remove a checkmark for a reading on one device, you can only have two possible operations on the other device, which are, not doing anything, or removing it too. Either way, you will get the checkmark removed after syncing. The same goes for adding. This will behave differently when you have two devices at a different revision. But hopefully this should be sufficient.

What is BETA version? And how to download it?
Take a look at this page for the answers.

Friday, June 26, 2015

4.2 Features (5) - Truly night mode

Biasanya, ketika anda memilih mode gelap, tampilan yang berubah hanya isi, sedangkan action bar/app bar di bagian atas dan bar belah tetap berwarna biru abu. Ini membuat mode gelap tidak begitu gelap. Sekarang, ketika anda memilih mode gelap, segala bagian dalam aplikasi berubah warna untuk mengikuti tampilan mode gelap, sehingga anda lebih nyaman membaca di ruangan gelap.

mode biasa
mode gelap


Apakah versi BETA itu? Bagaimana cara mengunduhnya?
Lihat di halaman ini untuk penjelasannya.



When you activate the night mode, the action bar (the bar on the top) and the split-version handle color is still the default blue grey color. This makes the night mode not-so-night mode. Now, when the night mode is on, the action bar color and split handle color will become almost black. So you can read more comfortably in a dark room.

normal mode
night mode

What is BETA version? And how to download it?
Take a look at this page for the answers.

4.2 Features (4) - Sharing URL

Ketika anda membagikan ayat (terutama melalui facebook), versi Alkitab yang akan ditampilkan mungkin berbeda dengan yang anda ingin bagikan. Contohnya, ketika anda membagikan ayat dari NIV, link yang diklik oleh orang lain melihat ayat yang anda bagikan mungkin akan menampilkan versi KJV atau yang lain. Alasannya, karena facebook hanya menerima direct link ketika membagikan sesuatu, dan link itu akan menuju ke halaman web yang menampilkan teks Alkitab. Ini menjadi masalah jika halaman web tersebut tidak menyediakan versi Alkitab yang sama seperti yang ingin anda bagikan.

Sekarang, ketika anda membagikan ayat, aplikasi ini akan membuat link otomatis untuk menampilkan versi Alkitab yang sesuai, karena teks-nya akan disimpan di dalam server kami. Jadi ketika anda menyalin dan membagi ayat, aplikasi ini otomatis menambahkan link untuk melihat ayat tersebut di halaman web.

Namun, jika anda ingin mematikan link tersebut, anda bisa ke penggunaan > Salin dan bagikan > matikan "link bagi ayat".

tampilan web link bagi ayat
opsi URL bagi ayat

URL ini berbeda setiap kali anda menyalin/membagi ayat. Bahkan jika pengguna lain menyalin dari ayat yang sama, link URL akan berbeda. Jika anda ingin tahu berapa kali ayat yang anda bagikan dilihat, anda bisa membuka halaman URL tersebut dan pilih menu "View Source" dari browser, dan bisa melihat jumlah "viewCount".

Apakah versi BETA itu? Bagaimana cara mengunduhnya?
Lihat di halaman ini untuk penjelasannya.



When you share verses (especially to facebook) the Bible version might be different than what you actually want to share. For example, if you share a verse from NIV, the link generated will redirect your friends to a verse in KJV or other versions. The reason for this is because facebook can only accept direct link when sharing, and the link will redirect to another website that provides web-based Bible reading text. But this could be a problem if the website doesn't provide the same Bible version as what you share.

Now, when you share verses, the app will generate a link for sharing that shows the verse in the exact same version you are currently viewing, because the actual verse text will be stored in our server.
So when you copy or share verses, it will automatically include the link to open it in web-browser. If you don't like this, you can go to Setting > Copying and sharing > disable the option "Share URL".

web-view when opening the shared verse
Share URL option

The URL is unique every time you copy or share. Even if a different user copies or shares the exact same verse, the URL will still be different. If you share a verse URL and you want to see about how many times your verse has been viewed, you can open the page and select the View Source menu on your browser, you can see a 'viewCount' message somewhere there.

What is BETA version? And how to download it?
Take a look at this page for the answers.

4.2 Features (3) - Progress mark synchronization

Lebih banyak pengguna yang menunggu fitur sync untuk rencana baca, namun kami perlu pemanasan dahulu dengan mencoba membuat fitur sync untuk jejak. Seperti yang anda ketahui, sync rencana baca jauh lebih kompleks daripada sync jejak. Jangan kuatir, kami pasti mencoba membuat sync rencana baca, jadi mohon kesabarannya.

Jika anda tidak familiar dengan jejak: jejak adalah 5 buah pin warna-warni yang anda lihat ketika membuka menu drawer kiri. Anda dapat membaca panduan lengkap tentang jejak di halaman ini.

Jejak kini dapat di-sync.
Dalam kasus ketika anda memiliki jejak di 2 HP yang berbeda, dan anda mengubah salah satu jejak di HP "A", namun jejak di HP "B" belum mengikuti perubahan tersebut, waktu lokal di perangkat tersebut akan digunakan untuk menentukan perubahan yang akan disimpan.
Contohnya, di HP "A" anda mengubah nama jejak menjadi "hari Minggu". Satu menit kemudian, anda mengubah namanya lagi menjadi "tiap hari". Maka, tidak peduli HP mana yang selesai terhubung dengan server terlebih dahulu (bisa jadi HP "B" terhubung dengan server duluan daripada "A"), jejak anda di HP "A" dan "B" akan berubah nama menjadi "tiap hari".














Apakah versi BETA itu? Bagaimana cara mengunduhnya?
Lihat di halaman ini untuk penjelasannya.



Although people may be waiting for reading plan synchronization across devices more, I need to warm up my brain by doing progress mark synchronization first. As you may know, reading plan sync is way more complex than progress mark sync. Don't worry, we will definitely try doing the reading plan sync so please be patient with us.

If you are not familiar with progress marks, it is the colorful pins that you see when you open the left drawer. You can read the more detail explanation about progress mark in our web guide.

Progress marks can now be synced.
In case that you update one of the five progress marks from two devices, before one catches up with the other, the local time of the device will be used to determine which changes are saved eventually. So for example you disconnect your phone and tablet, then on your phone you change the Red progress mark title to "Sunday reading" and then a minute later on your phone you change the Red progress mark title to "Daily", then, no matter which device connects to the sync server first, eventually the Red progress mark title will be "Daily", because it is set later.

What is BETA version? And how to download it?
Take a look at this page for the answers.

4.2 Features (2) - Partially highlight a verse

Jujur saja, saya tidak menyangka jika banyak dari anda yang ingin fitur ini.  Akhirnya, di aplikasi Alkitab/Quick Bible 4.2 BETA 4, anda bisa memberi sorot sebagian.

Pilih satu ayat, tambahkan sorotan. Ayat yang terpilih tersebut kini muncul di dalam dialog sorotan, anda bisa geser kursor pemilihan untuk mengatur bagian mana yang akan diberi sorotan. Jangan lupa memilih warna sorotan, kalau tidak ayat yang sudah dipilih tidak akan muncul sorotannya.

menambah sorotan
memilih kata yang akan disorot

Meski begitu, sorot sebagian ada beberapa kelemahan. Salah satunya, sorot sebagian tidak muncul secara otomatis jika anda berpindah versi Alkitab. Maksudnya, setelah anda memberi sorot sebagian di versi TB, jika anda berpindah ke versi lain, contohnya ESV, sorot sebagian itu akan otomatis menjadi sorot penuh seperti biasa. Namun jika anda kembali ke versi TB, sorot sebagian itu muncul kembali. Mengapa demikian? Sebab sangat sulit menentukan karakter apa yang dipilih secara otomatis dalam berbagai bahasa. Selain itu, pilihan untuk sorot sebagian tidak akan muncul jika anda memilih lebih dari satu ayat sekaligus. Ada berbagai kemungkinan yang sulit untuk diantisipasi dalam membuat fitur ini.

Apakah versi BETA itu? Bagaimana cara mengunduhnya?
Lihat di halaman ini untuk penjelasannya.



I personally don't expect that many of you ask this feature. And finally, in Alkitab/Quick Bible 4.2 BETA 4, you can now able to highlight some parts of a verse.

Select a verse, and choose to add a highlight. The selected verse will be shown in the highlight color selection dialog, and you can drag the selection handle to modify the part of the verse that will be highlighted. Do not forget to choose the highlight color for that verse, otherwise the verse won't be highlighted.

adding a highlight
selecting words to highlight

However, as some of you might have guessed, the partial highlight only works for one specific Bible version at a time. For example, if you highlight the verse partially in KJV, when you switch to a different Bible version, you will see the highlight as a full-verse highlight. But if you go back to KJV again, your partial highlight will still be saved. Also, this partial highlight option will not appear when you select more than one verse at a time. These variety of possibilities were the most difficult part to think when making this feature.

What is BETA version? And how to download it?
Take a look at this page for the answers.