Paweł Miczko (4AR) mieczyslav@gmail.com

Kowerter DokuWiki do LaTeX. Zbadać poziom zaimplementowania oferowanych rozwiązań. Zaimplementować.

• przebieg prac nad projektem

• plugin
• instrukcja instalacji pluginu

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:

• formatowanie tekstu
• nagłówki
• listy numerowane i nienumerowane
• linki wewnętrzne i zewnętrzne
• tworzenie odnośników
• wstawianie grafiki

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:

• czysty tekst parsujemy bez zmian

• Bold Text → \textbf{}

• Italic Text → \textit{}

• Underlined Text → \underline{}

• code → \verb||

dwie spacje -> \begin{verbatim}

Strike-through Text → \sout{}

• - Ordered List Item → \enumerate

• * Unordered List Item → \itemize

• Linki zewnętrzne → \url

Konwertowanie działa na bazie wyrażeń regularnych i PHPowskiej funkcji preg_match_all. Konieczna była także 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. Prace nad projektem zakończyły się spakowaniem pluginu i stworzeniem instrukcji obsługi potrzebnej do jego instalacji.