--- pl:miw:miw08_dokubibtex [2008/02/19 11:11]
gjn
+++ pl:miw:miw08_dokubibtex [2019/06/27 15:50] (aktualna)
@@ Linia 1: / Linia 1: @@
 ====== Opis ======
+__**Projekt zakończony**__
 Tomasz Huczek, <tomasz.huczek@gmail.com>
@@ Linia 5: / Linia 7: @@
 ====== Spotkania ======
+===== 08.03.04 =====
+===== 080318 =====
+  * style: standardowe style latex + lncs, aaai
+  * jak działało załączanie?
+===== 080408 =====
+  * 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
+===== 080422 =====
+  * testy -> udostepn pluginu
+  * możliwośc robienia własnych stylów.
 ====== 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:
+  - treść BibTeX wpisywana w źródło strony DokuWiki
+  - treść BibTeX jako zewnętrzny plik
+  - treść BibTeX jako plik załącznika do dokumentu DokuWiki
+\\
+Możliwe formy znaczników:
+<code>
+<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>
+</code>
+<code>
+<bibtex mode="url">[[http://test.com/file.bib]]</bibtex>
+</code>
+<code>
+<bibtex mode="file">{{file.bib}}</bibtex>
+</code>
+Plugin powinien udostępniać możliwość zmiany stylu spisu na przykład poprzez
+<code>
+<bibtex mode="url" style="ieee">[[http://www.test.com/file.bib]]</bibtex>
+</code>
+\\
+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:
+  - [[http://stat.genopole.cnrs.fr/~cambroise/doku.php?id=softwares:dokuwikibibtexplugin]] - wyłącznie kod BibTeX wpisywany w źródło strony DokuWiki
+  - [[http://perso.ensi-bourges.fr/jfl/doku.php?id=wiki:bibtex]] - dodatkowe opcje takie jak sortowanie, różne style. [[http://perso.ensi-bourges.fr/jfl/doku.php?id=research:publications|przykład działania]]. **Nie tetowane**
+==== Błędy istniejących rozwiązań ====
+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.
+==== Wątpliwości ====
+  * dlaczego projekt z poprzedniego roku nie działał na DokuWiki MiW? (//załączanie plików lokalnych//)
+----
+==== 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:
+<code>DOKU_INC + 'data/media/'</code>
+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|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:
+<code><bibtex style="ieee" mode="file">{{:start:miw:hekate.bib|}}</bibtex></code>
+<code><bibtex style="chicago" mode="file">{{:start:miw:hekate.bib|}}</bibtex></code>
+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 ===
+  * usunąć testowe wyświetlanie ścieżek do pliku **media** powyżej spisu treści
+=== Stylowanie ===
+Stylowanie jest zarządzane przez bibliotekę OSBib, która zawiera kilka gotowych styli opisanych w formacie XML. Przykładowy plik z opisem stylu: [[http://archiveme.net/dokuwiki/APA.xml|apa.xml]]
+Niestety nie udało mi się znaleźć żadnego narzędzia do prostej edycji/tworzenia styli w tym formacie.
 ====== Sprawozdanie ======
+{{:pl:miw:miw-bibtex-sprawozdanie.pdf|miw-bibtex-sprawozdanie.pdf}}
 ====== Materiały ======
-{{:pl:miw:miw07-bibtex.tar.gz|:pl:miw:miw07-bibtex.tar.gz}}
+== Plugin wykonany w ramach projektu w roku 2007  ==
+  * {{:pl:miw:miw07-bibtex.tar.gz|:pl:miw:miw07-bibtex.tar.gz}}
+== Obecna wersja pluginu  ==
+  * {{:pl:miw:bibtex-th-15-06-2008.zip|:pl:miw:bibtex-th-15-06-2008.zip}}
+==== DokuWiki ====
+  * [[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

pl/miw/miw08_dokubibtex.1203415891.txt.gz · ostatnio zmienione: 2019/06/27 15:58 (edycja zewnętrzna)

Pokaż stronę Poprzednie wersje

Menadżer multimediów Do góry

AIwiki

Menu

Dla Studentów

Old specialized AI courses

SMaDA/SMaIDA/AIDA

Informatyka (EAIiIB)

Studia Dr

Inne materialy dydaktyczne

Archiwum

Dyplomanci

Geist Season of Code

HeKatE

Public

Różnice