Tekst źródłowy strony Własny szablon: Jak to działa

==Jak to działa?==
===Znaczniki===
W Joggerze większość znaczników wstawia się w specjalne bloki. Bloki mają dwa zadania:
# 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.
# 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 użytkownikó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.

Niektóre tagi funkcjonują zupełnie samodzielnie i mogą zostać użyte wszędzie. Zaliczają sie do nich przede wszystkim [[Tagi#status i opis Jabbera|tagi pokazujące status Jabbera, opis i ikonkę dostępności]] oraz [[Tagi#Inne|3 inne znaczniki]] ([[Tagi#JID|<code>&lt;JID/&gt;</code>]], [[Tagi#ALL_ENTRIES_HREF|<code>&lt;ALL_ENTRIES_HREF/&gt;</code>]] i [[Tagi#COMMENT_FORM|<code>&lt;COMMENT_FORM/&gt;</code>]]).

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ś atrybutu HTML, dzięki czemu uzyskamy <strong lang="en" xml:lang="en">well-formed XML</strong>. Np. <code>&lt;img src="[[#imagesdir|/files/obrazek.gif]]" alt=""/&gt;</code> lub <code>&lt;a href="[[Tagi#ARCHIVE_HREF|&amp;ARCHIVE_HREF;]]"&gt;
[[Tagi#ARCHIVE_HREF_DESCR|&lt;ARCHIVE_HREF_DESCR/&gt;]]&lt;/a&gt;</code>

* - Uwaga: ważne jest, by w zapisie <em>&lt;NAZWA_ZNACZNIKA/&gt;</em> przed znakiem "/" (slash) nie było spacji. Więcej: [http://bugger.jogger.pl/index.php?do=details&id=47 Bugger - zgłoszenie nr 47].

===Co zmienić w ustawieniach?===
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".

<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 DTD, <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="/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>/files/style.css</code> to CSS naszego szablonu. Musi być oddzielnym plikiem, bo przy uproszczonych schematach 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 [http://zapiski.marcoos.org/2003/11/08/jak-nadac-wlasny-tytul-blogowi-na-jogger.pl/ rozwiązał marcoos], 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:

# zalecane jest, by wstawić następujący znacznik meta: <code>&lt;meta name="robots" content="noindex, nofollow" /&gt;</code>. [http://www.wired.com/news/business/0,1367,58838,00.html Dlatego].
# ścieżka do wgranych do Joggera plików stylów CSS to <code>/files/nazwa_pliku.css</code>, co za tym idzie aby użyć arkusza styli należy wstawić: <pre>&lt;link rel="stylesheet" href="/files/nazwa_pliku.css" type="text/css" title="Podstawowy styl" /&gt;</pre>
</dd></dl>

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 administracyjnym można wybrać przy pozycji <em>Typ MIME</em> następujące opcje: (podaję za marcoosem)

* <em>text/html</em> - dobry dla HTML 4, dozwolony dla XHTML 1.0
* <em>application/xhtml+xml</em> - zalecany dla XHTML 1.0, wymagany dla XHTML 1.1, XHTML Basic i pewnie kiedyś XHTML2.0
* <strong class="no">NOWY!</strong> <em>application/xml</em> - więcej: [http://bugger.jogger.pl/index.php?do=details&id=57 Bugger - zgłoszenie nr 57] <strong  style="color: green;">(OK)</strong>.
* <em>negocjacja typu mime</em> - jeśli User Agent 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 MSIE, 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.

===Co trzeba przygotować?===
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 spiąć w oddzielnym pliku, a definicje potrzebne tylko np. do strony komentarzy umieścić już w samym szablonie. Należy tylko pamiętać o umieszczaniu bezwględnych ścieżek do plików (/files/blabla.png zamias files/blabla.png), gdyż strony wpisów, komentarzy itd są umieszczane w podkatalogach.

Pliki (do 1MB) można wgrać do Joggera poprzez panel administracyjny, Wszystkie umieszczone będą w katalogu /files/

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 [[#statusimage|<code>&lt;STATUS_IMAGE/&gt;</code>]]).

===Kilka wskazówek===
* Polecam [http://validator.w3.org/ walidator (X)HTML] i [http://jigsaw.w3.org/css-validator/ walidator CSS].
* 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>
* 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.
* Należy pamiętać o oczach czytelników.
* Jeśli robicie szablon w poprawnym XHTML, to i tak to zrobicie, ale na wszelki 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 [http://ppewww.ph.gla.ac.uk/%7Eflavell/alt/alt-text.html artykuł o atrybutach <strong>alt</strong>].
* 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ą [http://www.republika.pl/jablonka/przewodnik/ogonki.html Ogonk?w 97], albo zapisuj?c pliki w systemowym Notatniku z kodowaniem UTF-8. (brak polskich znaków celowy)

===Zmiany w nazwach znaczników===
By uprościć i ujednolicić nazewnictwo Joggerowych znaczników, zmienione zostały nazwy nastepujących tagów:
 ENTRIES_BLOCK --&gt; [[Tagi#ENTRY_BLOCK|ENTRY_BLOCK]]
 ENTRIES_DAY --&gt; [[Tagi#ENTRY_DAY_BLOCK|ENTRY_DAY_BLOCK]]
 COMMENT_HREF --&gt; [[Tagi#ENTRY_COMMENT_HREF|ENTRY_COMMENT_HREF]]

 COMMENT_HREF_DESCR --&gt; [[Tagi#ENTRY_COMMENT_HREF_DESCR|ENTRY_COMMENT_HREF_DESCR]]
 USER_LOGIN_HREF --&gt; [[Tagi#USER_LOG_IN_HREF|USER_LOG_IN_HREF]]
 USER_BLOCK --&gt; [[Tagi#LOGGED_USER_BLOCK|LOGGED_USER_BLOCK]]
 USER_LOGIN_NAME --&gt; [[Tagi#LOGGED_USER_NAME|LOGGED_USER_NAME]]
 USER_LOGOUT_HREF --&gt; [[Tagi#LOGGED_USER_LOG_OUT_HREF|LOGGED_USER_LOG_OUT_HREF]]

 PUT_JID --&gt; [[Tagi#JID|JID]]
 IMAGES_DIR --&gt; [[#customdir|CUSTOM_DIR]]

* [[Tagi|Tagi]]

[[Kategoria:Pomoc]]