PPGWiki: Pomoc

More...

Na tej stronie znajdują się informacje związane z obsługą portalu PPGWiki.

Idea wiki #

Portale wiki związane są ściśle z ideą OpenContent czyli otwartego tworzenia treści (podejście wzorowane prawdopodobnie na idei OpenSource).
Istnieje wiele implementacji portali wiki. Głównym założeniem jest prostota i szybkość tworzenia treści przez określoną grupę osób (Wiki to po hawajsku "szybko"). Zakłada się, że podstawowe zasady tworzenia treści na portalu wiki powinny być do opanowania w ciągu kilu / kilkunastu minut.
Od storny użytkownika wiki nie wymaga żadnego dodatkowego oprogramowania poza przeglądarką.

Struktura wiki#

Portal wiki bazuje na podejściu hipertekstowym (graf skierowany, w którym wierzchołkami są strony, a krawędziami linki).

Dodawanie nowych stron#

Logujemy się do portalu.
Wybieramy dowolną stronę portalu PPGWiki.
Wybieramy zakładkę EditPage.
Umieszczamy na stronie link do nowo tworzonej strony np. [Nowa strona PPGWiki]. (Uwaga nazwa strony musi być unikalna.)
Wybieramy przycisk Save.
W efekcie powinien pojawić się czerwony link Nowa strona PPGWiki. Po jego wybraniu portal automatycznie utworzy żądaną stronę i udostępni ją do edycji.
Po wpisaniu treści strony i jej zapisaniu przyciskiem Save powstanie nowa strona portalu.

Podstawy formatowania treści #

---- = tworzy pojedynczą linijkę. Każdy nadmiarowy znak "-" jest ignorowany.
\\ = przełamuje tekst do następnej linii (tworzenie nagłówka i pewnych innych elementów automatycznie przełamuje tekst).
\\ \\ = tworzy dwa przełamania strony (każde przełamanie od kolejnego musi zostać przedzielone odstępem).
[łącze] = tworzy łącze do miejsca w dokumencie oznaczonego etykietką "Łącze"
[to także jest łącze] = tworzy łącze do miejsca w dokumencie oznaczonego 
etykietką 'ToTakżeJestŁącze', ale samą w nazwę łącza pokazuje wraz z odstępami.
[oto przykład|łącze] = tworzy łącze do miejsca w dokumencie oznaczonego etykietką
'Łącze', ale jako nazwę łącza wyświetla 'oto przykład'.
~[BezŁącza] = deaktywuje tworzenie łącza dla słowa w nawiasach kwadratowych.
[1] = tworzy odwołanie do przypisu oznaczonego numerem 1.
[#1] = zaznacza przypis oznaczony numerem 1.
!nagłówek = tworzy mały nagłówek z tekstem 'nagłówek'.
!!nagłówek = tworzy średniej wielkości nagłówek z tekstem 'nagłówek'.
!!!nagłówek = tworzy duży nagłówek z tekstem 'nagłówek'.
''tekst'' = wyświetla 'tekst' z kursywą.
__tekst__ = wyświetla 'tekst' pogrubiony.
{{tekst}} = wyświetla 'tekst' czcionką o stałej szerokości znaków.
[tekst|] = wyświetla 'tekst' podkreślony'.
* tekst = tworzy element 'tekst' listy punktowanej.
# tekst = tworzy element 'tekst' listy numerowanej.
;poj:obj = tworzy definicję dla 'poj' z objaśnieniem 'obj'.

Gdy zdarzy się, że więcej osób zamierza edytować tą samą stronę w jednym czasie, system Wiki nie dopuści do wprowadzania zmian i wyświetli informację o błędzie. Uwaga! Jeżeli użytkownik użyje przycisku Wstecz (Back) w przeglądarce, by powrócić do edytowania strony, niemalże zawsze wyświetlona zostanie informacja o błędzie. Dzieje się tak dlatego, że przeglądarka myśli, że wciąż jest edytowana poprzednia kopia strony.

Tworzenie hiperłącz#

Łączem może być zarówno bezpośredni adres internetowy zaczynający się od http:, ftp:, mailto:, https:, or news:. Wówczas łącze wskazuje na zewnętrzną stronę. Dla przykładu: należy wpisać [http://www.amu.edu.pl/], aby uzyskać takie odwołanie: http://www.amu.edu.pl/

lub [Uniwersytet im. A. Mickiewicza w Poznaniu|http://www.amu.edu.pl/], aby uzyskać: Uniwersytet im. A. Mickiewicza w Poznaniu

. Nazwa łącza może składać się z dowolnej liczby znaków, liter bądź liczb.

Usuwanie stron#

Stronę usunąć może tylko osoba posiadająca prawa administratora. W tym celu należy wybrać opcję PageInfo i wybrać przycisk Delete entire page.

Usuwanie załączników#

Załącznik usunąć może tylko osoba posiadająca prawa administratora. W tym celu należy wskazać spinacz dla danego załącznika, a następnie opcję przycisk Delete attachment.

Przypisy #

Przypis można stworzyć w ten sam sposób, co hiperłącze, ale podając jako nazwę łącza jedynie liczbę. W ten sposób tworzone jest odwołanie do przypisu, np. [1] tworzy przypis[1]. Aby móc stworzyć treść przypisu, należy wstawić [#1] w dowolnym miejscu i wpisać tekst po nawiasie zamykającym. Można również stworzyć przypis będący tekstem, np. [Tekst|1] również tworzy odwołanie do pierwszego przypisu[Tekst]. Można nadać nazwę również samemu przypisowi[2] (dzięki czemu przypis nie będzie zaczynał się od znaku #).

Tworzenie łącz wewnątrz serwisu Pracowni#

Można tworzyć łącza do innych stron znajdujących się w obrębie serwisu Pracowni, bez podawania całego adresu internetowego. Należy w tym celu jako nazwę łącza podać nazwę istniejącej już strony. Np. [IdeaWikiPPG] tworzy łącze do strony o nazwie Idea Wiki PPG: IdeaWikiPPG. Odwołaniu można nadać oczywiście etykietę, tak jak standardowemu łączu, np. [Idea Pracowni Pytań Granicznych|IdeaWikiPPG] tworzy Idea Pracowni Pytań Granicznych. Jeśli dana strona nie istnieje w serwisie, na stronie (po jej zapisaniu) zostanie wyświetlony błąd.

Dodawanie obrazów wewnątrz strony#

Można zagnieździć wewnątrz dokumentu plik z obrazem (zdjęcie) w dowolnym akceptowanym formacie (.png, .jpg, .gif etc.).
Pliki graficzne mogą być osadzone w portalu poprzez ich:

dodanie do portalu w formie załącznika
bezpośrednie odwołanie się do zewnętrznego zasobu dostępnego w internecie (uwaga ten sposób może powodować wydłużenie ładowania strony.

Ad. 1 Dodawanie pliku graficznego w formie załącznika

Przejdź do strony Img
Wybierze link Attach file
Prześlij plik na portal porzez jego wskazanie na dysku (Przeglądaj) oraz naciśniecie przycisku Upload.
Przejdź do strony, na której ma zostać osadzony plik graficzny i ustaw ją w tryb edycji (link Edit page).
Umieść w treści strony następującą frazę [{Image src='Img/Nazwa pliku'}] np. [{Image src='Img/jspwiki_logo.png'}]

Ad. 2 Dodawanie pliku graficznego znajdującego się w internecie

Przejdź do strony, na której ma zostać osadzony plik graficzny i ustaw ją w tryb edycji (link Edit page).
Umieść w treści strony następującą frazę [{Image src='http://adres pliku graficznego'}] np. [{Image src='http://www.uam.edu.pl/images/logo-uam10.gif'}]

Uwaga! Pliki graficzne mogą również pełnić funkcję linka. W takim przypadku wyrażenie Image przyjmuje następującą postać: [{Image src='http://adres pliku graficznego' link='http://adres strony www'}] np. [{Image src='http://www.uam.edu.pl/images/uamnapisBig.gif' link='http://www.uam.edu.pl'}]

Tworzenie list#

Listy mogą być dwojakiego rodzaju: punktowane lub numerowane.

Element listy punktowanej można utworzyć, umieszczając znak gwiazdki (*) na początku linii. Aby stworzyć element listy z większym wcięciem (akapitem), wystarczy umieścić więcej znaków gwiazdki.
Np.

* Punkt pierwszy \\ Tekst w nowej linii w obrębie tego punktu.
* Punkt drugi
* Punkt trzeci
** Podpunkt
*** Podpunkt

tworzy:

Punkt pierwszy
Tekst w nowej linii w obrębie tego punktu.
Punkt drugi
Punkt trzeci
- Podpunkt
  - Podpunkt

Element listy numerowanej można utworzyć, umieszczając znak hash (#}) na początku linii. Numeracja tworzona jest automatycznie. Aby stworzyć element listy z większym wcięciem (akapitem), wystarczy umieścić więcej znaków hash. Np.

# Punkt pierwszy \\ Tekst w nowej linii w obrębie tego punktu.
# Punkt drugi
## Podpunkt pierwszy 
## Podpunkt drugi
# Punkt trzeci

tworzy:

Punkt pierwszy
Tekst w nowej linii w obrębie tego punktu.
Punkt drugi
1. Podpunkt pierwszy
2. Podpunkt drugi
Punkt trzeci

Listy definicji i komentarze#

Aby stworzyć listę definicji, należy wpisać średnik, po nim nazwę definicji, dwukropek i następnie tekst objaśnienia definicji. Np. ;Definicja:Jej objaśnienie tworzy:

Definicja: Jej objaśnienie

Oczywiście tekst zarówno definicji, jak i jej objaśnienia, może zostać sformatowany, np.

;''Definicja'':__Jej objaśnienie__

tworzy:

Definicja: Jej objaśnienie

W podobny sposób można szybko tworzyć komentarze, pozostawiając miejsce definicji puste, np.

;:Komentarz

tworzy:

: Komentarz

Formatowanie tekstu#

Tekst może zostać pogrubiony, podkreślony, wyświetlony kursywą lub czcionką o stałej szerokości znaków. Przykłady znajdują się w Skrócie informacji u góry tej strony. Ponadto tekst może zostać wyświetlony tak jak kod źródłowy, w tym celu należy poprzedzić go trzema znakami { i zamknąć, również trzema, znakami } np.

Jakiś tekst

Tabele#

Aby stworzyć tabelę, wystarczy użyć znak |. Użycie dwóch znaków: || tworzy nagłówek tabeli. Na końcu wiersza nie należy umieszczać znaku |.
Np.

|| Nagłówek 1 || Nagłówek 2
| ''Tekst'' | Tekst \\ z przełamaniem
| [Łącze] | Tekst

tworzy:

Nagłówek 1	Nagłówek 2
Tekst	Tekst z przełamaniem
IdeaWikiPPG	Tekst

Style#

W celu bardziej szczegółowego formatowania tekstu, można użyć stylów. Każdy styl poprzedzony jest dwoma znakami procentów %, po czym następuje nazwa stylu, po niej tekst, który ma zostać sformatowany, po czym - na zakończenie - znów dwa znaki procentów.
Dostępne są następujące style:

%%(color:red) Ten tekst jest czerwony. %%

zmienia kolor czcionki na czerwony. W miejsce red należy podać angielską nazwę żądanego koloru.

%%small Zmniejsza czcionkę %%

tekst tekst

%%sub Tworzy indeks dolny %%

teksttekst

%%sup Tworzy indeks górny %%

teksttekst

%%strike Przekreśla tekst %%

tekst

%%commentbox Tworzy okno z komentarzem po prawej stronie %%

tekst

%%information Tworzy pole informacyjne %%

tekst

%%warning Tworzy pole z ostrzeżeniem %%

tekst

%%error Tworzy pole wystąpienia błędu %%

tekst

Dodawanie komentarzy do strony#

Aby dodać komentarz do strony, należy wybrać przycisk "Add Comment" znajdujący się w belce na samej górze lub na samym dole. Dodawanie komentarzy w trybie edytowania strony nie jest możliwe. Komentarz zostanie umieszczony na samym dole strony.

Dodawanie załącznika do strony#

Aby umieścić na stronie załącznik, należy wybrać przycisk "Attach File". Wyświetlona zostanie nowa strona, w której należy wybrać przycisk Przeglądaj (Browse), wybrać żądany plik, a następnie wybrać przycisk Upload. Łącze do załącznika zostanie umieszczone na samym dole strony.

Tworzenie spisu treści#

Aby szybko utworzyć spis treści podobny do tego, jaki znajduje się u góry tej strony, należy wpisać [{TableOfContents}]. Spis treści zostanie automatycznie utworzony z wszystkich nagłówków, jakie zostały użyte na stronie.

Strony specjalne#

Kategoryzacja stron#

Portal PPGWiki pozwala również w sposób automatyczny utworzyć listę stron należących do określonej kategorii. W tym celu należy w treści strony umieścić następujące polecenie: [{INSERT ReferringPagesPlugin page='Nazwa kategorii'}]. Umieszczenie takiego polecenia spowoduje, że przeszukane zostaną wszystkie strony i portalu i utworzona zostanie lista stron, w treści których znajduje się hiperłącze o nazwie [Nazwa kategorii].
Dużą zaletą kategoryzacji jest jej dynamizm. Jeśli nie chcemy usunąć daną stronę z określonej kategorii wówczas wystarczy usunąć z jej treści hiperłącze [Nazwa kategorii].
Przykład kategoryzacji związanej z kognitywistyką można znaleźć tu: Kognitywistyka

Komentarze#

Szczegółowa instrukcja jak skomentować stronę typu forum znajduje się tutaj.

Zmiana hasła#

Hasło zmieniamy poprzez zakładkę Profile dostępną za pomocą linku My Prefs. Nowe hasło należy wpisać zarówno w pole Password jak i Password (re-type).

Dodatkowa pomoc#

Pełną informację na temat działania używanego przez Pracownię Pytań Granicznych portalu JSPWiki można znaleźć pod adresem: http://jspwiki.org/wiki/Main

[1] Pierwszy przykładowy przypis.
[2 Drugi przypis] Drugi przykładowy przypis.

Przykładowy komentarz

--Użytkownik, 16-gru-2006