Spis treści

Opis

Projekt zakończony

Tomasz Huczek, tomasz.huczek@gmail.com

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

Spotkania

08.03.04

080318

080408

080422

Projekt

Cel Projektu

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.

Specyfikacja Funkcji

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

Istniejące rozwiązania

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

Błędy istniejących rozwiązań

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


Następujących rzeczy brak:

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

Wątpliwości


Jak działało załączanie

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)

Testowanie bazy BibTeX

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

Prototyp

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ąć:

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

TODO

Stylowanie

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.

Sprawozdanie

miw-bibtex-sprawozdanie.pdf

Materiały

Plugin wykonany w ramach projektu w roku 2007
Obecna wersja pluginu

DokuWiki