To jest stara wersja strony!
Opis
Paweł Miczko (4AR) mieczyslav@gmail.com
Kowerter DokuWiki do LaTeX.
Zbadać poziom zaimplementowania oferowanych rozwiązań.
Zaimplementować.
Spotkania
Projekt
Sprawozdanie
1. Cel projektu
Celem projektu było stworzenie pluginu do DokuWiki, który konwertowałby jej strony do formatu LaTeX.
Konwerter obejmuje podstawową składnię wiki, a więc:
2. Wykonanie
Na cele projektu założone zostało wiki znajdujące się pod adresem
http://student.agh.edu.pl/~micz/dokuwiki-2007-06-26b.
Prace nad projektem rozpoczęły się od określenia wstępnej specyfikacji fukcjonalności oraz scenariuszy użycia.
Funkcjonalności, jakie powinien wykazywać plugin, to przede wszystkim zamiana składni wiki na składnię latexa i tak na przykład:
dwie spacje -> \begin{verbatim}
Subscript →
Superscript →
======zzz====== → /section{zzz} /label{zzz} (w celu póżniejszych odnośników)
caption → \begin{figure} \includegraphics{Grafika} \caption{caption} \end{figure}
Zdefiniowano 3 możliwe przypadki użycia:
Do realizacji wybrany został jeden z nich:
Do stworzenia pluginu wybrany został język PHP. Parser został napisany obiektowo (z zastosowaniem klas).
Funkcja konwertująca parse() działa na bazie wyrażeń regularnych i PHPowskiej funkcji preg_match_all.
Prace nad projektem zakończyły się spakowaniem pluginu i stworzeniem instrukcji obsługi potrzebnej do jego instalacji. Dokonuje się jej za pomocą plugin managera.
Po prawidłowym zainstalowaniu pluginu u góry każdej strony w Wiki obok przycisków „Edytuj stronę” i „Poprzednie wersje” pojawia się przycisk „Konwertuj do Latexa”. Po jego naciśnięciu zostaje wywołana odpowiednia funkcja i otwiera się nowe okno zawierające przetworzony do Latexa kod.
Ostatnim etapem prac było napisanie niniejszego sprawozdania.
3. Zasadzki
W trakcie prac nad projektem okazało się, że konieczna będzie odpowiednia obsługa 10 znaków specjalnych TeXa: { , }, \, $, _, %, &, ~, ^, # które w wiki nie sprawiają problemów, ale po przeklejeniu w niezmienionej postaci powodowałyby błędy w kompilacji. Zostały one dołączone do listy rzeczy do zrobienia i odpowiednio załatwione.
Spośród
4. Możliwości kontynuacji
Materiały