Themes and XHTML - Revision history

Roccivic at 13:40, 15 April 2012

2012-04-15T13:40:05Z

LWC: /* XHTML Constant */ Fixed spelling

2010-01-24T23:00:47Z

‎XHTML Constant: Fixed spelling

Dirk: Wikipedia link - too lazy to explain what XHTML is ;-)

2010-01-24T17:29:39Z

Wikipedia link - too lazy to explain what XHTML is ;-)

Dirk: Plugins, Professional theme

2010-01-24T17:28:16Z

Plugins, Professional theme

Dirk: Corrections

2010-01-24T17:19:11Z

Corrections

Dirk: Themes and XHTML

2010-01-24T17:13:26Z

Themes and XHTML

New page

Since version 1.5.0, Geeklog supports XHTML compliant themes. This means that Geeklog will automatically create XHTML compliant tags when required.

== Switching to XHTML ==

Whether Geeklog will switch to XHTML compliant mode or not depends on the definition of a <tt>XHTML</tt> variable in the PHP code. This variable can either be defined by the theme (in the theme's <tt>functions.php</tt> file) or by selecting an XHTML DOCTYPE from the Configuation (since Geeklog 1.6.0):

Configuration > Geeklog > Theme > Theme > [http://www.geeklog.net/docs/english/config.html#desc_doctype DOCTYPE Declaration]

Selecting an XHTML DOCTYPE will automatically set the <tt>XHTML</tt> properly (any definition made by the theme still takes preference, though, so make sure the two don't conflict).

== XHTML Constant and Template Variable ==

For an XHTML compliant theme, the <tt>XHTML</tt> constant should be defined like so:

<pre>define('XHTML', ' /');</pre>

Otherwise, the constant will be defined as an empty string:

<pre>define('XHTML', '');</pre>

The definition of the <tt>XHTML</tt> constant will also be available as a <tt>{xhtml}</tt> template variable in all template files used by Geeklog. This way, it is possible to create themes that will work both as XHTML and "plain" HTML by using the template variable for tags that have to be closed in XHTML, e.g.

<pre><br{xhtml}>
<input type="submit" name="test"{xhtml}>
<img src="image.png" alt=""{xhtml}></pre>

== Other Template Variables ==

Themes that are written to be both valid HTML and XHTML (as described above) should use the <tt>{doctype}</tt> variable as the first line in <tt>header.thtml</tt> instead of hard-coding the DOCTYPE.

In XHTML mode, Geeklog will also provide a <tt>{xmlns}</tt> variable that will contain the <tt>xmlns</tt> attribute for the <tt>html</tt> element.

Putting it all together, the first 3 lines of your theme's <tt>header.thtml</tt> should look like this:

<pre>{doctype}
<html{lang_attribute}{xmlns}>
<head></pre>

The <tt>{lang_attribute}</tt> will set a <tt>lang</tt> attribute in multi-language setups.

[[Category:Themes]]

← Older revision		Revision as of 13:40, 15 April 2012
Line 2:		Line 2:

	== Switching to XHTML ==		== Switching to XHTML ==
		+
		+	Since Geeklog 2.0, you must specify a doctype for your theme, if you wish for your theme to be XHTML compliant.
		+	This is done in the functions.php file by implementing the function theme_config_yourThemeName() method, for example, for a theme called foobar this would look like:
		+
		+	function theme_config_foobar()
		+	{
		+	return array(
		+	'doctype' => 'xhtml10strict'
		+	);
		+	}
		+
		+	Valid XHTML doctypes are:
		+
		+	* xhtml10transitional
		+	* xhtml10strict
		+
		+	== Switching to XHTML in Geeklog < 2.0 ==

	Whether Geeklog will switch to XHTML compliant mode or not depends on the definition of an <tt>XHTML</tt> variable in the PHP code. This variable can either be defined by the theme (in the theme's <tt>functions.php</tt> file) or by selecting an XHTML DOCTYPE from the Configuation (since Geeklog 1.6.0):		Whether Geeklog will switch to XHTML compliant mode or not depends on the definition of an <tt>XHTML</tt> variable in the PHP code. This variable can either be defined by the theme (in the theme's <tt>functions.php</tt> file) or by selecting an XHTML DOCTYPE from the Configuation (since Geeklog 1.6.0):

@@ Line 19: / Line 19: @@
 <pre>define('XHTML', '');</pre>
-Plugins can simply use the <tt>XHTML</tt> constant - Geeklog will take care that is always defined. The same is true for code in <tt>lib-custom.php</tt>, with the exception of code that is not located in a function (since <tt>lib-custom.php</tt> wil be included before the theme, and any global code in <tt>lib-custom.php</tt> would therefore be executed before the constant is defined).
+Plugins can simply use the <tt>XHTML</tt> constant - Geeklog will take care that is always defined. The same is true for code in <tt>lib-custom.php</tt>, with the exception of code that is not located in a function (since <tt>lib-custom.php</tt> will be included before the theme, and any global code in <tt>lib-custom.php</tt> would therefore be executed before the constant is defined).
 == Template Variables ==

← Older revision		Revision as of 17:29, 24 January 2010
Line 1:		Line 1:
−	Since version 1.5.0, Geeklog supports XHTML compliant themes. This means that Geeklog will automatically create XHTML compliant tags when required.	+	Since version 1.5.0, Geeklog supports [http://en.wikipedia.org/wiki/XHTML XHTML] compliant themes. This means that Geeklog will automatically create XHTML compliant tags when required.

	== Switching to XHTML ==		== Switching to XHTML ==

@@ Line 9: / Line 9: @@
 Selecting an XHTML DOCTYPE will automatically set the <tt>XHTML</tt> constant properly (any definition made by the theme still takes precedence, though, so make sure the two don't conflict).
-== XHTML Constant and Template Variable ==
+== XHTML Constant ==
 For an XHTML compliant theme, the <tt>XHTML</tt> constant should be defined like so:
@@ Line 19: / Line 19: @@
 <pre>define('XHTML', '');</pre>
-The definition of the <tt>XHTML</tt> constant will also be available as a <tt>{xhtml}</tt> template variable in all template files used by Geeklog. This way, it is possible to create themes that will work both as XHTML and "plain" HTML by using the template variable for tags that have to be closed in XHTML, e.g.
+Plugins can simply use the <tt>XHTML</tt> constant - Geeklog will take care that is always defined. The same is true for code in <tt>lib-custom.php</tt>, with the exception of code that is not located in a function (since <tt>lib-custom.php</tt> wil be included before the theme, and any global code in <tt>lib-custom.php</tt> would therefore be executed before the constant is defined).
 <pre><br{xhtml}>
@@ Line 25: / Line 29: @@
 <img src="image.png" alt=""{xhtml}></pre>
-== Other Template Variables ==
+=== Other Template Variables ===
 Themes that are written to be both valid HTML and XHTML (as described above) should use the <tt>{doctype}</tt> variable as the first line in <tt>header.thtml</tt> instead of hard-coding the DOCTYPE.
@@ Line 38: / Line 42: @@
 The <tt>{lang_attribute}</tt> will set a <tt>lang</tt> attribute in [[Multilingual Support|multi-language setups]].
 [[Category:Themes]]

@@ Line 3: / Line 3: @@
 == Switching to XHTML ==
-Whether Geeklog will switch to XHTML compliant mode or not depends on the definition of a <tt>XHTML</tt> variable in the PHP code. This variable can either be defined by the theme (in the theme's <tt>functions.php</tt> file) or by selecting an XHTML DOCTYPE from the Configuation (since Geeklog 1.6.0):
+Whether Geeklog will switch to XHTML compliant mode or not depends on the definition of an <tt>XHTML</tt> variable in the PHP code. This variable can either be defined by the theme (in the theme's <tt>functions.php</tt> file) or by selecting an XHTML DOCTYPE from the Configuation (since Geeklog 1.6.0):
-Configuration > Geeklog > Theme > Theme > [http://www.geeklog.net/docs/english/config.html#desc_doctype DOCTYPE Declaration]
+: Configuration > Geeklog > Theme > Theme > [http://www.geeklog.net/docs/english/config.html#desc_doctype DOCTYPE Declaration]
-Selecting an XHTML DOCTYPE will automatically set the <tt>XHTML</tt> properly (any definition made by the theme still takes preference, though, so make sure the two don't conflict).
+Selecting an XHTML DOCTYPE will automatically set the <tt>XHTML</tt> constant properly (any definition made by the theme still takes precedence, though, so make sure the two don't conflict).
 == XHTML Constant and Template Variable ==
@@ Line 37: / Line 37: @@
 <head></pre>
-The <tt>{lang_attribute}</tt> will set a <tt>lang</tt> attribute in multi-language setups.
+The <tt>{lang_attribute}</tt> will set a <tt>lang</tt> attribute in [[Multilingual Support|multi-language setups]].
 [[Category:Themes]]