2010年2月15日 星期一

開發一個簡易的Joomla 1.5 佈景主題樣版-1

[Creating a basic Joomla! 1.5 template][計畫]-[手冊]

Joomla 1.5, joomla 教學, joomla 佈景主題

開發一個簡易joomla 1.5 佈景主題樣板-1

前言
我想這是想要嘗試開發的各位,最想看到的一篇了,為了使不熟悉CSS與PHP的讀者也能夠輕鬆無負擔的進入Joomla 1.5 佈景主題開發的世界,The Cave特別製作了這系列適合初學者學習的文章,讀者甚至可以直接就從這裡開始學習。不過小弟還是要說明一下,前面幾篇翻譯的文件不是說不重要,反而是一切的基礎,由其是"典型的樣板架構"這篇,更是不可不先看仔細。好了,說到這裡,就讓我們打開文字編輯器Step by Step逐步完成自己的第一個Joomla佈景主題吧

note:再次強調,此文件僅適用於Joomla1.5之後的版本。很不幸的Joomla!1.6之後的版本在使用XML檔案來定義相關參數的部分有了較大改變,所以以下所介紹的templateDetails.xml檔案只適用於1.5的版本喔。

小試身手
以下,我們開始介紹一個Joomla1.5.x佈景主題樣板該有的基本要素,跟著這一系列文章動手做下去,讀者將會有基本的認識,也就是知道哪些東西是必須要有的,而哪些東西是可以做變化的。

首先,請各位先準備好在"典型的樣板架構"這篇文章中所提到的基本檔案,內容空白沒有關係,畢竟我們本來就是要從零開始。接下來,請使用文字編輯器打開[templateDetails.xml檔]並輸入以下內容:

note:有關templateDetails.xml檔案的簡介可參考這裡

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//EN" "http://dev.joomla.org/xml/1.5/template-install.dtd">
<install version="1.5" type="template">
<name>joomla 1.5 佈景主題 template 教學</name>
<creationDate>2010-03-23</creationDate>
<author>我的大名</author>
<authorEmail>我的E-mail</authorEmail>
<authorUrl>我的網站</authorUrl>
<copyright>版權宣告</copyright>
<license>GNU/GPL</license>
<version>1.0.0</version>
<description>這是我的第一個joomla 1.5 佈景主題</description>
<files>
  <filename>index.php</filename>
  <filename>component.php</filename>
  <filename>templateDetails.xml</filename>
  <filename>template_thumbnail.png</filename>
  <filename>css/style.css</filename>
</files>
<positions>
  <position>header</position>
  <position>TopMenu</position>
  <position>footer</position>
</positions>


</install>

這個檔案存在的目的是為了定義整個joomla 佈景主題之所有資訊,各位可以看到,上方區塊中,粉紅色字是宣告此本文件所依循的XML版本,以及編碼方式(UTF-8)。藍色字則是指定了規範此檔案的dtd路徑,紅色install標籤中的子標籤則是整個佈景主題樣板所有的資訊,包含了佈景名稱、創建日期、作者資訊、版權宣告、版本以及簡單的佈景描述等等。

note:注意此文件存檔的時候要以UTF-8編碼,副檔名則是xml喔。

<filename></filename>標籤中放的是我們這個佈景主題所用到的檔案,只要是此joomla 佈景主題中有的都要在這個區塊中定義好,這樣子才會有效。

note:特別提醒,filename標籤一定要在files父標籤中。

<position></position>標籤中描述的則是模組可以放置的位子,在這裡我們先定義三個位置header、TopMenu以及footer。至於這三個位置在版面上如何安排,請各位繼續看下去,但是一定要先定義好。

note:特別提醒,position子標籤要再父標籤positions之中。

輸入完以上的joomla 佈景主題樣板資訊以及模組位置、檔案等等的配置後,下一篇我們要來編輯index.php檔,這可是整個佈景主題樣板的重要檔案,整個佈景主題的版面設計就靠他了。

[下一篇]

2 則留言: