diff options
| -rw-r--r-- | BUILD.md | 17 | ||||
| -rw-r--r-- | README.md | 18 |
2 files changed, 29 insertions, 6 deletions
@@ -8,6 +8,7 @@ Struktura repozytorium kodu Katalog [`src`](src) zawiera komponenty źródłowe programu: * [kod skryptu Pythona](src/bidding_data.py), który wykonuje całą robotę +* [kod skryptu pakującego program w interfejs graficzny](src/bidding_data_gui.py) * [ikonę programu](src/icon.ico) wraz ze [źródłami](src/icon.xcf) * [metadane programu](src/version) dla PyInstallera @@ -76,6 +77,13 @@ który, kolejno: * tworzy z nich nazwę dla paczki * pakuje cały katalog `dist` do paczki i umieszcza ją w `bundle` +--- + +Analogiczny proces dla interfejsu graficznego polega na podmianie skryptu +źródłowego z src/bidding_data.py na src/bidding_data_gui.py (dołącza sobie +bidding_data.py jako moduł) i wywołanie pyinstallera z opcją aplikacji +okienkowej. + Wymagania systemowe ------------------- @@ -97,6 +105,10 @@ Zbudowanie paczki z [`bundle`](bundle): * Windows PowerShell * .NET 4.5 +Interfejs graficzny (dodatkowo): + +* Tkinter + Znane problemy -------------- @@ -104,8 +116,9 @@ Znane problemy nie być DLLki z System.IO.Compression.FileSystem importowanej przez skrypt PowerShella. * PyInstaller nie lubi kompilować ze ścieżek ze znakami nie-ASCII. `¯\_(ツ)_/¯` -* co więcej, wersja stabilna produkuje .exe, które nie odpala się z niektórych -ścieżek nie-ASCII: https://github.com/pyinstaller/pyinstaller/issues/1396 +* co więcej, jego wersja stabilna produkuje .exe, które nie odpala się +z niektórych ścieżek nie-ASCII: +https://github.com/pyinstaller/pyinstaller/issues/1396 (.exe dostarczane w `dist` powinno działać) Kod żródłowy @@ -24,12 +24,15 @@ Instalacja repozytorium i rozpakuj ją do wybranego przez siebie katalogu roboczego programu. +Uwaga: paczki z sufiksem `-gui` zawierają wersję aplikacji z okienkowym +interfejsem graficznym. + W katalogu WWW Par skonfiguruj zasoby niezbędnę do prezentacji danych licytacji: * skopiuj [`css/bidding.css`](res/css/bidding.css) do katalogu WWW * dołącz plik [`css/bidding.css`](res/css/bidding.css) gdzieś w arkuszach stylów turnieju (np. poprzez `@import` w `kolorki.css`) -* skopiuj [`javas/bidding.js`](res/javas/bidding.js) do podkatalogu javas +* skopiuj [`javas/bidding.js`](res/javas/bidding.js) do podkatalogu javas katalogu WWW (plik dołączany jest automatycznie do stron z wynikami) * skopiuj [`images/link.png`](res/images/link.png) do podkatalogu images katalogu WWW @@ -41,12 +44,12 @@ Kompilacja i praca z kodem narzędzia Patrz: [`BUILD.md`](BUILD.md) -Użycie ------- +Użycie (wersja linii poleceń) +----------------------------- Program składa się ze skompilowanego skryptu języka Python, dostępnego w katalogu [`src`](src) tego repozytorium. - + Skrypt [`bidding_data.py`](src/bidding_data.py) operuje na następujących danych wejściowych: * plikach HTML wygenerowanych po zakończeniu turnieju stron statycznych @@ -67,6 +70,11 @@ Narzędzie obsługuje niestandardowe zakresy numeracji rozdań w turnieju. Mapowanie numeru rozdań z Par na numer rozdania w BWS (numer fizycznego pudełka) odbywa się automatycznie (na podstawie danych z BWS). +Użycie (wersja z interfejsem okienkowym) +---------------------------------------- + +Się klika, się wybiera i się robi. + Kompatybilność -------------- @@ -77,6 +85,8 @@ Wersja operująca na wyeksportowanych plikach CSV (np. przez `mdb-export`), kompatybilna z pozostałymi systemami operacyjnymi i niewymagająca ODBC, dostępna jest w gałęzi [csv](//github.com/emkael/jfrpary-bidding-data/tree/csv). +Do wersji z gałęzi CSV nie ma interfejsu graficznego. + Lista przyszłych usprawnień --------------------------- |