README.md

JS News: Client by Michał Budzyński

JS News is a Polish JavaScript group on Facebook, created by Damian Wielgosik & Kamil Trebunia. With 2,100+ active users it's best place in Polish internet to discuss everything related to Fronend development. And since it's mostly (only?) for Polish speaking developers, rest of this README will be in PL.

---

Co?

JS News: Client to oparty na node.js, commandlineowy klient do Waszej ulubionej fejsbukowej grupy - JS News . Umożliwia on przeglądanie postów i komentarzy bez uruchamiania przeglądarki, oraz informuje w czasie rzeczywistym o updatach poprzez systemowe notyfikacje.

Co nowego?

Changelog:

v 1.2.0 (:church: concordat) - 17 lipca 2014, autorzy: Jedrzej Gontarczyk & Maciej Slubowski

• Wsparcie dla wielu języków z wykorzystaniem L20N
  • Dodano locale dla języka polskiego
• Zamknięto Issue #33 (Lista obserwowanych nie czyści się już po restarcie aplikacji):
  • Zainstalowano LevelDB
  • Cache z pamięci przesunięto do bazy danych
• Poprawki drobnych bugów.

v 1.1.1 (:tv: colortv) - 27 czerwca 2014, autor: Jedrzej Gontarczyk

• Możliwość zdefiniowania w configu flag notyfikacyjnych dla każdej z grup:
  • FLAG_WATCH_NONE - nie wyświetlaj żadnych notyfikacji dla grupy
  • FLAG_WATCH_NEW_POSTS - wyświetlaj notyfikacje dla nowych postów
  • FLAG_WATCH_NEW_POST_LIKES - wyświetlaj notyfikacje dla lajków w postach
  • FLAG_WATCH_NEW_COMMENTS - wyświetlaj notyfikacje dla nowych komentarzy
  • FLAG_WATCH_NEW_COMMENT_LIKES - wyświetlaj notyfikacje dla nowych lajków komentarzy
• każda grupa może mieć przypisane wiele flag

v 1.1.0 (:elephant: hannibal) - 24 czerwca 2014, autor: Michał Maćkowiak

• Możliwość przechodzenia pomiędzy grupami zdefiniowanymi w configu
• Moduł inputu zmienony z readLIne na inquire
• Growl zmieniony na node-notifier (od OS X 10.8 notyfikacje systemowe + wsparcie dla Win i Linuxa)
• Notyfikacja informuje tylko o nowych postach (nie o lajkach i komentarzach), Issue #34
• Możliwość obserwowania wybranych postów - dostają one notyfikacje o każdym lajku i komentarzu (uwaga na Bug #33)
• Kolory można teraz zmienić w pliku config.js

Jak?

Aby uruchomić JS News: Client należy:

• Stworzyć swój plik config.js w katalogu /src/. Można wykorzystać do tego plik config.js.example zamieszczony w tym samym katalogu.
• Do poprawnego działania potrzebujemy facebookowych kluczy - prywatnego i publicznego. Przepraszam, ale nie chciało mi się bawić w serwerowe zagadnienia (nie udaję nawet że umiem), najprościej więc będzie stworzyć nową aplikację TUTAJ, następnie APPS -> Create New i wygenerować dla niej klucze (całość powinna trwać około 2.5 sec)
• Dependencje npm. W katalogu głównym aplikacji odpalamy npm install.
• Uruchamiamy z linii komend poprzez node index.js
• Cieszymy się, bawimy i radujemy.

Czemu?

Czy jesteś znudzony tłumaczeniem swoim współpracownikom i przełożonym że większość czasu na Facebooku spędzasz dyskutując o JavaScriptowych problemach, rozwiązaniach, projektach i pomysłach, i w żadnym wypadku nie jest to prokrastynacja? Robiąc to samo w terminalu cały czas wyglądasz jakbyś pracował :)!

Co dalej?

Wiele jeszcze zostało do zrobienia. Lista bugów i proponowanych ficzerów znajduje się tutaj. Proste poprawki, które nie powinny zająć więcej niż kilkadziesiąc minut (idealne aby rozpocząć przygodę z oprogramowaniem open source!) oznaczone zostały flagą good-first-issue. Jeśli masz czas i chęć rozwijać projekt, zapraszam (dla każdego kto wyląduje rozsądny Pull Request w masterze darmowy bilet na tegoroczny onGameStart)