Instrukcja pobierania i kompilacji notatek - Paweł Borycki

Instrukcja pobierania i kompilacji notatek
Paweł Borycki
13 sierpnia 2015
Wstęp
Notatki do zajęć prowadzę w formacie LATEX. Korzystam z systemu kontroli wersji Apache
Subversion (SVN). W niniejszej instrukcji opisano instalację i najprostsze sposoby wykorzystania oprogramowania klienckiego dla systemu SVN oraz kompilatora języka LATEXna przykładzie
programów TortoiseSVN, TeX Live i Winshell for Latex. Instrukcję przygotowano dla systemu
operacyjnego Windows.
Licencja
Notatki udostępniam na wolnej licencji GNU GPL 3, której treść znajduje się pod adresem
http://www.gnu.org/licenses/gpl.html. Oznacza to w szczególności, że można pobierać,
rozpowszechniać i udoskonalać je bezpłatnie. Nie można za to usuwać z nich informacji na
temat autorów i miejsca publikacji.
Współpraca
Jeśli ktoś z Was ma ochotę pomóc w korekcie, dodać swoje notatki, poprawić ewidentne
błędy lub w inny sposób przyczynić się do rozwoju notatek, będzie mi bardzo miło. Osoby
takie proszę o kontakt mailowy z podaniem posiadanego loginu w usługach Google.
1
TortoiseSVN
Program TortoiseSVN jest klientem systemu kontroli wersji. Dzięki niemu można łatwo
pobierać i aktualizować pliki do ich najnowszych wersji umieszczonych na serwerze.
1.1
Instalacja
1. Program można pobrać ze strony http://tortoisesvn.net/downloads.html. Jeśli nie
wiesz, czy Twój system jest 32-bitowy, czy 64-bitowy, pobierz wersję 32-bitową.
2. Pobrany plik MSI uruchom i zainstaluj pełny program z wszystkimi opcjami.
1
1.2
Pobieranie plików z serwera po raz pierwszy
1. Otwórz folder, do którego chcesz pobrać notatki.
2. Kliknij prawym przyciskiem myszy i wybierz opcję SVN Checkout...
3. Wpisz adres URL repozytorium:
https://subversion.assembla.com/svn/notatki-archeo/.
Wybierz opcję Fully recursive oraz wersję plików do pobrania HEAD.
4. Wyświetlona zostanie lista pobranych plików oraz ich wersja (np. At revison: 134).
5. Po pobraniu plików w wybranym przez Ciebie folderze powstanie nowy folder, domyślnie
o nazwie notatki-archeo.
6. Pliki i foldery podlegające kontroli wersji są oznaczone zieloną ikoną przesłaniającą ikonę
systemową. W katalogu znajdą się głównie pliki o rozszerzeniu .tex, które zawierają
notatki.
1.3
Aktualizacja plików do najnowszej wersji
1. Kliknij prawym przyciskiem myszy na katalog notatki-archeo i wybierz opcję SVN
Update.
2. Wyświetlona zostanie lista pobranych plików oraz ich wersja (np. At revison: 134).
3. Zaktualizowane zostaną pliki o rozszerzeniu .tex znajdujące się w katalogu, ale nie pliki
.pdf!
2
TeX Live
Program TeX Live pozwala utworzyć pliki .pdf w oparciu o pliki .tex.
2.1
Instalacja
1. Ze strony http://www.tug.org/texlive/acquire-netinstall.html pobierz plik
install-tl-windows.exe (wersja dla Windows).
2. Uruchom pobrany plik.
3. Potwierdzaj kolejne ustawienia. Lepiej nie zmieniać docelowego folderu
(C:\texlive\2015) i innych ustawień.
4. Poczekaj zainstaluje program zostanie pobrany z Internetu i zainstalowany. Nawet przy
szybkim łączu internetowym potrwa to długo, 2-3 godziny. Czas trwania instalacji jest
związany z koniecznością pobrania dużej liczby dość małych plików. Pobieranie można
przerwać przyciskiem Anuluj. Przy ponownym uruchomieniu wznowi się od miejsca, w
którym zostało przerwane.
3
Winshell for Latex
Program Winshell for Latex jest edytorem plików .tex wspierającym także ich komplicję
do plików .pdf z wykorzystaniem odpowiedniego kompilatora np. pobranego wcześniej TeX
Live.
3.1
Instalacja
1. Ze strony http://www.winshell.org/download.html pobierz program Winshell for Latex, najlepiej w postaci pliku .exe.
2. Uruchom ten plik i zainstaluj program.
2
Uwaga! W trakcie instalacji zmieni się domyślny program do otwierania plików .pdf. Po
zakończeniu całej instalacji trzeba ponownie zmienić ten program na Adobe Acrobat Reader.
W tym celu w systemie Windows 10 kliknij prawym przyciskiem myszy dowolny plik .pdf,
wybierz opcję Właściwości i przy polu Otwierany za pomocą kliknij Zmień.
3.2
Kompilacja TEX do PDF
1. Otwórz jeden z pobranych plików .tex z notatkami w programie Winshell.
2. W programie Winshell z górnego menu wybierz Uruchom → PDFLaTeX. Powtórz tę
czynność dwukrotnie, aby wygenerował się spis treści i przypisy.
3. Jeśli nie pojawi się żaden błąd w katalogu, w którym był plik .tex, pojawi się sporo
nowych plików w tym plik .pdf. Ponownego generowania plików nie można prowadzić
jeśli PDF jest otwarty w programie Acrobat Reader.
4. Wykonanie operacji SVN Update na katalogu z plikami spowoduje jedynie uaktualnienie
plików .tex. Pliki .pdf trzeba wygenerować ponownie.
Zakończenie
Osoby chętne do wykonania powyższych proszę o kontakt mailowy w przypadku jakichkolwiek problemów.
Wszystkim życzę powodzenia na egzaminach w czasie sesji i udanych wakacji!
3