Instalacja systemu MikTeX 2.9 + WinShell

Instalacja MikTeX 2.9

Zrzuty ekranu z systemu Windows 7 PL. W innych wersjach poszczególna okna mogą wyglądać nieco inaczej.

  1. Pobierz plik basic-miktex-2.9.3927.exe.
  2. Uruchom pobrany plik:
  3. Aby zainstalować program trzeba zaakceptować warunki licencji:
  4. Następnie instalator pyta czy chcemy aby program był dostępny dla wszystkich użytkowników komputera czy tylko dla aktywnego konta (jeśli masz więcej kont w systemie może to być dla ciebie istotne - w większości przypadków domyślne ustawienie jest ok):
  5. Można podać dokładny katalog w którym zostanie zainstalowany program - domyślna wartość w większości przypadków jest dobra:
  6. Tu możesz wybrać jaki będzie domyślny rozmiar papiery (A4 to zwykła kartka od drukarki) oraz sposób w jaki będą doinstalowywane brakujące pakiety. Opcja "Ask mi first" powoduje, że przy każdej okazji kiedy czegoś brakuje pojawi się pytań co robić (instalować czy nie):
  7. Teraz możemy już tylko potwierdzić, że wszystko jest ok i rozpocząć instalację:
  8. Instalacja zajmie trochę czasu! Po jej zakończeniu uakywni się przycisk "Dalej >":
  9. Jeśli wszystko pójdzie dobrze, to na końcu zobaczysz taki ekran:

Konfiguracja systemu MikTeX do obsługi języka polskiego

Ten punkt jest opcjonalny. MikTeX powinien sam sobie poradzić z instalacją pakietów. Jednak po licznych zgłoszeniach problemów z tym związanych postanowiłem opisać jak ręcznie zapewnić sobie doinstalowanie wszystkiego co trzeba.

  1. Uruchamiamy program konfiguracyjny MikTeX'a. Znajduje się on w menu start (przycisk Windows na dole ekranu -> Wszystkie programy -> MikTeX 2.9 -> Maintenance (Admin) -> Settings):
  2. W programie tym wybieramy zakładkę Languages i upewniamy się, że na liście języków zaznaczony jest również język polski:
  3. Następnie przechodzimy do zakładmi Packages i wyszukujemy tam Language Support i w środku zaznaczamy Polish:
  4. Następnie na liście pakietów przechodzimy Fonts -> Outline fonts i zaznaczamy na liście pakiet plpsfont:
  5. Nasze wybory potwierdzemy przyciskiem Zastosuj a następnie zgadzamy się na instalacje:
  6. Czekamy na zakońzenie instalacji:

    Instalacja może potrwać kilka (kilkanaście?) minut. Musisz w tym czasie być podłączony do Internetu.
  7. Po zakończeniu tych czynności zamykamy program z ustawieniami za pomocą przycisku Ok:

Instalacja programu WinShell

  1. Teraz pobierz i uruchom plik: WinShell331.exe
  2. Instalacja sprowadza się do naciskania przycisku "Dalej >" (lub "Next >" w wersji angielskiej). Po zakończeniu instalator domyślnie proponuje uruchomienie programu.
  3. Przy pierwszym uruchomieniu programu WinShell możemy wybrać język interfesju użytkownika. Wśród dostępnych pozycji jest też język Polski:
  4. Po uruchomieniu programu, główne okno WinShella powinno wyglądać mniej więcej tak:
  5. Aby WinShell poprawnie pokazywał polskie znaki w dokumentach musimy wejść w menu Opcje -> Ogólne i tam odnaleźć zakładkę czcionka. Ustawienia powinny być takie jak na ekranie:

    Zapamiętaj dobrze to miejsce w programie. Prawdopodobnie będziesz spotykać się z różnymi dokumentami stworzonymi przez inne osoby. Może zdarzyć się tak, że będą one zapisane w kodowaniu innym niż UTF-8 (które jest zalecane i "najlepsze", ale nie wszyscy o tym wiedzą). Wtedy - aby edytować taki dokument, będziesz musiał tu wrócić i zmienić kodowanie na inną wartość ("Domyślne" oznacza kodowanie CP1250).
  6. Oczywiście wybór potwierdzamy przyciskiem Ok. Doinstalujemy teraz jeszcze słowniki ortograficzne języka polskiego. W tym celu należy wyłączyć program WinShell...
  7. ... a następnie pobrać plik pl.zip. Jest tu słownik pochodzący ze strony http://www.sjp.pl/slownik/ort/ zmodyfikowany tak aby działał też z kodowaniem UTF-8. Jeśli wolisz oficjalne wydanie i chcesz sam przekonwertować pliki na kodowanie UTF-8 to oczywiście możesz to zrobić.
  8. Po otworzeniu pobranego archiwum zip widzimy, że są w nim 4 pliki:
  9. Należy przegrać te pliki do folderu: c:\Program Files\WinShell\Dictionaries:

    W systemach Windows Vista lub Windows 7 system może poprosić nas o dodatkowe potwierdzenie takiej czynności:

    Docelowo folder Dictionaries powinien wyglądać tak:
  10. Teraz należy ponownie uruchomić program WinShell. Można go znaleźć w menu Start->Wszystkie programy->WinShell. Po uruchomieniu wchodzimy w menu Opcje -> Ogólne. Jest tam możliwość wyboru słownika do sprawdzania pisowni
  11. Z listy rozwijanej wybieramy pozycję pl_PL_utf8:

    Jeśli w przyszłości będzie potrzeba edycji tekstów po angielsku należy przełączyć to pole na en_US, a jeśli program będzie używany z tekstami polskimi w kodowaniu Windows CP1250 to należy wybrać słownik pl_PL i ustawić kodowanie "Domyślne" w zakładce "Czcionka".
  12. Dla porządku zamkniemy teraz - otwarty domyślnie w programie - projekt "demo". Na liście po lewej stronie, klikamy lewym przyciskiem myszy na wpis "demo":

    i wybieramy opcję "Zamknij".

Weryfikacja instalacji

  1. Sprawdzimy teraz czy wszystko działa poprawnie. W menu Plik wybieramy opcje "nowy" i w oknie nowego dokumentu wpisujemy (można skopiować i wkleić):
    \documentclass[12pt,a4paper]{article}
    \usepackage{polski}
    \usepackage[utf8]{inputenc}
    
    \title{Dokument testowy}
    \author{ja}
    \date{\today}
    
    \begin{document}
    To jest tylko test.
    
    Jurz już jórz jóż.
    
    Ąęćółńżźś...
    
    \end{document}
    

    Zwróć uwagę czy poprawnie działa sprawdzanie pisowni i czy polskie znaki są widoczne. Jeśli nie - sprawdź ustawienia w menu Opcje -> Ogólne. Poprawny widok okna programu w tym momencie jest taki:
  2. Aby skompilować nasz dokument w systemie LaTeX musimy teraz zapisać nasz plik. Możesz wybrać dowolną nazwę (byle nie zawierała spacji!!!) i lokalizację. Pamiętaj jednak, że przy kompilacji LaTeX tworzy kilka plików pomocniczych, które później nie są automatycznie kasowane. Wobec tego warto zapisać nasz testowy dokument w jakimś nowym, pustym folderze - tak aby łatwo było się go później pozbyć. Po zapisaniu pliku uruchamiamy kompilację do PDF korzystając z przycisku:
  3. Ponieważ jest to pierwsze użycie systemu LaTeX może okazać się, że brakuje pakietów potrzebnych do pisania po polsku - w związku z tym może pojawić się okno pytające czy zainstalować brakujące pliki:

    Ponieważ takich pytań może się pojawić sporo warto ODZNACZYĆ opcję "Always show this dialog..." - oszczędzi to kilku podobnych pytań. W przypadku systemów Windows Vista lub Windows 7 warto też w menu rozwijanym "This package will be installed for:" wybrać z list nazwę swojego użytkownika i NIE korzystać z opcji "Anyone who use this computer (all users)", gdyż zdarza się, że opcja ta nie działa poprawnie. Po wciśnięciu przycisku Install rozpocznie się instalacja pakietów. Ponieważ jest to pierwsze uruchomienie, może potrwać dość długo (kilka minut!). Niestety nie zobaczymy w tym momencie żadnego paska postępu.
  4. Co gorsza zdarzają się sytuacje, że program przestanie odpowiadać w tym kroku. Musimy wtedy wymusić zamknięcie programu WinShell, uruchomić go ponownie, otworzyć nasz testowy dokument i spróbować skompilować raz jeszcze. W oknie "Package installation" gdzie system pyta nas czy napewno chcemy dodać pakiet, można dodatkowo zmienić źródło instalacji. Domyślnie jest tam "Random package repository" co czasem skutkuje wyborem bardzo wolnego serwera. Jeśli masz problemy z instalacją pakietów kombinuj ze zmianą źródła na inny serwer (próbuj do skutku aż będzie dobrze!). Dobrym wyborem może być na przykład Iralndzki serwer heanet.ie.
  5. Po poprawnym skompilowaniu dokumentu okno programu WinShell powinno wyglądać tak:
  6. Pozostaje teraz jedynie sprawdzenie czy wynikowy plik PDF jest poprawny. Używamy w tym celu przycisku z ikoną: . Poniżej obraz poprawnie przetworzonego dokumentu:

    Zwróć uwagę czy w wynikowym pliku PDF poprawnie widoczne są wszystkie polskie znaki! Uwaga: Oczywiście aby ta funkcja zadziałał trzeba mieć jakikolwiek program do oglądania plików PDF.

Masz pytania/problemy?

Możesz napisać do mnie: ja@hope.art.pl - ale pamiętaj, że mam sporo pracy i być może nie odpowiem dość szybko, za co z góry przepraszam. Nie mniej postaram się pomóc na tyle na ile to możliwe. Jeśli masz problem polegający na tym, że coś się nie kompiluje albo kompiluje się źle, to przy zgłaszaniu problemu wyślij do mnie całą zawartość okienka "Log" z programu WinShell: