Joomla! Documentation - User contributions [en]

Nginx/zh-tw

2016-06-15T02:34:13Z

Lai32290: Created page with "對於 Gentoo 的使用者，PHP 需要執行 FastCGI 的服務 (fpm)，所以 nginx 的服務將會分開執行 PHP："

<noinclude><languages /></noinclude>
[http://nginx.net/ nginx] is a lightweight Web server that powers about 13% of Web servers across all domains[http://en.wikipedia.org/wiki/Nginx#Description]. Unless you have specific requirements that demand a heavy Web server like Apache, you are much better off using nginx.

以下介紹如何在 [http://wiki.nginx.org/PHPFcgiExample nginx 和 PHP FastCGI] 中使用 Joomla!

== 安裝 nginx ==
對於Ubuntu 的使用者，執行 <tt>aptitude install nginx</tt>。對於其他的Linux版本，請使用各自的套件管理器(Package Manager)，或者請看 http://wiki.nginx.org/Install。

== 安裝 PHP FastCGI ==
對於 Ubuntu 的使用者，請看這篇非常詳細的如何 [http://wiki.nginx.org/PHPFcgiExample 設定 PHP 以及 FastCGI 給 nginx] 的教學。

對於 Gentoo 的使用者，PHP 需要執行 FastCGI 的服務 (fpm)，所以 nginx 的服務將會分開執行 PHP：
<pre>
# echo "dev-lang/php gd gd2 curl simplexml tokenizer dom tidy sqlite xml fpm cgi" >> /etc/portage/package.use
# emerge php
</pre>
The default settings of php-fpm are good for most servers. For special configurations, visit the [http://php.net/manual/en/install.fpm.php PHP FPM site].

== Configure Nginx ==
nginx configuration files reside in:
* <tt>/etc/nginx/sites-available/</tt> on Ubuntu (for sites running on that nginx instance)
* <tt>/etc/nginx/nginx.conf</tt> on Gentoo and Raspbian(= Debian optimized for Raspberry Pi)

Here is an sample nginx configuration file, joomla.conf, that you can reuse over all your nginx enabled-sites.

<pre>
server {
listen 80;
server_name YOUR_DOMAIN;
server_name_in_redirect off;

access_log /var/log/nginx/localhost.access_log;
error_log /var/log/nginx/localhost.error_log info;

root PATH_ON_SERVER;
index index.php index.html index.htm default.html default.htm;
# Support Clean (aka Search Engine Friendly) URLs
location / {
try_files $uri $uri/ /index.php?$args;
}

# deny running scripts inside writable directories
location ~* /(images|cache|media|logs|tmp)/.*\.(php|pl|py|jsp|asp|sh|cgi)$ {
return 403;
error_page 403 /403_error.html;
}

location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include /etc/nginx/fastcgi.conf;
}

# caching of files
location ~* \.(ico|pdf|flv)$ {
expires 1y;
}

location ~* \.(js|css|png|jpg|jpeg|gif|swf|xml|txt)$ {
expires 14d;
}

}
</pre>

Pay attention to a few things:
# The parameter <tt>fastcgi_pass</tt> is set to 127.0.0.1:9000, corresponding to the port that fpm is configured to listen to. This means you can run the PHP processes on separate servers. On Gentoo, you can find this configuration in <tt>/etc/php/fpm-php5.3/php-fpm.conf/</tt>
# Don't forget to replace YOUR_DOMAIN & PATH_ON_SERVER above depending on your domain and the path of Joomla on your server.

== GZip support ==
If you need GZip compression support, add the following section to the http section of the main nginx configuration file:
<pre>
gzip on;
gzip_http_version 1.1;
gzip_comp_level 6;
gzip_min_length 1100;
gzip_buffers 4 8k;
gzip_types text/plain application/xhtml+xml text/css application/xml application/xml+rss text/javascript application/javascript application/x-javascript
gzip_proxied any;
gzip_disable "MSIE [1-6]\.";
</pre>

== Sources ==
* [http://en.gentoo-wiki.com/wiki/Nginx Nginx in Gentoo]
* [http://www.kevinworthington.com/nginx-for-windows/ Nginx for Windows]
* [http://wiki.nginx.org/Install#Ubuntu_PPA Nginx in Ubuntu]
* [http://www.debianadmin.com/howto-install-nginx-webserver-in-debian.html Nginx in Debian]
* [http://php.net/manual/en/install.fpm.php PHP-FPM installation and configuration]
* [http://wiki.nginx.org/HttpGzipModule GZip in Nginx]
* [http://wiki.nginx.org/HttpRewriteModule Rewrite in Nginx]
* [http://nginx.org/en/docs/http/request_processing.html How nginx processes a request]

Translations:Nginx/7/zh-tw

2016-06-15T02:34:13Z

Lai32290: Created page with "對於 Gentoo 的使用者，PHP 需要執行 FastCGI 的服務 (fpm)，所以 nginx 的服務將會分開執行 PHP："

對於 Gentoo 的使用者，PHP 需要執行 FastCGI 的服務 (fpm)，所以 nginx 的服務將會分開執行 PHP：

Nginx/zh-tw

2016-06-15T02:32:24Z

Lai32290:

<noinclude><languages /></noinclude>
[http://nginx.net/ nginx] is a lightweight Web server that powers about 13% of Web servers across all domains[http://en.wikipedia.org/wiki/Nginx#Description]. Unless you have specific requirements that demand a heavy Web server like Apache, you are much better off using nginx.

以下介紹如何在 [http://wiki.nginx.org/PHPFcgiExample nginx 和 PHP FastCGI] 中使用 Joomla!

== 安裝 nginx ==
對於Ubuntu 的使用者，執行 <tt>aptitude install nginx</tt>。對於其他的Linux版本，請使用各自的套件管理器(Package Manager)，或者請看 http://wiki.nginx.org/Install。

== 安裝 PHP FastCGI ==
對於 Ubuntu 的使用者，請看這篇非常詳細的如何 [http://wiki.nginx.org/PHPFcgiExample 設定 PHP 以及 FastCGI 給 nginx] 的教學。

For Gentoo, PHP will run as a FastCGI service (fpm), so the nginx server will run PHP as a separated process:
<pre>
# echo "dev-lang/php gd gd2 curl simplexml tokenizer dom tidy sqlite xml fpm cgi" >> /etc/portage/package.use
# emerge php
</pre>
The default settings of php-fpm are good for most servers. For special configurations, visit the [http://php.net/manual/en/install.fpm.php PHP FPM site].

== Configure Nginx ==
nginx configuration files reside in:
* <tt>/etc/nginx/sites-available/</tt> on Ubuntu (for sites running on that nginx instance)
* <tt>/etc/nginx/nginx.conf</tt> on Gentoo and Raspbian(= Debian optimized for Raspberry Pi)

Here is an sample nginx configuration file, joomla.conf, that you can reuse over all your nginx enabled-sites.

<pre>
server {
listen 80;
server_name YOUR_DOMAIN;
server_name_in_redirect off;

access_log /var/log/nginx/localhost.access_log;
error_log /var/log/nginx/localhost.error_log info;

root PATH_ON_SERVER;
index index.php index.html index.htm default.html default.htm;
# Support Clean (aka Search Engine Friendly) URLs
location / {
try_files $uri $uri/ /index.php?$args;
}

# deny running scripts inside writable directories
location ~* /(images|cache|media|logs|tmp)/.*\.(php|pl|py|jsp|asp|sh|cgi)$ {
return 403;
error_page 403 /403_error.html;
}

location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include /etc/nginx/fastcgi.conf;
}

# caching of files
location ~* \.(ico|pdf|flv)$ {
expires 1y;
}

location ~* \.(js|css|png|jpg|jpeg|gif|swf|xml|txt)$ {
expires 14d;
}

}
</pre>

Pay attention to a few things:
# The parameter <tt>fastcgi_pass</tt> is set to 127.0.0.1:9000, corresponding to the port that fpm is configured to listen to. This means you can run the PHP processes on separate servers. On Gentoo, you can find this configuration in <tt>/etc/php/fpm-php5.3/php-fpm.conf/</tt>
# Don't forget to replace YOUR_DOMAIN & PATH_ON_SERVER above depending on your domain and the path of Joomla on your server.

== GZip support ==
If you need GZip compression support, add the following section to the http section of the main nginx configuration file:
<pre>
gzip on;
gzip_http_version 1.1;
gzip_comp_level 6;
gzip_min_length 1100;
gzip_buffers 4 8k;
gzip_types text/plain application/xhtml+xml text/css application/xml application/xml+rss text/javascript application/javascript application/x-javascript
gzip_proxied any;
gzip_disable "MSIE [1-6]\.";
</pre>

== Sources ==
* [http://en.gentoo-wiki.com/wiki/Nginx Nginx in Gentoo]
* [http://www.kevinworthington.com/nginx-for-windows/ Nginx for Windows]
* [http://wiki.nginx.org/Install#Ubuntu_PPA Nginx in Ubuntu]
* [http://www.debianadmin.com/howto-install-nginx-webserver-in-debian.html Nginx in Debian]
* [http://php.net/manual/en/install.fpm.php PHP-FPM installation and configuration]
* [http://wiki.nginx.org/HttpGzipModule GZip in Nginx]
* [http://wiki.nginx.org/HttpRewriteModule Rewrite in Nginx]
* [http://nginx.org/en/docs/http/request_processing.html How nginx processes a request]

Translations:Nginx/6/zh-tw

2016-06-15T02:32:24Z

Lai32290:

對於 Ubuntu 的使用者，請看這篇非常詳細的如何 [http://wiki.nginx.org/PHPFcgiExample 設定 PHP 以及 FastCGI 給 nginx] 的教學。

Nginx/zh-tw

2016-06-15T02:32:08Z

Lai32290: Created page with "對於 Ubuntu 的使用者，請看這篇非常好的如何 [http://wiki.nginx.org/PHPFcgiExample 設定 PHP 以及 FastCGI 給 nginx] 的教學。"

<noinclude><languages /></noinclude>
[http://nginx.net/ nginx] is a lightweight Web server that powers about 13% of Web servers across all domains[http://en.wikipedia.org/wiki/Nginx#Description]. Unless you have specific requirements that demand a heavy Web server like Apache, you are much better off using nginx.

以下介紹如何在 [http://wiki.nginx.org/PHPFcgiExample nginx 和 PHP FastCGI] 中使用 Joomla!

== 安裝 nginx ==
對於Ubuntu 的使用者，執行 <tt>aptitude install nginx</tt>。對於其他的Linux版本，請使用各自的套件管理器(Package Manager)，或者請看 http://wiki.nginx.org/Install。

== 安裝 PHP FastCGI ==
對於 Ubuntu 的使用者，請看這篇非常好的如何 [http://wiki.nginx.org/PHPFcgiExample 設定 PHP 以及 FastCGI 給 nginx] 的教學。

For Gentoo, PHP will run as a FastCGI service (fpm), so the nginx server will run PHP as a separated process:
<pre>
# echo "dev-lang/php gd gd2 curl simplexml tokenizer dom tidy sqlite xml fpm cgi" >> /etc/portage/package.use
# emerge php
</pre>
The default settings of php-fpm are good for most servers. For special configurations, visit the [http://php.net/manual/en/install.fpm.php PHP FPM site].

== Configure Nginx ==
nginx configuration files reside in:
* <tt>/etc/nginx/sites-available/</tt> on Ubuntu (for sites running on that nginx instance)
* <tt>/etc/nginx/nginx.conf</tt> on Gentoo and Raspbian(= Debian optimized for Raspberry Pi)

Here is an sample nginx configuration file, joomla.conf, that you can reuse over all your nginx enabled-sites.

<pre>
server {
listen 80;
server_name YOUR_DOMAIN;
server_name_in_redirect off;

access_log /var/log/nginx/localhost.access_log;
error_log /var/log/nginx/localhost.error_log info;

root PATH_ON_SERVER;
index index.php index.html index.htm default.html default.htm;
# Support Clean (aka Search Engine Friendly) URLs
location / {
try_files $uri $uri/ /index.php?$args;
}

# deny running scripts inside writable directories
location ~* /(images|cache|media|logs|tmp)/.*\.(php|pl|py|jsp|asp|sh|cgi)$ {
return 403;
error_page 403 /403_error.html;
}

location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include /etc/nginx/fastcgi.conf;
}

# caching of files
location ~* \.(ico|pdf|flv)$ {
expires 1y;
}

location ~* \.(js|css|png|jpg|jpeg|gif|swf|xml|txt)$ {
expires 14d;
}

}
</pre>

Pay attention to a few things:
# The parameter <tt>fastcgi_pass</tt> is set to 127.0.0.1:9000, corresponding to the port that fpm is configured to listen to. This means you can run the PHP processes on separate servers. On Gentoo, you can find this configuration in <tt>/etc/php/fpm-php5.3/php-fpm.conf/</tt>
# Don't forget to replace YOUR_DOMAIN & PATH_ON_SERVER above depending on your domain and the path of Joomla on your server.

== GZip support ==
If you need GZip compression support, add the following section to the http section of the main nginx configuration file:
<pre>
gzip on;
gzip_http_version 1.1;
gzip_comp_level 6;
gzip_min_length 1100;
gzip_buffers 4 8k;
gzip_types text/plain application/xhtml+xml text/css application/xml application/xml+rss text/javascript application/javascript application/x-javascript
gzip_proxied any;
gzip_disable "MSIE [1-6]\.";
</pre>

== Sources ==
* [http://en.gentoo-wiki.com/wiki/Nginx Nginx in Gentoo]
* [http://www.kevinworthington.com/nginx-for-windows/ Nginx for Windows]
* [http://wiki.nginx.org/Install#Ubuntu_PPA Nginx in Ubuntu]
* [http://www.debianadmin.com/howto-install-nginx-webserver-in-debian.html Nginx in Debian]
* [http://php.net/manual/en/install.fpm.php PHP-FPM installation and configuration]
* [http://wiki.nginx.org/HttpGzipModule GZip in Nginx]
* [http://wiki.nginx.org/HttpRewriteModule Rewrite in Nginx]
* [http://nginx.org/en/docs/http/request_processing.html How nginx processes a request]

Translations:Nginx/6/zh-tw

2016-06-15T02:32:07Z

Lai32290: Created page with "對於 Ubuntu 的使用者，請看這篇非常好的如何 [http://wiki.nginx.org/PHPFcgiExample 設定 PHP 以及 FastCGI 給 nginx] 的教學。"

對於 Ubuntu 的使用者，請看這篇非常好的如何 [http://wiki.nginx.org/PHPFcgiExample 設定 PHP 以及 FastCGI 給 nginx] 的教學。

Nginx/zh-tw

2016-06-15T02:28:43Z

Lai32290:

<noinclude><languages /></noinclude>
[http://nginx.net/ nginx] is a lightweight Web server that powers about 13% of Web servers across all domains[http://en.wikipedia.org/wiki/Nginx#Description]. Unless you have specific requirements that demand a heavy Web server like Apache, you are much better off using nginx.

以下介紹如何在 [http://wiki.nginx.org/PHPFcgiExample nginx 和 PHP FastCGI] 中使用 Joomla!

== 安裝 nginx ==
對於Ubuntu 的使用者，執行 <tt>aptitude install nginx</tt>。對於其他的Linux版本，請使用各自的套件管理器(Package Manager)，或者請看 http://wiki.nginx.org/Install。

== 安裝 PHP FastCGI ==
For Ubuntu, read this excellent page on how to [http://wiki.nginx.org/PHPFcgiExample configure PHP and FastCGI for nginx].

For Gentoo, PHP will run as a FastCGI service (fpm), so the nginx server will run PHP as a separated process:
<pre>
# echo "dev-lang/php gd gd2 curl simplexml tokenizer dom tidy sqlite xml fpm cgi" >> /etc/portage/package.use
# emerge php
</pre>
The default settings of php-fpm are good for most servers. For special configurations, visit the [http://php.net/manual/en/install.fpm.php PHP FPM site].

== Configure Nginx ==
nginx configuration files reside in:
* <tt>/etc/nginx/sites-available/</tt> on Ubuntu (for sites running on that nginx instance)
* <tt>/etc/nginx/nginx.conf</tt> on Gentoo and Raspbian(= Debian optimized for Raspberry Pi)

Here is an sample nginx configuration file, joomla.conf, that you can reuse over all your nginx enabled-sites.

<pre>
server {
listen 80;
server_name YOUR_DOMAIN;
server_name_in_redirect off;

access_log /var/log/nginx/localhost.access_log;
error_log /var/log/nginx/localhost.error_log info;

root PATH_ON_SERVER;
index index.php index.html index.htm default.html default.htm;
# Support Clean (aka Search Engine Friendly) URLs
location / {
try_files $uri $uri/ /index.php?$args;
}

# deny running scripts inside writable directories
location ~* /(images|cache|media|logs|tmp)/.*\.(php|pl|py|jsp|asp|sh|cgi)$ {
return 403;
error_page 403 /403_error.html;
}

location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include /etc/nginx/fastcgi.conf;
}

# caching of files
location ~* \.(ico|pdf|flv)$ {
expires 1y;
}

location ~* \.(js|css|png|jpg|jpeg|gif|swf|xml|txt)$ {
expires 14d;
}

}
</pre>

Pay attention to a few things:
# The parameter <tt>fastcgi_pass</tt> is set to 127.0.0.1:9000, corresponding to the port that fpm is configured to listen to. This means you can run the PHP processes on separate servers. On Gentoo, you can find this configuration in <tt>/etc/php/fpm-php5.3/php-fpm.conf/</tt>
# Don't forget to replace YOUR_DOMAIN & PATH_ON_SERVER above depending on your domain and the path of Joomla on your server.

== GZip support ==
If you need GZip compression support, add the following section to the http section of the main nginx configuration file:
<pre>
gzip on;
gzip_http_version 1.1;
gzip_comp_level 6;
gzip_min_length 1100;
gzip_buffers 4 8k;
gzip_types text/plain application/xhtml+xml text/css application/xml application/xml+rss text/javascript application/javascript application/x-javascript
gzip_proxied any;
gzip_disable "MSIE [1-6]\.";
</pre>

== Sources ==
* [http://en.gentoo-wiki.com/wiki/Nginx Nginx in Gentoo]
* [http://www.kevinworthington.com/nginx-for-windows/ Nginx for Windows]
* [http://wiki.nginx.org/Install#Ubuntu_PPA Nginx in Ubuntu]
* [http://www.debianadmin.com/howto-install-nginx-webserver-in-debian.html Nginx in Debian]
* [http://php.net/manual/en/install.fpm.php PHP-FPM installation and configuration]
* [http://wiki.nginx.org/HttpGzipModule GZip in Nginx]
* [http://wiki.nginx.org/HttpRewriteModule Rewrite in Nginx]
* [http://nginx.org/en/docs/http/request_processing.html How nginx processes a request]

Translations:Nginx/2/zh-tw

2016-06-15T02:28:43Z

Lai32290:

以下介紹如何在 [http://wiki.nginx.org/PHPFcgiExample nginx 和 PHP FastCGI] 中使用 Joomla!

Nginx/zh-tw

2016-06-15T02:28:22Z

Lai32290: Created page with "== 安裝 PHP FastCGI =="

<noinclude><languages /></noinclude>
[http://nginx.net/ nginx] is a lightweight Web server that powers about 13% of Web servers across all domains[http://en.wikipedia.org/wiki/Nginx#Description]. Unless you have specific requirements that demand a heavy Web server like Apache, you are much better off using nginx.

以下介紹如何在 [http://wiki.nginx.org/PHPFcgiExample nginx 和 FastCGI 的 PHP ] 中使用 Joomla!

== 安裝 nginx ==
對於Ubuntu 的使用者，執行 <tt>aptitude install nginx</tt>。對於其他的Linux版本，請使用各自的套件管理器(Package Manager)，或者請看 http://wiki.nginx.org/Install。

== 安裝 PHP FastCGI ==
For Ubuntu, read this excellent page on how to [http://wiki.nginx.org/PHPFcgiExample configure PHP and FastCGI for nginx].

For Gentoo, PHP will run as a FastCGI service (fpm), so the nginx server will run PHP as a separated process:
<pre>
# echo "dev-lang/php gd gd2 curl simplexml tokenizer dom tidy sqlite xml fpm cgi" >> /etc/portage/package.use
# emerge php
</pre>
The default settings of php-fpm are good for most servers. For special configurations, visit the [http://php.net/manual/en/install.fpm.php PHP FPM site].

== Configure Nginx ==
nginx configuration files reside in:
* <tt>/etc/nginx/sites-available/</tt> on Ubuntu (for sites running on that nginx instance)
* <tt>/etc/nginx/nginx.conf</tt> on Gentoo and Raspbian(= Debian optimized for Raspberry Pi)

Here is an sample nginx configuration file, joomla.conf, that you can reuse over all your nginx enabled-sites.

<pre>
server {
listen 80;
server_name YOUR_DOMAIN;
server_name_in_redirect off;

access_log /var/log/nginx/localhost.access_log;
error_log /var/log/nginx/localhost.error_log info;

root PATH_ON_SERVER;
index index.php index.html index.htm default.html default.htm;
# Support Clean (aka Search Engine Friendly) URLs
location / {
try_files $uri $uri/ /index.php?$args;
}

# deny running scripts inside writable directories
location ~* /(images|cache|media|logs|tmp)/.*\.(php|pl|py|jsp|asp|sh|cgi)$ {
return 403;
error_page 403 /403_error.html;
}

location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include /etc/nginx/fastcgi.conf;
}

# caching of files
location ~* \.(ico|pdf|flv)$ {
expires 1y;
}

location ~* \.(js|css|png|jpg|jpeg|gif|swf|xml|txt)$ {
expires 14d;
}

}
</pre>

Pay attention to a few things:
# The parameter <tt>fastcgi_pass</tt> is set to 127.0.0.1:9000, corresponding to the port that fpm is configured to listen to. This means you can run the PHP processes on separate servers. On Gentoo, you can find this configuration in <tt>/etc/php/fpm-php5.3/php-fpm.conf/</tt>
# Don't forget to replace YOUR_DOMAIN & PATH_ON_SERVER above depending on your domain and the path of Joomla on your server.

== GZip support ==
If you need GZip compression support, add the following section to the http section of the main nginx configuration file:
<pre>
gzip on;
gzip_http_version 1.1;
gzip_comp_level 6;
gzip_min_length 1100;
gzip_buffers 4 8k;
gzip_types text/plain application/xhtml+xml text/css application/xml application/xml+rss text/javascript application/javascript application/x-javascript
gzip_proxied any;
gzip_disable "MSIE [1-6]\.";
</pre>

== Sources ==
* [http://en.gentoo-wiki.com/wiki/Nginx Nginx in Gentoo]
* [http://www.kevinworthington.com/nginx-for-windows/ Nginx for Windows]
* [http://wiki.nginx.org/Install#Ubuntu_PPA Nginx in Ubuntu]
* [http://www.debianadmin.com/howto-install-nginx-webserver-in-debian.html Nginx in Debian]
* [http://php.net/manual/en/install.fpm.php PHP-FPM installation and configuration]
* [http://wiki.nginx.org/HttpGzipModule GZip in Nginx]
* [http://wiki.nginx.org/HttpRewriteModule Rewrite in Nginx]
* [http://nginx.org/en/docs/http/request_processing.html How nginx processes a request]

Translations:Nginx/5/zh-tw

2016-06-15T02:28:22Z

Lai32290: Created page with "== 安裝 PHP FastCGI =="

== 安裝 PHP FastCGI ==

Nginx/zh-tw

2016-06-15T02:28:04Z

Lai32290: Created page with "對於Ubuntu 的使用者，執行 <tt>aptitude install nginx</tt>。對於其他的Linux版本，請使用各自的套件管理器(Package Manager)，或者請看 http://wiki..."

<noinclude><languages /></noinclude>
[http://nginx.net/ nginx] is a lightweight Web server that powers about 13% of Web servers across all domains[http://en.wikipedia.org/wiki/Nginx#Description]. Unless you have specific requirements that demand a heavy Web server like Apache, you are much better off using nginx.

以下介紹如何在 [http://wiki.nginx.org/PHPFcgiExample nginx 和 FastCGI 的 PHP ] 中使用 Joomla!

== 安裝 nginx ==
對於Ubuntu 的使用者，執行 <tt>aptitude install nginx</tt>。對於其他的Linux版本，請使用各自的套件管理器(Package Manager)，或者請看 http://wiki.nginx.org/Install。

== Install PHP FastCGI ==
For Ubuntu, read this excellent page on how to [http://wiki.nginx.org/PHPFcgiExample configure PHP and FastCGI for nginx].

For Gentoo, PHP will run as a FastCGI service (fpm), so the nginx server will run PHP as a separated process:
<pre>
# echo "dev-lang/php gd gd2 curl simplexml tokenizer dom tidy sqlite xml fpm cgi" >> /etc/portage/package.use
# emerge php
</pre>
The default settings of php-fpm are good for most servers. For special configurations, visit the [http://php.net/manual/en/install.fpm.php PHP FPM site].

== Configure Nginx ==
nginx configuration files reside in:
* <tt>/etc/nginx/sites-available/</tt> on Ubuntu (for sites running on that nginx instance)
* <tt>/etc/nginx/nginx.conf</tt> on Gentoo and Raspbian(= Debian optimized for Raspberry Pi)

Here is an sample nginx configuration file, joomla.conf, that you can reuse over all your nginx enabled-sites.

<pre>
server {
listen 80;
server_name YOUR_DOMAIN;
server_name_in_redirect off;

access_log /var/log/nginx/localhost.access_log;
error_log /var/log/nginx/localhost.error_log info;

root PATH_ON_SERVER;
index index.php index.html index.htm default.html default.htm;
# Support Clean (aka Search Engine Friendly) URLs
location / {
try_files $uri $uri/ /index.php?$args;
}

# deny running scripts inside writable directories
location ~* /(images|cache|media|logs|tmp)/.*\.(php|pl|py|jsp|asp|sh|cgi)$ {
return 403;
error_page 403 /403_error.html;
}

location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include /etc/nginx/fastcgi.conf;
}

# caching of files
location ~* \.(ico|pdf|flv)$ {
expires 1y;
}

location ~* \.(js|css|png|jpg|jpeg|gif|swf|xml|txt)$ {
expires 14d;
}

}
</pre>

Pay attention to a few things:
# The parameter <tt>fastcgi_pass</tt> is set to 127.0.0.1:9000, corresponding to the port that fpm is configured to listen to. This means you can run the PHP processes on separate servers. On Gentoo, you can find this configuration in <tt>/etc/php/fpm-php5.3/php-fpm.conf/</tt>
# Don't forget to replace YOUR_DOMAIN & PATH_ON_SERVER above depending on your domain and the path of Joomla on your server.

== GZip support ==
If you need GZip compression support, add the following section to the http section of the main nginx configuration file:
<pre>
gzip on;
gzip_http_version 1.1;
gzip_comp_level 6;
gzip_min_length 1100;
gzip_buffers 4 8k;
gzip_types text/plain application/xhtml+xml text/css application/xml application/xml+rss text/javascript application/javascript application/x-javascript
gzip_proxied any;
gzip_disable "MSIE [1-6]\.";
</pre>

== Sources ==
* [http://en.gentoo-wiki.com/wiki/Nginx Nginx in Gentoo]
* [http://www.kevinworthington.com/nginx-for-windows/ Nginx for Windows]
* [http://wiki.nginx.org/Install#Ubuntu_PPA Nginx in Ubuntu]
* [http://www.debianadmin.com/howto-install-nginx-webserver-in-debian.html Nginx in Debian]
* [http://php.net/manual/en/install.fpm.php PHP-FPM installation and configuration]
* [http://wiki.nginx.org/HttpGzipModule GZip in Nginx]
* [http://wiki.nginx.org/HttpRewriteModule Rewrite in Nginx]
* [http://nginx.org/en/docs/http/request_processing.html How nginx processes a request]

Translations:Nginx/4/zh-tw

2016-06-15T02:28:03Z

對於Ubuntu 的使用者，執行 <tt>aptitude install nginx</tt>。對於其他的Linux版本，請使用各自的套件管理器(Package Manager)，或者請看 http://wiki.nginx.org/Install。

Nginx/zh-tw

2016-06-15T02:25:02Z

Lai32290: Created page with "== 安裝 nginx =="

<noinclude><languages /></noinclude>
[http://nginx.net/ nginx] is a lightweight Web server that powers about 13% of Web servers across all domains[http://en.wikipedia.org/wiki/Nginx#Description]. Unless you have specific requirements that demand a heavy Web server like Apache, you are much better off using nginx.

以下介紹如何在 [http://wiki.nginx.org/PHPFcgiExample nginx 和 FastCGI 的 PHP ] 中使用 Joomla!

== 安裝 nginx ==
For Ubuntu, run <tt>aptitude install nginx</tt>. For other distros, run the corresponding package manager, or see http://wiki.nginx.org/Install.

== Install PHP FastCGI ==
For Ubuntu, read this excellent page on how to [http://wiki.nginx.org/PHPFcgiExample configure PHP and FastCGI for nginx].

For Gentoo, PHP will run as a FastCGI service (fpm), so the nginx server will run PHP as a separated process:
<pre>
# echo "dev-lang/php gd gd2 curl simplexml tokenizer dom tidy sqlite xml fpm cgi" >> /etc/portage/package.use
# emerge php
</pre>
The default settings of php-fpm are good for most servers. For special configurations, visit the [http://php.net/manual/en/install.fpm.php PHP FPM site].

== Configure Nginx ==
nginx configuration files reside in:
* <tt>/etc/nginx/sites-available/</tt> on Ubuntu (for sites running on that nginx instance)
* <tt>/etc/nginx/nginx.conf</tt> on Gentoo and Raspbian(= Debian optimized for Raspberry Pi)

Here is an sample nginx configuration file, joomla.conf, that you can reuse over all your nginx enabled-sites.

<pre>
server {
listen 80;
server_name YOUR_DOMAIN;
server_name_in_redirect off;

access_log /var/log/nginx/localhost.access_log;
error_log /var/log/nginx/localhost.error_log info;

root PATH_ON_SERVER;
index index.php index.html index.htm default.html default.htm;
# Support Clean (aka Search Engine Friendly) URLs
location / {
try_files $uri $uri/ /index.php?$args;
}

# deny running scripts inside writable directories
location ~* /(images|cache|media|logs|tmp)/.*\.(php|pl|py|jsp|asp|sh|cgi)$ {
return 403;
error_page 403 /403_error.html;
}

location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include /etc/nginx/fastcgi.conf;
}

# caching of files
location ~* \.(ico|pdf|flv)$ {
expires 1y;
}

location ~* \.(js|css|png|jpg|jpeg|gif|swf|xml|txt)$ {
expires 14d;
}

}
</pre>

Pay attention to a few things:
# The parameter <tt>fastcgi_pass</tt> is set to 127.0.0.1:9000, corresponding to the port that fpm is configured to listen to. This means you can run the PHP processes on separate servers. On Gentoo, you can find this configuration in <tt>/etc/php/fpm-php5.3/php-fpm.conf/</tt>
# Don't forget to replace YOUR_DOMAIN & PATH_ON_SERVER above depending on your domain and the path of Joomla on your server.

== GZip support ==
If you need GZip compression support, add the following section to the http section of the main nginx configuration file:
<pre>
gzip on;
gzip_http_version 1.1;
gzip_comp_level 6;
gzip_min_length 1100;
gzip_buffers 4 8k;
gzip_types text/plain application/xhtml+xml text/css application/xml application/xml+rss text/javascript application/javascript application/x-javascript
gzip_proxied any;
gzip_disable "MSIE [1-6]\.";
</pre>

== Sources ==
* [http://en.gentoo-wiki.com/wiki/Nginx Nginx in Gentoo]
* [http://www.kevinworthington.com/nginx-for-windows/ Nginx for Windows]
* [http://wiki.nginx.org/Install#Ubuntu_PPA Nginx in Ubuntu]
* [http://www.debianadmin.com/howto-install-nginx-webserver-in-debian.html Nginx in Debian]
* [http://php.net/manual/en/install.fpm.php PHP-FPM installation and configuration]
* [http://wiki.nginx.org/HttpGzipModule GZip in Nginx]
* [http://wiki.nginx.org/HttpRewriteModule Rewrite in Nginx]
* [http://nginx.org/en/docs/http/request_processing.html How nginx processes a request]

Translations:Nginx/3/zh-tw

2016-06-15T02:25:01Z

Lai32290: Created page with "== 安裝 nginx =="

== 安裝 nginx ==

Nginx/zh-tw

2016-06-15T02:24:51Z

Lai32290:

<noinclude><languages /></noinclude>
[http://nginx.net/ nginx] is a lightweight Web server that powers about 13% of Web servers across all domains[http://en.wikipedia.org/wiki/Nginx#Description]. Unless you have specific requirements that demand a heavy Web server like Apache, you are much better off using nginx.

以下介紹如何在 [http://wiki.nginx.org/PHPFcgiExample nginx 和 FastCGI 的 PHP ] 中使用 Joomla!

== Install nginx ==
For Ubuntu, run <tt>aptitude install nginx</tt>. For other distros, run the corresponding package manager, or see http://wiki.nginx.org/Install.

== Install PHP FastCGI ==
For Ubuntu, read this excellent page on how to [http://wiki.nginx.org/PHPFcgiExample configure PHP and FastCGI for nginx].

For Gentoo, PHP will run as a FastCGI service (fpm), so the nginx server will run PHP as a separated process:
<pre>
# echo "dev-lang/php gd gd2 curl simplexml tokenizer dom tidy sqlite xml fpm cgi" >> /etc/portage/package.use
# emerge php
</pre>
The default settings of php-fpm are good for most servers. For special configurations, visit the [http://php.net/manual/en/install.fpm.php PHP FPM site].

== Configure Nginx ==
nginx configuration files reside in:
* <tt>/etc/nginx/sites-available/</tt> on Ubuntu (for sites running on that nginx instance)
* <tt>/etc/nginx/nginx.conf</tt> on Gentoo and Raspbian(= Debian optimized for Raspberry Pi)

Here is an sample nginx configuration file, joomla.conf, that you can reuse over all your nginx enabled-sites.

<pre>
server {
listen 80;
server_name YOUR_DOMAIN;
server_name_in_redirect off;

access_log /var/log/nginx/localhost.access_log;
error_log /var/log/nginx/localhost.error_log info;

root PATH_ON_SERVER;
index index.php index.html index.htm default.html default.htm;
# Support Clean (aka Search Engine Friendly) URLs
location / {
try_files $uri $uri/ /index.php?$args;
}

# deny running scripts inside writable directories
location ~* /(images|cache|media|logs|tmp)/.*\.(php|pl|py|jsp|asp|sh|cgi)$ {
return 403;
error_page 403 /403_error.html;
}

location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include /etc/nginx/fastcgi.conf;
}

# caching of files
location ~* \.(ico|pdf|flv)$ {
expires 1y;
}

location ~* \.(js|css|png|jpg|jpeg|gif|swf|xml|txt)$ {
expires 14d;
}

}
</pre>

Pay attention to a few things:
# The parameter <tt>fastcgi_pass</tt> is set to 127.0.0.1:9000, corresponding to the port that fpm is configured to listen to. This means you can run the PHP processes on separate servers. On Gentoo, you can find this configuration in <tt>/etc/php/fpm-php5.3/php-fpm.conf/</tt>
# Don't forget to replace YOUR_DOMAIN & PATH_ON_SERVER above depending on your domain and the path of Joomla on your server.

== GZip support ==
If you need GZip compression support, add the following section to the http section of the main nginx configuration file:
<pre>
gzip on;
gzip_http_version 1.1;
gzip_comp_level 6;
gzip_min_length 1100;
gzip_buffers 4 8k;
gzip_types text/plain application/xhtml+xml text/css application/xml application/xml+rss text/javascript application/javascript application/x-javascript
gzip_proxied any;
gzip_disable "MSIE [1-6]\.";
</pre>

== Sources ==
* [http://en.gentoo-wiki.com/wiki/Nginx Nginx in Gentoo]
* [http://www.kevinworthington.com/nginx-for-windows/ Nginx for Windows]
* [http://wiki.nginx.org/Install#Ubuntu_PPA Nginx in Ubuntu]
* [http://www.debianadmin.com/howto-install-nginx-webserver-in-debian.html Nginx in Debian]
* [http://php.net/manual/en/install.fpm.php PHP-FPM installation and configuration]
* [http://wiki.nginx.org/HttpGzipModule GZip in Nginx]
* [http://wiki.nginx.org/HttpRewriteModule Rewrite in Nginx]
* [http://nginx.org/en/docs/http/request_processing.html How nginx processes a request]

Translations:Nginx/2/zh-tw

2016-06-15T02:24:50Z

Lai32290:

以下介紹如何在 [http://wiki.nginx.org/PHPFcgiExample nginx 和 FastCGI 的 PHP ] 中使用 Joomla!

Nginx/zh-tw

2016-06-15T02:24:06Z

Lai32290: Created page with "以下介紹如何在 [http://wiki.nginx.org/PHPFcgiExample nginx and PHP via FastCGI] 中使用 Joomla!"

<noinclude><languages /></noinclude>
[http://nginx.net/ nginx] is a lightweight Web server that powers about 13% of Web servers across all domains[http://en.wikipedia.org/wiki/Nginx#Description]. Unless you have specific requirements that demand a heavy Web server like Apache, you are much better off using nginx.

以下介紹如何在 [http://wiki.nginx.org/PHPFcgiExample nginx and PHP via FastCGI] 中使用 Joomla!

== Install nginx ==
For Ubuntu, run <tt>aptitude install nginx</tt>. For other distros, run the corresponding package manager, or see http://wiki.nginx.org/Install.

== Install PHP FastCGI ==
For Ubuntu, read this excellent page on how to [http://wiki.nginx.org/PHPFcgiExample configure PHP and FastCGI for nginx].

For Gentoo, PHP will run as a FastCGI service (fpm), so the nginx server will run PHP as a separated process:
<pre>
# echo "dev-lang/php gd gd2 curl simplexml tokenizer dom tidy sqlite xml fpm cgi" >> /etc/portage/package.use
# emerge php
</pre>
The default settings of php-fpm are good for most servers. For special configurations, visit the [http://php.net/manual/en/install.fpm.php PHP FPM site].

== Configure Nginx ==
nginx configuration files reside in:
* <tt>/etc/nginx/sites-available/</tt> on Ubuntu (for sites running on that nginx instance)
* <tt>/etc/nginx/nginx.conf</tt> on Gentoo and Raspbian(= Debian optimized for Raspberry Pi)

Here is an sample nginx configuration file, joomla.conf, that you can reuse over all your nginx enabled-sites.

<pre>
server {
listen 80;
server_name YOUR_DOMAIN;
server_name_in_redirect off;

access_log /var/log/nginx/localhost.access_log;
error_log /var/log/nginx/localhost.error_log info;

root PATH_ON_SERVER;
index index.php index.html index.htm default.html default.htm;
# Support Clean (aka Search Engine Friendly) URLs
location / {
try_files $uri $uri/ /index.php?$args;
}

# deny running scripts inside writable directories
location ~* /(images|cache|media|logs|tmp)/.*\.(php|pl|py|jsp|asp|sh|cgi)$ {
return 403;
error_page 403 /403_error.html;
}

location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include /etc/nginx/fastcgi.conf;
}

# caching of files
location ~* \.(ico|pdf|flv)$ {
expires 1y;
}

location ~* \.(js|css|png|jpg|jpeg|gif|swf|xml|txt)$ {
expires 14d;
}

}
</pre>

Pay attention to a few things:
# The parameter <tt>fastcgi_pass</tt> is set to 127.0.0.1:9000, corresponding to the port that fpm is configured to listen to. This means you can run the PHP processes on separate servers. On Gentoo, you can find this configuration in <tt>/etc/php/fpm-php5.3/php-fpm.conf/</tt>
# Don't forget to replace YOUR_DOMAIN & PATH_ON_SERVER above depending on your domain and the path of Joomla on your server.

== GZip support ==
If you need GZip compression support, add the following section to the http section of the main nginx configuration file:
<pre>
gzip on;
gzip_http_version 1.1;
gzip_comp_level 6;
gzip_min_length 1100;
gzip_buffers 4 8k;
gzip_types text/plain application/xhtml+xml text/css application/xml application/xml+rss text/javascript application/javascript application/x-javascript
gzip_proxied any;
gzip_disable "MSIE [1-6]\.";
</pre>

== Sources ==
* [http://en.gentoo-wiki.com/wiki/Nginx Nginx in Gentoo]
* [http://www.kevinworthington.com/nginx-for-windows/ Nginx for Windows]
* [http://wiki.nginx.org/Install#Ubuntu_PPA Nginx in Ubuntu]
* [http://www.debianadmin.com/howto-install-nginx-webserver-in-debian.html Nginx in Debian]
* [http://php.net/manual/en/install.fpm.php PHP-FPM installation and configuration]
* [http://wiki.nginx.org/HttpGzipModule GZip in Nginx]
* [http://wiki.nginx.org/HttpRewriteModule Rewrite in Nginx]
* [http://nginx.org/en/docs/http/request_processing.html How nginx processes a request]

Translations:Nginx/2/zh-tw

2016-06-15T02:24:06Z

Lai32290: Created page with "以下介紹如何在 [http://wiki.nginx.org/PHPFcgiExample nginx and PHP via FastCGI] 中使用 Joomla!"

以下介紹如何在 [http://wiki.nginx.org/PHPFcgiExample nginx and PHP via FastCGI] 中使用 Joomla!

Nginx/zh-tw

2016-06-15T02:16:18Z

Lai32290: Created page with "Nginx"

<noinclude><languages /></noinclude>
[http://nginx.net/ nginx] is a lightweight Web server that powers about 13% of Web servers across all domains[http://en.wikipedia.org/wiki/Nginx#Description]. Unless you have specific requirements that demand a heavy Web server like Apache, you are much better off using nginx.

Below are instructions on how to get Joomla! running with [http://wiki.nginx.org/PHPFcgiExample nginx and PHP via FastCGI].

== Install nginx ==
For Ubuntu, run <tt>aptitude install nginx</tt>. For other distros, run the corresponding package manager, or see http://wiki.nginx.org/Install.

== Install PHP FastCGI ==
For Ubuntu, read this excellent page on how to [http://wiki.nginx.org/PHPFcgiExample configure PHP and FastCGI for nginx].

For Gentoo, PHP will run as a FastCGI service (fpm), so the nginx server will run PHP as a separated process:
<pre>
# echo "dev-lang/php gd gd2 curl simplexml tokenizer dom tidy sqlite xml fpm cgi" >> /etc/portage/package.use
# emerge php
</pre>
The default settings of php-fpm are good for most servers. For special configurations, visit the [http://php.net/manual/en/install.fpm.php PHP FPM site].

== Configure Nginx ==
nginx configuration files reside in:
* <tt>/etc/nginx/sites-available/</tt> on Ubuntu (for sites running on that nginx instance)
* <tt>/etc/nginx/nginx.conf</tt> on Gentoo and Raspbian(= Debian optimized for Raspberry Pi)

Here is an sample nginx configuration file, joomla.conf, that you can reuse over all your nginx enabled-sites.

<pre>
server {
listen 80;
server_name YOUR_DOMAIN;
server_name_in_redirect off;

access_log /var/log/nginx/localhost.access_log;
error_log /var/log/nginx/localhost.error_log info;

root PATH_ON_SERVER;
index index.php index.html index.htm default.html default.htm;
# Support Clean (aka Search Engine Friendly) URLs
location / {
try_files $uri $uri/ /index.php?$args;
}

# deny running scripts inside writable directories
location ~* /(images|cache|media|logs|tmp)/.*\.(php|pl|py|jsp|asp|sh|cgi)$ {
return 403;
error_page 403 /403_error.html;
}

location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include /etc/nginx/fastcgi.conf;
}

# caching of files
location ~* \.(ico|pdf|flv)$ {
expires 1y;
}

location ~* \.(js|css|png|jpg|jpeg|gif|swf|xml|txt)$ {
expires 14d;
}

}
</pre>

Pay attention to a few things:
# The parameter <tt>fastcgi_pass</tt> is set to 127.0.0.1:9000, corresponding to the port that fpm is configured to listen to. This means you can run the PHP processes on separate servers. On Gentoo, you can find this configuration in <tt>/etc/php/fpm-php5.3/php-fpm.conf/</tt>
# Don't forget to replace YOUR_DOMAIN & PATH_ON_SERVER above depending on your domain and the path of Joomla on your server.

== GZip support ==
If you need GZip compression support, add the following section to the http section of the main nginx configuration file:
<pre>
gzip on;
gzip_http_version 1.1;
gzip_comp_level 6;
gzip_min_length 1100;
gzip_buffers 4 8k;
gzip_types text/plain application/xhtml+xml text/css application/xml application/xml+rss text/javascript application/javascript application/x-javascript
gzip_proxied any;
gzip_disable "MSIE [1-6]\.";
</pre>

== Sources ==
* [http://en.gentoo-wiki.com/wiki/Nginx Nginx in Gentoo]
* [http://www.kevinworthington.com/nginx-for-windows/ Nginx for Windows]
* [http://wiki.nginx.org/Install#Ubuntu_PPA Nginx in Ubuntu]
* [http://www.debianadmin.com/howto-install-nginx-webserver-in-debian.html Nginx in Debian]
* [http://php.net/manual/en/install.fpm.php PHP-FPM installation and configuration]
* [http://wiki.nginx.org/HttpGzipModule GZip in Nginx]
* [http://wiki.nginx.org/HttpRewriteModule Rewrite in Nginx]
* [http://nginx.org/en/docs/http/request_processing.html How nginx processes a request]

Translations:Nginx/Page display title/zh-tw

2016-06-15T02:16:18Z

Lai32290: Created page with "Nginx"

Nginx

Translations:Creating a basic Joomla! template/29/zh-tw

2016-06-14T01:57:01Z

Lai32290: Created page with "Category:Templates Category:Tutorials"

[[Category:Templates]]
[[Category:Tutorials]]

Creating a basic Joomla! template/zh-tw

2016-06-14T01:50:42Z

Lai32290: Created page with "== 結論 =="

<noinclude><languages /></noinclude>
{{version/tutor|1.5,2.5,3.1}}{{JSplit}}
== 引言 ==

這篇教學的主要用意是作為一個創建 Joomla! 模板的介紹。將會包含創建基本模板所需要的基本檔案以及程式碼。所展示的程式碼可以複製、貼上來使用，但是也許會需要一些些的修改。

== 設置資料夾架構 ==
要創建最「基本」的模板，在 ''templates'' 裡面 '''新增一個資料夾'''。將資料夾名稱取為和你的模板名稱相同，這裡取為 ''mynewtemplate''。

使用你最喜歡的編輯器來新增 <code>index.php</code> 以及 <code>templateDetails.xml</code> 檔案。
為了方便整理，新增 '''2 個資料夾'''，將他們命名為 ''images'' 以及 ''css''。
在 ''css'' 資料夾裡面新增一個叫作 <code>template.css</code>的檔案。

雖然可以將你所有的 [[S:MyLanguage/Cascading Style Sheet (CSS)|CSS]] 直接放在 index.php 檔案的開頭，但是很多的網頁開發員都習慣將他們的CSS分開至別的檔案，這樣可以使用 <code>link</code> 標籤來將它們連接到多個頁面裡。將CSS放置分開的檔案也可以被新增到緩存裡，這樣可以縮短讀取網頁的時間。

這是最基本所需要的設置。資料夾以及檔案的架構如下：
* mynewtemplate/
** css/
*** template.css
** images/
** index.php
** templateDetails.xml

== 新增基本的 templateDetails.xml 檔案 ==
<tt>templateDetails.xml</tt> 檔案是必要的，沒有它的話，Joomla! 將會找不到你的模板。關於模板檔案裡的Key 的 [[Wikipedia:Metadata|metadata]]。

檔案的語法在每個版本的 Joomla 都不一樣。

{{JVer|1.5}} 版的語法如下：

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//EN" "http://www.joomla.org/xml/dtd/1.5/template-install.dtd">
<install version="1.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</install>
</source>

{{JVer|2.5}}版之後的語法如下。<code>version="2.5"</code> 更改了你安裝的 Joomla 的版本。

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension version="2.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</extension>
</source>

所以，你可以發現我們在標籤之中設置指數 (在 <code><element></code> 中)。最簡單的方式就是複製貼上到你的 <tt>templateDetails.xml</tt> 檔案裡來進行修改 (例如 <code><name></code> 以及 <code><author></code>)。

The <code><files></code> part should contain all the files that you use - you possibly don't know what they are called yet - don't worry, update it later. The <code><folder></code> element can be used to define an entire folder at once.

Leave the positions as they are - these are a common set so you will be able to switch easily from the standard templates.

== 新增基本的 index.php 檔案 ==
{{:Creating a basic index file/en}}

This leaves a final file of:

<source lang="php">
<?php defined('_JEXEC') or die('Restricted access');?>
<!DOCTYPE html>
<html xml:lang="<?php echo $this->language; ?>" lang="<?php echo $this->language; ?>" >
<head>
<jdoc:include type="head" />
<link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/<?php echo $this->template ?>/css/template.css" type="text/css" />
</head>
<body>
<jdoc:include type="modules" name="top" />
<jdoc:include type="component" />
<jdoc:include type="modules" name="bottom" />
</body>
</html>
</source>

== 測試模板 ==
從模板管理器中找到你的模板，選取它並且按下「預設」來將它設置成目前的模板。

{{JVer|1.5}} 在 Joomla! 1.5，你的新模板將會直接在 [[Help15:Screen.templates.15|Template Manager]] 中出現，可以在擴充 -> 模板管理中找到。

{{JVer|2.5}}+ In the Joomla! 2.5 series and later, you first need to tell Joomla! that you have created a new template. This feature is called ''Discover Extensions'' and can be accessed via Extensions -> Extension Manager -> Discover (i.e. the Discover ''tab''). Click '''Discover''' (i.e. the Discover ''button'') to discover your template, then select it and click '''Install''' to install it. Now your template should show up in the [[Help16:Extensions_Template_Manager_Styles|Template Manager (Styles)]], accessible via Extensions -> Template Manager.

Note you can create your template outside of Joomla and simply install it like any regular extension.

HINT: there are a couple of ways you can preview your index page as you put it together, either insert the styles into the head of the index page or directly link it to the style sheet you will be using temporarily. You can remove these links before packaging the file.

== 將模板封裝成安裝包 ==
{{:Packaging_a_extension/en}}

== 結論 ==

You should now have created a template that works. It won't look like much yet. The best thing to do now is start experimenting with the layout.

<noinclude>
[[Category:Templates]]
[[Category:Tutorials]]
</noinclude>

Translations:Creating a basic Joomla! template/27/zh-tw

2016-06-14T01:50:41Z

Lai32290: Created page with "== 結論 =="

== 結論 ==

Translations:Creating a basic Joomla! template/26/zh-tw

2016-06-14T01:50:20Z

Lai32290: Created page with "en"

Creating a basic Joomla! template/zh-tw

2016-06-14T01:50:17Z

Lai32290: Created page with "== 將模板封裝成安裝包 =="

<noinclude><languages /></noinclude>
{{version/tutor|1.5,2.5,3.1}}{{JSplit}}
== 引言 ==

這篇教學的主要用意是作為一個創建 Joomla! 模板的介紹。將會包含創建基本模板所需要的基本檔案以及程式碼。所展示的程式碼可以複製、貼上來使用，但是也許會需要一些些的修改。

== 設置資料夾架構 ==
要創建最「基本」的模板，在 ''templates'' 裡面 '''新增一個資料夾'''。將資料夾名稱取為和你的模板名稱相同，這裡取為 ''mynewtemplate''。

使用你最喜歡的編輯器來新增 <code>index.php</code> 以及 <code>templateDetails.xml</code> 檔案。
為了方便整理，新增 '''2 個資料夾'''，將他們命名為 ''images'' 以及 ''css''。
在 ''css'' 資料夾裡面新增一個叫作 <code>template.css</code>的檔案。

雖然可以將你所有的 [[S:MyLanguage/Cascading Style Sheet (CSS)|CSS]] 直接放在 index.php 檔案的開頭，但是很多的網頁開發員都習慣將他們的CSS分開至別的檔案，這樣可以使用 <code>link</code> 標籤來將它們連接到多個頁面裡。將CSS放置分開的檔案也可以被新增到緩存裡，這樣可以縮短讀取網頁的時間。

這是最基本所需要的設置。資料夾以及檔案的架構如下：
* mynewtemplate/
** css/
*** template.css
** images/
** index.php
** templateDetails.xml

== 新增基本的 templateDetails.xml 檔案 ==
<tt>templateDetails.xml</tt> 檔案是必要的，沒有它的話，Joomla! 將會找不到你的模板。關於模板檔案裡的Key 的 [[Wikipedia:Metadata|metadata]]。

檔案的語法在每個版本的 Joomla 都不一樣。

{{JVer|1.5}} 版的語法如下：

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//EN" "http://www.joomla.org/xml/dtd/1.5/template-install.dtd">
<install version="1.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</install>
</source>

{{JVer|2.5}}版之後的語法如下。<code>version="2.5"</code> 更改了你安裝的 Joomla 的版本。

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension version="2.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</extension>
</source>

所以，你可以發現我們在標籤之中設置指數 (在 <code><element></code> 中)。最簡單的方式就是複製貼上到你的 <tt>templateDetails.xml</tt> 檔案裡來進行修改 (例如 <code><name></code> 以及 <code><author></code>)。

The <code><files></code> part should contain all the files that you use - you possibly don't know what they are called yet - don't worry, update it later. The <code><folder></code> element can be used to define an entire folder at once.

Leave the positions as they are - these are a common set so you will be able to switch easily from the standard templates.

== 新增基本的 index.php 檔案 ==
{{:Creating a basic index file/en}}

This leaves a final file of:

<source lang="php">
<?php defined('_JEXEC') or die('Restricted access');?>
<!DOCTYPE html>
<html xml:lang="<?php echo $this->language; ?>" lang="<?php echo $this->language; ?>" >
<head>
<jdoc:include type="head" />
<link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/<?php echo $this->template ?>/css/template.css" type="text/css" />
</head>
<body>
<jdoc:include type="modules" name="top" />
<jdoc:include type="component" />
<jdoc:include type="modules" name="bottom" />
</body>
</html>
</source>

== 測試模板 ==
從模板管理器中找到你的模板，選取它並且按下「預設」來將它設置成目前的模板。

{{JVer|1.5}} 在 Joomla! 1.5，你的新模板將會直接在 [[Help15:Screen.templates.15|Template Manager]] 中出現，可以在擴充 -> 模板管理中找到。

{{JVer|2.5}}+ In the Joomla! 2.5 series and later, you first need to tell Joomla! that you have created a new template. This feature is called ''Discover Extensions'' and can be accessed via Extensions -> Extension Manager -> Discover (i.e. the Discover ''tab''). Click '''Discover''' (i.e. the Discover ''button'') to discover your template, then select it and click '''Install''' to install it. Now your template should show up in the [[Help16:Extensions_Template_Manager_Styles|Template Manager (Styles)]], accessible via Extensions -> Template Manager.

Note you can create your template outside of Joomla and simply install it like any regular extension.

HINT: there are a couple of ways you can preview your index page as you put it together, either insert the styles into the head of the index page or directly link it to the style sheet you will be using temporarily. You can remove these links before packaging the file.

== 將模板封裝成安裝包 ==
{{:Packaging_a_extension/en}}

== Conclusion ==

You should now have created a template that works. It won't look like much yet. The best thing to do now is start experimenting with the layout.

<noinclude>
[[Category:Templates]]
[[Category:Tutorials]]
</noinclude>

Translations:Creating a basic Joomla! template/25/zh-tw

2016-06-14T01:50:16Z

Lai32290: Created page with "== 將模板封裝成安裝包 =="

== 將模板封裝成安裝包 ==

Creating a basic Joomla! template/zh-tw

2016-06-14T01:49:28Z

Lai32290: Created page with "{{JVer|1.5}} 在 Joomla! 1.5，你的新模板將會直接在 Template Manager 中出現，可以在擴充 -> 模板管理中找到。"

<noinclude><languages /></noinclude>
{{version/tutor|1.5,2.5,3.1}}{{JSplit}}
== 引言 ==

這篇教學的主要用意是作為一個創建 Joomla! 模板的介紹。將會包含創建基本模板所需要的基本檔案以及程式碼。所展示的程式碼可以複製、貼上來使用，但是也許會需要一些些的修改。

== 設置資料夾架構 ==
要創建最「基本」的模板，在 ''templates'' 裡面 '''新增一個資料夾'''。將資料夾名稱取為和你的模板名稱相同，這裡取為 ''mynewtemplate''。

使用你最喜歡的編輯器來新增 <code>index.php</code> 以及 <code>templateDetails.xml</code> 檔案。
為了方便整理，新增 '''2 個資料夾'''，將他們命名為 ''images'' 以及 ''css''。
在 ''css'' 資料夾裡面新增一個叫作 <code>template.css</code>的檔案。

雖然可以將你所有的 [[S:MyLanguage/Cascading Style Sheet (CSS)|CSS]] 直接放在 index.php 檔案的開頭，但是很多的網頁開發員都習慣將他們的CSS分開至別的檔案，這樣可以使用 <code>link</code> 標籤來將它們連接到多個頁面裡。將CSS放置分開的檔案也可以被新增到緩存裡，這樣可以縮短讀取網頁的時間。

這是最基本所需要的設置。資料夾以及檔案的架構如下：
* mynewtemplate/
** css/
*** template.css
** images/
** index.php
** templateDetails.xml

== 新增基本的 templateDetails.xml 檔案 ==
<tt>templateDetails.xml</tt> 檔案是必要的，沒有它的話，Joomla! 將會找不到你的模板。關於模板檔案裡的Key 的 [[Wikipedia:Metadata|metadata]]。

檔案的語法在每個版本的 Joomla 都不一樣。

{{JVer|1.5}} 版的語法如下：

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//EN" "http://www.joomla.org/xml/dtd/1.5/template-install.dtd">
<install version="1.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</install>
</source>

{{JVer|2.5}}版之後的語法如下。<code>version="2.5"</code> 更改了你安裝的 Joomla 的版本。

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension version="2.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</extension>
</source>

所以，你可以發現我們在標籤之中設置指數 (在 <code><element></code> 中)。最簡單的方式就是複製貼上到你的 <tt>templateDetails.xml</tt> 檔案裡來進行修改 (例如 <code><name></code> 以及 <code><author></code>)。

The <code><files></code> part should contain all the files that you use - you possibly don't know what they are called yet - don't worry, update it later. The <code><folder></code> element can be used to define an entire folder at once.

Leave the positions as they are - these are a common set so you will be able to switch easily from the standard templates.

== 新增基本的 index.php 檔案 ==
{{:Creating a basic index file/en}}

This leaves a final file of:

<source lang="php">
<?php defined('_JEXEC') or die('Restricted access');?>
<!DOCTYPE html>
<html xml:lang="<?php echo $this->language; ?>" lang="<?php echo $this->language; ?>" >
<head>
<jdoc:include type="head" />
<link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/<?php echo $this->template ?>/css/template.css" type="text/css" />
</head>
<body>
<jdoc:include type="modules" name="top" />
<jdoc:include type="component" />
<jdoc:include type="modules" name="bottom" />
</body>
</html>
</source>

== 測試模板 ==
從模板管理器中找到你的模板，選取它並且按下「預設」來將它設置成目前的模板。

{{JVer|1.5}} 在 Joomla! 1.5，你的新模板將會直接在 [[Help15:Screen.templates.15|Template Manager]] 中出現，可以在擴充 -> 模板管理中找到。

{{JVer|2.5}}+ In the Joomla! 2.5 series and later, you first need to tell Joomla! that you have created a new template. This feature is called ''Discover Extensions'' and can be accessed via Extensions -> Extension Manager -> Discover (i.e. the Discover ''tab''). Click '''Discover''' (i.e. the Discover ''button'') to discover your template, then select it and click '''Install''' to install it. Now your template should show up in the [[Help16:Extensions_Template_Manager_Styles|Template Manager (Styles)]], accessible via Extensions -> Template Manager.

Note you can create your template outside of Joomla and simply install it like any regular extension.

HINT: there are a couple of ways you can preview your index page as you put it together, either insert the styles into the head of the index page or directly link it to the style sheet you will be using temporarily. You can remove these links before packaging the file.

== Packaging the template for installation ==
{{:Packaging_a_extension/en}}

== Conclusion ==

You should now have created a template that works. It won't look like much yet. The best thing to do now is start experimenting with the layout.

<noinclude>
[[Category:Templates]]
[[Category:Tutorials]]
</noinclude>

Translations:Creating a basic Joomla! template/21/zh-tw

2016-06-14T01:49:27Z

Lai32290: Created page with "{{JVer|1.5}} 在 Joomla! 1.5，你的新模板將會直接在 Template Manager 中出現，可以在擴充 -> 模板管理中找到。"

{{JVer|1.5}} 在 Joomla! 1.5，你的新模板將會直接在 [[Help15:Screen.templates.15|Template Manager]] 中出現，可以在擴充 -> 模板管理中找到。

Creating a basic Joomla! template/zh-tw

2016-06-14T01:08:56Z

Lai32290: Created page with "從模板管理器中找到你的模板，選取它並且按下「預設」來將它設置成目前的模板。"

<noinclude><languages /></noinclude>
{{version/tutor|1.5,2.5,3.1}}{{JSplit}}
== 引言 ==

這篇教學的主要用意是作為一個創建 Joomla! 模板的介紹。將會包含創建基本模板所需要的基本檔案以及程式碼。所展示的程式碼可以複製、貼上來使用，但是也許會需要一些些的修改。

== 設置資料夾架構 ==
要創建最「基本」的模板，在 ''templates'' 裡面 '''新增一個資料夾'''。將資料夾名稱取為和你的模板名稱相同，這裡取為 ''mynewtemplate''。

使用你最喜歡的編輯器來新增 <code>index.php</code> 以及 <code>templateDetails.xml</code> 檔案。
為了方便整理，新增 '''2 個資料夾'''，將他們命名為 ''images'' 以及 ''css''。
在 ''css'' 資料夾裡面新增一個叫作 <code>template.css</code>的檔案。

雖然可以將你所有的 [[S:MyLanguage/Cascading Style Sheet (CSS)|CSS]] 直接放在 index.php 檔案的開頭，但是很多的網頁開發員都習慣將他們的CSS分開至別的檔案，這樣可以使用 <code>link</code> 標籤來將它們連接到多個頁面裡。將CSS放置分開的檔案也可以被新增到緩存裡，這樣可以縮短讀取網頁的時間。

這是最基本所需要的設置。資料夾以及檔案的架構如下：
* mynewtemplate/
** css/
*** template.css
** images/
** index.php
** templateDetails.xml

== 新增基本的 templateDetails.xml 檔案 ==
<tt>templateDetails.xml</tt> 檔案是必要的，沒有它的話，Joomla! 將會找不到你的模板。關於模板檔案裡的Key 的 [[Wikipedia:Metadata|metadata]]。

檔案的語法在每個版本的 Joomla 都不一樣。

{{JVer|1.5}} 版的語法如下：

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//EN" "http://www.joomla.org/xml/dtd/1.5/template-install.dtd">
<install version="1.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</install>
</source>

{{JVer|2.5}}版之後的語法如下。<code>version="2.5"</code> 更改了你安裝的 Joomla 的版本。

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension version="2.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</extension>
</source>

所以，你可以發現我們在標籤之中設置指數 (在 <code><element></code> 中)。最簡單的方式就是複製貼上到你的 <tt>templateDetails.xml</tt> 檔案裡來進行修改 (例如 <code><name></code> 以及 <code><author></code>)。

The <code><files></code> part should contain all the files that you use - you possibly don't know what they are called yet - don't worry, update it later. The <code><folder></code> element can be used to define an entire folder at once.

Leave the positions as they are - these are a common set so you will be able to switch easily from the standard templates.

== 新增基本的 index.php 檔案 ==
{{:Creating a basic index file/en}}

This leaves a final file of:

<source lang="php">
<?php defined('_JEXEC') or die('Restricted access');?>
<!DOCTYPE html>
<html xml:lang="<?php echo $this->language; ?>" lang="<?php echo $this->language; ?>" >
<head>
<jdoc:include type="head" />
<link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/<?php echo $this->template ?>/css/template.css" type="text/css" />
</head>
<body>
<jdoc:include type="modules" name="top" />
<jdoc:include type="component" />
<jdoc:include type="modules" name="bottom" />
</body>
</html>
</source>

== 測試模板 ==
從模板管理器中找到你的模板，選取它並且按下「預設」來將它設置成目前的模板。

{{JVer|1.5}} In Joomla! 1.5, your new template will show up immediately in the [[Help15:Screen.templates.15|Template Manager]], accessible via Extensions -> Template Manager.

{{JVer|2.5}}+ In the Joomla! 2.5 series and later, you first need to tell Joomla! that you have created a new template. This feature is called ''Discover Extensions'' and can be accessed via Extensions -> Extension Manager -> Discover (i.e. the Discover ''tab''). Click '''Discover''' (i.e. the Discover ''button'') to discover your template, then select it and click '''Install''' to install it. Now your template should show up in the [[Help16:Extensions_Template_Manager_Styles|Template Manager (Styles)]], accessible via Extensions -> Template Manager.

Note you can create your template outside of Joomla and simply install it like any regular extension.

HINT: there are a couple of ways you can preview your index page as you put it together, either insert the styles into the head of the index page or directly link it to the style sheet you will be using temporarily. You can remove these links before packaging the file.

== Packaging the template for installation ==
{{:Packaging_a_extension/en}}

== Conclusion ==

You should now have created a template that works. It won't look like much yet. The best thing to do now is start experimenting with the layout.

<noinclude>
[[Category:Templates]]
[[Category:Tutorials]]
</noinclude>

Translations:Creating a basic Joomla! template/20/zh-tw

2016-06-14T01:08:55Z

Lai32290: Created page with "從模板管理器中找到你的模板，選取它並且按下「預設」來將它設置成目前的模板。"

從模板管理器中找到你的模板，選取它並且按下「預設」來將它設置成目前的模板。

Creating a basic Joomla! template/zh-tw

2016-06-14T01:01:38Z

Lai32290: Created page with "== 測試模板 =="

<noinclude><languages /></noinclude>
{{version/tutor|1.5,2.5,3.1}}{{JSplit}}
== 引言 ==

這篇教學的主要用意是作為一個創建 Joomla! 模板的介紹。將會包含創建基本模板所需要的基本檔案以及程式碼。所展示的程式碼可以複製、貼上來使用，但是也許會需要一些些的修改。

== 設置資料夾架構 ==
要創建最「基本」的模板，在 ''templates'' 裡面 '''新增一個資料夾'''。將資料夾名稱取為和你的模板名稱相同，這裡取為 ''mynewtemplate''。

使用你最喜歡的編輯器來新增 <code>index.php</code> 以及 <code>templateDetails.xml</code> 檔案。
為了方便整理，新增 '''2 個資料夾'''，將他們命名為 ''images'' 以及 ''css''。
在 ''css'' 資料夾裡面新增一個叫作 <code>template.css</code>的檔案。

雖然可以將你所有的 [[S:MyLanguage/Cascading Style Sheet (CSS)|CSS]] 直接放在 index.php 檔案的開頭，但是很多的網頁開發員都習慣將他們的CSS分開至別的檔案，這樣可以使用 <code>link</code> 標籤來將它們連接到多個頁面裡。將CSS放置分開的檔案也可以被新增到緩存裡，這樣可以縮短讀取網頁的時間。

這是最基本所需要的設置。資料夾以及檔案的架構如下：
* mynewtemplate/
** css/
*** template.css
** images/
** index.php
** templateDetails.xml

== 新增基本的 templateDetails.xml 檔案 ==
<tt>templateDetails.xml</tt> 檔案是必要的，沒有它的話，Joomla! 將會找不到你的模板。關於模板檔案裡的Key 的 [[Wikipedia:Metadata|metadata]]。

檔案的語法在每個版本的 Joomla 都不一樣。

{{JVer|1.5}} 版的語法如下：

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//EN" "http://www.joomla.org/xml/dtd/1.5/template-install.dtd">
<install version="1.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</install>
</source>

{{JVer|2.5}}版之後的語法如下。<code>version="2.5"</code> 更改了你安裝的 Joomla 的版本。

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension version="2.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</extension>
</source>

所以，你可以發現我們在標籤之中設置指數 (在 <code><element></code> 中)。最簡單的方式就是複製貼上到你的 <tt>templateDetails.xml</tt> 檔案裡來進行修改 (例如 <code><name></code> 以及 <code><author></code>)。

The <code><files></code> part should contain all the files that you use - you possibly don't know what they are called yet - don't worry, update it later. The <code><folder></code> element can be used to define an entire folder at once.

Leave the positions as they are - these are a common set so you will be able to switch easily from the standard templates.

== 新增基本的 index.php 檔案 ==
{{:Creating a basic index file/en}}

This leaves a final file of:

<source lang="php">
<?php defined('_JEXEC') or die('Restricted access');?>
<!DOCTYPE html>
<html xml:lang="<?php echo $this->language; ?>" lang="<?php echo $this->language; ?>" >
<head>
<jdoc:include type="head" />
<link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/<?php echo $this->template ?>/css/template.css" type="text/css" />
</head>
<body>
<jdoc:include type="modules" name="top" />
<jdoc:include type="component" />
<jdoc:include type="modules" name="bottom" />
</body>
</html>
</source>

== 測試模板 ==
Find the template in the Template Manager, select it and click '''Default''' to make it the default template.

{{JVer|1.5}} In Joomla! 1.5, your new template will show up immediately in the [[Help15:Screen.templates.15|Template Manager]], accessible via Extensions -> Template Manager.

{{JVer|2.5}}+ In the Joomla! 2.5 series and later, you first need to tell Joomla! that you have created a new template. This feature is called ''Discover Extensions'' and can be accessed via Extensions -> Extension Manager -> Discover (i.e. the Discover ''tab''). Click '''Discover''' (i.e. the Discover ''button'') to discover your template, then select it and click '''Install''' to install it. Now your template should show up in the [[Help16:Extensions_Template_Manager_Styles|Template Manager (Styles)]], accessible via Extensions -> Template Manager.

Note you can create your template outside of Joomla and simply install it like any regular extension.

HINT: there are a couple of ways you can preview your index page as you put it together, either insert the styles into the head of the index page or directly link it to the style sheet you will be using temporarily. You can remove these links before packaging the file.

== Packaging the template for installation ==
{{:Packaging_a_extension/en}}

== Conclusion ==

You should now have created a template that works. It won't look like much yet. The best thing to do now is start experimenting with the layout.

<noinclude>
[[Category:Templates]]
[[Category:Tutorials]]
</noinclude>

Translations:Creating a basic Joomla! template/19/zh-tw

2016-06-14T01:01:37Z

Lai32290: Created page with "== 測試模板 =="

== 測試模板 ==

Translations:Creating a basic Joomla! template/17/zh-tw

2016-06-14T01:01:06Z

Lai32290: Created page with "en"

Creating a basic Joomla! template/zh-tw

2016-06-14T01:01:01Z

Lai32290: Created page with "== 新增基本的 index.php 檔案 =="

<noinclude><languages /></noinclude>
{{version/tutor|1.5,2.5,3.1}}{{JSplit}}
== 引言 ==

這篇教學的主要用意是作為一個創建 Joomla! 模板的介紹。將會包含創建基本模板所需要的基本檔案以及程式碼。所展示的程式碼可以複製、貼上來使用，但是也許會需要一些些的修改。

== 設置資料夾架構 ==
要創建最「基本」的模板，在 ''templates'' 裡面 '''新增一個資料夾'''。將資料夾名稱取為和你的模板名稱相同，這裡取為 ''mynewtemplate''。

使用你最喜歡的編輯器來新增 <code>index.php</code> 以及 <code>templateDetails.xml</code> 檔案。
為了方便整理，新增 '''2 個資料夾'''，將他們命名為 ''images'' 以及 ''css''。
在 ''css'' 資料夾裡面新增一個叫作 <code>template.css</code>的檔案。

雖然可以將你所有的 [[S:MyLanguage/Cascading Style Sheet (CSS)|CSS]] 直接放在 index.php 檔案的開頭，但是很多的網頁開發員都習慣將他們的CSS分開至別的檔案，這樣可以使用 <code>link</code> 標籤來將它們連接到多個頁面裡。將CSS放置分開的檔案也可以被新增到緩存裡，這樣可以縮短讀取網頁的時間。

這是最基本所需要的設置。資料夾以及檔案的架構如下：
* mynewtemplate/
** css/
*** template.css
** images/
** index.php
** templateDetails.xml

== 新增基本的 templateDetails.xml 檔案 ==
<tt>templateDetails.xml</tt> 檔案是必要的，沒有它的話，Joomla! 將會找不到你的模板。關於模板檔案裡的Key 的 [[Wikipedia:Metadata|metadata]]。

檔案的語法在每個版本的 Joomla 都不一樣。

{{JVer|1.5}} 版的語法如下：

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//EN" "http://www.joomla.org/xml/dtd/1.5/template-install.dtd">
<install version="1.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</install>
</source>

{{JVer|2.5}}版之後的語法如下。<code>version="2.5"</code> 更改了你安裝的 Joomla 的版本。

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension version="2.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</extension>
</source>

所以，你可以發現我們在標籤之中設置指數 (在 <code><element></code> 中)。最簡單的方式就是複製貼上到你的 <tt>templateDetails.xml</tt> 檔案裡來進行修改 (例如 <code><name></code> 以及 <code><author></code>)。

The <code><files></code> part should contain all the files that you use - you possibly don't know what they are called yet - don't worry, update it later. The <code><folder></code> element can be used to define an entire folder at once.

Leave the positions as they are - these are a common set so you will be able to switch easily from the standard templates.

== 新增基本的 index.php 檔案 ==
{{:Creating a basic index file/en}}

This leaves a final file of:

<source lang="php">
<?php defined('_JEXEC') or die('Restricted access');?>
<!DOCTYPE html>
<html xml:lang="<?php echo $this->language; ?>" lang="<?php echo $this->language; ?>" >
<head>
<jdoc:include type="head" />
<link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/<?php echo $this->template ?>/css/template.css" type="text/css" />
</head>
<body>
<jdoc:include type="modules" name="top" />
<jdoc:include type="component" />
<jdoc:include type="modules" name="bottom" />
</body>
</html>
</source>

== Testing the template ==
Find the template in the Template Manager, select it and click '''Default''' to make it the default template.

{{JVer|1.5}} In Joomla! 1.5, your new template will show up immediately in the [[Help15:Screen.templates.15|Template Manager]], accessible via Extensions -> Template Manager.

{{JVer|2.5}}+ In the Joomla! 2.5 series and later, you first need to tell Joomla! that you have created a new template. This feature is called ''Discover Extensions'' and can be accessed via Extensions -> Extension Manager -> Discover (i.e. the Discover ''tab''). Click '''Discover''' (i.e. the Discover ''button'') to discover your template, then select it and click '''Install''' to install it. Now your template should show up in the [[Help16:Extensions_Template_Manager_Styles|Template Manager (Styles)]], accessible via Extensions -> Template Manager.

Note you can create your template outside of Joomla and simply install it like any regular extension.

HINT: there are a couple of ways you can preview your index page as you put it together, either insert the styles into the head of the index page or directly link it to the style sheet you will be using temporarily. You can remove these links before packaging the file.

== Packaging the template for installation ==
{{:Packaging_a_extension/en}}

== Conclusion ==

You should now have created a template that works. It won't look like much yet. The best thing to do now is start experimenting with the layout.

<noinclude>
[[Category:Templates]]
[[Category:Tutorials]]
</noinclude>

Translations:Creating a basic Joomla! template/16/zh-tw

2016-06-14T01:01:00Z

Lai32290: Created page with "== 新增基本的 index.php 檔案 =="

== 新增基本的 index.php 檔案 ==

Creating a basic Joomla! template/zh-tw

2016-06-14T00:15:04Z

Lai32290: Created page with "所以，你可以發現我們在標籤之中設置指數 (在 <code><element></code> 中)。最簡單的方式就是複製貼上到你的 <tt>templateDetails.xml</tt> 檔案..."

<noinclude><languages /></noinclude>
{{version/tutor|1.5,2.5,3.1}}{{JSplit}}
== 引言 ==

這篇教學的主要用意是作為一個創建 Joomla! 模板的介紹。將會包含創建基本模板所需要的基本檔案以及程式碼。所展示的程式碼可以複製、貼上來使用，但是也許會需要一些些的修改。

== 設置資料夾架構 ==
要創建最「基本」的模板，在 ''templates'' 裡面 '''新增一個資料夾'''。將資料夾名稱取為和你的模板名稱相同，這裡取為 ''mynewtemplate''。

使用你最喜歡的編輯器來新增 <code>index.php</code> 以及 <code>templateDetails.xml</code> 檔案。
為了方便整理，新增 '''2 個資料夾'''，將他們命名為 ''images'' 以及 ''css''。
在 ''css'' 資料夾裡面新增一個叫作 <code>template.css</code>的檔案。

雖然可以將你所有的 [[S:MyLanguage/Cascading Style Sheet (CSS)|CSS]] 直接放在 index.php 檔案的開頭，但是很多的網頁開發員都習慣將他們的CSS分開至別的檔案，這樣可以使用 <code>link</code> 標籤來將它們連接到多個頁面裡。將CSS放置分開的檔案也可以被新增到緩存裡，這樣可以縮短讀取網頁的時間。

這是最基本所需要的設置。資料夾以及檔案的架構如下：
* mynewtemplate/
** css/
*** template.css
** images/
** index.php
** templateDetails.xml

== 新增基本的 templateDetails.xml 檔案 ==
<tt>templateDetails.xml</tt> 檔案是必要的，沒有它的話，Joomla! 將會找不到你的模板。關於模板檔案裡的Key 的 [[Wikipedia:Metadata|metadata]]。

檔案的語法在每個版本的 Joomla 都不一樣。

{{JVer|1.5}} 版的語法如下：

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//EN" "http://www.joomla.org/xml/dtd/1.5/template-install.dtd">
<install version="1.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</install>
</source>

{{JVer|2.5}}版之後的語法如下。<code>version="2.5"</code> 更改了你安裝的 Joomla 的版本。

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension version="2.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</extension>
</source>

所以，你可以發現我們在標籤之中設置指數 (在 <code><element></code> 中)。最簡單的方式就是複製貼上到你的 <tt>templateDetails.xml</tt> 檔案裡來進行修改 (例如 <code><name></code> 以及 <code><author></code>)。

The <code><files></code> part should contain all the files that you use - you possibly don't know what they are called yet - don't worry, update it later. The <code><folder></code> element can be used to define an entire folder at once.

Leave the positions as they are - these are a common set so you will be able to switch easily from the standard templates.

== Creating a basic index.php file ==
{{:Creating a basic index file/en}}

This leaves a final file of:

<source lang="php">
<?php defined('_JEXEC') or die('Restricted access');?>
<!DOCTYPE html>
<html xml:lang="<?php echo $this->language; ?>" lang="<?php echo $this->language; ?>" >
<head>
<jdoc:include type="head" />
<link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/<?php echo $this->template ?>/css/template.css" type="text/css" />
</head>
<body>
<jdoc:include type="modules" name="top" />
<jdoc:include type="component" />
<jdoc:include type="modules" name="bottom" />
</body>
</html>
</source>

== Testing the template ==
Find the template in the Template Manager, select it and click '''Default''' to make it the default template.

{{JVer|1.5}} In Joomla! 1.5, your new template will show up immediately in the [[Help15:Screen.templates.15|Template Manager]], accessible via Extensions -> Template Manager.

{{JVer|2.5}}+ In the Joomla! 2.5 series and later, you first need to tell Joomla! that you have created a new template. This feature is called ''Discover Extensions'' and can be accessed via Extensions -> Extension Manager -> Discover (i.e. the Discover ''tab''). Click '''Discover''' (i.e. the Discover ''button'') to discover your template, then select it and click '''Install''' to install it. Now your template should show up in the [[Help16:Extensions_Template_Manager_Styles|Template Manager (Styles)]], accessible via Extensions -> Template Manager.

Note you can create your template outside of Joomla and simply install it like any regular extension.

HINT: there are a couple of ways you can preview your index page as you put it together, either insert the styles into the head of the index page or directly link it to the style sheet you will be using temporarily. You can remove these links before packaging the file.

== Packaging the template for installation ==
{{:Packaging_a_extension/en}}

== Conclusion ==

You should now have created a template that works. It won't look like much yet. The best thing to do now is start experimenting with the layout.

<noinclude>
[[Category:Templates]]
[[Category:Tutorials]]
</noinclude>

Translations:Creating a basic Joomla! template/13/zh-tw

2016-06-14T00:15:03Z

所以，你可以發現我們在標籤之中設置指數 (在 <code><element></code> 中)。最簡單的方式就是複製貼上到你的 <tt>templateDetails.xml</tt> 檔案裡來進行修改 (例如 <code><name></code> 以及 <code><author></code>)。

Creating a basic Joomla! template/zh-tw

2016-06-13T16:51:28Z

Lai32290: Created page with "{{JVer|2.5}}版之後的語法如下。<code>version="2.5"</code> 更改了你安裝的 Joomla 的版本。"

<noinclude><languages /></noinclude>
{{version/tutor|1.5,2.5,3.1}}{{JSplit}}
== 引言 ==

這篇教學的主要用意是作為一個創建 Joomla! 模板的介紹。將會包含創建基本模板所需要的基本檔案以及程式碼。所展示的程式碼可以複製、貼上來使用，但是也許會需要一些些的修改。

== 設置資料夾架構 ==
要創建最「基本」的模板，在 ''templates'' 裡面 '''新增一個資料夾'''。將資料夾名稱取為和你的模板名稱相同，這裡取為 ''mynewtemplate''。

使用你最喜歡的編輯器來新增 <code>index.php</code> 以及 <code>templateDetails.xml</code> 檔案。
為了方便整理，新增 '''2 個資料夾'''，將他們命名為 ''images'' 以及 ''css''。
在 ''css'' 資料夾裡面新增一個叫作 <code>template.css</code>的檔案。

雖然可以將你所有的 [[S:MyLanguage/Cascading Style Sheet (CSS)|CSS]] 直接放在 index.php 檔案的開頭，但是很多的網頁開發員都習慣將他們的CSS分開至別的檔案，這樣可以使用 <code>link</code> 標籤來將它們連接到多個頁面裡。將CSS放置分開的檔案也可以被新增到緩存裡，這樣可以縮短讀取網頁的時間。

這是最基本所需要的設置。資料夾以及檔案的架構如下：
* mynewtemplate/
** css/
*** template.css
** images/
** index.php
** templateDetails.xml

== 新增基本的 templateDetails.xml 檔案 ==
<tt>templateDetails.xml</tt> 檔案是必要的，沒有它的話，Joomla! 將會找不到你的模板。關於模板檔案裡的Key 的 [[Wikipedia:Metadata|metadata]]。

檔案的語法在每個版本的 Joomla 都不一樣。

{{JVer|1.5}} 版的語法如下：

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//EN" "http://www.joomla.org/xml/dtd/1.5/template-install.dtd">
<install version="1.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</install>
</source>

{{JVer|2.5}}版之後的語法如下。<code>version="2.5"</code> 更改了你安裝的 Joomla 的版本。

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension version="2.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</extension>
</source>

So, as you can see, we have a set of information between markup tags (the <code><element></code>s). Your best approach is to copy and paste this into your <tt>templateDetails.xml</tt> file and change the relevant bits (such as <code><name></code> and <code><author></code>).

The <code><files></code> part should contain all the files that you use - you possibly don't know what they are called yet - don't worry, update it later. The <code><folder></code> element can be used to define an entire folder at once.

Leave the positions as they are - these are a common set so you will be able to switch easily from the standard templates.

== Creating a basic index.php file ==
{{:Creating a basic index file/en}}

This leaves a final file of:

<source lang="php">
<?php defined('_JEXEC') or die('Restricted access');?>
<!DOCTYPE html>
<html xml:lang="<?php echo $this->language; ?>" lang="<?php echo $this->language; ?>" >
<head>
<jdoc:include type="head" />
<link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/<?php echo $this->template ?>/css/template.css" type="text/css" />
</head>
<body>
<jdoc:include type="modules" name="top" />
<jdoc:include type="component" />
<jdoc:include type="modules" name="bottom" />
</body>
</html>
</source>

== Testing the template ==
Find the template in the Template Manager, select it and click '''Default''' to make it the default template.

{{JVer|1.5}} In Joomla! 1.5, your new template will show up immediately in the [[Help15:Screen.templates.15|Template Manager]], accessible via Extensions -> Template Manager.

{{JVer|2.5}}+ In the Joomla! 2.5 series and later, you first need to tell Joomla! that you have created a new template. This feature is called ''Discover Extensions'' and can be accessed via Extensions -> Extension Manager -> Discover (i.e. the Discover ''tab''). Click '''Discover''' (i.e. the Discover ''button'') to discover your template, then select it and click '''Install''' to install it. Now your template should show up in the [[Help16:Extensions_Template_Manager_Styles|Template Manager (Styles)]], accessible via Extensions -> Template Manager.

Note you can create your template outside of Joomla and simply install it like any regular extension.

HINT: there are a couple of ways you can preview your index page as you put it together, either insert the styles into the head of the index page or directly link it to the style sheet you will be using temporarily. You can remove these links before packaging the file.

== Packaging the template for installation ==
{{:Packaging_a_extension/en}}

== Conclusion ==

You should now have created a template that works. It won't look like much yet. The best thing to do now is start experimenting with the layout.

<noinclude>
[[Category:Templates]]
[[Category:Tutorials]]
</noinclude>

Translations:Creating a basic Joomla! template/12/zh-tw

2016-06-13T16:51:28Z

Lai32290: Created page with "{{JVer|2.5}}版之後的語法如下。<code>version="2.5"</code> 更改了你安裝的 Joomla 的版本。"

{{JVer|2.5}}版之後的語法如下。<code>version="2.5"</code> 更改了你安裝的 Joomla 的版本。

Creating a basic Joomla! template/zh-tw

2016-06-13T16:48:53Z

Lai32290: Created page with "{{JVer|1.5}} 版的語法如下："

<noinclude><languages /></noinclude>
{{version/tutor|1.5,2.5,3.1}}{{JSplit}}
== 引言 ==

這篇教學的主要用意是作為一個創建 Joomla! 模板的介紹。將會包含創建基本模板所需要的基本檔案以及程式碼。所展示的程式碼可以複製、貼上來使用，但是也許會需要一些些的修改。

== 設置資料夾架構 ==
要創建最「基本」的模板，在 ''templates'' 裡面 '''新增一個資料夾'''。將資料夾名稱取為和你的模板名稱相同，這裡取為 ''mynewtemplate''。

使用你最喜歡的編輯器來新增 <code>index.php</code> 以及 <code>templateDetails.xml</code> 檔案。
為了方便整理，新增 '''2 個資料夾'''，將他們命名為 ''images'' 以及 ''css''。
在 ''css'' 資料夾裡面新增一個叫作 <code>template.css</code>的檔案。

雖然可以將你所有的 [[S:MyLanguage/Cascading Style Sheet (CSS)|CSS]] 直接放在 index.php 檔案的開頭，但是很多的網頁開發員都習慣將他們的CSS分開至別的檔案，這樣可以使用 <code>link</code> 標籤來將它們連接到多個頁面裡。將CSS放置分開的檔案也可以被新增到緩存裡，這樣可以縮短讀取網頁的時間。

這是最基本所需要的設置。資料夾以及檔案的架構如下：
* mynewtemplate/
** css/
*** template.css
** images/
** index.php
** templateDetails.xml

== 新增基本的 templateDetails.xml 檔案 ==
<tt>templateDetails.xml</tt> 檔案是必要的，沒有它的話，Joomla! 將會找不到你的模板。關於模板檔案裡的Key 的 [[Wikipedia:Metadata|metadata]]。

檔案的語法在每個版本的 Joomla 都不一樣。

{{JVer|1.5}} 版的語法如下：

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//EN" "http://www.joomla.org/xml/dtd/1.5/template-install.dtd">
<install version="1.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</install>
</source>

For {{JVer|2.5}} and later, use the following version. Change <code>version="2.5"</code> into the version of your Joomla! installation.

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension version="2.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</extension>
</source>

So, as you can see, we have a set of information between markup tags (the <code><element></code>s). Your best approach is to copy and paste this into your <tt>templateDetails.xml</tt> file and change the relevant bits (such as <code><name></code> and <code><author></code>).

The <code><files></code> part should contain all the files that you use - you possibly don't know what they are called yet - don't worry, update it later. The <code><folder></code> element can be used to define an entire folder at once.

Leave the positions as they are - these are a common set so you will be able to switch easily from the standard templates.

== Creating a basic index.php file ==
{{:Creating a basic index file/en}}

This leaves a final file of:

<source lang="php">
<?php defined('_JEXEC') or die('Restricted access');?>
<!DOCTYPE html>
<html xml:lang="<?php echo $this->language; ?>" lang="<?php echo $this->language; ?>" >
<head>
<jdoc:include type="head" />
<link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/<?php echo $this->template ?>/css/template.css" type="text/css" />
</head>
<body>
<jdoc:include type="modules" name="top" />
<jdoc:include type="component" />
<jdoc:include type="modules" name="bottom" />
</body>
</html>
</source>

== Testing the template ==
Find the template in the Template Manager, select it and click '''Default''' to make it the default template.

{{JVer|1.5}} In Joomla! 1.5, your new template will show up immediately in the [[Help15:Screen.templates.15|Template Manager]], accessible via Extensions -> Template Manager.

{{JVer|2.5}}+ In the Joomla! 2.5 series and later, you first need to tell Joomla! that you have created a new template. This feature is called ''Discover Extensions'' and can be accessed via Extensions -> Extension Manager -> Discover (i.e. the Discover ''tab''). Click '''Discover''' (i.e. the Discover ''button'') to discover your template, then select it and click '''Install''' to install it. Now your template should show up in the [[Help16:Extensions_Template_Manager_Styles|Template Manager (Styles)]], accessible via Extensions -> Template Manager.

Note you can create your template outside of Joomla and simply install it like any regular extension.

HINT: there are a couple of ways you can preview your index page as you put it together, either insert the styles into the head of the index page or directly link it to the style sheet you will be using temporarily. You can remove these links before packaging the file.

== Packaging the template for installation ==
{{:Packaging_a_extension/en}}

== Conclusion ==

You should now have created a template that works. It won't look like much yet. The best thing to do now is start experimenting with the layout.

<noinclude>
[[Category:Templates]]
[[Category:Tutorials]]
</noinclude>

Translations:Creating a basic Joomla! template/11/zh-tw

2016-06-13T16:48:52Z

Lai32290: Created page with "{{JVer|1.5}} 版的語法如下："

{{JVer|1.5}} 版的語法如下：

Creating a basic Joomla! template/zh-tw

2016-06-13T16:48:24Z

Lai32290: Created page with "檔案的語法在每個版本的 Joomla 都不一樣。"

<noinclude><languages /></noinclude>
{{version/tutor|1.5,2.5,3.1}}{{JSplit}}
== 引言 ==

這篇教學的主要用意是作為一個創建 Joomla! 模板的介紹。將會包含創建基本模板所需要的基本檔案以及程式碼。所展示的程式碼可以複製、貼上來使用，但是也許會需要一些些的修改。

== 設置資料夾架構 ==
要創建最「基本」的模板，在 ''templates'' 裡面 '''新增一個資料夾'''。將資料夾名稱取為和你的模板名稱相同，這裡取為 ''mynewtemplate''。

使用你最喜歡的編輯器來新增 <code>index.php</code> 以及 <code>templateDetails.xml</code> 檔案。
為了方便整理，新增 '''2 個資料夾'''，將他們命名為 ''images'' 以及 ''css''。
在 ''css'' 資料夾裡面新增一個叫作 <code>template.css</code>的檔案。

雖然可以將你所有的 [[S:MyLanguage/Cascading Style Sheet (CSS)|CSS]] 直接放在 index.php 檔案的開頭，但是很多的網頁開發員都習慣將他們的CSS分開至別的檔案，這樣可以使用 <code>link</code> 標籤來將它們連接到多個頁面裡。將CSS放置分開的檔案也可以被新增到緩存裡，這樣可以縮短讀取網頁的時間。

這是最基本所需要的設置。資料夾以及檔案的架構如下：
* mynewtemplate/
** css/
*** template.css
** images/
** index.php
** templateDetails.xml

== 新增基本的 templateDetails.xml 檔案 ==
<tt>templateDetails.xml</tt> 檔案是必要的，沒有它的話，Joomla! 將會找不到你的模板。關於模板檔案裡的Key 的 [[Wikipedia:Metadata|metadata]]。

檔案的語法在每個版本的 Joomla 都不一樣。

For {{JVer|1.5}}, use the following:

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//EN" "http://www.joomla.org/xml/dtd/1.5/template-install.dtd">
<install version="1.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</install>
</source>

For {{JVer|2.5}} and later, use the following version. Change <code>version="2.5"</code> into the version of your Joomla! installation.

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension version="2.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</extension>
</source>

So, as you can see, we have a set of information between markup tags (the <code><element></code>s). Your best approach is to copy and paste this into your <tt>templateDetails.xml</tt> file and change the relevant bits (such as <code><name></code> and <code><author></code>).

The <code><files></code> part should contain all the files that you use - you possibly don't know what they are called yet - don't worry, update it later. The <code><folder></code> element can be used to define an entire folder at once.

Leave the positions as they are - these are a common set so you will be able to switch easily from the standard templates.

== Creating a basic index.php file ==
{{:Creating a basic index file/en}}

This leaves a final file of:

<source lang="php">
<?php defined('_JEXEC') or die('Restricted access');?>
<!DOCTYPE html>
<html xml:lang="<?php echo $this->language; ?>" lang="<?php echo $this->language; ?>" >
<head>
<jdoc:include type="head" />
<link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/<?php echo $this->template ?>/css/template.css" type="text/css" />
</head>
<body>
<jdoc:include type="modules" name="top" />
<jdoc:include type="component" />
<jdoc:include type="modules" name="bottom" />
</body>
</html>
</source>

== Testing the template ==
Find the template in the Template Manager, select it and click '''Default''' to make it the default template.

{{JVer|1.5}} In Joomla! 1.5, your new template will show up immediately in the [[Help15:Screen.templates.15|Template Manager]], accessible via Extensions -> Template Manager.

{{JVer|2.5}}+ In the Joomla! 2.5 series and later, you first need to tell Joomla! that you have created a new template. This feature is called ''Discover Extensions'' and can be accessed via Extensions -> Extension Manager -> Discover (i.e. the Discover ''tab''). Click '''Discover''' (i.e. the Discover ''button'') to discover your template, then select it and click '''Install''' to install it. Now your template should show up in the [[Help16:Extensions_Template_Manager_Styles|Template Manager (Styles)]], accessible via Extensions -> Template Manager.

Note you can create your template outside of Joomla and simply install it like any regular extension.

HINT: there are a couple of ways you can preview your index page as you put it together, either insert the styles into the head of the index page or directly link it to the style sheet you will be using temporarily. You can remove these links before packaging the file.

== Packaging the template for installation ==
{{:Packaging_a_extension/en}}

== Conclusion ==

You should now have created a template that works. It won't look like much yet. The best thing to do now is start experimenting with the layout.

<noinclude>
[[Category:Templates]]
[[Category:Tutorials]]
</noinclude>

Translations:Creating a basic Joomla! template/10/zh-tw

2016-06-13T16:48:23Z

Lai32290: Created page with "檔案的語法在每個版本的 Joomla 都不一樣。"

檔案的語法在每個版本的 Joomla 都不一樣。

Creating a basic Joomla! template/zh-tw

2016-06-13T16:47:22Z

Lai32290: Created page with "<tt>templateDetails.xml</tt> 檔案是必要的，沒有它的話，Joomla! 將會找不到你的模板。關於模板檔案裡的Key 的 metadata。"

<noinclude><languages /></noinclude>
{{version/tutor|1.5,2.5,3.1}}{{JSplit}}
== 引言 ==

這篇教學的主要用意是作為一個創建 Joomla! 模板的介紹。將會包含創建基本模板所需要的基本檔案以及程式碼。所展示的程式碼可以複製、貼上來使用，但是也許會需要一些些的修改。

== 設置資料夾架構 ==
要創建最「基本」的模板，在 ''templates'' 裡面 '''新增一個資料夾'''。將資料夾名稱取為和你的模板名稱相同，這裡取為 ''mynewtemplate''。

使用你最喜歡的編輯器來新增 <code>index.php</code> 以及 <code>templateDetails.xml</code> 檔案。
為了方便整理，新增 '''2 個資料夾'''，將他們命名為 ''images'' 以及 ''css''。
在 ''css'' 資料夾裡面新增一個叫作 <code>template.css</code>的檔案。

雖然可以將你所有的 [[S:MyLanguage/Cascading Style Sheet (CSS)|CSS]] 直接放在 index.php 檔案的開頭，但是很多的網頁開發員都習慣將他們的CSS分開至別的檔案，這樣可以使用 <code>link</code> 標籤來將它們連接到多個頁面裡。將CSS放置分開的檔案也可以被新增到緩存裡，這樣可以縮短讀取網頁的時間。

這是最基本所需要的設置。資料夾以及檔案的架構如下：
* mynewtemplate/
** css/
*** template.css
** images/
** index.php
** templateDetails.xml

== 新增基本的 templateDetails.xml 檔案 ==
<tt>templateDetails.xml</tt> 檔案是必要的，沒有它的話，Joomla! 將會找不到你的模板。關於模板檔案裡的Key 的 [[Wikipedia:Metadata|metadata]]。

The syntax of the file is different for each Joomla version.

For {{JVer|1.5}}, use the following:

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//EN" "http://www.joomla.org/xml/dtd/1.5/template-install.dtd">
<install version="1.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</install>
</source>

For {{JVer|2.5}} and later, use the following version. Change <code>version="2.5"</code> into the version of your Joomla! installation.

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension version="2.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</extension>
</source>

So, as you can see, we have a set of information between markup tags (the <code><element></code>s). Your best approach is to copy and paste this into your <tt>templateDetails.xml</tt> file and change the relevant bits (such as <code><name></code> and <code><author></code>).

The <code><files></code> part should contain all the files that you use - you possibly don't know what they are called yet - don't worry, update it later. The <code><folder></code> element can be used to define an entire folder at once.

Leave the positions as they are - these are a common set so you will be able to switch easily from the standard templates.

== Creating a basic index.php file ==
{{:Creating a basic index file/en}}

This leaves a final file of:

<source lang="php">
<?php defined('_JEXEC') or die('Restricted access');?>
<!DOCTYPE html>
<html xml:lang="<?php echo $this->language; ?>" lang="<?php echo $this->language; ?>" >
<head>
<jdoc:include type="head" />
<link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/<?php echo $this->template ?>/css/template.css" type="text/css" />
</head>
<body>
<jdoc:include type="modules" name="top" />
<jdoc:include type="component" />
<jdoc:include type="modules" name="bottom" />
</body>
</html>
</source>

== Testing the template ==
Find the template in the Template Manager, select it and click '''Default''' to make it the default template.

{{JVer|1.5}} In Joomla! 1.5, your new template will show up immediately in the [[Help15:Screen.templates.15|Template Manager]], accessible via Extensions -> Template Manager.

{{JVer|2.5}}+ In the Joomla! 2.5 series and later, you first need to tell Joomla! that you have created a new template. This feature is called ''Discover Extensions'' and can be accessed via Extensions -> Extension Manager -> Discover (i.e. the Discover ''tab''). Click '''Discover''' (i.e. the Discover ''button'') to discover your template, then select it and click '''Install''' to install it. Now your template should show up in the [[Help16:Extensions_Template_Manager_Styles|Template Manager (Styles)]], accessible via Extensions -> Template Manager.

Note you can create your template outside of Joomla and simply install it like any regular extension.

HINT: there are a couple of ways you can preview your index page as you put it together, either insert the styles into the head of the index page or directly link it to the style sheet you will be using temporarily. You can remove these links before packaging the file.

== Packaging the template for installation ==
{{:Packaging_a_extension/en}}

== Conclusion ==

You should now have created a template that works. It won't look like much yet. The best thing to do now is start experimenting with the layout.

<noinclude>
[[Category:Templates]]
[[Category:Tutorials]]
</noinclude>

Translations:Creating a basic Joomla! template/9/zh-tw

2016-06-13T16:47:21Z

Lai32290: Created page with "<tt>templateDetails.xml</tt> 檔案是必要的，沒有它的話，Joomla! 將會找不到你的模板。關於模板檔案裡的Key 的 metadata。"

<tt>templateDetails.xml</tt> 檔案是必要的，沒有它的話，Joomla! 將會找不到你的模板。關於模板檔案裡的Key 的 [[Wikipedia:Metadata|metadata]]。

Creating a basic Joomla! template/zh-tw

2016-06-13T01:21:55Z

Lai32290: Created page with "== 新增基本的 templateDetails.xml 檔案 =="

<noinclude><languages /></noinclude>
{{version/tutor|1.5,2.5,3.1}}{{JSplit}}
== 引言 ==

這篇教學的主要用意是作為一個創建 Joomla! 模板的介紹。將會包含創建基本模板所需要的基本檔案以及程式碼。所展示的程式碼可以複製、貼上來使用，但是也許會需要一些些的修改。

== 設置資料夾架構 ==
要創建最「基本」的模板，在 ''templates'' 裡面 '''新增一個資料夾'''。將資料夾名稱取為和你的模板名稱相同，這裡取為 ''mynewtemplate''。

使用你最喜歡的編輯器來新增 <code>index.php</code> 以及 <code>templateDetails.xml</code> 檔案。
為了方便整理，新增 '''2 個資料夾'''，將他們命名為 ''images'' 以及 ''css''。
在 ''css'' 資料夾裡面新增一個叫作 <code>template.css</code>的檔案。

雖然可以將你所有的 [[S:MyLanguage/Cascading Style Sheet (CSS)|CSS]] 直接放在 index.php 檔案的開頭，但是很多的網頁開發員都習慣將他們的CSS分開至別的檔案，這樣可以使用 <code>link</code> 標籤來將它們連接到多個頁面裡。將CSS放置分開的檔案也可以被新增到緩存裡，這樣可以縮短讀取網頁的時間。

這是最基本所需要的設置。資料夾以及檔案的架構如下：
* mynewtemplate/
** css/
*** template.css
** images/
** index.php
** templateDetails.xml

== 新增基本的 templateDetails.xml 檔案 ==
The <tt>templateDetails.xml</tt> file is essential. Without it, your template won't be seen by Joomla!. The file holds key [[Wikipedia:Metadata|metadata]] about the template.

The syntax of the file is different for each Joomla version.

For {{JVer|1.5}}, use the following:

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//EN" "http://www.joomla.org/xml/dtd/1.5/template-install.dtd">
<install version="1.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</install>
</source>

For {{JVer|2.5}} and later, use the following version. Change <code>version="2.5"</code> into the version of your Joomla! installation.

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension version="2.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</extension>
</source>

So, as you can see, we have a set of information between markup tags (the <code><element></code>s). Your best approach is to copy and paste this into your <tt>templateDetails.xml</tt> file and change the relevant bits (such as <code><name></code> and <code><author></code>).

The <code><files></code> part should contain all the files that you use - you possibly don't know what they are called yet - don't worry, update it later. The <code><folder></code> element can be used to define an entire folder at once.

Leave the positions as they are - these are a common set so you will be able to switch easily from the standard templates.

== Creating a basic index.php file ==
{{:Creating a basic index file/en}}

This leaves a final file of:

<source lang="php">
<?php defined('_JEXEC') or die('Restricted access');?>
<!DOCTYPE html>
<html xml:lang="<?php echo $this->language; ?>" lang="<?php echo $this->language; ?>" >
<head>
<jdoc:include type="head" />
<link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/<?php echo $this->template ?>/css/template.css" type="text/css" />
</head>
<body>
<jdoc:include type="modules" name="top" />
<jdoc:include type="component" />
<jdoc:include type="modules" name="bottom" />
</body>
</html>
</source>

== Testing the template ==
Find the template in the Template Manager, select it and click '''Default''' to make it the default template.

{{JVer|1.5}} In Joomla! 1.5, your new template will show up immediately in the [[Help15:Screen.templates.15|Template Manager]], accessible via Extensions -> Template Manager.

{{JVer|2.5}}+ In the Joomla! 2.5 series and later, you first need to tell Joomla! that you have created a new template. This feature is called ''Discover Extensions'' and can be accessed via Extensions -> Extension Manager -> Discover (i.e. the Discover ''tab''). Click '''Discover''' (i.e. the Discover ''button'') to discover your template, then select it and click '''Install''' to install it. Now your template should show up in the [[Help16:Extensions_Template_Manager_Styles|Template Manager (Styles)]], accessible via Extensions -> Template Manager.

Note you can create your template outside of Joomla and simply install it like any regular extension.

HINT: there are a couple of ways you can preview your index page as you put it together, either insert the styles into the head of the index page or directly link it to the style sheet you will be using temporarily. You can remove these links before packaging the file.

== Packaging the template for installation ==
{{:Packaging_a_extension/en}}

== Conclusion ==

You should now have created a template that works. It won't look like much yet. The best thing to do now is start experimenting with the layout.

<noinclude>
[[Category:Templates]]
[[Category:Tutorials]]
</noinclude>

Translations:Creating a basic Joomla! template/8/zh-tw

2016-06-13T01:21:54Z

Lai32290: Created page with "== 新增基本的 templateDetails.xml 檔案 =="

== 新增基本的 templateDetails.xml 檔案 ==

Creating a basic Joomla! template/zh-tw

2016-06-13T01:21:26Z

Lai32290: Created page with "這是最基本所需要的設置。資料夾以及檔案的架構如下："

<noinclude><languages /></noinclude>
{{version/tutor|1.5,2.5,3.1}}{{JSplit}}
== 引言 ==

這篇教學的主要用意是作為一個創建 Joomla! 模板的介紹。將會包含創建基本模板所需要的基本檔案以及程式碼。所展示的程式碼可以複製、貼上來使用，但是也許會需要一些些的修改。

== 設置資料夾架構 ==
要創建最「基本」的模板，在 ''templates'' 裡面 '''新增一個資料夾'''。將資料夾名稱取為和你的模板名稱相同，這裡取為 ''mynewtemplate''。

使用你最喜歡的編輯器來新增 <code>index.php</code> 以及 <code>templateDetails.xml</code> 檔案。
為了方便整理，新增 '''2 個資料夾'''，將他們命名為 ''images'' 以及 ''css''。
在 ''css'' 資料夾裡面新增一個叫作 <code>template.css</code>的檔案。

雖然可以將你所有的 [[S:MyLanguage/Cascading Style Sheet (CSS)|CSS]] 直接放在 index.php 檔案的開頭，但是很多的網頁開發員都習慣將他們的CSS分開至別的檔案，這樣可以使用 <code>link</code> 標籤來將它們連接到多個頁面裡。將CSS放置分開的檔案也可以被新增到緩存裡，這樣可以縮短讀取網頁的時間。

這是最基本所需要的設置。資料夾以及檔案的架構如下：
* mynewtemplate/
** css/
*** template.css
** images/
** index.php
** templateDetails.xml

== Creating a basic templateDetails.xml file ==
The <tt>templateDetails.xml</tt> file is essential. Without it, your template won't be seen by Joomla!. The file holds key [[Wikipedia:Metadata|metadata]] about the template.

The syntax of the file is different for each Joomla version.

For {{JVer|1.5}}, use the following:

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//EN" "http://www.joomla.org/xml/dtd/1.5/template-install.dtd">
<install version="1.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</install>
</source>

For {{JVer|2.5}} and later, use the following version. Change <code>version="2.5"</code> into the version of your Joomla! installation.

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension version="2.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</extension>
</source>

So, as you can see, we have a set of information between markup tags (the <code><element></code>s). Your best approach is to copy and paste this into your <tt>templateDetails.xml</tt> file and change the relevant bits (such as <code><name></code> and <code><author></code>).

The <code><files></code> part should contain all the files that you use - you possibly don't know what they are called yet - don't worry, update it later. The <code><folder></code> element can be used to define an entire folder at once.

Leave the positions as they are - these are a common set so you will be able to switch easily from the standard templates.

== Creating a basic index.php file ==
{{:Creating a basic index file/en}}

This leaves a final file of:

<source lang="php">
<?php defined('_JEXEC') or die('Restricted access');?>
<!DOCTYPE html>
<html xml:lang="<?php echo $this->language; ?>" lang="<?php echo $this->language; ?>" >
<head>
<jdoc:include type="head" />
<link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/<?php echo $this->template ?>/css/template.css" type="text/css" />
</head>
<body>
<jdoc:include type="modules" name="top" />
<jdoc:include type="component" />
<jdoc:include type="modules" name="bottom" />
</body>
</html>
</source>

== Testing the template ==
Find the template in the Template Manager, select it and click '''Default''' to make it the default template.

{{JVer|1.5}} In Joomla! 1.5, your new template will show up immediately in the [[Help15:Screen.templates.15|Template Manager]], accessible via Extensions -> Template Manager.

{{JVer|2.5}}+ In the Joomla! 2.5 series and later, you first need to tell Joomla! that you have created a new template. This feature is called ''Discover Extensions'' and can be accessed via Extensions -> Extension Manager -> Discover (i.e. the Discover ''tab''). Click '''Discover''' (i.e. the Discover ''button'') to discover your template, then select it and click '''Install''' to install it. Now your template should show up in the [[Help16:Extensions_Template_Manager_Styles|Template Manager (Styles)]], accessible via Extensions -> Template Manager.

Note you can create your template outside of Joomla and simply install it like any regular extension.

HINT: there are a couple of ways you can preview your index page as you put it together, either insert the styles into the head of the index page or directly link it to the style sheet you will be using temporarily. You can remove these links before packaging the file.

== Packaging the template for installation ==
{{:Packaging_a_extension/en}}

== Conclusion ==

You should now have created a template that works. It won't look like much yet. The best thing to do now is start experimenting with the layout.

<noinclude>
[[Category:Templates]]
[[Category:Tutorials]]
</noinclude>

Translations:Creating a basic Joomla! template/7/zh-tw

2016-06-13T01:21:26Z

Lai32290: Created page with "這是最基本所需要的設置。資料夾以及檔案的架構如下："

這是最基本所需要的設置。資料夾以及檔案的架構如下：

Creating a basic Joomla! template/zh-tw

2016-06-13T01:17:32Z

Lai32290:

<noinclude><languages /></noinclude>
{{version/tutor|1.5,2.5,3.1}}{{JSplit}}
== 引言 ==

這篇教學的主要用意是作為一個創建 Joomla! 模板的介紹。將會包含創建基本模板所需要的基本檔案以及程式碼。所展示的程式碼可以複製、貼上來使用，但是也許會需要一些些的修改。

== 設置資料夾架構 ==
要創建最「基本」的模板，在 ''templates'' 裡面 '''新增一個資料夾'''。將資料夾名稱取為和你的模板名稱相同，這裡取為 ''mynewtemplate''。

使用你最喜歡的編輯器來新增 <code>index.php</code> 以及 <code>templateDetails.xml</code> 檔案。
為了方便整理，新增 '''2 個資料夾'''，將他們命名為 ''images'' 以及 ''css''。
在 ''css'' 資料夾裡面新增一個叫作 <code>template.css</code>的檔案。

雖然可以將你所有的 [[S:MyLanguage/Cascading Style Sheet (CSS)|CSS]] 直接放在 index.php 檔案的開頭，但是很多的網頁開發員都習慣將他們的CSS分開至別的檔案，這樣可以使用 <code>link</code> 標籤來將它們連接到多個頁面裡。將CSS放置分開的檔案也可以被新增到緩存裡，這樣可以縮短讀取網頁的時間。

This is the most basic practical setup. Outline of folder and file structure:
* mynewtemplate/
** css/
*** template.css
** images/
** index.php
** templateDetails.xml

== Creating a basic templateDetails.xml file ==
The <tt>templateDetails.xml</tt> file is essential. Without it, your template won't be seen by Joomla!. The file holds key [[Wikipedia:Metadata|metadata]] about the template.

The syntax of the file is different for each Joomla version.

For {{JVer|1.5}}, use the following:

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//EN" "http://www.joomla.org/xml/dtd/1.5/template-install.dtd">
<install version="1.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</install>
</source>

For {{JVer|2.5}} and later, use the following version. Change <code>version="2.5"</code> into the version of your Joomla! installation.

<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<extension version="2.5" type="template">
<name>mynewtemplate</name>
<creationDate>2008-05-01</creationDate>
<author>John Doe</author>
<authorEmail>john@example.com</authorEmail>
<authorUrl>http://www.example.com</authorUrl>
<copyright>John Doe 2008</copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>My New Template</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<folder>images</folder>
<folder>css</folder>
</files>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
</positions>
</extension>
</source>

So, as you can see, we have a set of information between markup tags (the <code><element></code>s). Your best approach is to copy and paste this into your <tt>templateDetails.xml</tt> file and change the relevant bits (such as <code><name></code> and <code><author></code>).

The <code><files></code> part should contain all the files that you use - you possibly don't know what they are called yet - don't worry, update it later. The <code><folder></code> element can be used to define an entire folder at once.

Leave the positions as they are - these are a common set so you will be able to switch easily from the standard templates.

== Creating a basic index.php file ==
{{:Creating a basic index file/en}}

This leaves a final file of:

<source lang="php">
<?php defined('_JEXEC') or die('Restricted access');?>
<!DOCTYPE html>
<html xml:lang="<?php echo $this->language; ?>" lang="<?php echo $this->language; ?>" >
<head>
<jdoc:include type="head" />
<link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/<?php echo $this->template ?>/css/template.css" type="text/css" />
</head>
<body>
<jdoc:include type="modules" name="top" />
<jdoc:include type="component" />
<jdoc:include type="modules" name="bottom" />
</body>
</html>
</source>

== Testing the template ==
Find the template in the Template Manager, select it and click '''Default''' to make it the default template.

{{JVer|1.5}} In Joomla! 1.5, your new template will show up immediately in the [[Help15:Screen.templates.15|Template Manager]], accessible via Extensions -> Template Manager.

{{JVer|2.5}}+ In the Joomla! 2.5 series and later, you first need to tell Joomla! that you have created a new template. This feature is called ''Discover Extensions'' and can be accessed via Extensions -> Extension Manager -> Discover (i.e. the Discover ''tab''). Click '''Discover''' (i.e. the Discover ''button'') to discover your template, then select it and click '''Install''' to install it. Now your template should show up in the [[Help16:Extensions_Template_Manager_Styles|Template Manager (Styles)]], accessible via Extensions -> Template Manager.

Note you can create your template outside of Joomla and simply install it like any regular extension.

HINT: there are a couple of ways you can preview your index page as you put it together, either insert the styles into the head of the index page or directly link it to the style sheet you will be using temporarily. You can remove these links before packaging the file.

== Packaging the template for installation ==
{{:Packaging_a_extension/en}}

== Conclusion ==

You should now have created a template that works. It won't look like much yet. The best thing to do now is start experimenting with the layout.

<noinclude>
[[Category:Templates]]
[[Category:Tutorials]]
</noinclude>