Michał Kotra, mkotra@student.agh.edu.pl

GraphViz plugin dla Dokuwiki, renderowanie diagramow z zamieszczonego w wiki kodu DOT oraz plikow umieszczanych w wiki.

co jest/czego brakuje w http://wiki.ioslo.net/dokuwiki/graphviz/

• znaleziony plugin został przetestowany z dokuWiki i działa poprawnie. Wersja zapewnia podstawową funkcjonalność, tj. renderowanie diagramów z zamieszczonego w wiki kodu DOT (kod musi byc obłożony tagami: <graphviz mode></graphviz> (przy czym mode = dot, neato, twopi, circo, fdp). Działanie zostało przetestowane na systemie Linux z zainstalowaną dokuWiki 2007-06-26b oraz graphviz w wersji 2.12-4.
• plugin nie umożliwia generowania kodu z zamieszczonych gotowych plików DOT. Należałoby zatem dopisać taką funkcjonalność do istniejącego kodu.
• dodatkowo istnieje możliwość włączenia obsługi generowania diagramów uml (wymaga jeszcze przetestowania) Uml Graph Sun Java 5 Jsdk

• prototyp czytania z pliku dot w wiki, uwaga:

<graphviz file="pl:miw:costam.dot"></graphviz>

• Do istniejącego pluginu została dopisana żądana funkcjonalność. Możliwe jest korzystanie z plików *.dot, ścieżki do plików korzystają z przestrzeni nazw tak jak w przykładzie.

• Dodano obsługę adresów url

<graphviz url="http://www.costam.org/costam.dor"></graphviz>

• Wersja testowa pluginu znajduje się pod adresem: http://student.agh.edu.pl/~mkotra/graphviz.tar

• Aby możliwe było zamieszczanie w wiki plików *.dot niezbędne jest dodanie w pliku conf/mime.conf linii:

dot    application/graphviz 

• naprawa bugów
• testy na stronie notatki
• poprawiono obsługę url, wykorzystując narzędzie Curl
• graphviz od razu generuje png [bez zbędnej konwersji ps-png]
• dodanie możliwości ustawienia parametrów width i height height=„300” width=„800”
• aktualna wersja: http://student.agh.edu.pl/~mkotra/graphviz.tar

• sprawozd
• debug - graphviz
• protot prologu - zrobiony, pokażę na konsultacjach

na przyszłość: * dokuviewvc, patrz http://viewvc.org/ (embedded) * dokutrac, patrz: http://cvstrac.org/, http://trac.edgewall.org/

Prostsza i lepiej zdefiniowana propozycja: plugin do wiki do uruchamiania Prologu, scenariusze użycia:

• zadaję pluginowi kod i goal

<prolog goal="kobieta(X),write(X),nl,fail">
kobieta(kasia).
mezczyzna(jasiu).
</prolog>

• zadaję pluginowi nazwę pliku z kodem w wiki i goal

<prolog goal="kobieta(X)" file="pl:miw:test.pl">
</prolog>

<prolog goal="kobieta(X) url="http://costam.org/test.pl">
</prolog>

• mogę skojarzyć z każdą strona wiki kod prologu, zadaję pluginowi goal i scope: interpretowanie tylko tej strony, zbioru stron, np. namespace

<prolog goal="kobieta(X)" scope="."> ta str
<prolog goal="kobieta(X)" scope="pl:miw:proj"> podana str
<prolog goal="kobieta(X)" scope="pl:miw:"> namespace
<prolog goal="kobieta(X)" scope="pl:miw:proj.*08"> regexp

<prolog>
kobieta(kasia).
mezczyzna(jasiu).
</prolog>

• pytania:
  • co z frag prolog z goal? też merge
  • co z cache → scenariusze?
  • jak zadawać scope, co może Panu przeszukać wiki? regexp
  • defaultowe wypisywanie w celu?

<prolog goal=„kobieta(X),write(X),nl,fail”>

  <prolog goal="kobieta(X)" wrt="y">

• mieszana składnia wiki… → msc

Testy pluginu na osobnej stronie

sprawozdanie

• http://wiki.ioslo.net/dokuwiki/graphviz
• http://wiki.splitbrain.org/wiki:plugins:syntax
• http://wiki.splitbrain.org/wiki:plugins:syntax_tutorial