Skip to content

Commit

Permalink
alpha 10 release notes, separate readme for Linux installation
Browse files Browse the repository at this point in the history
  • Loading branch information
Noiredd committed Dec 10, 2018
1 parent 8027566 commit 51a4ea7
Show file tree
Hide file tree
Showing 3 changed files with 36 additions and 12 deletions.
19 changes: 19 additions & 0 deletions LINUX.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
## Instalacja fw-local na Linuksie

Tutorial zakłada, że potrafisz otworzyć terminal na swoim systemie.
Będzie to potrzebne w jednym z kroków.

0. Prawdopodobnie twoja dystrybucja jest już wyposażona w Pythona 3.
Jeśli jednak tak nie jest, musisz sobie własnoręcznie zainstalować środowisko.
W razie wątpliwości użyj swojej ulubionej wyszukiwarki i wpisz frazę: "`(nazwa mojej dystrybucji) install python3`".
1. Pobierz pliki programu (link na [poprzedniej stronie](README.md)).
2. Instalacja modułów. fw-local wymaga do działania kilku dodatkowych modułów do pythona.
Są to: `pillow`, `requests_html` oraz `matplotlib`.
Standardowo moduły instaluje się z poziomu terminala poleceniem: `python3 -m pip install nazwa_modułu`.
W przypadku popularnej dystrybucji Ubuntu (oraz podobnych, bazujących na Debianie wydaniach) konieczne może okazać się doinstalowanie jeszcze pewnego pakietu systemowego.
Zrobisz to poleceniem `sudo apt-get install python-beautifulsoup` ([źródło](https://stackoverflow.com/a/26281671/6919631)).
3. Uruchomienie programu powinno być proste: *wystarczy* uruchomić plik `fw-local.bat`.
Może się tak zdarzyć, że system zaprotestuje - prawdopodobnie będzie trzeba ustawić odpowiednie pozwolenia dla tego pliku.
Zrobisz to, oczywiście z konsoli, poleceniem `sudo chmod +x fw-local.bat`.

Zaznaczam, że ponieważ istnieje cała masa różnych dystrybucji linuksa, powyższe instrukcje wcale nie muszą zadziałać co do joty w podanej formie.
27 changes: 16 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,28 +7,33 @@ fw-local pozwala na *zaimportowanie własnych ocen* z portalu i zapisanie ich lo
Razem z Twoimi ocenami, fw-local pobiera także podstawowe informacje o obejrzanych przez Ciebie filmach -
dzięki temu masz możliwość *przeglądania ich i filtrowania* na różne sposoby - zupełnie tak, jak w starym, dobrym filmwebie!

**WAŻNE**: fw-local jest na razie w fazie *alfa* - to znaczy, że nie jest jeszcze gotowy i może (oraz będzie) ulegać różnym zmianom!

<a href="https://raw.githubusercontent.com/Noiredd/fw-local/master/screenshot.png">
<img src="https://github.com/Noiredd/fw-local/blob/master/screenshot.png" width="900" height="485" border="10" alt="Kliknij by zobaczyć w większym rozmiarze" /></a>

**WAŻNE**: fw-local jest na razie w fazie *alfa* - to znaczy, że nie jest jeszcze gotowy i może (oraz będzie) ulegać różnym zmianom!

**WAŻNE**: fw-local na razie działa poprawnie tylko w systemie **Windows**.
Na pewno obsługiwane są wersje 7 (z SP 1) oraz 10, prawdopodobnie powinien zadziałać też w Viście.
Jeśli chcesz używać go na Linuksie bądź Maku, prawdopodobnie czeka Cię odrobina więcej pracy - czytaj dalej.

### Jak uruchomić fw-local?
Na ten moment program nie ma instalatora, więc pierwsze uruchomienie może być mało wygodne.
Poniżej znajduje się instrukcja instalacji dla systemu Windows.
Jeśli pracujesz na Linuksie - zobacz [instrukcję instalacji dla Linuksa](LINUX.md).

0. Pobierz [pliki programu](https://github.com/Noiredd/fw-local/archive/v1.0-alpha.9.zip) i wypakuj, gdzie Ci wygodnie.

1. Pierwszym krokiem będzie prawdopodobnie **instalacja Pythona 3** ([link do oficjalnego wydania](https://www.python.org/downloads/)) -
0. Pierwszym krokiem będzie prawdopodobnie **instalacja Pythona 3** ([link do oficjalnego wydania](https://www.python.org/downloads/)) -
na chwilę obecną najnowszym wydaniem jest Python 3.7.1.
fw-local nie uruchomi się w środowisku starszym niż Python 3.6\*!
fw-local nie uruchomi się w środowisku starszym niż Python 3.6!
**Ważne:** na początku instalacji zaznacz `Add Python3 to PATH`!
Jeśli już posiadasz Pythona, możesz przejść do następnego kroku.
\* - jest to spowodowane zależnością względem modułu `requests_html`
Jeśli już posiadasz Pythona, możesz przejść do następnego kroku.

1. Pobierz [pliki programu](https://github.com/Noiredd/fw-local/archive/v1.0-alpha.10.zip) i wypakuj, gdzie Ci wygodnie.

2. **Instalacja modułów**. Po prostu odpal `setup.bat`, skrypt powinien wszystko zrobić za Ciebie.
Jeśli to nie Twoje pierwsze starcie z Pythonem, to możesz woleć manualnie zainstalować `pillow`, `requests_html` i `matplotlib`.
Jeśli używasz linuksa, jeden z dodatkowych modułów (`BeautifulSoup`) wymaga także doinstalowania odpowiedniego pakietu - [tutaj](https://stackoverflow.com/a/26281671/6919631) więcej informacji.
Jeśli interesują Cię szczegóły tego, co się wydarzy: przejrzyj treść skryptu lub/i instrukcję dla Linuksa.

3. Samo **uruchomienie** programu, jest już proste - zwyczajnie odpalasz `fw-local.bat`. Powinno ukazać Ci się okno jak w screenie wyżej (tylko puste, z prośbą o pierwsze zalogowanie).
3. Samo **uruchomienie** programu jest już banalne - zwyczajnie odpalasz `fw-local.bat`.
Powinno ukazać Ci się okno jak w screenie wyżej (tylko puste, z prośbą o pierwsze zalogowanie).

### Co potrafi fw-local?
Po pierwsze musisz zaimportować swoje oceny z filmwebu. fw-local poprosi Cię o to przy pierwszym uruchomieniu.
Expand Down
2 changes: 1 addition & 1 deletion fw-local/gui.py
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
from filmweb import FilmwebAPI
from presenter import Presenter

VERSION = '1.0-alpha.8'
VERSION = '1.0-alpha.10'

class Login(object):
# By default a dormant window that offers a request function to be called by
Expand Down

0 comments on commit 51a4ea7

Please sign in to comment.