Both sides previous revision
Poprzednia wersja
Nowa wersja
|
Poprzednia wersja
|
pl:miw:2009:miw09_wiki_papers:howto [2009/06/04 08:55] jsi08 |
pl:miw:2009:miw09_wiki_papers:howto [2019/06/27 15:50] (aktualna) |
* curl | * curl |
* gd2 | * 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 | - 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]] | - Edytuj [[pl:miw:2009:miw09_wiki_papers:wyprobuj|stronę testową]] dla [[pl:miw:2009:miw09_wiki_papers|Wiki Papers]] |
| |
===== Składnia ===== | ===== 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;...;; | options:OPCJA1;OPCJA2;...;; |
| title:Tytuł wykresu lub tabeli;; |
| author:Jan Nowak;; |
| DBLP:2008;; |
| </papers> |
</code> | </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;; | author:Imie i Nazwisko 1;http://www.strona.pana1.com;; |
[publikacje pana 1] | [publikacje pana 1] |
[publikacje pana 2] | [publikacje pana 2] |
</code> | </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;; | BIBLIOGRAFIA:OPCJE;ROK;http://strona.zawierająca.publikacje/pana=X;; |
</code> | </code> |
</code> | </code> |
Zalecane jest podanie adresu dla publikacji. W przeciwnym wypadku zostanie on wygenerowany automatycznie (bez gwarancji poprawności!!) | 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]] | 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 ==== | ==== Dostępne publikacje ==== |
| |
| |
===== 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 ==== | ==== Najprostszy wariant ==== |
<code> | <code> |
DBLP:2008;http://url.dblp/podany/dla=nowaka;; | DBLP:2008;http://url.dblp/podany/dla=nowaka;; |
BPP:2005;http://url.bpp/podany/dla=nowaka;; | BPP:2005;http://url.bpp/podany/dla=nowaka;; |
</paprs> | </papers> |
</code> | </code> |
Opcje wpisujemy w pluginie raz, kiedy ich nie określimy, używane są domyślne. \\ | Opcje wpisujemy w pluginie raz, kiedy ich nie określimy, używane są domyślne. \\ |
Zostaną wyświetlone publikacje na 3 możliwe sposoby: | 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 ^ | ^ author ^ DBLP::2008 ^ BPP::2005 ^ |