TypeFriendly to system budowania podręczników oraz publikacji w formacie HTML z prostych plików tekstowych. Posiada wszystkie niezbędne narzędzia, dzięki czemu można niemal natychmiast rozpocząć pisanie, bez konieczności skupiania się na technicznych aspektach przetwarzania. Cecha ta jest szczególnie istotna dla osób, które nie są biegłe w językach programowania i które miałyby problemy z rozbudową np. DocBooka poza podstawową funkcjonalność, jak np. przechowywanie wersji źródłowej każdego rozdziału w innym pliku. Jednak, jak każde narzędzie, TypeFriendly musi zostać najpierw zainstalowany, co samo w sobie nie jest trudne, ale wymaga posiadania interpretera języka PHP. W systemach linuksowych jego zdobycie to kwestia wpisania jednego polecenia, ale z otrzymywanych sygnałów wiem, że pod Windowsem osobom nowym w temacie zadanie to może sprawić pewien kłopot. Dlatego postanowiłem stworzyć ten oto ilustrowany przewodnik, który krok po kroku pokazuje cały proces. Przejdźmy zatem do konkretów.
Instalacja
Instalację zaczniemy od zdobycia PHP. Język ten ma spore możliwości, lecz niemal wszystkie dostępne w sieci artykuły koncentrują się na podłączaniu go do serwerów WWW. Nam taka funkcjonalność nie jest w ogóle potrzebna, dlatego ją pominiemy.
Najpierw musimy odwiedzić stronę projektu: www.php.net. W dziale "Downloads" znajdziemy najnowsze wydania, również w wersji dla systemu Windows. W chwili pisania tego tekstu najnowszą stabilną wersją było PHP 5.2.9:
Ściągamy plik PHP 5.2.9-1 ZIP Package. Strona zapyta nas jeszcze o serwer, z którego chcemy go pobrać - wybieramy najbliższy nam i czekamy, aż wszystko znajdzie się na naszym HDD. Teraz musimy stworzyć na dysku katalog, do którego rozpakujemy zawartość, na potrzeby artykułu przyjmijmy, że będzie to D:\php\
Rozpakujmy wszystkie pliki wchodzące w skład ściągniętego archiwum do D:\php\:
Ponieważ TypeFriendly obsługiwany jest z linii komend, musimy jeszcze powiadomić system operacyjny, gdzie znajduje się interpreter PHP, aby nie musieć wpisywać do niego pełnej, dość długiej ścieżki. W tym celu odwiedzamy Panel Sterowania i wchodzimy w aplet System:
Na zakładce Zaawansowane znajdziemy opcję Zmienne środowiskowe. Klikamy na nią i naszym oczom ukaże się kolejne okienko:
W ramce Zmienne środowiskowe dla użytkownika XXX klikamy na przycisk Nowa i w kolejnym okienku dialogowym wpisujemy dane takie, jak na obrazku: nazwa PATH oraz wartość w postaci naszej ścieżki. Może się zdarzyć, że w Twoim systemie będziesz już mieć utworzoną taką zmienną. Wtedy nie tworzysz jej na nowo, lecz edytujesz istniejącą i dopisujesz do niej ścieżkę D:\php\ po dwukropku. Przykład: C:\jakas\sciezka:D:\php\.
Możemy teraz zapisać wszystko i zamknąć panel sterowania, zaś kolejnym krokiem będzie upewnienie się, że wszystko wykonaliśmy poprawnie. PHP przetestujemy w bardzo prosty sposób. Utwórz w katalogu Moje dokumenty plik o nazwie phpinfo.php oraz o treści:
<?php phpinfo(); ?>
Następnie uruchom wiersz poleceń i przejdź do katalogu "Moje dokumenty" tak, jak widoczne to jest na kolejnym obrazku:
W wierszu poleceń możesz poruszać się po katalogach przy pomocy polecenia cd. W znaku zachęty system zawsze pokaże Ci bieżącą ścieżkę. Po znalezieniu się w Moich dokumentach wpisujemy:
php phpinfo.php
Jeśli wszystko zadziałało poprawnie, na ekranie powinno pojawić się dość dużo tekstu:
PHP wydrukował po prostu wszystkie dostępne informacje o swojej bieżącej konfiguracji, a to znak, że wszystko działa i możemy zająć się już samym TypeFriendly.
Aby pobrać TypeFriendly, wchodzimy na stronę www.invenzzia.org do działu "Pliki". Pobieramy stamtąd najnowszą wersję skryptu.
Rozpakujmy go do katalogu D:\tf\
Plik typefriendly.php musi znaleźć się bezpośrednio w folderze D:\tf\ (bez żadnych dodatkowych podkatalogów, chyba że chcesz mieć więcej do wklepywania). Powróćmy teraz do wiersza poleceń. Podręcznik do TypeFriendly jest również stworzony w TypeFriendly i dostarczany w wersji źródłowej, stanowiąc równocześnie przykład. Dlatego aby sprawdzić poprawność działania, spróbujemy stworzyć jego wersję HTML.
Aby przełączyć się w wierszu poleceń na inny dysk, wystarczy wpisać jego literę i zakończyć linijkę dwukropkiem. Dalej możemy na powrót poruszać się poleceniem cd. Po przejściu do katalogu TypeFriendly, wydajemy polecenie:
php typefriendly.php -o xhtml ./docs/
Flaga -o xhtml oznacza, że chcemy stworzyć wersję XHTML podręcznika, którego źródła znajdują się w ./docs/ (kropka oznacza bieżący katalog). Jeśli wszystko poszło dobrze, powinniśmy ujrzeć następujący widok:
Wygenerowaną dokumentację znajdziesz w D:\tf\docs\output\xhtml\:
To wszystko - udało Ci się właśnie zainstalować PHP oraz TypeFriendly pod systemem Windows. Mi już pozostaje życzyć tylko miłego pisania.
