Różnice między wybraną wersją a wersją aktualną.
| Both sides previous revision Poprzednia wersja Nowa wersja | Poprzednia wersja | ||
|
pl:miw:miw08_dokuviz:sprawozdanie [2008/04/15 10:09] gjn |
pl:miw:miw08_dokuviz:sprawozdanie [2019/06/27 15:50] (aktualna) |
||
|---|---|---|---|
| Linia 2: | Linia 2: | ||
| ===== Wstęp ===== | ===== Wstęp ===== | ||
| * celem zadania było utworzenie pluginu dla Dokuwiki umożliwiającego renderowanie diagramów z zamieszczonego kodu DOT, oraz plików umieszczonych w wiki. | * celem zadania było utworzenie pluginu dla Dokuwiki umożliwiającego renderowanie diagramów z zamieszczonego kodu DOT, oraz plików umieszczonych w wiki. | ||
| + | |||
| ===== Rozbudowa istniejącego pluginu ===== | ===== Rozbudowa istniejącego pluginu ===== | ||
| - | * czego nie było | + | Graphviz plugin dla Dokuwiki został oparty na znalezionym rozwiązaniu http://wiki.ioslo.net/dokuwiki/graphviz/ |
| - | * co dodano | + | Wersja ta obsługiwała podstawową funkcjonalność, tj. renderowanie diagramów z zamieszczonego w wiki kodu dot. |
| - | FIXME | + | W stosunku do znalezionej w sieci wersji wprowadzono następujące ulepszenia: |
| + | * możliwość renderowania diagramów z zamieszczonych w wiki plików dot | ||
| + | * możliwość renderowania diagramów z plików dot znajdujących się w sieci, poprzez podanie ścieżki url. Funkcjonalność ta została osiągnięta, dzięki wykorzystaniu narzędzia Curl. | ||
| + | * dodano możliwość zdefiniowania wysokości i szerokości renderowanych diagramów | ||
| + | * poprawiono sposób generowania plików png, gdyż w poprzedniej wersji zastosowane nieoptymalne rozwiązanie powodujące utratę jakości. | ||
| ===== Instalacja pluginu ===== | ===== Instalacja pluginu ===== | ||
| Linia 41: | Linia 46: | ||
| <code><graphviz neato file="pl:miw:plik.dot" width ="100" height="50"></graphviz></code> | <code><graphviz neato file="pl:miw:plik.dot" width ="100" height="50"></graphviz></code> | ||
| - | ====== Zasadzki ====== | + | |
| - | cache w wiki | + | |
| - | ??? | + | |
| + | |||
| + | ===== Zasadzki ===== | ||
| + | W związku ze sposobem działania mechanizmu cache w Dokuwiki istnieje możliwość, że plugin nie zadziała poprawnie. Nie wgłębiając się w szczegóły mechanizm cache w Dokuwiki wywołuje plugin podczas zapisywania dokumentu. Sam plugin renderuje diagramy w przypadku, gdy natrafi na kod, którego nigdy wcześniej nie renderował. W przeciwnym przypadku zostanie załadowany obrazek przechowywany w pamięci cache. Może się zatem zdarzyć, że renderując diagram z zewnętrznego pliku który ulegnie zmianie, plugin tych zmian nie wykryje gdyż podany kod: | ||
| + | "<graphviz url=".."></graphviz>" | ||
| + | będzie w obu przypadkach identyczny. W razie wystąpienia tego typu problemów pomóc powinno wyczyszczenie zawartości katalogu: | ||
| + | wiki/data/media/graphviz | ||
| + | Można również użyć opcji NOCACHE -> http://wiki.splitbrain.org/wiki:caching | ||
