Faq

2006-03-13T22:27:41Z

Adas: /* Jak zacząć przygodę z Joggerem? */

==Informacje ogólne==
===Co to jest Jogger?===
Jogger jest to internetowy dziennik (blog), oparty o [[#TOC_9|jabbera]].

===Co to jest JID?===
Każdy użytkownik [http://jabberpl.org Jabbera] posiada swój JabberID (w skrócie: JID) przypominający adres e-mail – na przykład: nazwa@jabberpl.org.

===Co to jest Jabber?===
Jabber jest otwartym protokołem XML służącym do wymiany wiadomości w czasie rzeczywistym między dwoma punktami w Internecie. Podstawowym rdzeniem technologii Jabber jest asynchroniczna, rozbudowywująca się platforma natychmiastowych wiadomości oraz sieć IM (natychmiastowych wiadomości), która oferuje takie same możliwości jak systemy AIM, ICQ, GG, MSN i Yahoo. ([http://jabberpl.org JabberPl])

===Czy Jogger jest płatny?===
Nie, Jogger jest w pełni bezpłatny.

===Skąd pochodzi Jogger?===
Oryginalny jogger jest na licencji GPL i jest udostępniony w repozytorium na JabberStudio. JoggerPL został oparty na tym pomyśle i to jest w tej chwili jedyne co je łączy.

===Jakie funkcje ma polski Jogger?===
* ''Panel sterowania'' z dostępem na hasło.
* ''Schematy'' - możliwość zmiany wyglądu dziennika poprzez wybór tematu lub utworzenie własnego.
* ''Komentarze'' - dodana możliwość komentowania wpisów w blogu.
* ''Powiadamianie'' - informacja o nowym komentarzu do naszego wpisu, o nowych wpisach pojawiających się na innych śledzonych joggerach, oraz o śledzonych wątkach przesyłana jest bezpośrednio do komunikatora.
* ''Domeny'' - użytkownik może sobie utworzyć łatwą do zapamiętania domenę typu ''http://moja_nazwa.jogger.pl''.
* ''Przekierowania'' z różnych adresów na jednego joga.
* ''Edycja wpisów i komentarzy''.
* ''Blokowanie IP''.
* ''Export do XML''.
* ''Emotikony''.
* ''Poziom wiadomości'' - ukryte 8 poziomów wpisów, które są widoczne dopiero po zalogowaniu.
* ''Przystosowanie do różnych wersji językowych.''
* ''System odnośników'' - znacznie usprawniony w stosunku do oryginału, zrobiony dla potrzeb plików RSS.

===Kto jest autorem polskiego joggera?===
Autorem polskiej wersji joggera jest [mailto:sparrow@itn.pl Sparrow], który jest również odpowiedzialny za liczne modyfikacje, ulepszenia kodu itp.

==Jak zacząć?==
===Jak zacząć przygodę z Joggerem?===
Aby rozpocząć przygodę z Joggerem należy do swojej listy kontaktów dopisać dowolny adres w formacie <code>''TWÓJ_NICK''@jogger.pl</code>. np. <code>zosia@jogger.pl</code>. Zostaniemy poinformowanie, że rejestracja jest możliwa jedynie na stronie http://jogger.pl/register/. Wchodzimy i pokazuje się strona rejestracji. Wymaga ona jedynie podania swojego JIDa (w formacie nick@serwer) i domene pod jaką będzie dostępny nasz jogg. W moim wypadku wygląda to następująco:

[[Grafika:Reg.png]]

Link potwierdzający dostaniemy go od [[Bot|Bota]]. Po włączeniu wyświetli się nam komunikat z linkiem do naszego bloga i nowym hasłem, które możemy zmienić w [[Panel Sterowania|Panelu Sterowania]].

===Jak zalogować się do Panelu Sterowania?===
Aby zalogować się do ''Panelu Sterowania'' wystarczy odnaleźć na stronie głównej [http://jogger.pl joggera] menu po prawej stronie. Menu jest białe z turkosowimi nagłówkami. Tam w pozycji ''Logowanie'' wystarczy wpisać jako login swój JID i Hasło.

<center>[[Grafika:Logowanie.png]]</CENTER>

Po zalogowaniu się możemy spokojnie przechodzić do naszego panelu sterowania np. z takiego linka:
https://login.jogger.pl/

===Skąd wziąć hasło?===
Wyślij do joggera wiadomość o treści: '''<PASS>'''. Otrzymasz z powrotem losowo wygenerowane hasło, dzięki któremu będziesz mógł się zalogować do ''Panelu Sterowania''.

UWAGA! Wiadomości wysyłamy poprzez ''Okno rozmowy'' lub ''Wyślij Wiadomość'', w zależności od posiadanego komunikatora.

Przykład wysyłania wiadomości o treści <PASS> z komunikatora Konnekt:<center>[[Grafika:Pass.png]]</center>

==Własne style==
===Style===
Informacje w poradniku [[Wlasne szablony dla joggera: Wprowadzenie|Własne szablony dla Joggera]].

==Inne==
===Tytuł wpisu===
Pamiętaj o dodaniu tytułu do swojego wpisu! Nie jest to obowiązkowe, ale ładniej wygląda. Aby to zrobić wyślij wpis jako ''Wiadomość'' (Wyślij wiadomość) zamiast ''Chat'' (Okno rozmowy). Niektóre wersje klientów jabbera niestety nie posiadają takiej opcji.

<center>Przykład wysyłania wiadomości z komunikatora PSI i Miranda 
 PSI [Grafika:/language/pl/images/ww_psi.jpg] Miranda (nie obsługuje "tematów" można dodać tylko samą treść) [Grafika:language/pl/images/ww_mir.jpg]
</CENTER>

===Znaczniki html===
Jeżeli chodzi o znaczniki html to nie ma specjalnych ograniczeń, można używać dowolne, ale tylko te proste (b,i, u itp.) będą wyświetlane na stronie głównej joggera.

===Funkcje joggera===
Joggera można wykorzystać jako książkę zmian w swoim projekcie, jako stronę informacyjną i na wiele innych sposobów... to czym będzie Twój jogger zależy tylko i wyłącznie od Ciebie ;)

===Kodowanie===
Obowiązującym kodowaniem znaków dla Jabbera jest '''UTF-8''', jeżeli Twój klient działa w innym standardzie (np. WPKontakt) nie używaj polskich znaków...

'''Uwaga!''' Jogger to '''nie''' jest forum, główna strona '''nie''' służy do dyskusji pomiędzy użytkownikami.

===Strona główna joggera===
Tutaj pokaże Wam z czego mniej więcej składa się strona główna joggera:
<center>[Grafika:/language/pl/images/jog11.jpg]</CENTER>

# ''Menu'' - tutaj są umieszczone linki do najważniejszych informacji o joggerze,
# ''Nowe Dzienniki'' - w tej pozycji możemy zobaczyć kto ostatnio założył sobie joggera,
# ''Statystyki'' - ogólne statystyki joggera,
# ''Logowanie'' - tutaj logujemy się do ''Panelu Sterowania'',
# ''"Wstęp"'' - słowo wstępu od autora ([http://sparrow.jogger.pl Sparrow'a]),
# ''Przyklejone Wpisy'' - tutaj [http://sparrow.jogger.pl Sparrow] umieszcza ważne informacje dotyczące [http://jabberpl.org Jabbera], [http://jogger.pl Joggera] i innych ciekawych rzeczy ;). Tylko on może tam coś załączyć.
# ''Ostatnio dodane wpisy'' - w tym miejscu wyświetlane są ostatnio dodane notki joggerowców,
# ''Stopka'' - stopka ;)

===Zalety joggera===
* Ma powiadamianie o nowych komentarzach, tzn. dostajemy wiadomość na jabbera jeżeli ktoś doda komentarz do naszego wpisu,
* Śledzenie jogów, gdy "śledzona" osoba doda wpis do swojego joggera zostajemy o tym poinformowani, oczywiście na jabbera ;),
* W joggerze możemy również edytować swoje wpisy i komentarze,
* Możemy również wszystkie nasze wpisy wyeksportować do pliku xml,
* Jogger ma bardzo dużą przewagę nad zwykłym blogiem ponieważ stosuje Poziomy wiadomości - ukryte 8 poziomów wpisów, które są widoczne dopiero po zalogowaniu,
* Jogger jest międzynarodowy,
* Posiada ciekawe schematy, które możemy wymieniać,
* Jest możliwość blokowania niechcianego IP
* Joggera można prowadzić mając kilka JID'ów,
* Dzięki joggerowi mamy bardzo fajną i oryginalną domenę,

===RSS===
Swój prywatny dziennik możesz łatwo udostępniać innym przy pomocy plików w formacie RSS. Format [http://groups.yahoo.com/group/rss-dev/files/namespace.html RSS 1.0] rozpowszechniania używanym przez usługi news-owe oraz serwisy internetowe na całym świecie. W pliku RSS zawarte są aktualne nagłówki wpisów (tytuły) oraz odnośniki do dziennika.

Do adresu podstawowego (tag [[Tagi#RSS (NOWY)|RSS]]) można dodać różne parametry, pozwalające na konfigurację dodatkowych związanych z nim opcji. Wszystkie podawane są po adresie joggera (np. http://sparrow.jogger.pl/rss).

/rss/ same tematy wpisów, domyślna liczba
/rss/liczba_wpisow same tematy wpisów, ustalona liczba
/rss/content/liczba_wpisow całe wpisy, tekstowo, ustalona liczba
/rss/short/liczba_wpisow skróty wpisów, tekstowo, ustalona liczba
/rss/content/html/liczba_wpisow całe wpisy, w formacie html, ustalona liczba
/rss/short/html/liczba_wpisow skróty wpisów, w formacie html, ustalona liczba

====Przykład użycia====
''Przykład używa starego formatu adresu rss, jeśli prowadzisz kilka joggów z jednego konta, używaj koniecznie nowego formatu!''

Aby otrzymać listę ostatnich wpisów wystarczy przesłać do skryptu ''syndication.php'' parametru "jid" swój jabberowy adres (Jabber ID).

Źródłowy URL realizujący to zadanie wygląda następująco:
''http://jogger.pl/syndication.php?count=10&jid=janek@jabberPL.org''

Aby dodać do wyników pole <description> zawierające pełne wpisy, należy dołączyć parametr "desc=1" np.:
''http://jogger.pl/syndication.php?count=10&jid=janek@jabberPL.org&desc=1''

Aby wszystkie wpisy posiadały formatowanie w HTML-u należy dodać jeszcze parametr "html=1" np.
''http://jogger.pl/syndication.php?count=10&jid=janek@jabberPL.org&desc=1&html=1''

===Poziomy===
Dzięki tej opcji możemy ustalić "prywatność" naszych wpisów. Poziom oznaczamy cyferkami od 0 do 11.

* 0 - oznacza że nasze wpisy mają domyślny poziom, i będą wyświetlane na stronie głównej [http://jogger.pl joggera] oraz będą widoczne (na naszym joggerze) dla każdego odwiedzającego,
* 1 - oznacza że dane wpisy będą nie widoczne na stronie głównej [http://jogger.pl/ joggera], ale będą widoczne tylko na naszym joggerze,
* 2 - oznacza że dane wpisy będą widoczne tylko dla zalogowanych użytkowników,
* 3 - 11 - oznacza że dane wpisy nie będą widoczne na stronie głównej [http://jogger.pl/ joggera]. Również na naszej prywatnej stronie joggera będzie niewidoczny, dopiero po zalogowaniu się dana osoba będzie mogła obejrzeć i skomentować wpisy.

Poziomy możemy ustalać na kilka sposobów, oto przykłady:

* Poprzez wybranie w ''Panelu Konfiguracyjnym'' pozycji ''Ustawień'' i tam wybrać ''Standardowy poziom nowych wpisów'', wtedy każdy wpis będzie na takim poziomie na jaki ustalimy,
* Poprzez wybranie w ''Panelu Konfiguracyjnym'' pozycji ''Dodaj wpis'', czyli podczas wpisywania notki z przeglądarki możemy ustalić konkretny poziom dla aktualnie wpisywanej notki,
* Poprzez wybranie w ''Panelu Konfiguracyjnym'' pozycji ''Edycja wpisów'', tutaj możemy ustalić poziom dla istniejącej już notki,
* Poprzez komunikator w którym piszemy notki, tzn. wystarczy przed tekstem wpisać '''<level*>''' gdzie * oznacza numer poziomu,

Mamy również możliwość ustawienia ewentualnych użytkowników, którzy będą mogli czytać nasze wpisy na wyższych, przydzielonych im poziomach. Możemy to ustawić w ''Panelu Konfiguracyjnym'' w pozycji ''Poziomy'':
* ''"Użytkownik posiadający joggera"'' - tutaj wpisujemy JID'a osoby, która ma mieć dostęp do wyższego poziomu. Osoba ta musi posiadać własnego joggera. Wtedy wchodząc na naszego joggera, nie musi się nigdzie logować, od razu widzi notki na "poziomie" ;)
* ''"Użytkownik spoza joggera"'' - tutaj wpisujemy nazwę użytkownika (dowolnego) i hasło oraz ustalamy poziom. Osoba ta dopiero po zalogowaniu się ma możliwość przeczytania notki z ustalonym poziomem,

===Pliki===
Jogger daje nam możliwość wgrywania plików (do 1 MB), które potem możemy wykorzystać np. w naszym szablonie.

Kontakt

2006-03-13T22:24:05Z

Adas:

Najprostrzym sposobem skontaktowania się z osobami związanymi z joggerem to zostawienie wpisu na tej stronie.

*[http://wiki.jogger.pl/index.php?title=Kontakt&action=edit&section=new Dodaj nowy wpis] - pamiętaj o wpisaniu tytułu.

Własny szablon: Wprowadzenie

2006-03-13T22:21:20Z

Adas:

Na kolejnych stronach zebraliśmy skorowidz znaczników - wraz z przykładami ich użycia - dzięki którym można
zrobić swój własny szablon dla joga. Tagi pogrupowane są według bloków
w których można je umieszczać (lub w których ma to sens).

Oprócz tego przygotowaliśmy przykładowy szablon, w którym zostały użyte prawie wszystkie dostępne znaczniki. Mamy nadzieję, że zapoznanie się z jego kodem pomoże w stworzeniu swojego unikatowego szablonu oraz rozwiąże ewentualne problemy. W razie jakichkolwiek pytań bądź problemów związanych z tworzeniem własnych szablonów, [[Kontakt|służymy pomocą]]. Zatem zapraszamy do zapoznania się z kolejnymi stronami instrukcji.

*[[Wlasne_szablony_dla_joggera:_Jak_to_dzia%C5%82a|Jak to działa?]]
*[[Tagi]] - znaczniki do wykorzystania w szablonach

JoggerWiki - Wkład użytkownika [pl]

Faq

Kontakt

Własny szablon: Wprowadzenie