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

Źródło „http://wiki.jogger.pl/index.php?title=ThemesFaq:Wlasne_szablony_dla_joggera&oldid=1285”