debe to kindle Mini Tool to lovers of debe from eksisozluk (one of the most famous website -refered as collaborative dictionary like reddit- in Turkey) for pushing debe (Most Liked Entries of Yesterday) to kindle every day via Github Actions.
Nasıl Kullanırım ?
- Öncelikle kullanacağınız mail adresininizin SMTP/IMAP ayarlarının var olduğunu düşünüyorum. Eğer yapılmamış veya emin değilseniz Mail Ayarları & Oluşabilecek Hatalar kısmına bakın. Sonra buradan "Daha az güvenli uygulama erişimi"'ne izin verin.
- Projeyi fork'layın. (Github üyeliğiniz yoksa tabi önce üye olun ve sağ üstte yer alan Fork'a tıklayın)
Settings > Secrets
'a girip, sağ üstte yer alanNew Depository Secret
ile aşağıda yer alan üç adet Secret'i oluşturun.KINDLE_MAIL
: kindle mail adresiniz. ([email protected])MAIL_NAME
: gönderilecek mail adresiniz ([email protected])MAIL_PASSWORD
: mail adresinizin şifresi.
- Dilerseniz gönderim saatini
.github/workflows/debe-to-kindle.yml
dosyasında yer alancron: "1 7 * * *"
kısmından değiştirebilirsiniz. İkinci sayı saati ilk sayı ise dakikayı belirtiyor. 09:20 içincron: "20 9 * * *"
gibi. (Saatler UTC üzerinden) debe-to-kindle-push.yml
vedebe-to-kindle.yml
adında iki adet action var. Push değişiklik yapıldığında, diğeri ise günlük olarak mail gönderir. Kurulum yaptığınızda günlük mail gönderilir ancak ayarları yeniden yaptıktan sonra deneme yapmak için :- Repository anasayfasındaki
yeşil / kırmızı işaret > Details
'i tıklayın. Açılan sayfadanRe-run all jobs
'a tıklayın. - Veya
Actions > debe-to-kindle-push
'a tıklayıp orada yer alan son Action sayfasındanRe-run all jobs
'a tıklayın.
- Repository anasayfasındaki
- Mail ayarları Gmail'e göre ayarlanmış ancak diğer mail servisleri de kullanılabilir (belki daha iyi bile olur). Bunun için
debe-to-kindle.yml
vedebe-to-kindle-push.yml
dosyalarında en alt satırlarda yer alan bilgileri kullanacağınız mail servisinin SMTPservisi bilgilerini değiştirmeniz gerekmektedir. Örneğin : Hotmail için ayarlar, Yahoo için ayarlar.server_address
: genelde smtp ile başlayan adres. (Yahoo : smtp.mail.yahoo.com, Hotmail/Outlook : smtp-mail.outlook.com)server_port
: smtp bağlantı noktası. (Yahoo : 465 veya 587, Hotmail/Outlook : 587)secure
: mail servisinin TLS kullanıp kullanmadığı. %95 true.
- Eğer bu adımda mail gönderiminde hata var ise bu sayfa üzerinden (sanıyorum ki bir kez olarak) Devam Et seçeneğine tıklayın.
- "Verify your Kindle document" mail'i alırsanız burada yer alan
Personal Document Settings > Approved Personal Document E-mail List
kısmından gönderim yaptığınız mail adresini ekleyerek bu uyarıyı geçebilirsiniz veya geçmeyerek istediğiniz günler mail üzerinden onaylayarak sadece o gün için debe'yi kindle'a indirebilirsiniz. - Debe'yi kindle üzerinden okumanın keyfini çıkarın :)
Mail Ayarları & Oluşabilecek Hatalar
Melun Gmail, kendini korumayı görev edindiği için giriş yapamama hatalarını pek çok çeşitli yollar ile alabilirsiniz. Karşılaşacağınız hata muhtemelen Actions üzerinde göreceğiniz Invalid login: 534-5.7.14 <https://accounts.google.com/signin/continue?sarp=1&scc=1&plt=AKgnsbt
olacaktır. Bu sebepten bu sayfa üzerindeki 1. Adım kısmında yazanları ve Sorun Giderme kısmındaki adımları büyük bir dikkat ile tamamlayın. Ayrıca bu sayfa üzerinden "Daha az güvenli uygulama erişimi"'ne izin vermelisiniz.
- İki adımlı uygulama kullanıyorsanız, kendi şifreniz yerine uygulama şifresi ile giriş yapmanız gerekiyor olabilir. Yukarıda yer alan linkin Sorun Giderme kısmında ne yapacağınızı bulabilirsiniz. Bu sayfa üzerinde yer alan Google'da oturum açma sekmesinden Uygulama Şifreleri'ni tıklayarak uygulama şifresi oluşturun ve mail şifresi yerine orada yer alan şifreyi boşluksuz olarak kullanın.
- Son ve pek önemli olarak şu sayfada yer alan Devam Et düğmesine tıklamayı ihmal etmeyin. Yine yukarıdaki linkte yer alan Sorun Giderme kısmında aynı link yer alıyor. Yaptığım çeşitli denemeler sırasında bu linki en az bir kere tıklamadan girişe izin verildiğine şahit olmadım.
Geri Bildirim
Bir hata bulduysanız (o sizin kullanıcı hatanızdır, gayet çalışıyor işte), veya (daha ne eklenebilir emin değilim ama) yeni bir özellik eklenmesini dilerseniz mail atmaktan ([email protected]), pull requests göndermekten, sözlük üzerinden mesaj atmaktan ve dua etmekten geri durmayın.