|
|
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><ADMIN_[...]_HREF/></code> można wstawić do bloku <strong><ADMIN_BLOCK></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><JID/></code></a>, <a href="#allentrieshref"><code><ALL_ENTRIES_HREF/></code></a>, <a href="#commentform"><code><COMMENT_FORM/></code></a> i <a href="#customdir"><code><CUSTOM_DIR/></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><NAZWA_ZNACZNIKA/></em>* można napisać <em>&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><img src="<a href="#imagesdir">&CUSTOM_DIR;</a>/obrazek.gif" alt=""/></code> lub <code><a href="<a href="#archivehref">&ARCHIVE_HREF;</a>"><a href="#archivehrefdescr"><ARCHIVE_HREF_DESCR/></a></a></code><br /><br />
| |
− |
| |
− | * - Uwaga: ważne jest, by w zapisie <em><NAZWA_ZNACZNIKA/></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><head></code> i tym podobnych. Pominąć trzeba także sam znacznik <code><body></code> oraz <code></body></code>.
| |
− | Wszystko dlatego, że Jogger sam uzupełni szablon i ostatecznie
| |
− | wyświetli poprawną stronę. Na początek pliku zostanie wstawione np.:
| |
− | <pre><!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
| |
− | <html lang="pl">
| |
− |
| |
− | <head>
| |
− | <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
| |
− | <meta name="robots" content="noindex, nofollow">
| |
− | <title>Jogger :: staszyna@chrome.pl</title>
| |
− | <link rel="StyleSheet" href="custom/staszyna/files/style.css" type="text/css">
| |
− | </head>
| |
− |
| |
− | <body></pre>
| |
− | A na koniec:
| |
− | <pre></body>
| |
− | <html></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><meta name="robots" content="noindex, nofollow" /></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><CUSTOM_DIR/></code></a>, który wstawi ścieżkę do katalogu <code>files/</code>. Czyli: <pre><link rel="StyleSheet" href="<a href="#customdir">&CUSTOM_DIR;</a>/nazwa_pliku.css" type="text/css" title="Podstawowy styl" /></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><CUSTOM_DIR/></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><CUSTOM_DIR/></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><STATUS_IMAGE/></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 <a href="http://www.jogger.pl">Jogger</a>.
| |
− | Copyright (c) 2002-2003 Justin Mecham oraz JabberPL Group.<br />
| |
− | Wszystkie prawa zastrzeżone. <a href="http://jogger.pl/info.php?id=legal">Legalność</a>;
| |
− |
| |
− | <a href="http://www.jogger.pl/about.php">Informacje</a></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 --> <a href="#entryblock">ENTRY_BLOCK</a>
| |
− | ENTRIES_DAY --> <a href="#entrydayblock">ENTRY_DAY_BLOCK</a>
| |
− | COMMENT_HREF --> <a href="#entrycommenthref">ENTRY_COMMENT_HREF</a>
| |
− |
| |
− | COMMENT_HREF_DESCR --> <a href="#entrycommnenthrefdescr">ENTRY_COMMENT_HREF_DESCR</a>
| |
− | USER_LOGIN_HREF --> <a href="#userloginhref">USER_LOG_IN_HREF</a>
| |
− | USER_BLOCK --> <a href="#loggeduserblock">LOGGED_USER_BLOCK</a>
| |
− | USER_LOGIN_NAME --> <a href="#loggedusername">LOGGED_USER_NAME</a>
| |
− | USER_LOGOUT_HREF --> <a href="#loggeduserlogouthref">LOGGED_USER_LOG_OUT_HREF</a>
| |
− |
| |
− | PUT_JID --> <a href="#jid">JID</a>
| |
− | IMAGES_DIR --> <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><ENTRY_BLOCK> ... </ENTRY_BLOCK></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><ENTRY_BLOCK>
| |
− | <h2 id="<a href="#entryid">&ENTRY_ID;</a>"><a href="#entrysubject"><ENTRY_SUBJECT/></a></h2>
| |
− |
| |
− | <p>
| |
− | dnia <a href="#entrydate"><ENTRY_DATE/></a>, o godzinie <a href="#entryhour"><ENTRY_HOUR/></a> /
| |
− | <a href="<a href="#entrycommenthref">&ENTRY_COMMENT_HREF;</a>"><a href="#entrycommenthrefdescr"><ENTRY_COMMENT_HREF_DESCR/></a>;
| |
− | <span <a href="#entrycommenthrefdescr">class="ukryj"</a>> do wpisu <em><a href="#entrysubject"><ENTRY_SUBJECT/></a></em></span></a>
| |
− |
| |
− | <ADMIN_BLOCK>
| |
− | <span>
| |
− | <a href="<a href="#adminentryedithref">&ADMIN_ENTRY_EDIT_HREF;</a>">Edytuj</a>,
| |
− | <a href="<a href="#adminentryremovehref">&ADMIN_ENTRY_REMOVE_HREF;</a>">Usuń</a>.
| |
− | </span>
| |
− |
| |
− | </ADMIN_BLOCK>
| |
− | </p>
| |
− | <div class="wpis">
| |
− | <a href="#entrycontent"><ENTRY_CONTENT/></a>
| |
− | </div>
| |
− | </ENTRY_BLOCK></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><ENTRY_DAY_BLOCK> ... </ENTRY_DAY_BLOCK></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"><ENTRY_BLOCK></a>
| |
− | <div class="dzien">
| |
− |
| |
− | <h2>dzień <a href="#entrydate"><ENTRY_DATE/></a> roku:</h2>
| |
− | <ENTRY_DAY_BLOCK>
| |
− | <h3 id="<a href="#entryid">&ENTRY_ID;</a>">godzina <a href="#entryhour"><ENTRY_HOUR/></a> Temat: <a href="http://akson.sgh.waw.pl/%7Esm31682/jogger/themes/3entrysubject"><ENTRY_SUBJECT/></a></h3>
| |
− |
| |
− | <div class="wpis">
| |
− | <a href="#entrycontent"><ENTRY_CONTENT/></a>
| |
− | </div>
| |
− |
| |
− | <p>
| |
− | <a href="<a href="http://akson.sgh.waw.pl/%7Esm31682/jogger/themes/entrycommenthref">&ENTRY_COMMENT_HREF;</a>"><a href="#entrycommenthrefdescr"><ENTRY_COMMENT_HREF_DESCR/></a>;
| |
− | <span <a href="#entrycommenthrefdescr">class="ukryj"</a>> do wpisu <em><a href="#entrysubject"><ENTRY_SUBJECT/></a></em></span></a>
| |
− |
| |
− | <ADMIN_BLOCK>
| |
− | <span>
| |
− | <a href="<a href="#adminentryedithref">&ADMIN_ENTRY_EDIT_HREF;"></a>Edytuj</a>,
| |
− | <a href="<a href="#adminentryremovehref">&ADMIN_ENTRY_REMOVE_HREF;"></a>Usuń</a>.
| |
− | </span>
| |
− |
| |
− | </ADMIN_BLOCK>
| |
− | </p>
| |
− | </ENTRY_DAY_BLOCK>
| |
− | <hr />
| |
− | </div>
| |
− | </ENTRY_BLOCK></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><hr /></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><ENTRY_SUBJECT/></code> lub <code>&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><ENTRY_DATE/></code> lub <code>&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><ENTRY_HOUR/></code> lub <code>&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><ENTRY_ID/></code> lub <code>&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><h2 id="&ENTRY_ID;"><a href="#entrysubject"><ENTRY_SUBJECT/></a></h2></pre>
| |
− | Można także zrobić od razu odnośnik do danego wpisu, na wypadek, gdyby ktoś chciał podać doń URL:
| |
− | <pre><h2 id="&ENTRY_ID;"><a href="#&ENTRY_ID;"><a href="#entrysubject"><ENTRY_SUBJECT/></a></a></h2></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><ENTRY_LEVEL/></code> lub <code>&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><LEVELx></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><ENTRY_LEVEL></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><h2 class="poziom&ENTRY_LEVEL;" id="<a href="#entryid">&ENTRY_ID;</a>"><a href="#entrysubject"><ENTRY_SUBJECT/></a></h2></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><ENTRY_CONTENT></code> lub <code>&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><ENTRY_COMMENT_HREF></code> lub <code>&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><ENTRY_COMMENT_HREF_DESCR></code> lub <code>&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><a href="<a href="#entrycommenthref">&ENTRY_COMMENT_HREF;</a>">
| |
− | <ENTRY_COMMENT_HREF_DESCR/><span class="ukryj"> do wpisu <em><a href="#entrysubject"><ENTRY_SUBJECT/></a></em></span>
| |
− | </a></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><ENTRY_CLASS></code> lub <code>&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><ENTRY_CLASS_RESET></code> lub <code>&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><ARCHIVE_BLOCK> ... </ARCHIVE_BLOCK></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:
| |
− |
| |
− | <ul>
| |
− | <ARCHIVE_BLOCK>
| |
− | <li><a href="<a href="#archivehref">&ARCHIVE_HREF;</a>"><a href="#archivehrefdescr"><ARCHIVE_HREF_DESCR/></a></a></li>
| |
− | </ARCHIVE_BLOCK>
| |
− |
| |
− | </ul></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><ARCHIVE_HREF/></code> lub <code>&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><ARCHIVE_HREF_DESCR/></code> lub <code>&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><LINK_BLOCK> ... </LINK_BLOCK></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:
| |
− |
| |
− | <ul>
| |
− | <LINK_BLOCK>
| |
− | <li><a href="<a href="#linkhref">&LINK_HREF;</a>"><a href="#linkhrefdescr"><LINK_HREF_DESCR/></a></a></li>
| |
− | </LINK_BLOCK>
| |
− |
| |
− | </ul></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><LINK_HREF/></code> lub <code>&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><LINK_HREF_DESCR/></code> lub <code>&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><COMMENT_BLOCK>... </COMMENT_BLOCK></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><h2>Komentarze:</h2>
| |
− | <COMMENT_BLOCK>
| |
− | <div class="<a href="#commentclass">&COMMENT_CLASS;</a>">
| |
− | <p>
| |
− | <a href="#commentnick"><COMMENT_NICK/></a> | dnia <a href="#commentdate"><COMMENT_DATE/></a>, o godzinie <a href="#commenthour"><COMMENT_HOUR/></a>
| |
− |
| |
− | <ADMIN_BLOCK>
| |
− | <span>
| |
− | <a href="<a href="#admincommentremovehref">&ADMIN_COMMENT_REMOVE_HREF;</a>">Usuń</a>,
| |
− | <a href="<a href="#admincommentblockiphref">&ADMIN_COMMENT_BLOCKIP_HREF;</a>">Zablokuj IP</a>.
| |
− | </span>
| |
− |
| |
− | </ADMIN_BLOCK>
| |
− | </p>
| |
− | <a href="#commentcontent"><COMMENT_CONTENT/></a>
| |
− | </div>
| |
− | </COMMENT_BLOCK></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><COMMENT_CLASS/></code> lub <code>&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><COMMENT_NICK/></code> lub <code>&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><COMMENT_DATE/></code> lub <code>&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><COMMENT_HOUR/></code> lub <code>&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><COMMENT_CONTENT/></code> lub <code>&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><ADMIN_BLOCK> ... </ADMIN_BLOCK></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><ENTRY_BLOCKY>
| |
− | (...)
| |
− | <ADMIN_BLOCK>
| |
− | <span>
| |
− | <a href="<a href="#adminentrytedithref">&ADMIN_ENTRY_EDIT_HREF;</a>">Edytuj</a>,
| |
− | <a href="<a href="#adminentryremovehref">&ADMIN_ENTRY_REMOVE_HREF;</a>">Usuń</a>.
| |
− | </span>
| |
− |
| |
− | </ADMIN_BLOCK>
| |
− | (...)
| |
− | </ENTRY_BLOCKY></pre>
| |
− | w bloku <strong>COMMENT_BLOCK</strong>:
| |
− | <pre><COMMENT_BLOCK>
| |
− | (...)
| |
− | <ADMIN_BLOCK>
| |
− | <span>
| |
− |
| |
− | <a href="<a href="#admincommentremovehref">&ADMIN_COMMENT_REMOVE_HREF;</a>">Usuń</a>,
| |
− | <a href="<a href="#admincommentblockiphref">&ADMIN_COMMENT_BLOCKIP_HREF;</a>">Zablokuj IP</a>.
| |
− | </span>
| |
− | </ADMIN_BLOCK>
| |
− |
| |
− | (...)
| |
− | </COMMENT_BLOCK></pre>
| |
− | można też tak:
| |
− | <pre><ADMIN_BLOCK>
| |
− | <p>Tego akapitu nie zobaczy nikt poza mną.</p>
| |
− | </ADMIN_BLOCK></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><ADMIN_ENTRY_EDIT_HREF/></code> lub <code>&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><ADMIN_ENTRY_REMOVE_HREF/></code> lub <code>&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><ADMIN_COMMENT_REMOVE_HREF/></code> lub <code>&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><ADMIN_COMMENT_BLOCKIP_HREF/></code> lub <code>&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><NOUSER_BLOCK> ... </NOUSER_BLOCK></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
| |
− |
| |
− | <NOUSER_BLOCK>
| |
− | <p><a href="<a href="#userloginhref">&USER_LOG_IN_HREF;</a>">Zaloguj się</a>, by przeczytać inne wpisy.</p>
| |
− | </NOUSER_BLOCK>
| |
− | <a href="#loggeduserblock"><LOGGED_USER_BLOCK> ( ... ) </LOGGED_USER_BLOCK></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><USER_LOG_IN_HREF/></code> lub <code>&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:<br />
| |
− |
| |
− | <NOUSER_BLOCK>
| |
− | <form action="http://login.[Twoja_nazwa_domeny].jogger.pl/index.php" method="post" id="logowanie">
| |
− | <div><input type="hidden" name="op" value="loginuser" /></div>
| |
− | <div><span>Login:</span><input type="text" name="user" /></div>
| |
− |
| |
− | <div><span>Hasło:</span><input type="password" name="pass" /></div>
| |
− | <div><input type="submit" value="Zaloguj" id="guzik" /></div>
| |
− | </form>
| |
− | </NOUSER_BLOCK></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><LOGGED_USER_BLOCK> ... </LOGGED_USER_BLOCK></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"><NOUSER_BLOCK> ( ... ) </NOUSER_BLOCK></a>
| |
− | <LOGGED_USER_BLOCK>
| |
− | <p><a href="#loggedusername">
| |
− | <LOGGED_USER_NAME/></a>,
| |
− | <a href="<a href="#loggeduserlogouthref">&LOGGED_USER_LOG_OUT_HREF;</a>"><em>wyloguj się</em></a>, gdy będziesz wychodzić.
| |
− | </p>
| |
− |
| |
− | </LOGGED_USER_BLOCK></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><LOGGED_USER_NAME/></code> lub <code>&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><LOGGED_USER_LOG_OUT_HREF/></code> lub <code>&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><ul>
| |
− | <li>mój status: <strong><a href="#statustext"><STATUS_TEXT/></a></strong> <img src="<a href="#statusimage">&STATUS_IMAGE;</a>" alt="" />
| |
− | <li>mój opis: <em><a href="#statusdescr"><STATUS_DESCR/></a></em>
| |
− |
| |
− | </ul></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><STATUS_TEXT/></code> lub <code>&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><STATUS_IMAGE/></code> lub <code>&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">&CUSTOM_DIR;</a>/&STATUS_IMAGE;</code></del>. Wystarczy samo <code>&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><STATUS_DESCR/></code> lub <code>&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><STATUS_DESCR2/></code> lub <code>&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><JID/></code> lub <code>&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><acronym lang="en" xml:lang="en" title="Jabber Identyfier">JID</acronym>: <JID/></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><ALL_ENTRIES_HREF/></code> lub <code>&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><a href="&ALL_ENTRIES_HREF;" title="Powrót do reszty wpisów">Wróć</a></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><COMMENT_FORM/></code> lub <code>&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><h2>Dodaj swój komentarz:</h2>
| |
− |
| |
− | <COMMENT_FORM/></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><form action="/comment.php" method="post">
| |
− | <div><input type="hidden" name="jid" value="[jid_komentowanego]" />
| |
− | <input type="hidden" name="eid" value="[id_wpisu]" />
| |
− | <input type="hidden" name="startid" value="0" />
| |
− | <input type="hidden" name="op" value="addcomm" /></div>
| |
− |
| |
− | <table>
| |
− | <tr>
| |
− | <td>Podpis:</td>
| |
− | <td><input type="text" name="commnickid" <strong>id="commnickid"</strong> value="[Twój_jid]" /></td>
| |
− |
| |
− | </tr>
| |
− | <tr>
| |
− | <td>Treść:</td>
| |
− | <td><textarea name="commbody" <strong>id="commbody"</strong> cols="60" rows="6"></textarea></td>
| |
− |
| |
− | </tr>
| |
− | <tr>
| |
− | <td>&nbsp;</td>
| |
− | <td>
| |
− | <input type="checkbox" name="notifyentry" value="notify" />
| |
− |
| |
− | Śledź ten wątek i powiadom mnie o nowych komentarzach
| |
− | </td>
| |
− | </tr>
| |
− | <tr>
| |
− | <td>&nbsp;</td>
| |
− | <td><input type='submit' name="submit" <strong>id="submitcomm"</strong> value='Wyślij' /></td>
| |
− |
| |
− | </tr>
| |
− | </table>
| |
− | </form></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><CUSTOM_DIR/></code> lub <code>&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><a href="http://www.mozilla.org/products/firefox/" title="Get Firefox - Web Browsing Redefined">
| |
− | <img src="&CUSTOM_DIR;/getfirefox_small.png"
| |
− | width="110" height="32" border="0" alt="Get Firefox" />
| |
− |
| |
− | </a></pre>
| |
− | <pre><link rel="StyleSheet" href="&CUSTOM_DIR;/nazwa_pliku.css" type="text/css" title="Pierwszy" /></pre></dd><dt>uwagi</dt><dd>
| |
− | <ol>
| |
− | <li>Jeśli chcesz wstawić ikonkę dostępności za pomocą znacznika <code><STATUS_IMAGE/></code>, nie używaj już taga <code><CUSTOM_DIR/></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><CUSTOM_DIR/></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><CUSTOM_DIR/></code> będzie jak najbardziej właściwe (np. <code><div style="background-color: <CUSTOM_DIR/>/tlo.gif"> ... </div></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>
| |