ThemesFaq:Wlasne szablony dla joggera: Różnice pomiędzy wersjami

Z JoggerWiki
Skocz do: nawigacji, wyszukiwania
 
 
Linia 1: Linia 1:
<h1 id="top">Własne szablony dla Joggera</h1>
 
  
<hr />
 
 
<h2>Wprowadzenie</h2>
 
 
<p>Poniżej przedstawiam skorowidz znaczników, 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).</p>
 
 
<p>Oprócz tego przygotowałem <a href="http://akson.sgh.waw.pl/%7Esm31682/jogger/themes/sample.html">przykładowy szablon</a>,
 
w którym użyłem prawie wszystkich dostępnych znaczników. Mam nadzieję,
 
że zapoznanie się z jego kodem rozwiąże ewentualne problemy.</p>
 
 
<p>W razie jakichkolwiek pytań związanych z tworzeniem własnych szablonów - mój <acronym lang="en" xml:lang="en" title="Jabber Identyfier">JID</acronym> to <em>staszyna@chrome.pl</em>. Zapraszam.</p>
 
 
<h2>Jak to działa?</h2>
 
 
<h3>Znaczniki</h3>
 
 
<p>W Joggerze większość znaczników wstawia się w specjalne bloki. Bloki mają dwa zadania:</p>
 
 
<ol>
 
<li>W przypadku wpisów, listy odnośników, listy pozycji archiwum i
 
komentarzy blok pokazuje Joggerowi, którą część szablonu ma powtórzyć
 
wyświetlając kolejny wpis, komentarz itd. Tak więc wszystko co
 
umieścimy w bloku <strong>COMMENT_BLOCK</strong> będzie powielone wraz z każdym dodanym komentarzem.</li>
 
<li>Są też trzy bloki, które mają inne zadanie. Chodzi o <strong>ADMIN_BLOCK</strong>, <strong>LOGGED_USER_BLOCK</strong>, <strong>NOUSER_BLOCK</strong>
 
- treść w nich zawarta jest widoczna tylko dla określonych uzytkowników
 
(odpowiednio: dla właściciela, gościa zalogowanego i gościa
 
niezalogowanego). Na przykład, tagi z grupy <code>&lt;ADMIN_[...]_HREF/&gt;</code> można wstawić do bloku <strong>&lt;ADMIN_BLOCK&gt;</strong>, by zwykli odwiedzający nie widzieli linków administracyjnych.</li>
 
 
</ol>
 
 
<p>Niektóre tagi funcjonują zupełnie samodzielnie i mogą zostac użyte wszędzie. Zaliczają sie do nich przede wszystkim <a href="#status">tagi pokazujące status Jabbera, opis i ikonkę dostępności</a> oraz <a href="#inne">4 inne znaczniki</a> (<a href="#jid"><code>&lt;JID/&gt;</code></a>, <a href="#allentrieshref"><code>&lt;ALL_ENTRIES_HREF/&gt;</code></a>, <a href="#commentform"><code>&lt;COMMENT_FORM/&gt;</code></a> i <a href="#customdir"><code>&lt;CUSTOM_DIR/&gt;</code></a>).</p>
 
 
<p>Obowiązują dwa sposoby zapisu tagów <strong>pojedynczych</strong>, tj. takich, które wstawiają określony tekst. Oprócz zwykłego <em>&lt;NAZWA_ZNACZNIKA/&gt;</em>* można napisać <em>&amp;NAZWA_ZNACZNIKA;</em>. Drugiego sposobu można użyć wtedy, gdy tag ma być argumentem jakiegoś atrubutu HTML, dzięki czemu uzyskamy <strong lang="en" xml:lang="en">well-formed XML</strong>. Np. <code>&lt;img src="<a href="#imagesdir">&amp;CUSTOM_DIR;</a>/obrazek.gif" alt=""/&gt;</code> lub <code>&lt;a href="<a href="#archivehref">&amp;ARCHIVE_HREF;</a>"&gt;<a href="#archivehrefdescr">&lt;ARCHIVE_HREF_DESCR/&gt;</a>&lt;/a&gt;</code><br /><br />
 
 
* - Uwaga: ważne jest, by w zapisie <em>&lt;NAZWA_ZNACZNIKA/&gt;</em> przed znakiem "/" (slash) nie było spacji. Więcej: <a href="http://bugger.jogger.pl/index.php?do=details&id=47" title="Joggerowy system zgłaszania błędów i propozycji.">Bugger - zgłoszenie nr 47</a>.</p>
 
 
<h3>Co zmienić w ustawieniach?</h3>
 
 
<p>By Jogger użył niestandardowego schematu, należy zmienić w ustawieniach dwie opcje: <em>Własne szablony dla strony joggera</em> i <em>Własne szablony dla komentarzy</em>. Mamy tam do wyboru dwa różne "tak".</p>
 
 
<dl><dt>Tak, uproszczony
 
</dt><dd>Kiedyś był to jedyny sposób obsługi szablonów. Polega to na tym, że szablon składa się jedynie z zawartości elementu <strong>BODY</strong>. Nie należy nawet umieszczać żadnego <acronym lang="en" xml:lang="en" title="Document Type Definition">DTD</acronym>, <code>&lt;head&gt;</code> i tym podobnych. Pominąć trzeba także sam znacznik <code>&lt;body&gt;</code> oraz <code>&lt;/body&gt;</code>.
 
Wszystko dlatego, że Jogger sam uzupełni szablon i ostatecznie
 
wyświetli poprawną stronę. Na początek pliku zostanie wstawione np.:
 
<pre>&lt;!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"&gt;
 
&lt;html lang="pl"&gt;
 
 
&lt;head&gt;
 
        &lt;meta http-equiv="Content-Type" content="text/html; charset=UTF-8"&gt;
 
        &lt;meta name="robots" content="noindex, nofollow"&gt;
 
        &lt;title&gt;Jogger :: staszyna@chrome.pl&lt;/title&gt;
 
        &lt;link rel="StyleSheet" href="custom/staszyna/files/style.css" type="text/css"&gt;
 
&lt;/head&gt;
 
 
&lt;body&gt;</pre>
 
A na koniec:
 
<pre>&lt;/body&gt;
 
&lt;html&gt;</pre>
 
Plik <code>custom/staszyna/files/style.css</code> to CSS naszego szablonu. Musi być oddzielnym plikiem, bo przy uproszczonych schemtach nie mamy dostępu do elementu <strong>HEAD</strong>. Dodatkowo można zauważyć, że nie mamy wpływu na DOCTYPE schematu ani na tytuł joga. Drugi problem <a href="http://marcoos.jogger.pl/?startid=200311#e10451">rozwiązał marcoos</a>, pierwszy jest nierozwiązywalny. I właśnie z tego powodu powstał drugi sposób obsługi schematów.
 
 
</dd><dt>Tak, pełny
 
</dt><dd>Jeśli wybierzemy tę opcję, Jogger nie będzie ingerował w kod
 
schematu. Mamy więc pełną swobodę w ustawianiu np. DTD, znaczników
 
meta, tytułu, elementów <strong>LINK</strong>, języka joga itd. Dwie wskazówki:
 
 
<ol>
 
<li>zalecane jest, by wstawić następujący znacznik meta: <code>&lt;meta name="robots" content="noindex, nofollow" /&gt;</code>. <a href="http://www.wired.com/news/business/0,1367,58838,00.html" title="Artykuł na wired.com">Dlatego</a>.
 
</li><li>ścieżka do wgranych do Joggera plików stylów CSS to <code>custom/[Twój_nick]/files/nazwa_pliku.css</code>. Można ją wstawić samemu lub po prostu użyć znacznika <a href="#customdir"><code>&lt;CUSTOM_DIR/&gt;</code></a>, który wstawi ścieżkę do katalogu <code>files/</code>. Czyli: <pre>&lt;link rel="StyleSheet" href="<a href="#customdir">&amp;CUSTOM_DIR;</a>/nazwa_pliku.css" type="text/css" title="Podstawowy styl" /&gt;</pre>
 
 
</li></ol>
 
</dd></dl>
 
 
<p>Dodatkowo, Jogger daje nam możliwość ustawienia typu MIME plików
 
szablonu, dzięki czemu osiągalna jest pełna poprawność XHTML 1.1. W
 
panelu konfiguracyjnym można wybrać przy pozycji <em>Typ MIME</em> następujące opcje: (podaję za marcoosem)</p>
 
<ul>
 
<li><em>text/html</em> - dobry dla HTML 4, dozwolony dla XHTML 1.0</li>
 
<li><em>application/xhtml+xml</em> - zalecany dla XHTML 1.0, wymagany dla XHTML 1.1, XHTML Basic i pewnie kiedyś XHTML2.0</li>
 
 
<li><strong class="no">NOWY!</strong> <em>application/xml</em> - więcej: <a href="http://bugger.jogger.pl/index.php?do=details&id=57" title="Joggerowy system zgłaszania błędów i propozycji.">Bugger - zgłoszenie nr 57</a> <strong  style="color: green;">(OK)</strong>.
 
<li><em>negocjacja typu mime</em> - jeśli <acronym lang="en" xml:lang="en" title="User Agent">UA</acronym> akceptuje <em>application/xhtml+xml</em> - wyślij jako <em>application/xhtml+xml</em>, jeśli nie - wyślij jako <em>text/html</em> (błędnie, ale żeby działało). Wszystkiemu winne jest oczywiście <acronym lang="en" xml:lang="en" title="Microsoft Internet Explorer">MSIE</acronym>, które w ogóle nie rozumie <em>application/xhtml+xml</em> i pliki XHTML wysłane w ten sposób próbuje zapisać na dysku użytkownika.
 
 
</li></ul>
 
 
<h3>Co trzeba przygotować?</h3>
 
 
<p>Najlepiej przygotować trzy pliki: <strong>szablon strony głównej</strong>, <strong>szablon strony z komentarzami</strong> i <strong>plik (pliki) CSS</strong>.
 
Jeśli nie zrobimy np. strony komentarzy, Jogger użyje zaznaczonego w
 
ustawieniach gotowego schematu. Można też oczywiście style CSS umieścić
 
w sekcji HEAD szablonu, pod warunkiem, że używamy pełnych schematów.
 
Jednak zewnętrzny plik arkusza stylów wydaje się być wygodniejszym
 
rozwiązaniem. Można to także połączyć, ogólne style spiać w oddzielnym
 
pliku, a definicje potrzebne tylko np. do strony komentarzy umieścić
 
już w samym szablonie. Należy tylko pamietać o odpowiednim określaniu w
 
arkuszu stylów ścieżek do obrazków (więcej na ten temat: patrz opis <a href="#customdir"><code>&lt;CUSTOM_DIR/&gt;</code></a>).</p>
 
 
<p>Grafikę (do 150KB) można wgrać do Joggera poprzez panel sterowania. W schemacie można uzyć taga <a href="#customdir"><code>&lt;CUSTOM_DIR/&gt;</code></a>, który wstawia ścieżkę do katalogu m. in. z grafiką - <code>custom/[Twój_nick]/files</code>. Znacznik ten nie jest interpretowany w oddzielnych plikach CSS.<br />Grafika
 
może być oczywiście dowolna, z bardziej nietypowych rzeczy można
 
przygotować favikonę a także dwa pliki, których Jogger będzie używał do
 
pokazywania statusu właściciela. Te dwa pliki muszą nazywać się <strong>online.png</strong> i <strong>offline.png</strong> (patrz też: opis <a href="#statusimage"><code>&lt;STATUS_IMAGE/&gt;</code></a>).</p>
 
 
<h3>Kilka wskazówek</h3>
 
 
<ul>
 
<li>Polecam <a href="http://validator.w3.org/">walidator (X)HTML</a> i <a href="http://jigsaw.w3.org/css-validator/">walidator CSS</a>.
 
</li><li>Nie jest to wymagane w żadnym regulaminie, ale przez internetową uprzejmość można umieścić w szablonie np. taką stopkę:
 
<pre>Powered by &lt;a href="http://www.jogger.pl"&gt;Jogger&lt;/a&gt;.
 
Copyright (c) 2002-2003 Justin Mecham oraz JabberPL Group.&lt;br /&gt;
 
Wszystkie prawa zastrzeżone. &lt;a href="http://jogger.pl/info.php?id=legal"&gt;Legalność&lt;/a&gt;;
 
 
&lt;a href="http://www.jogger.pl/about.php"&gt;Informacje&lt;/a&gt;</pre>
 
</li><li>Dobrze jest zadbać o przejrzysty layout - czytający powinien
 
od razu wiedzieć, który wpis czyta, który skomentuje klikając
 
odpowiedni link, a nawet która data odnosi się do którego wpisu.
 
</li><li>Należy pamiętać o oczach czytelników.
 
</li><li>Jeśli robicie szablon w poprawnym XHTML, to i tak to zrobicie, ale na wszeli wypadek przypominam o atrybucie <strong>alt</strong> przy grafice. Jeśli grafika jest wyłącznie dekoracyjna i nie ma wpływu na treść lub działanie użytkownika, należy dodać <code>alt=""</code>. Polecam bardzo ciekawy <a href="http://ppewww.ph.gla.ac.uk/%7Eflavell/alt/alt-text.html">artykuł o atrybutach <strong>alt</strong></a>.
 
</li><li>UNIKOD!!! to bardzo wa?ne, nawet je?li jedynym tekstem jaki
 
znajdzie si? w czystym szablonie b?dzie stopka. W Windows można albo za
 
pomocą <a href="http://www.republika.pl/jablonka/przewodnik/ogonki.html" title="Strona o programie Ogonki 97">Ogonk?w 97</a>, albo zapisuj?c pliki w systemowym Notatniku z
 
kodowaniem UTF-8. (brak polskich znaków celowy)
 
 
</li></ul>
 
 
<h3>Zmiany w nazwach znaczników</h3>
 
<p>By uprościć i ujednolicić nazewnictwo Joggerowych znaczników, zmienione zostały nazwy nastepujących tagów:
 
</p><pre>ENTRIES_BLOCK --&gt; <a href="#entryblock">ENTRY_BLOCK</a>
 
ENTRIES_DAY --&gt; <a href="#entrydayblock">ENTRY_DAY_BLOCK</a>
 
COMMENT_HREF --&gt; <a href="#entrycommenthref">ENTRY_COMMENT_HREF</a>
 
 
COMMENT_HREF_DESCR --&gt; <a href="#entrycommnenthrefdescr">ENTRY_COMMENT_HREF_DESCR</a>
 
USER_LOGIN_HREF --&gt; <a href="#userloginhref">USER_LOG_IN_HREF</a>
 
USER_BLOCK --&gt; <a href="#loggeduserblock">LOGGED_USER_BLOCK</a>
 
USER_LOGIN_NAME --&gt; <a href="#loggedusername">LOGGED_USER_NAME</a>
 
USER_LOGOUT_HREF --&gt; <a href="#loggeduserlogouthref">LOGGED_USER_LOG_OUT_HREF</a>
 
 
PUT_JID --&gt; <a href="#jid">JID</a>
 
IMAGES_DIR --&gt; <a href="#customdir">CUSTOM_DIR</a>
 
</pre>
 
 
<hr />
 
 
<h2 id="skorowidz">Skorowidz</h2>
 
 
<ul id="lista">
 
<li><a href="#entryblock">ENTRY_BLOCK</a>
 
 
        <ul>
 
        <li><a href="#entrydayblock">ENTRY_DAY_BLOCK</a></li>
 
        <li><a href="#entrysubject">ENTRY_SUBJECT</a></li>
 
        <li><a href="#entrydate">ENTRY_DATE</a></li>
 
        <li><a href="#entryhour">ENTRY_HOUR</a></li>
 
        <li><a href="#entryid">ENTRY_ID</a></li>
 
 
        <li><a href="#entrylevel">ENTRY_LEVEL</a></li>
 
        <li><a href="#entrycontent">ENTRY_CONTENT</a></li>
 
        <li><a href="#entrycommenthref">ENTRY_COMMENT_HREF</a></li>
 
        <li><a href="#entrycommenthrefdescr">ENTRY_COMMENT_HREF_DESCR</a></li>
 
<li><a href="#entryclass">ENTRY_CLASS</a> <strong class="no">NOWY!</strong></li>
 
 
<li><a href="#entryclassreset">ENTRY_CLASS_RESET</a> <strong class="no">NOWY!</strong></li>
 
        <li><a href="#adminentryedithref">ADMIN_ENTRY_EDIT_HREF</a> (opis przy bloku <a href="#adminblock">ADMIN_BLOCK</a>)</li>
 
        <li><a href="#adminentryremovehref">ADMIN_ENTRY_REMOVE_HREF</a> (opis przy bloku <a href="#adminblock">ADMIN_BLOCK</a>)</li>
 
 
        </ul>
 
</li>
 
<li><a href="#archiveblock">ARCHIVE_BLOCK</a>
 
        <ul>
 
        <li><a href="#archivehref">ARCHIVE_HREF</a></li>
 
        <li><a href="#archivehrefdescr">ARCHIVE_HREF_DESCR</a></li>
 
        </ul>
 
</li>
 
<li><a href="#linkblock">LINK_BLOCK</a>
 
 
        <ul>
 
        <li><a href="#linkhref">LINK_HREF</a></li>
 
        <li><a href="#linkhrefdescr">LINK_HREF_DESCR</a></li>
 
        </ul>
 
</li>
 
<li><a href="#commentblock">COMMENT_BLOCK</a>
 
        <ul>
 
        <li><a href="#commentclass">COMMENT_CLASS</a></li>
 
 
        <li><a href="#commentnick">COMMENT_NICK</a></li>
 
        <li><a href="#commentdate">COMMENT_DATE</a></li>
 
        <li><a href="#commenthour">COMMENT_HOUR</a></li>
 
        <li><a href="#commentcontent">COMMENT_CONTENT</a></li>
 
        <li><a href="#admincommentremovehref">ADMIN_COMMENT_REMOVE_HREF</a> (opis przy bloku <a href="#adminblock">ADMIN_BLOCK</a>)</li>
 
 
        <li><a href="#admincommentblockiphref">ADMIN_COMMENT_BLOCKIP_HREF</a> (opis przy bloku <a href="#adminblock">ADMIN_BLOCK</a>)</li>
 
        </ul>
 
</li>
 
<li><a href="#adminblock">ADMIN_BLOCK</a>
 
        <ul>
 
        <li><a href="#adminentryedithref">ADMIN_ENTRY_EDIT_HREF</a></li>
 
 
        <li><a href="#adminentryremovehref">ADMIN_ENTRY_REMOVE_HREF</a></li>
 
        <li><a href="#admincommentremovehref">ADMIN_COMMENT_REMOVE_HREF</a></li>
 
        <li><a href="#admincommentblockipthref">ADMIN_COMMENT_BLOCKIP_HREF</a></li>
 
        </ul>
 
</li>
 
<li><a href="#nouserblock">NOUSER_BLOCK</a>
 
        <ul>
 
        <li><a href="#userloginhref">USER_LOG_IN_HREF</a></li>
 
 
        <li><a href="#loginformularz">FORMULARZ</a></li>
 
        </ul>
 
</li>
 
<li><a href="#loggeduserblock">LOGGED_USER_BLOCK</a>
 
        <ul>
 
        <li><a href="#loggedusername">LOGGED_USER_NAME</a></li>
 
        <li><a href="#loggeduserlogouthref">LOGGED_USER_LOG_OUT_HREF</a></li>
 
        </ul>
 
 
</li>
 
<li><a href="#status">status i opis Jabbera</a>
 
        <ul>
 
        <li><a href="#statustext">STATUS_TEXT</a></li>
 
        <li><a href="#statusimage">STATUS_IMAGE</a></li>
 
        <li><a href="#statusdescr">STATUS_DESCR</a></li>
 
        <li><a href="#statusdescr2">STATUS_DESCR2</a></li>
 
 
        </ul>
 
</li>
 
<li><a href="#inne">inne</a>
 
<ul>
 
<li><a href="#jid">JID</a></li>
 
        <li><a href="#allentrieshref">ALL_ENTRIES_HREF</a></li>
 
        <li><a href="#commentform">COMMENT_FORM</a></li>
 
        <li><a href="#customdir">CUSTOM_DIR</a></li>
 
 
        </ul>
 
</li>
 
</ul>
 
 
 
<div id="indeks">
 
 
<hr />
 
 
<h3 id="entryblock">ENTRY_BLOCK</h3>
 
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#entryblock">utwórz dowiązanie (#)</a></p>
 
 
<dl><dt>typ</dt><dd>wymagany tag otwierający i tag zamykający  (<code>&lt;ENTRY_BLOCK&gt; ... &lt;/ENTRY_BLOCK&gt;</code>)</dd><dt>stosowanie</dt><dd>strona główna joggera</dd><dt>działanie</dt><dd>wstawia
 
wpisy</dd><dt>przykład</dt><dd><pre>&lt;ENTRY_BLOCK&gt;
 
    &lt;h2 id="<a href="#entryid">&amp;ENTRY_ID;</a>"&gt;<a href="#entrysubject">&lt;ENTRY_SUBJECT/&gt;</a>&lt;/h2&gt;
 
 
    &lt;p&gt;
 
      dnia <a href="#entrydate">&lt;ENTRY_DATE/&gt;</a>, o godzinie <a href="#entryhour">&lt;ENTRY_HOUR/&gt;</a> /
 
      &lt;a href="<a href="#entrycommenthref">&amp;ENTRY_COMMENT_HREF;</a>"&gt;<a href="#entrycommenthrefdescr">&lt;ENTRY_COMMENT_HREF_DESCR/&gt;</a>;
 
      &lt;span <a href="#entrycommenthrefdescr">class="ukryj"</a>&gt; do wpisu &lt;em&gt;<a href="#entrysubject">&lt;ENTRY_SUBJECT/&gt;</a>&lt;/em&gt;&lt;/span&gt;&lt;/a&gt;
 
 
      &lt;ADMIN_BLOCK&gt;
 
        &lt;span&gt;
 
    &lt;a href="<a href="#adminentryedithref">&amp;ADMIN_ENTRY_EDIT_HREF;</a>"&gt;Edytuj&lt;/a&gt;,
 
          &lt;a href="<a href="#adminentryremovehref">&amp;ADMIN_ENTRY_REMOVE_HREF;</a>"&gt;Usuń&lt;/a&gt;.
 
  &lt;/span&gt;
 
 
      &lt;/ADMIN_BLOCK&gt;
 
    &lt;/p&gt;
 
    &lt;div class="wpis"&gt;
 
      <a href="#entrycontent">&lt;ENTRY_CONTENT/&gt;</a>
 
    &lt;/div&gt;
 
  &lt;/ENTRY_BLOCK&gt;</pre>
 
 
  Efekt można przedstawić następująco:
 
  <pre><big>Najnowszy wpis</big>
 
<small>dnia 23 czerwca 2004, o godzinie 17:19:34 / Dodaj komentarz</small>
 
    Lorem ipsum dolor sit amet, consectetuer adipiscing
 
    elit. Suspendisse wisi. Donec aliquam, erat id
 
    tincidunt vehicula, magna augue feugiat diam, a dictum
 
    nisl ipsum pulvinar lectus. Mauris eleifend adipiscing
 
    libero. Phasellus ut nunc ac urna ultrices vehicula.
 
    Duis turpis. Sed ante. Morbi condimentum ultricies quam.
 
 
 
<big>Poprzedni wpis</big>
 
<small>dnia 23 czerwca 2004, o godzinie 12:09:11 / 2 komentarze</small>
 
    Cras ut lorem venenatis odio euismod adipiscing.
 
    Curabitur ut elit sed mi molestie porttitor. Donec et
 
    orci ac diam elementum mattis. Mauris purus. Fusce
 
    blandit tellus sit amet pede. Fusce eleifend turpis
 
    eget mauris. Fusce quis sapien. Sed lacinia. Praesent
 
    euismod posuere diam.
 
     
 
<big>Wczorajszy wpis</big>
 
<small>dnia 22 czerwca 2004, o godzienie 02:27:01 / 1 komentarz</small>
 
 
    Suspendisse sagittis quam quis enim. Duis a lectus.
 
    Aenean ut massa. Aliquam ultrices, erat quis interdum
 
    luctus, libero nunc fringilla nibh, sit amet consequat
 
    est augue commodo ante. Ut quis risus. Nulla gravida
 
    eros. Aliquam mi tortor, sodales vitae, facilisis
 
    tempus, vestibulum id, nisl.</pre></dd></dl>
 
 
 
<h3 id="entrydayblock">ENTRY_DAY_BLOCK</h3>
 
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#entrydayblock">utwórz dowiązanie (#)</a></p>
 
 
<dl><dt>typ</dt><dd>znacznik opcjonalny; wymagany tag otwierający i tag zamykający  (<code>&lt;ENTRY_DAY_BLOCK&gt; ... &lt;/ENTRY_DAY_BLOCK&gt;</code>)</dd><dt>stosowanie</dt><dd>strona główna joggera</dd><dt>działanie</dt><dd>użycie tego znacznika nie jest obowiązkowe. Służy on do grupowania wpisów z jednego dnia, zatem jeśli w projekcie szablonu każdy wpis jest oddzielną jednostką, ten znacznik nie będzie przydatny.</dd><dt>przykład</dt><dd><pre><a href="#entryblock">&lt;ENTRY_BLOCK&gt;</a>
 
  &lt;div class="dzien"&gt;
 
 
    &lt;h2&gt;dzień <a href="#entrydate">&lt;ENTRY_DATE/&gt;</a> roku:&lt;/h2&gt;
 
    &lt;ENTRY_DAY_BLOCK&gt;
 
      &lt;h3 id="<a href="#entryid">&amp;ENTRY_ID;</a>"&gt;godzina <a href="#entryhour">&lt;ENTRY_HOUR/&gt;</a> Temat: <a href="http://akson.sgh.waw.pl/%7Esm31682/jogger/themes/3entrysubject">&lt;ENTRY_SUBJECT/&gt;</a>&lt;/h3&gt;
 
 
      &lt;div class="wpis"&gt;
 
        <a href="#entrycontent">&lt;ENTRY_CONTENT/&gt;</a>
 
      &lt;/div&gt;
 
 
      &lt;p&gt;
 
        &lt;a href="<a href="http://akson.sgh.waw.pl/%7Esm31682/jogger/themes/entrycommenthref">&amp;ENTRY_COMMENT_HREF;</a>"&gt;<a href="#entrycommenthrefdescr">&lt;ENTRY_COMMENT_HREF_DESCR/&gt;</a>;
 
        &lt;span <a href="#entrycommenthrefdescr">class="ukryj"</a>&gt; do wpisu &lt;em&gt;<a href="#entrysubject">&lt;ENTRY_SUBJECT/&gt;</a>&lt;/em&gt;&lt;/span&gt;&lt;/a&gt;
 
 
        &lt;ADMIN_BLOCK&gt;
 
          &lt;span&gt;
 
            &lt;a href="<a href="#adminentryedithref">&amp;ADMIN_ENTRY_EDIT_HREF;"&gt;</a>Edytuj&lt;/a&gt;,
 
            &lt;a href="<a href="#adminentryremovehref">&amp;ADMIN_ENTRY_REMOVE_HREF;"&gt;</a>Usuń&lt;/a&gt;.
 
  &lt;/span&gt;
 
 
        &lt;/ADMIN_BLOCK&gt;
 
      &lt;/p&gt;
 
    &lt;/ENTRY_DAY_BLOCK&gt;
 
    &lt;hr /&gt;
 
  &lt;/div&gt;
 
&lt;/ENTRY_BLOCK&gt;</pre>
 
 
  Należy zwrócić uwagę na położenie nagłówka h2 zawierającego znacznik <a href="#entrydate"><strong>ENTRY_DATE</strong></a> oraz na położenie poziomej linii <code>&lt;hr /&gt;</code>. Efekt można przedstawić następująco:
 
 
 
  <pre><big>dzień 23 czerwca 2004 roku:</big>
 
 
 
  Najnowszy wpis
 
    Lorem ipsum dolor sit amet, consectetuer adipiscing
 
    elit. Suspendisse wisi. Donec aliquam, erat id
 
    tincidunt vehicula, magna augue feugiat diam, a dictum
 
    nisl ipsum pulvinar lectus. Mauris eleifend adipiscing
 
    libero. Phasellus ut nunc ac urna ultrices vehicula.
 
    Duis turpis. Sed ante. Morbi condimentum ultricies quam.
 
    <small>Dodaj komentarz</small>
 
 
 
  Poprzedni wpis
 
    Cras ut lorem venenatis odio euismod adipiscing.
 
    Curabitur ut elit sed mi molestie porttitor. Donec et
 
    orci ac diam elementum mattis. Mauris purus. Fusce
 
    blandit tellus sit amet pede. Fusce eleifend turpis
 
    eget mauris. Fusce quis sapien. Sed lacinia. Praesent
 
    euismod posuere diam.
 
    <small>2 komentarze</small>
 
 
-----------------------------------------------------------
 
 
<big>dzień 22 czerwca 2004 roku:</big>
 
 
  Wczorajszy wpis
 
    Suspendisse sagittis quam quis enim. Duis a lectus.
 
    Aenean ut massa. Aliquam ultrices, erat quis interdum
 
    luctus, libero nunc fringilla nibh, sit amet consequat
 
    est augue commodo ante. Ut quis risus. Nulla gravida
 
    eros. Aliquam mi tortor, sodales vitae, facilisis
 
    tempus, vestibulum id, nisl.
 
    <small>1 komentarz</small></pre></dd></dl>
 
 
 
<h3 id="entrysubject">ENTRY_SUBJECT</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#entrysubject">utwórz dowiązanie (#)</a></p>
 
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;ENTRY_SUBJECT/&gt;</code> lub <code>&amp;ENTRY_SUBJECT;</code></dd><dt>stosowanie</dt><dd>strona główna joggera (w bloku <strong>ENTRY_BLOCK</strong>) i szablon komentarzy</dd><dt>działanie</dt><dd>wstawia tytuł wpisu (tytuły dodaje się wysyłając w kliencie Jabbera wpis jako wiadomość, a nie jako czat).</dd></dl>
 
 
<h3 id="entrydate">ENTRY_DATE</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#entrydate">utwórz dowiązanie (#)</a></p>
 
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;ENTRY_DATE/&gt;</code> lub <code>&amp;ENTRY_DATE;</code></dd><dt>stosowanie</dt><dd>strona główna joggera (w bloku <strong>ENTRY_BLOCK</strong>) i szablon komentarzy</dd><dt>działanie</dt><dd>wstawia datę (dzień, miesiąc (słownie) i rok) wysłania wpisu lub wpisów (patrz <a href="#entrydayblock">wyjaśnienia w opisie bloku <strong>ENTRY_DAY_BLOCK</strong></a>).</dd></dl>
 
 
<h3 id="entryhour">ENTRY_HOUR</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#entryhour">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;ENTRY_HOUR/&gt;</code> lub <code>&amp;ENTRY_HOUR;</code></dd><dt>stosowanie</dt><dd>strona główna joggera (w bloku <strong>ENTRY_BLOCK</strong>) i szablon komentarzy</dd><dt>działanie</dt><dd>wstawia godzinę wysłania wpisu (w formacie GG:MM:SS).</dd></dl>
 
 
<h3 id="entryid">ENTRY_ID</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#entryid">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;ENTRY_ID/&gt;</code> lub <code>&amp;ENTRY_ID;</code></dd><dt>stosowanie</dt><dd>strona główna joggera (w bloku <strong>ENTRY_BLOCK</strong>) i szablon komentarzy</dd><dt>działanie</dt><dd>wstawia numer ID wpisu w bazie Joggera. Można tego użyć, by stworzyć zakotwiczenie do wpisu (ang. <em lang="en" xml:lang="en">anchor link</em>). Wstawiany tekst wygląda np. tak: <code>e32726</code></dd><dt>przykłady</dt><dd>znacznika mozna użyć po prostu w atrybucie <strong>id</strong> np. nagłowka wpisu:
 
 
<pre>&lt;h2 id="&amp;ENTRY_ID;"&gt;<a href="#entrysubject">&lt;ENTRY_SUBJECT/&gt;</a>&lt;/h2&gt;</pre>
 
Można także zrobić od razu odnośnik do danego wpisu, na wypadek, gdyby ktoś chciał podać doń URL:
 
<pre>&lt;h2 id="&amp;ENTRY_ID;"&gt;&lt;a href="#&amp;ENTRY_ID;"&gt;<a href="#entrysubject">&lt;ENTRY_SUBJECT/&gt;</a>&lt;/a&gt;&lt;/h2&gt;</pre></dd></dl>
 
 
<h3 id="entrylevel">ENTRY_LEVEL</h3>
 
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#entrylevel">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;ENTRY_LEVEL/&gt;</code> lub <code>&amp;ENTRY_LEVEL</code></dd><dt>stosowanie</dt><dd>strona główna joggera (w bloku <strong>ENTRY_BLOCK</strong>) i szablon komentarzy</dd><dt>działanie</dt><dd>wstawia liczbę oznaczającą poziom dostępności wpisu. Poziom ten określa się poprzedzając treść wpisu znacznikiem <code>&lt;LEVELx&gt;</code>,
 
gdzie x to liczba od 0 do 10. Poziom 0 oznacza, że wpis będzie widoczne
 
dla każdego, a oprócz tego (i tym różni się od poziomu 1.) zostanie
 
wyświetlony na stronie głównej Joggera, w częsci "Ostatnio dodane
 
wpisy". Poziomy od 2 do 10 są już prywatne, by przeczytać takie wpisy,
 
należy się zalogować.</dd><dt>przykład</dt><dd>Znacznika <code>&lt;ENTRY_LEVEL&gt;</code> można użyć na przykład do określenia koloru tła tytułu w zależności od poziomu dostępności wpisu.
 
 
<pre>&lt;h2 class="poziom&amp;ENTRY_LEVEL;" id="<a href="#entryid">&amp;ENTRY_ID;</a>"&gt;<a href="#entrysubject">&lt;ENTRY_SUBJECT/&gt;</a>&lt;/h2&gt;</pre>
 
CSS:
 
<pre>.poziom0 { background-color: #fff; }
 
.poziom1 { background-color: #eee; }
 
.poziom2 { background-color: #ddd; }
 
.poziom3 { background-color: #ccc; }
 
(...)</pre></dd><dt>uwagi</dt><dd>Znacznika
 
można użyć na wiele sposobów. Można po prostu przy każdym wpisie
 
wyświetlić jego poziom dostępności, można (tak jak wyżej) zmieniać
 
kolory tła wpisów, można użyć atrybutu <strong>title</strong>, lub pseudoelementów CSS :before i :after (np. <code>.poziom2:after { content: " (Wpis ukryty)" }</code> - pomysł <a href="http://xyc.jogger.pl" title="Przejdź do joga XyCastego.">XyCastego</a>). Wszystko jest dozwolone.</dd></dl>
 
 
<h3 id="entrycontent">ENTRY_CONTENT</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#entrycontent">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;ENTRY_CONTENT&gt;</code> lub <code>&amp;ENTRY_CONTENT;</code></dd><dt>stosowanie</dt><dd>strona główna joggera (w bloku <strong>ENTRY_BLOCK</strong>) i szablon komentarzy</dd><dt>działanie</dt><dd>wstawia treść wpisu.</dd></dl>
 
 
<h3 id="entrycommenthref">ENTRY_COMMENT_HREF</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#entrycommenthref">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;ENTRY_COMMENT_HREF&gt;</code> lub <code>&amp;ENTRY_COMMENT_HREF;</code></dd><dt>stosowanie</dt><dd>strona główna joggera (w bloku <strong>ENTRY_BLOCK</strong>)</dd><dt>działanie</dt><dd>wstawia URL w odnośniku do strony z komentarzami.</dd></dl>
 
 
<h3 id="entrycommenthrefdescr">ENTRY_COMMENT_HREF_DESCR</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#entrycommenthrefdescr">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;ENTRY_COMMENT_HREF_DESCR&gt;</code> lub  <code>&amp;ENTRY_COMMENT_HREF_DESCR;</code></dd><dt>stosowanie</dt><dd>strona główna joggera (w bloku <strong>ENTRY_BLOCK</strong>)</dd><dt>działanie</dt><dd>wstawia
 
tekst odnośnika do stron z komentarzami. Jeśli nie ma żadnych
 
komentarzy, wtedy jest to "Dodaj komentarz". Jeśli komentarze są - np.
 
"1 komentarz", "3 komentarze", "5 komentarzy".</dd><dt>uwagi</dt><dd>Ponieważ
 
możliwe jest, że kilka wpisów nie będzie miało żadnego komentarza lub
 
będą miały taką samą ich liczbę, może się zdarzyć, że na stronie będzie
 
kilka odnośników tak samo opisanych, a prowadzących do różnych stron.
 
Może to spowodować nieporozumienia, szczególnie w przeglądarkach
 
tekstowych lub dźwiękowych. Dlatego zalecany jest zapis:
 
 
<pre>&lt;a href="<a href="#entrycommenthref">&amp;ENTRY_COMMENT_HREF;</a>"&gt;
 
  &lt;ENTRY_COMMENT_HREF_DESCR/&gt;&lt;span class="ukryj"&gt; do wpisu &lt;em&gt;<a href="#entrysubject">&lt;ENTRY_SUBJECT/&gt;</a>&lt;/em&gt;&lt;/span&gt;
 
  &lt;/a&gt;</pre>
 
 
Klasa "ukryj" powinna zostać w CSS zdefiniowana następująco:
 
<pre>.ukryj {
 
display: none;
 
}</pre>Dzieki temu, przeglądając stronę
 
bez CSS, zamiast napisu "2 komentarze" w trzech różnych miejscach,
 
zobaczymy: "2 komentarze do wpisu <em>Pierwszy</em>", "2 komentarze do wpisu <em>Drugi</em>", "2 komentarze do wpisu <em>Trzeci</em>".</dd></dl>
 
 
<h3 id="entryclass">ENTRY_CLASS  <strong class="no">NOWY!</strong></h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#entryclass">utwórz dowiązanie (#)</a></p>
 
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;ENTRY_CLASS&gt;</code> lub <code>&amp;ENTRY_CLASS;</code></dd><dt>stosowanie</dt><dd>strona główna joggera (w bloku <strong>ENTRY_BLOCK</strong>)</dd><dt>działanie</dt><dd>działa analogicznie do znacznika <a href="#commentclass"><strong>COMMENT_CLASS</strong></a> - naprzemiennie wstawia tekst <code>entry1</code> i <code>entry2</code>. Można go użyć zarówno do wpisów jak i do całych dni, o ile w szablonie zastosowano znacznik <a href="#entrydayblock"><strong>ENTRY_DAY_BLOCK</strong></a>. <strong>ENTRY_CLASS</strong> zawsze wstawia wspomniane teksty naprzemiennie - bez względu na liczbę wpisów zgrupowanych pod jadą datą.</dd><dt>uwagi</dt><dd>patrz <a href="#entryclassreset"><strong>ENTRY_CLASS_RESET</strong></a>  <strong class="no">NOWY!</strong><br /><br /><a href="http://bugger.jogger.pl/index.php?do=details&id=60" title="Joggerowy system zgłaszania błędów i propozycji.">Bugger - zgłoszenie nr 60</a> <strong  style="color: green;">(OK)</strong></dd></dl>
 
 
<h3 id="entryclassreset">ENTRY_CLASS_RESET <strong class="no">NOWY!</strong></h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#entryclassreset">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;ENTRY_CLASS_RESET&gt;</code> lub <code>&amp;ENTRY_CLASS_RESET;</code></dd><dt>stosowanie</dt><dd>strona główna joggera (w bloku <strong>ENTRY_BLOCK</strong>)</dd><dt>działanie</dt><dd>działa tylko w połączeniu z <a href="#entryclass"><strong>ENTRY_CLASS</strong></a>. Nie ma ściśle wyznaczonego miejsca, może zostać wpisany gdziekolwiek w bloku <a href="#entryblock"><strong>ENTRY_BLOCK</strong></a>. Powoduje zignorowanie dotychczasowego porządku działania <a href="#entryclass"><strong>ENTRY_CLASS</strong></a> i ponowne rozpoczęcie od <code>entry1</code>. Znacznik ten może być przydatny, jeśli wpisy zgrupowane pod wspólną datą mają zmieniać klasy lokalnie, a nie globalnie. W takim przypadku każdy pierwszy wpis danego dnia miałby klasę <code>entry1</code>.</dd></dl>
 
 
<hr />
 
 
<h3 id="archiveblock">ARCHIVE_BLOCK</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#archiveblock">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>wymagany tag otwierający i tag zamykający (<code>&lt;ARCHIVE_BLOCK&gt; ... &lt;/ARCHIVE_BLOCK&gt;</code>)</dd><dt>stosowanie</dt><dd>szablon strony głównej i szablon komentarzy</dd><dt>działanie</dt><dd>w tym bloku należy umieścić kod odpowiadający za wyświetlanie linków do stron z poprzednimi wpisami.</dd><dt>przykład</dt><dd><pre>Starsze wpisy:
 
 
&lt;ul&gt;
 
  &lt;ARCHIVE_BLOCK&gt;
 
    &lt;li&gt;&lt;a href="<a href="#archivehref">&amp;ARCHIVE_HREF;</a>"&gt;<a href="#archivehrefdescr">&lt;ARCHIVE_HREF_DESCR/&gt;</a>&lt;/a&gt;&lt;/li&gt;
 
  &lt;/ARCHIVE_BLOCK&gt;
 
 
&lt;/ul&gt;</pre></dd><dt>uwagi</dt><dd><a href="http://bugger.jogger.pl/index.php?do=details&id=10" title="Joggerowy system zgłaszania błędów i propozycji.">Bugger - zgłoszenie nr 10</a> (propozycja nowych znaczników)<br /><a href="http://bugger.jogger.pl/index.php?do=details&id=20" title="Joggerowy system zgłaszania błędów i propozycji.">Bugger - zgłoszenie nr 20</a> (propozycja nowych znaczników)</dd></dl>
 
 
<h3 id="archivehref">ARCHIVE_HREF</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#archivehref">utwórz dowiązanie (#)</a></p>
 
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;ARCHIVE_HREF/&gt;</code> lub <code>&amp;ARCHIVE_HREF;</code></dd><dt>stosowanie</dt><dd>blok <strong>ARCHIVE_BLOCK</strong> (szablon strony głównej i szablon komentarzy)</dd><dt>działanie</dt><dd>wstawia URL do stron archiwum.</dd></dl>
 
 
<h3 id="archivehrefdescr">ARCHIVE_HREF_DESCR</h3>
 
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#archivehrefdescr">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;ARCHIVE_HREF_DESCR/&gt;</code> lub <code>&amp;ARCHIVE_HREF_DESCR;</code></dd><dt>stosowanie</dt><dd>blok <strong>ARCHIVE_BLOCK</strong> (szablon strony głównej i szablon komentarzy)</dd><dt>działanie</dt><dd>wstawia nazwy stron archiwum (np. <em>Styczeń 2004</em> lub - jeśli sortujemy wpisy według ich liczby na stronie - np. <em>17.02.2004 - 27.01.2004</em>).</dd></dl>
 
 
<hr />
 
 
<h3 id="linkblock">LINK_BLOCK</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#linkblock">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>wymagany tag otwierający i tag zamykający (<code>&lt;LINK_BLOCK&gt; ... &lt;/LINK_BLOCK&gt;</code>)</dd><dt>stosowanie</dt><dd>szablon strony głównej i szablon komentarzy</dd><dt>działanie</dt><dd>w
 
tym bloku należy umieścić kod odpowiadający za wyświetlanie linków do
 
stron, które zapamiętamy w panelu konfiguracyjnym Joggera. Odnośniki
 
zostaną wyświetlone w kolejności alfabetycznej. Dzięki tej funkcji
 
można dodawać i usuwać linki do ulubionych stron bez konieczności
 
zmiany kodu szablonu.</dd><dt>przykład</dt><dd><pre>Polecam:
 
 
&lt;ul&gt;
 
  &lt;LINK_BLOCK&gt;
 
    &lt;li&gt;&lt;a href="<a href="#linkhref">&amp;LINK_HREF;</a>"&gt;<a href="#linkhrefdescr">&lt;LINK_HREF_DESCR/&gt;</a>&lt;/a&gt;&lt;/li&gt;
 
  &lt;/LINK_BLOCK&gt;
 
 
&lt;/ul&gt;</pre></dd><dt>uwagi</dt><dd><a href="http://bugger.jogger.pl/index.php?do=details&id=7" title="Joggerowy system zgłaszania błędów i propozycji.">Bugger - zgłoszenie nr 7</a> (propozycja nowej opcji)<br /><a href="http://bugger.jogger.pl/index.php?do=details&id=89" title="Joggerowy system zgłaszania błędów i propozycji.">Bugger - zgłoszenie nr 89</a> (propozycja nowego znacznika)</dl>
 
 
<h3 id="linkhref">LINK_HREF</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#linkhref">utwórz dowiązanie (#)</a></p>
 
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;LINK_HREF/&gt;</code> lub <code>&amp;LINK_HREF;</code></dd><dt>stosowanie</dt><dd>blok <strong>LINK_BLOCK</strong> (szablon strony głównej i szablon komentarzy)</dd><dt>działanie</dt><dd>wstawia URL do polecanych stron. (patrz: wyjaśnienie przy <a href="#linkblock"><strong>LINK_BLOCK</strong></a>)</dd></dl>
 
 
<h3 id="linkhrefdescr">LINK_HREF_DESCR</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#linkhrefdescr">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;LINK_HREF_DESCR/&gt;</code> lub <code>&amp;LINK_HREF_DESCR;</code></dd><dt>stosowanie</dt><dd>blok <strong>LINK_BLOCK</strong> (szablon strony głównej i szablon komentarzy)</dd><dt>działanie</dt><dd>wstawia nazwy polecanych stron. (patrz: wyjaśnienie przy <a href="#linkblock"><strong>LINK_BLOCK</strong></a>)</dd></dl>
 
 
<hr />
 
 
<h3 id="commentblock">COMMENT_BLOCK</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#commentblock">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>wymagany tag otwierający i tag zamykający (<code>&lt;COMMENT_BLOCK&gt;... &lt;/COMMENT_BLOCK&gt;</code>)</dd><dt>stosowanie</dt><dd>szablon komentarzy</dd><dt>działanie</dt><dd>blok służy wyświetlaniu kolejnych komentarzy.</dd><dt>przykład</dt><dd>
 
 
<pre>&lt;h2&gt;Komentarze:&lt;/h2&gt;
 
&lt;COMMENT_BLOCK&gt;
 
  &lt;div class="<a href="#commentclass">&amp;COMMENT_CLASS;</a>"&gt;
 
    &lt;p&gt;
 
      <a href="#commentnick">&lt;COMMENT_NICK/&gt;</a> | dnia <a href="#commentdate">&lt;COMMENT_DATE/&gt;</a>, o godzinie <a href="#commenthour">&lt;COMMENT_HOUR/&gt;</a>
 
 
      &lt;ADMIN_BLOCK&gt;
 
        &lt;span&gt;
 
          &lt;a href="<a href="#admincommentremovehref">&amp;ADMIN_COMMENT_REMOVE_HREF;</a>"&gt;Usuń&lt;/a&gt;,
 
          &lt;a href="<a href="#admincommentblockiphref">&amp;ADMIN_COMMENT_BLOCKIP_HREF;</a>"&gt;Zablokuj IP&lt;/a&gt;.
 
        &lt;/span&gt;
 
 
      &lt;/ADMIN_BLOCK&gt;
 
    &lt;/p&gt;
 
    <a href="#commentcontent">&lt;COMMENT_CONTENT/&gt;</a>
 
  &lt;/div&gt;
 
&lt;/COMMENT_BLOCK&gt;</pre></dd><dt>uwagi</dt><dd>patrz też: <a href="#commentform"><strong>COMMENT_FORM</strong></a><br /><br /><a href="http://bugger.jogger.pl/index.php?do=details&id=41" title="Joggerowy system zgłaszania błędów i propozycji.">Bugger - zgłoszenie nr 41</a> (propozycja nowych znaczników)</dd></dl>
 
 
<h3 id="commentclass">COMMENT_CLASS</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#commentclass">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy , zapis: <code>&lt;COMMENT_CLASS/&gt;</code> lub <code>&amp;COMMENT_CLASS;</code></dd><dt>stosowanie</dt><dd>blok <strong>COMMENT_BLOCK</strong> (szablon komentarzy)</dd><dt>działanie</dt><dd>wstawia na zmianę <code>comment1</code> lub <code>comment2</code>.
 
Dzięki temu można za pomocą CSS zróżnicować wygląd sąsiadujących
 
komentarzy, i tym samym ułatwić ich czytanie. Najczęściej definiuje się
 
odmienne kolory tła lub style obramowania.</dd></dl>
 
 
<h3 id="commentnick">COMMENT_NICK</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#commentnick">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;COMMENT_NICK/&gt;</code> lub <code>&amp;COMMENT_NICK;</code></dd><dt>stosowanie</dt><dd>blok <strong>COMMENT_BLOCK</strong> (szablon komentarzy)</dd><dt>działanie</dt><dd>wstawia
 
podpis komentującego. Jeśli komentujący jest użytkownikiem Joggera i w
 
chwili dodawania komentarza był zalogowany do Joggera (zalogować się
 
można na <a href="http://www.jogger.pl/">stronie głównej Joggera</a>), wstawiony zostanie podpis będący odnośnikiem do joga komentującego.</dd></dl>
 
 
<h3 id="commentdate">COMMENT_DATE</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#commentdate">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;COMMENT_DATE/&gt;</code> lub <code>&amp;COMMENT_DATE;</code></dd><dt>stosowanie</dt><dd>blok <strong>COMMENT_BLOCK</strong> (szablon komentarzy)</dd><dt>działanie</dt><dd>wstawia datę dodania komentarza.</dd></dl>
 
 
<h3 id="commenthour">COMMENT_HOUR</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#commenthour">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;COMMENT_HOUR/&gt;</code> lub <code>&amp;COMMENT_HOUR;</code></dd><dt>stosowanie</dt><dd>blok <strong>COMMENT_BLOCK</strong> (szablon komentarzy)</dd><dt>działanie</dt><dd>wstawia godzinę dodania komentarza.</dd></dl>
 
 
<h3 id="commentcontent">COMMENT_CONTENT</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#commentcontent">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;COMMENT_CONTENT/&gt;</code> lub <code>&amp;COMMENT_CONTENT;</code></dd><dt>stosowanie</dt><dd>blok <strong>COMMENT_BLOCK</strong> (szablon komentarzy)</dd><dt>działanie</dt><dd>wstawia treść komentarza.</dd></dl>
 
 
<hr />
 
 
<h3 id="adminblock">ADMIN_BLOCK</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#adminblock">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>wymagany tag otwierający i tag zamykający (<code>&lt;ADMIN_BLOCK&gt; ... &lt;/ADMIN_BLOCK&gt;</code>)</dd><dt>stosowanie</dt><dd>szablon strony głównej i szablon komentarzy</dd><dt>działanie</dt><dd>blok powoduje pokazanie zawartej w nim treści jedynie zalogowanemu (na <a href="http://www.jogger.pl/">stronie głównej Joggera</a>) właścicielowi. Można w nim umieścić wszystko, jednak 4 specjalne tagi nadają się do tego lepiej niż cokolwiek innego.</dd><dt>przykład</dt><dd>
 
 
w bloku <strong>ENTRY_BLOCK</strong>:
 
<pre>&lt;ENTRY_BLOCKY&gt;
 
  (...)
 
  &lt;ADMIN_BLOCK&gt;
 
    &lt;span&gt;
 
      &lt;a href="<a href="#adminentrytedithref">&amp;ADMIN_ENTRY_EDIT_HREF;</a>"&gt;Edytuj&lt;/a&gt;,
 
      &lt;a href="<a href="#adminentryremovehref">&amp;ADMIN_ENTRY_REMOVE_HREF;</a>"&gt;Usuń&lt;/a&gt;.
 
    &lt;/span&gt;
 
 
  &lt;/ADMIN_BLOCK&gt;
 
  (...)
 
&lt;/ENTRY_BLOCKY&gt;</pre>
 
w bloku <strong>COMMENT_BLOCK</strong>:
 
<pre>&lt;COMMENT_BLOCK&gt;
 
  (...)
 
  &lt;ADMIN_BLOCK&gt;
 
    &lt;span&gt;
 
 
      &lt;a href="<a href="#admincommentremovehref">&amp;ADMIN_COMMENT_REMOVE_HREF;</a>"&gt;Usuń&lt;/a&gt;,
 
      &lt;a href="<a href="#admincommentblockiphref">&amp;ADMIN_COMMENT_BLOCKIP_HREF;</a>"&gt;Zablokuj IP&lt;/a&gt;.
 
    &lt;/span&gt;
 
  &lt;/ADMIN_BLOCK&gt;
 
 
  (...)
 
&lt;/COMMENT_BLOCK&gt;</pre>
 
można też tak:
 
<pre>&lt;ADMIN_BLOCK&gt;
 
  &lt;p&gt;Tego akapitu nie zobaczy nikt poza mną.&lt;/p&gt;
 
&lt;/ADMIN_BLOCK&gt;</pre></dd><dt>uwagi</dt><dd>4 tagi zaczynające się od "<strong>ADMIN_</strong>" nie muszą być umieszczone w bloku <strong>ADMIN_BLOCK</strong>.
 
Jednak wtedy zwykli użytkownicy odwiedzający joga zobaczą opisy
 
adminowych odnośników. Niczym to nie grozi, bo bez hasła i tak nic nie
 
popsują, chodzi tylko o wygląd strony.<br /><br /><a href="http://bugger.jogger.pl/index.php?do=details&id=77" title="Joggerowy system zgłaszania błędów i propozycji.">Bugger - zgłoszenie nr 77</a> (propozycja nowych znaczników)<br /><a href="http://bugger.jogger.pl/index.php?do=details&id=90" title="Joggerowy system zgłaszania błędów i propozycji.">Bugger - zgłoszenie nr 90</a> (propozycja nowych znaczników)</dd></dl>
 
 
<h3 id="adminentryedithref">ADMIN_ENTRY_EDIT_HREF</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#adminentryedithref">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;ADMIN_ENTRY_EDIT_HREF/&gt;</code> lub <code>&amp;ADMIN_ENTRY_EDIT_HREF;</code></dd><dt>stosowanie</dt><dd>blok <strong>ADMIN_BLOCK</strong> (szablon strony głównej (wtedy w bloku <strong>ENTRIES_DAY</strong>) i szablon komentarzy (wtedy gdziekolwiek, bo odnosi się do komentowanego wpisu))</dd><dt>działanie</dt><dd>wstawia URL do strony edycji danego wpisu.</dd></dl>
 
 
<h3 id="adminentryremovehref">ADMIN_ENTRY_REMOVE_HREF</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#adminentryremovehref">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;ADMIN_ENTRY_REMOVE_HREF/&gt;</code> lub <code>&amp;ADMIN_ENTRY_REMOVE_HREF;</code></dd><dt>stosowanie</dt><dd>blok <strong>ADMIN_BLOCK</strong> (szablon strony głównej (wtedy w bloku <strong>ENTRIES_DAY</strong>) i szablon komentarzy (wtedy gdziekolwiek, bo odnosi się do komentowanego wpisu))</dd><dt>działanie</dt><dd>wstawia URL do strony z pytaniem o potwierdzenie usunięcia danego wpisu.</dd></dl>
 
 
<h3 id="admincommentremovehref">ADMIN_COMMENT_REMOVE_HREF</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#admincommentremovehref">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;ADMIN_COMMENT_REMOVE_HREF/&gt;</code> lub  <code>&amp;ADMIN_COMMENT_REMOVE_HREF;</code></dd><dt>stosowanie</dt><dd>blok <strong>ADMIN_BLOCK</strong> w bloku <strong>COMMENT_BLOCK</strong> (szablon komentarzy)</dd><dt>działanie</dt><dd>wstawia URL do odnośnika powodującego usunięcie danego komentarza (bez potwierdzania).</dd></dl>
 
 
<h3 id="admincommentblockiphref">ADMIN_COMMENT_BLOCKIP_HREF</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#admincommentblockiphref">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;ADMIN_COMMENT_BLOCKIP_HREF/&gt;</code> lub <code>&amp;ADMIN_COMMENT_BLOCKIP_HREF;</code></dd><dt>stosowanie</dt><dd>blok <strong>ADMIN_BLOCK</strong> w bloku <strong>COMMENT_BLOCK</strong> (szablon komentarzy)</dd><dt>działanie</dt><dd>wstawia URL do odnośnika powodującego zablokowanie IP osoby komentującej.</dd></dl>
 
 
<hr />
 
 
<h3 id="nouserblock">NOUSER_BLOCK</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#nouserblock">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>wymagany tag otwierający i tag zamykający (<code>&lt;NOUSER_BLOCK&gt; ... &lt;/NOUSER_BLOCK&gt;</code>)</dd><dt>stosowanie</dt><dd>szablon strony głównej i szablon komentarzy</dd><dt>działanie</dt><dd>Wszystko
 
umieszczone w tym bloku będzie widoczne jedynie dla niezalogowanych
 
użytkowników, np. zwykłych gości. Można tu wstawić link do strony
 
logowania lub od razu odpowiedni formularz (dzięki dla kryska).</dd><dt>przykład</dt><dd><pre>Dla znajomych
 
 
&lt;NOUSER_BLOCK&gt;
 
  &lt;p&gt;&lt;a href="<a href="#userloginhref">&amp;USER_LOG_IN_HREF;</a>"&gt;Zaloguj się&lt;/a&gt;, by przeczytać inne wpisy.&lt;/p&gt;
 
&lt;/NOUSER_BLOCK&gt;
 
<a href="#loggeduserblock">&lt;LOGGED_USER_BLOCK&gt; ( ... ) &lt;/LOGGED_USER_BLOCK&gt;</a></pre></dd><dt>uwagi</dt><dd>patrz: <a href="#loginformularz">formularz logowania</a></dd></dl>
 
 
<h3 id="userloginhref">USER_LOG_IN_HREF</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#userloginhref">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;USER_LOG_IN_HREF/&gt;</code> lub <code>&amp;USER_LOG_IN_HREF;</code></dd><dt>stosowanie</dt><dd>np. blok <strong>NOUSER_BLOCK</strong> (szablon strony głównej i szablon komentarzy)</dd><dt>działanie</dt><dd>wstawia URL odnośnika  do strony  logowania (na przykład <a href="http://login.staszyna.jogger.pl/">http://login.staszyna.jogger.pl</a>).
 
Takiego linka można np. użyć dyskretnie, by nie tylko ukryć niektóre
 
wpisy, ale także samą informację o ukrywaniu czegokolwiek.</dd></dl>
 
 
<h3 id="loginformularz">FORMULARZ</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#loginformularz">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>formularz przygotowany przez kryska, z moimi niewielkimi modyfikacjami</dd><dt>stosowanie</dt><dd>np. blok <strong>NOUSER_BLOCK</strong> (szablon strony głównej i szablon komentarzy)</dd><dt>działanie</dt><dd>formularz od razu przekazuje Joggerowi dane o nazwie użytkownika i haśle, bez pośrednictwa wyżej wspomnianej strony.</dd><dt>przykład</dt><dd><pre>Dla znajomych:&lt;br /&gt;
 
 
&lt;NOUSER_BLOCK&gt;
 
  &lt;form action="http://login.[Twoja_nazwa_domeny].jogger.pl/index.php" method="post" id="logowanie"&gt;
 
    &lt;div&gt;&lt;input type="hidden" name="op" value="loginuser" /&gt;&lt;/div&gt;
 
    &lt;div&gt;&lt;span&gt;Login:&lt;/span&gt;&lt;input type="text" name="user" /&gt;&lt;/div&gt;
 
 
    &lt;div&gt;&lt;span&gt;Hasło:&lt;/span&gt;&lt;input type="password" name="pass" /&gt;&lt;/div&gt;
 
    &lt;div&gt;&lt;input type="submit" value="Zaloguj" id="guzik" /&gt;&lt;/div&gt;
 
  &lt;/form&gt;
 
&lt;/NOUSER_BLOCK&gt;</pre></dd><dt>uwagi</dt><dd>by to ładniej wyglądało, można w CSS dodać np.:
 
 
<pre>/* logowanie */
 
 
form#logowanie span {
 
        width: 4em;
 
        float: left;
 
}
 
 
form#logowanie div {
 
        margin-bottom: 3px;
 
}
 
 
form#logowanie input {
 
        width: 8em;
 
        padding-left: 3px;
 
}
 
 
form#logowanie input#guzik {
 
        width: auto;
 
        padding: 3px 5px;
 
        margin-top: 5px;
 
        margin-left: 4em; /* tyle samo, ile width w span wyżej */
 
        font-family: sans-serif;
 
}</pre></dd></dl>
 
 
<hr />
 
 
<h3 id="loggeduserblock">LOGGED_USER_BLOCK</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#loggeduserblock">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>wymagany tag otwierający i tag zamykający (<code>&lt;LOGGED_USER_BLOCK&gt; ... &lt;/LOGGED_USER_BLOCK&gt;</code>)</dd><dt>stosowanie</dt><dd>szablon strony głównej i szablon komentarzy</dd><dt>działanie</dt><dd>treść zawarta w tym bloku będzie widoczna tylko i wyłącznie dla zalogowanych gości joga.</dd><dt>przykład</dt><dd><pre>Dla znajomych:
 
 
<a href="#nouserblock">&lt;NOUSER_BLOCK&gt; ( ... ) &lt;/NOUSER_BLOCK&gt;</a>
 
&lt;LOGGED_USER_BLOCK&gt;
 
  &lt;p&gt;<a href="#loggedusername">
 
    &lt;LOGGED_USER_NAME/&gt;</a>,
 
    &lt;a href="<a href="#loggeduserlogouthref">&amp;LOGGED_USER_LOG_OUT_HREF;</a>"&gt;&lt;em&gt;wyloguj się&lt;/em&gt;&lt;/a&gt;, gdy będziesz wychodzić.
 
  &lt;/p&gt;
 
 
&lt;/LOGGED_USER_BLOCK&gt;</pre></dd></dl>
 
 
<h3 id="loggedusername">LOGGED_USER_NAME</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#loggedusername">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;LOGGED_USER_NAME/&gt;</code> lub <code>&amp;LOGGED_USER_NAME;</code></dd><dt>stosowanie</dt><dd>blok <strong>LOGGED_USER_BLOCK</strong> (szablon strony głównej i szablon komentarzy)</dd><dt>działanie</dt><dd>wstawia nazwę zalogowanego użytkownika.</dd></dl>
 
 
<h3 id="loggeduserlogouthref">LOGGED_USER_LOG_OUT_HREF</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#loggeduserlogouthref">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;LOGGED_USER_LOG_OUT_HREF/&gt;</code> lub <code>&amp;LOGGED_USER_LOG_OUT_HREF;</code></dd><dt>stosowanie</dt><dd>blok <strong>LOGGED_USER_BLOCK</strong> (szablon strony głównej i szablon komentarzy)</dd><dt>działanie</dt><dd>wstawia
 
URL do odnośnika wylogowującego zalogowanego użytkownika. Warto
 
sprawić, by użytkownik rzeczywiście kliknął w ten link, gdy będzie
 
odchodził np. od komputera w kawiarence internetowej.</dd></dl>
 
 
<hr />
 
 
<h3 id="status">status i opis Jabbera</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#status">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>grupa znaczników służących do wyświetlania tekstu
 
dostępności (np. dostępny/rozłączony), ikony dostępności oraz
 
Jabberowego opisu.</dd><dt>stosowanie</dt><dd>szablon strony głównej i szablon komentarzy, nie wymagają żadnego specjalnego bloku</dd><dt>znaczniki</dt><dd><a href="#statustext"><strong>STATUS_TEXT</strong></a>, <a href="#statusimage"><strong>STATUS_IMAGE</strong></a>, <a href="#statusdescr"><strong>STATUS_DESCR</strong></a> oraz <a href="#statusdescr2"><strong>STATUS_DESCR2</strong></a>.</dd><dt>przykład</dt><dd>
 
 
<pre>&lt;ul&gt;
 
  &lt;li&gt;mój status: &lt;strong&gt;<a href="#statustext">&lt;STATUS_TEXT/&gt;</a>&lt;/strong&gt; &lt;img src="<a href="#statusimage">&amp;STATUS_IMAGE;</a>" alt="" /&gt;
 
  &lt;li&gt;mój opis: &lt;em&gt;<a href="#statusdescr">&lt;STATUS_DESCR/&gt;</a>&lt;/em&gt;
 
 
&lt;/ul&gt;</pre></dd></dl>
 
<h3 id="statustext">STATUS_TEXT</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="##entryblock">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;STATUS_TEXT/&gt;</code> lub <code>&amp;STATUS_TEXT;</code></dd><dt>stosowanie</dt><dd>szablon strony głównej i szablon komentarzy</dd><dt>działanie</dt><dd>wstawia teskt dostępności lub niedostępności. Oba należy ustawić w panelu konfiguracyjnym, w zakładce <em>Ustawienia</em> (<em>Tekst dostępności</em> i <em>Tekst niedostępności</em>), np. dostępny/rozłączony, online/offline, jestem/nie ma mnie itd.</dd></dl>
 
 
<h3 id="statusimage">STATUS_IMAGE</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#statusimage">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;STATUS_IMAGE/&gt;</code> lub <code>&amp;STATUS_IMAGE;</code></dd><dt>stosowanie</dt><dd>szablon strony głównej i szablon komentarzy</dd><dt>działanie</dt><dd>wstawia ścieżkę do pliku-ikony dostepności. Należy najpierw utworzyć i wgrać do Joggera dwa takie pliki: <strong>online.png</strong> i <strong>offline.png</strong>. W zależności od statusu właściciela joga, Jogger wstawi ścieżkę do odpowiedniego pliku.</dd><dt>uwagi</dt><dd>znacznik wstawia pełną ścieżkę, a nie tylko nazwę pliku. Dlatego nie trzeba pisać: <del><code><a href="#customdir">&amp;CUSTOM_DIR;</a>/&amp;STATUS_IMAGE;</code></del>. Wystarczy samo <code>&amp;STATUS_IMAGE;</code></dd></dl>
 
 
<h3 id="statusdescr">STATUS_DESCR</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#statusdescr">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;STATUS_DESCR/&gt;</code> lub <code>&amp;STATUS_DESCR;</code></dd><dt>stosowanie</dt><dd>szablon strony głównej i szablon komentarzy</dd><dt>działanie</dt><dd>wstawia Jabberowy opis.</dd><dt>uwagi</dt><dd><a href="http://bugger.jogger.pl/index.php?do=details&id=68" title="Joggerowy system zgłaszania błędów i propozycji.">Bugger - zgłoszenie nr 68</a></dd></dl>
 
 
<h3 id="statusdescr2">STATUS_DESCR2</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#statusdescr2">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;STATUS_DESCR2/&gt;</code> lub <code>&amp;STATUS_DESCR2;</code></dd><dt>stosowanie</dt><dd>szablon strony głównej i szablon komentarzy</dd><dt>działanie</dt><dd>podobnie jak <a href="#statusdescr"><strong>STATUS_DESCR</strong></a> wstawia opis na Jabberze, tyle tylko, że ujęty w cudzysłowy. Jeśli opisu nie ma, cudzysłowy nie zostaną wyświetlone.</dd></dl>
 
 
<hr />
 
 
<h3 id="inne">Inne</h3>
 
 
<h3 id="jid">JID</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#jid">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;JID/&gt;</code> lub <code>&amp;JID;</code></dd><dt>stosowanie</dt><dd>szablon strony głównej i szablon komentarzy</dd><dt>działanie</dt><dd>wstawia JID (Jabber ID) właściciela joga.</dd><dt>przykład</dt><dd><pre>&lt;acronym lang="en" xml:lang="en" title="Jabber Identyfier"&gt;JID&lt;/acronym&gt;: &lt;JID/&gt;</pre></dd></dl>
 
 
<h3 id="allentrieshref">ALL_ENTRIES_HREF</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#allentrieshref">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;ALL_ENTRIES_HREF/&gt;</code> lub <code>&amp;ALL_ENTRIES_HREF;</code></dd><dt>stosowanie</dt><dd>szablon komentarzy</dd><dt>działanie</dt><dd>wstawia
 
link prowadzący do strony głównej z odpowiednimi wpisami (tzn. jeśli
 
ktoś czyta komentarze do wpisu ze stycznia, to ten link przeniesie go
 
do strony z wpisami ze stycznia).</dd><dt>przykład</dt><dd><pre>&lt;a href="&amp;ALL_ENTRIES_HREF;" title="Powrót do reszty wpisów"&gt;Wróć&lt;/a&gt;</pre></dd></dl>
 
 
<h3 id="commentform">COMMENT_FORM</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#commentform">utwórz dowiązanie (#)</a></p>
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;COMMENT_FORM/&gt;</code> lub <code>&amp;COMMENT_FORM;</code></dd><dt>stosowanie</dt><dd>szablon komentarzy</dd><dt>działanie</dt><dd>wstawia cały formularz do dodawania komentarzy.</dd><dt>przykład</dt><dd><pre>&lt;h2&gt;Dodaj swój komentarz:&lt;/h2&gt;
 
 
&lt;COMMENT_FORM/&gt;</pre></dd><dt>uwagi</dt><dd>tag wstawia następującą tabelę (zamiast "Sledź ten wątek..." może być button "Przestań sledzić ten wątek"):
 
<pre>&lt;form action="/comment.php" method="post"&gt;
 
  &lt;div&gt;&lt;input type="hidden" name="jid"  value="[jid_komentowanego]" /&gt;
 
  &lt;input type="hidden" name="eid"  value="[id_wpisu]" /&gt;
 
  &lt;input type="hidden" name="startid"  value="0" /&gt;
 
  &lt;input type="hidden" name="op" value="addcomm" /&gt;&lt;/div&gt;
 
 
  &lt;table&gt;
 
    &lt;tr&gt;
 
      &lt;td&gt;Podpis:&lt;/td&gt;
 
      &lt;td&gt;&lt;input type="text" name="commnickid" <strong>id="commnickid"</strong> value="[Twój_jid]" /&gt;&lt;/td&gt;
 
 
    &lt;/tr&gt;
 
    &lt;tr&gt;
 
      &lt;td&gt;Treść:&lt;/td&gt;
 
      &lt;td&gt;&lt;textarea name="commbody" <strong>id="commbody"</strong> cols="60" rows="6"&gt;&lt;/textarea&gt;&lt;/td&gt;
 
 
    &lt;/tr&gt;
 
    &lt;tr&gt;
 
      &lt;td&gt;&amp;nbsp;&lt;/td&gt;
 
      &lt;td&gt;
 
        &lt;input type="checkbox" name="notifyentry" value="notify" /&gt;
 
 
        Śledź ten wątek i powiadom mnie o nowych komentarzach
 
    &lt;/td&gt;
 
    &lt;/tr&gt;
 
    &lt;tr&gt;
 
      &lt;td&gt;&amp;nbsp;&lt;/td&gt;
 
      &lt;td&gt;&lt;input type='submit' name="submit" <strong>id="submitcomm"</strong> value='Wyślij' /&gt;&lt;/td&gt;
 
 
    &lt;/tr&gt;
 
  &lt;/table&gt;
 
&lt;/form&gt;</pre>
 
By zastosować style do tego formularza wystarczy użyć ID jego pól. Jak widać pole z podpisem ma <code>id="commnickid"</code>, pole tekstowe z treścią komentarza - <code>id="commbody"</code>, przycisk "Wyślij" - <code>id="submitcomm"</code> a przycisk "Przestań śledzić ten wątek" - <code>id="tracestop"</code>
 
 
</dd><dt>uwagi</dt><dd><a href="http://bugger.jogger.pl/index.php?do=details&id=8" title="Joggerowy system zgłaszania błędów i propozycji.">Bugger - zgłoszenie nr 8</a><br /><a href="http://bugger.jogger.pl/index.php?do=details&id=88" title="Joggerowy system zgłaszania błędów i propozycji.">Bugger - zgłoszenie nr 88</a> <strong  style="color: green;">(OK)</strong></dd></dl>
 
 
<h3 id="customdir">CUSTOM_DIR</h3>
 
<p><a href="#top">na górę</a> | <a href="#skorowidz">spis znaczników</a> | <a href="#customdir">utwórz dowiązanie (#)</a></p>
 
 
<dl><dt>typ</dt><dd>pojedynczy, zapis: <code>&lt;CUSTOM_DIR/&gt;</code> lub <code>&amp;CUSTOM_DIR;</code></dd><dt>stosowanie</dt><dd>szablon strony głównej i szablon komentarzy</dd><dt>działanie</dt><dd>wstawia
 
scieżkę do osobistego joggerowego katalogu, w którym można przechowywać
 
do 150 KB danych. Katalog służy głównie do przechowywania grafiki do
 
joga, jednak wgrywać można doń nie tylko pliki graficzne. Jedyne
 
ograniczenie dotyczy plików skojarzonych z językiem PHP. Wstawiana
 
ścieżka to <code>custom/[Twój_nick]/files</code> (bez ukośnika na końcu, trzeba go dodać samemu).</dd><dt>przykład</dt><dd><pre>&lt;a href="http://www.mozilla.org/products/firefox/" title="Get Firefox - Web Browsing Redefined"&gt;
 
  &lt;img src="&amp;CUSTOM_DIR;/getfirefox_small.png"
 
  width="110" height="32" border="0" alt="Get Firefox" /&gt;
 
 
&lt;/a&gt;</pre>
 
<pre>&lt;link rel="StyleSheet" href="&amp;CUSTOM_DIR;/nazwa_pliku.css" type="text/css" title="Pierwszy" /&gt;</pre></dd><dt>uwagi</dt><dd>
 
<ol>
 
<li>Jeśli chcesz wstawić ikonkę dostępności za pomocą znacznika <code>&lt;STATUS_IMAGE/&gt;</code>, nie używaj już taga <code>&lt;CUSTOM_DIR/&gt;</code>. Więcej informacji przy opisie <a href="#statusimage"><strong>STATUS_IMAGE</strong></a>.</li>
 
<li>Mimo, że ścieżek do grafiki używa się także w plikach CSS (np. <code>background-image: url(obrazki/tlo.gif);</code>), zdecydowano, że znacznik <code>&lt;CUSTOM_DIR/&gt;</code>
 
 
nie będzie obsługiwany w tych plikach. Działa jedynie w pliku szablonu
 
strony głównej i strony z komentarzami. Używanie go w plikach CSS
 
byłoby bezcelowe, ponieważ zarówno pliki CSS, jak i wszystkie inne
 
pliki wgrane do Joggera znajdują się w tym samym katalogu: <code>custom/[Twój_nick]/files/</code>. Dzięki temu do grafiki wystarczy odwołać się poprzez wpisanie jedynie nazwy pliku, np. <code>background-image: url(tlo.gif);</code>, ponieważ ścieżki podawane w plikach CSS są przez przeglądarki czytane względem położenia tych plików, a nie plików *.html.<br />Oczwiście, jeśli definicje CSS wpiszemy w pliku szblonu (*.html), w sekcji <strong>HEAD</strong> lub bezpośrednio przy odpowiednich elementach, wtedy użycie <code>&lt;CUSTOM_DIR/&gt;</code> będzie jak najbardziej właściwe (np. <code>&lt;div style="background-color: &lt;CUSTOM_DIR/&gt;/tlo.gif"&gt; ... &lt;/div&gt;</code>).
 
 
</li><li>Należy pamietać o atrybucie <strong>alt</strong> dla każdego umieszczanego obrazka. Jeśli jest to tylko grafika ozdobna należy dodać pusty  <code>alt=""</code>.
 
</li></ol></dd></dl>
 
 
</div>
 
 
<div id="stopka">
 
<p style="float: left;">
 
Stanisław Małolepszy, http://staszyna.jogger.pl kwiecień 2003 - maj 2004; aktualizacja: 1 lipca 2004
 
</p>
 

Aktualna wersja na dzień 20:58, 9 lut 2006