Skip to content

Latest commit

 

History

History
93 lines (73 loc) · 3.44 KB

README_RISE.md

File metadata and controls

93 lines (73 loc) · 3.44 KB

#####Instrukcja instalacji wtyczki RISE służącej do obsługi interaktywnego pokazu slajdów
Konfigurację przeprowadzono z wykorzystaniem Pythona w wersji 3.5.1.
Wszelnie uwagi na temat instalacji RISE pod Pythonem 2.X mile widziane
W zależności od wersji IPythona należy pobrać repozytorium z odpowiedniej gałęzi:
https://github.com/damianavila/RISE/releases

UNIX

  1. Pobierz potrzebne pliki z repozytorium https://github.com/damianavila/RISE.git

    git clone https://github.com/damianavila/RISE.git

  2. Instalacja polega na uruchomieniu skryptu setup.py z parametrem install.

cd RISE/
python setup.py install

Jeżeli instalacja nie przebiega prawidowo (pojawiaja sie bledy dotyczace JUPYTERa),
Należy dodatkowo ustawić zmienna JUPYTER_CONFIG_DIR. Prawdopodobnie powinna wskazywać na
~/.jupyter, szczegolowy opis znaduje sie tutaj: http://jupyter-core.readthedocs.org/en/latest/paths.html

JUPYTER_CONFIG_DIR=<path_to_config> python setup.py install

Sprawdzenie instalacji:

Po otwarciu w jupyter nootebook dowolnego wykładu w menu toolbar powinna pojawić
się nowa ikona : "Enter/Exit Live Reveal Slideshow" (wygląda jak histogram)

cd <path_to_python-lecture>
jupyter notebook LX.ipynb
!!!

Aby osiagnac najlepszy efekt zaleca sie wykonanie instrukcji
zawartej w dziale WAŻNE

Windows

  1. Pobierz potrzebne pliki z repozytorium https://github.com/damianavila/RISE.git

    git clone https://github.com/damianavila/RISE.git

    (jeżeli nie masz Gita - zainstaluj go)

  2. W tym przypadku nie jest konieczne ustawianie żadnych zmiennych,
    należy przejć do folderu RISE i rozpoczć instalacje:

    cd <path_to_RISE>
python setup.py install

  3. Instalacja powinna zakończyć sie bez żadnych bledów
    Aby zweryfikować, sprawdź czy możesz wlaczyc pokaz slajdów
    tak jak opisano w Sprawdzenie instalacji w dziale powswieconym
    instalacji na UNIX.

WAŻNE

Aby slajdy mieściły się w pełni na ekranie, konieczna jest modyfikacja
parametru odpowiadającego za ich powiększenie (domyślnie równa 160%).

Parametr jest ustawiony w pliku
<path_to_application>/jupyter/nbextensions/livereveal/main.css
gdzie <path_to_application> to miejsce w którym przechowywane są dane o aplikacjach
(w to miejsce były kopiowane pliki po uruchomieniu skryptu setup.py)
na przykład może to być
~/.local/share/ w przypadku systemu UNIX czy
C:\Users\<USERNAME>\AppData\Roaming w przypadku systemu Windows


Jeżeli masz problemy ze znalezieniem wlasciwej scieżki, zmodyfikuj dowolny szablon
z /RISE (na przyklad plik /RISE/livereveal/reveal.js/css/theme/simple.css)
dodajac jakis komentarz który nie zmieni jego dzialania. Nastepnie uruchom ponownie
skrypt setup.py. W konsoli powinny pojawić sie scieżki:

  1. Scieżka do /RISE
  2. Szukana sciezka (do niej kopiowany jest nowy plik simple.css)

Modyfikację należy wprowadzić w linii 67, ustawiając parametr:
font-size: 100%;

Po wykonaniu powyższych czynności można cieszyć się interaktywnym pokazem slajdów.

Przydatne linki:
https://github.com/agh-glk/python-lecture
https://github.com/damianavila/RISE
https://github.com/damianavila/RISE/releases
https://github.com/damianavila/RISE.git