Projekt zakończony

Tomasz Huczek, tomasz.huczek@gmail.com

Bibtexplugin for dokuwiki, urlopen problems, bibtex file stored as an attachment in the wiki

• style: standardowe style latex + lncs, aaai
• jak działało załączanie?

• obsł. przestrz nazw, w swoim wiki
• próba obsługi styli? jak się mają te style do styli w latexu
• sposób pobierania plików nie przez url

• testy → udostepn pluginu
• możliwośc robienia własnych stylów.

Celem projektu jest stworzenie pluginu do DokuWiki umożiwiającego wstawianie do dokumentów spisów treści w formacie BibTeX. Plugin ma udostępniać szereg funkcji, w tym załączanie zewnętrznych plików oraz plików załączonych na serwerze DokuWiki. Plugin również ma udostępniać możliwość zmiany stylu wyświetlanej treści BibTeX.

Plugin powinien udostępniać szereg funkcjonalności takich jak tworzenie spisu na kilka sposobów:

1. treść BibTeX wpisywana w źródło strony DokuWiki
2. treść BibTeX jako zewnętrzny plik
3. treść BibTeX jako plik załącznika do dokumentu DokuWiki

Możliwe formy znaczników:

<bibtex mode="text">
@Book{BookAmbroise2004,
  author = 	 {G.J. McLachlan and  K.A. Do and  C. Ambroise},
  title = 	 {Analyzing microarray gene expression data},
  publisher = 	 {Wiley},
  url={http://www.amazon.com/exec/obidos/tg/detail/-/0471226165/qid=1128710740/sr=8-1/ref=sr_8_xs_ap_i1_xgl14/002-9543089-9105613?v=glance&s=books&n=507846},
  year = 	 2004
}
</bibtex>

<bibtex mode="url">[[http://test.com/file.bib]]</bibtex>

<bibtex mode="file">{{file.bib}}</bibtex>

Plugin powinien udostępniać możliwość zmiany stylu spisu na przykład poprzez

<bibtex mode="url" style="ieee">[[http://www.test.com/file.bib]]</bibtex>

Przykłady różnych styli BibTeX - http://www.cs.stir.ac.uk/~kjt/software/latex/showbst.html

Pluginy obsługujące BibTeX w Doku wiki:

1. http://stat.genopole.cnrs.fr/~cambroise/doku.php?id=softwares:dokuwikibibtexplugin - wyłącznie kod BibTeX wpisywany w źródło strony DokuWiki
2. http://perso.ensi-bourges.fr/jfl/doku.php?id=wiki:bibtex - dodatkowe opcje takie jak sortowanie, różne style. przykład działania. Nie tetowane

Przetestowałem projekt z poprzedniego roku. To co funkcjonuje:

• załączanie kodu BibTeX jako źródło strony
• załączanie pliku do dokumentu DokuWiki
• załączanie pliku jako zewnetrznego adresu

Następujących rzeczy brak:

• brak różnych styli wyświetlania
• nieprawidłowy format xhtml (definicje wewnątrz tagów akapitów <p></p>)

Rozwiązania podane w odnośnikach z poprzedniego podpunktu nie spełniają w całości założeń projektu wymienionych na wstepie.

• dlaczego projekt z poprzedniego roku nie działał na DokuWiki MiW? (załączanie plików lokalnych)

Załączanie (dla plików wewnętrznych - na serwerze DokuWiki) działa w ten sposób, że pobierany jest plik z katalogu:

DOKU_INC + 'data/media/'

Więc mogą pojawić się problemy, gdy pliki uploadowane nie trawiają do katalogu /data/media (można zmienić chyba tę ścieżkę przy instalacji DokuWiki)

Przetestowałem lokalnie pliki *bib z naszej DokuWki i wszystkie wyświetlają się prawidłowo, beż żadnych błędów.

Zainstalowałem DokuWiki na swoim testowym serwerze. Pod adresem: http://archiveme.net/dokuwiki/start:miw:eng znajduje się przykładowa strona z przestrzeniami nazw (2 poziomy) oraz przykładowe spisy treści wygenerowane pluginem BibTeX.

Udało się osiągnąć:

• adres pliku pobierany jest wewnętrzną funkcją DokuWiki string mediaFN( $fn ) - brak problemów z przestrzeniami nazw
• stylowanie wewnetrznymi metodami biblioteki OSBib

Stylowanie działa na zasadzie:

<bibtex style="ieee" mode="file">{{:start:miw:hekate.bib|}}</bibtex>

<bibtex style="chicago" mode="file">{{:start:miw:hekate.bib|}}</bibtex>

Dostępne style oferowane przez bibliotekę OSBib są wymienione na stronie odanej powyżej, a są to: APA, ieee, britishmedicaljournal, chicago, harvard, mla, turabian

• usunąć testowe wyświetlanie ścieżek do pliku media powyżej spisu treści

Stylowanie jest zarządzane przez bibliotekę OSBib, która zawiera kilka gotowych styli opisanych w formacie XML. Przykładowy plik z opisem stylu: apa.xml

Niestety nie udało mi się znaleźć żadnego narzędzia do prostej edycji/tworzenia styli w tym formacie.

miw-bibtex-sprawozdanie.pdf

• :pl:miw:miw07-bibtex.tar.gz

• :pl:miw:bibtex-th-15-06-2008.zip

• http://wiki.splitbrain.org/wiki:plugins:syntax_tutorial - plugin development tutorial
• http://wiki.splitbrain.org/wiki:plugins:syntax_skeleton - szkielet pluginu
• http://wiki.splitbrain.org/wiki:plugins:file_structure - struktura katalogów pluginów
• http://dev.splitbrain.org/reference/dokuwiki/nav.html?inc/io.php.html - DokuWiki framework