--- pl:miw:2009:miw09_wiki_papers:howto [2009/06/03 23:09]
jsi08
+++ pl:miw:2009:miw09_wiki_papers:howto [2019/06/27 15:50] (aktualna)
@@ Linia 5: / Linia 5: @@
     * curl
     * gd2
-  - Rozpakuj plik {{:pl:miw:2009:miw09_wiki_papers:wiki_papers_beta.tar.gz|wiki_papers_beta.tar.gz}} do katalogu ''lib/plugins''
+  - Rozpakuj plik {{:pl:miw:2009:miw09_wiki_papers:wiki_papers-2.tar.gz|wiki_papers-2.tar.gz}} do katalogu ''lib/plugins''
   - Nadaj odpowiednie uprawnienia dla skopiowanego katalogu
   - Edytuj [[pl:miw:2009:miw09_wiki_papers:wyprobuj|stronę testową]] dla [[pl:miw:2009:miw09_wiki_papers|Wiki Papers]]
@@ Linia 14: / Linia 14: @@
 ===== Składnia =====
-Między znacznikami ''<papers></papers>'' określamy:
+Między znacznikami ''<papers></papers>'' umieszczamy opcje, nagłówki, tytuł, autorów oraz publikacje. W przypadku wielu opcji, oddziela się je średnikiem. Każdy z elementów zakończony jest podwójnym średnikiem:
-  * opcje nie są obowiązkowe \\ <code>
+<code>
+<papers>
 options:OPCJA1;OPCJA2;...;;
+title:Tytuł wykresu lub tabeli;;
+author:Jan Nowak;;
+DBLP:2008;;
+</papers>
 </code>
-  * autorów; może być wielu autorów \\ <code>
+==== Opcje ====
+Opcje nie są obowiązkowe. Domyślną opcją jest ''TEXT''.
+Lista dostępnych opcji:
+  * Główne:
+    * ''TEXT'' -- wyświetl tekst
+    * ''TABLE'' -- wyświetl tabelę
+    * ''CODE'' -- wyświetl jako kod
+    * ''CHART'' -- wyświetl wykres
+  * Sterujące:
+    * ''EXTRASPAN'' -- poszerza wykres (pomocne, gdy opisy na osi nachodzą na siebie)
+    * ''NOHEADERS'' -- nie generuj nagłówków i nie porządkuj kolumn tabeli (nagłówki użytkownika zostaną dodane, jeśli zdefiniowano)
+    * ''HIDEAUTHOR'' -- nie wyświetlaj autora w tekście
+    * ''SHOWINFO'' -- wyświetl identyfikatory obok numerów publikacji
+Przykład:
+<code>
+options:CHART;EXTRASPAN;;
+</code>
+Wyświetli się wykres ze zwiększoną szerokością słupków.
+==== Nagłówki ====
+Nagłówki generują się automatycznie na podstawie wybranych przez użytkownika statystyk publikacji. Można je wyłączyć (opcja ''NOHEADERS'') lub podmienić zdefiniowanymi przez siebie:
+<code>
+options:TABLE;;
+headers:Wiosna;Lato;Jesień;Zima;;
+</code>
+Wyświetli się tabela z podmienionymi nagłówkami.
+==== Tytuł ====
+Dodaje tytuł do tabeli lub wykresu.
+<code>
+options:CHART;;
+title:Tytułowy tytuł;;
+</code>
+Wyświetli wykres zatytuowany 'Tytułowy tytuł'.
+==== Autorzy ====
+Może być wielu autorów w jednym bloku kodu Wiki Papers. Po określeniu autora sprawdzane są jego publikacje, aż do następnego autora lub końca bloku ''</papers>''. Na wyjściu autorowi przydzielony jes wiersz tekstu, jeden wiersz tabeli lub jeden kolor słupka wykresu. Autorowi można określić adres strony, która będzie wyświetlana po kliknięciu na link z jego nazwiskiem.
+<code>
 author:Imie i Nazwisko 1;http://www.strona.pana1.com;;
 [publikacje pana 1]
@@ Linia 24: / Linia 69: @@
 [publikacje pana 2]
 </code>
-  * publikacje; możliwa dowolna ilość publikacji różnego rodzaju \\ <code>
+==== Publikacje ====
+Możliwa dowolna ilość publikacji różnego rodzaju. Publikacje określa się, podając jej bibliografię, ewentualne opcje, rok, oraz URL (zalecane), który wskazuje na stronę z określonymi publikacjami. W przypadku niepodania URL, plugin wygeneruje adres automatycznie na podstawie zadanych parametrów, jednak bez gwarancji sukcesu (np. Kowalskich jest w bazie dwóch i nie ma jednoznaczności).
+Szablon:
+<code>
 BIBLIOGRAFIA:OPCJE;ROK;http://strona.zawierająca.publikacje/pana=X;;
 </code>
@@ Linia 34: / Linia 84: @@
 </code>
 Zalecane jest podanie adresu dla publikacji. W przeciwnym wypadku zostanie on wygenerowany automatycznie (bez gwarancji poprawności!!)
+==== Przykłady ====
 Zobacz: [[pl:miw:2009:miw09_wiki_papers#section1|Składnia]]
-FIXME
-Pełny przykład: [[pl:miw:2009:miw09_wiki_papers:wyprobuj|Wypróbuj]]
+Rzeczywisty przykład: [[pl:miw:2009:miw09_wiki_papers:wyprobuj|Wypróbuj]] lub [[pl:miw:2009:miw09_wiki_papers:wyprobuj1|Wypróbuj1]]
 ==== Dostępne publikacje ====
@@ Linia 61: / Linia 112: @@
-===== Przykłady =====
+===== Przykłady użycia =====
-FIXME
+W przykładach zamieszczam fikcyjne dane jedynie po to, aby zobrazować użycie składni.
+Działający przykład jest [[pl:miw:2009:miw09_wiki_papers:wyprobuj|tutaj]] i [[pl:miw:2009:miw09_wiki_papers:wyprobuj1|tu]].
 ==== Najprostszy wariant ====
 <code>
@@ Linia 73: / Linia 127: @@
 Wyświetli się:
-Kowalski, [[http://url.dblp/automatycznie/wygenerowany/dla/kowalskiego|13]], [[http://url.bpp/automatycznie/wygenerowany/dla/kowalskiego|1313]]
+Kowalski: [[http://url.dblp/automatycznie/wygenerowany/dla/kowalskiego|13]], [[http://url.bpp/automatycznie/wygenerowany/dla/kowalskiego|1313]]
 Lepiej jednak podać url dla publikacji danego autora za każdym razem. Zapobiegnie to sytuacji, kiedy nie zostanie odnaleziony w bazie publikacji zadany autor. Będziemy również pewni, że nasz adres jest prawidłowy i określa autora __jednoznacznie__. W przypadku błędnego url (naszego, czy też wygenerowanego) możemy zobaczyć (jeśli mamy szczęście) zamiast liczby publikacji komunikat o błędzie.
@@ Linia 87: / Linia 141: @@
     DBLP:2008;http://url.dblp/podany/dla=nowaka;;
     BPP:2005;http://url.bpp/podany/dla=nowaka;;
-</paprs>
+</papers>
 </code>
 Opcje wpisujemy w pluginie raz, kiedy ich nie określimy, używane są domyślne. \\
 Na wyjściu zobaczymy:
-Kowalski, [[http://url.dblp/podany/dla=kowalskiego|DBLP::2008=13]], [[http://url.bpp/podany/dla=kowalskiego|BPP::2005=1313]]
+Kowalski: [[http://url.dblp/podany/dla=kowalskiego|DBLP::2008=13]], [[http://url.bpp/podany/dla=kowalskiego|BPP::2005=1313]]
-[[http://www.nowak.com|Nowak]], [[http://url.dblp/podany/dla=nowaka|DBLP::2008=22]], [[http://url.bpp/podany/dla=nowaka|BPP::2005=44]]
+[[http://www.nowak.com|Nowak]]: [[http://url.dblp/podany/dla=nowaka|DBLP::2008=22]], [[http://url.bpp/podany/dla=nowaka|BPP::2005=44]]
 ==== Opcje dla wyświetlania tekstu ====
@@ Linia 152: / Linia 206: @@
 Zostaną wyświetlone publikacje na 3 możliwe sposoby:
-Kowalski, [[http://url.dblp/podany/dla=kowalskiego|13]], [[http://url.bpp/podany/dla=kowalskiego|1313]]
+Kowalski: [[http://url.dblp/podany/dla=kowalskiego|13]], [[http://url.bpp/podany/dla=kowalskiego|1313]]
-[[http://www.nowak.com|Nowak]], [[http://url.dblp/podany/dla=nowaka|22]], [[http://url.bpp/podany/dla=nowaka|44]]
+[[http://www.nowak.com|Nowak]]: [[http://url.dblp/podany/dla=nowaka|22]], [[http://url.bpp/podany/dla=nowaka|44]]
 ^  author  ^  DBLP::2008  ^  BPP::2005  ^

pl/miw/2009/miw09_wiki_papers/howto.1244063393.txt.gz · ostatnio zmienione: 2019/06/27 15:57 (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