TemplateAnatomy - Revision history

FunPika: added Category:Development using HotCat

2014-03-15T15:40:31Z

← Older revision		Revision as of 15:40, 15 March 2014
Line 118:		Line 118:

	Some of these including the template tutorial listed top of this page, with wiki pages.		Some of these including the template tutorial listed top of this page, with wiki pages.

			[[Category:Development]]

50.45.173.59 at 17:24, 28 February 2014

2014-02-28T17:24:07Z

Show changes

50.45.173.59 at 17:13, 28 February 2014

2014-02-28T17:13:46Z

← Older revision		Revision as of 17:13, 28 February 2014
Line 1:		Line 1:
	[[CssWork]] - parent of these pages		[[CssWork]] - parent of these pages
	<br>[[ThemesAnatomy]] - parent of this page		<br>[[ThemesAnatomy]] - parent of this page

			<h2>Index of Template pages</h2>

			* From Template library man pages
			** [[TemplateTutorialWeb]]

	<h2>Official docs for templates from docs/HOWTO-Templates.pod</h2>		<h2>Official docs for templates from docs/HOWTO-Templates.pod</h2>

50.45.173.59 at 18:21, 27 February 2014

2014-02-27T18:21:34Z

Show changes

50.45.172.110 at 07:03, 21 February 2014

2014-02-21T07:03:07Z

← Older revision		Revision as of 07:03, 21 February 2014
Line 49:		Line 49:

	<h4>How do I generate a blank template?</h4>		<h4>How do I generate a blank template?</h4>
			<pre>
	Use template-tool:		Use template-tool:

	template-tool -g filename		template-tool -g filename
			</pre>

			<h4>Can I set my own Template options?</h4>
	</h4>Can I set my own Template options?</h4>

	You can change some of the configuration options of Template,		You can change some of the configuration options of Template,

50.45.172.110 at 06:59, 21 February 2014

2014-02-21T06:59:58Z

← Older revision		Revision as of 06:59, 21 February 2014
Line 3:		Line 3:

	<h2>Official docs for templates from docs/HOWTO-Templates.pod</h2>		<h2>Official docs for templates from docs/HOWTO-Templates.pod</h2>
	~~<pre>~~
	HOWTO-Templates - How to write Slash templates		HOWTO-Templates - How to write Slash templates

50.45.172.110 at 22:54, 20 February 2014

2014-02-20T22:54:07Z

← Older revision		Revision as of 22:54, 20 February 2014
Line 2:		Line 2:
	<br>[[ThemesAnatomy]] - parent of this page		<br>[[ThemesAnatomy]] - parent of this page

	<h2>Official docs for ~~themes~~ from docs/HOWTO-Templates.pod</h2>		<h2>Official docs for templates from docs/HOWTO-Templates.pod</h2>
	<pre>		<pre>
	HOWTO-Templates - How to write Slash templates		HOWTO-Templates - How to write Slash templates

50.45.172.110 at 22:52, 20 February 2014

2014-02-20T22:52:14Z

← Older revision		Revision as of 22:52, 20 February 2014
Line 1:		Line 1:
	[[CssWork]] - parent of these pages		[[CssWork]] - parent of these pages
	<br>[[ThemesAnatomy]] - parent of this page		<br>[[ThemesAnatomy]] - parent of this page

			<h2>Official docs for themes from docs/HOWTO-Templates.pod</h2>
			<pre>
			HOWTO-Templates - How to write Slash templates

			<h3>QUESTIONS</h3>

			<h4>What is a template?</h4>

			A template is a bit of text that is parsed by Perl, using the Template
			Toolkit. Template Toolkit has support for variables, control structures,
			and more. It is more easily understood and edited by non-programmers
			than is Perl, and it is much safer than executing raw Perl code.

			Templates are compiled into Perl functions and the resulting compiled
			code is cached. Templates are fast and convenient and easy.

			For more information on how templates are written, see the man pages
			for Slash::Display and Template, and the Template Toolkit web page
			at E<lt>URL:http://www.template-toolkit.org/E<gt>.

			<h4> How do I get my template into a running site?</h4>

			Use the Template Editor via the admin menu on the site, or use
			template-tool on the command line. You can find out information
			on it by calling it with the "-h" option.


			<h4> How do I get my template installed with a plugin/theme?</h4>

			For a plugin it has to be added to the PLUGIN file (see
			F<HOWTO-Plugins>). For a theme it just needs to be in the templates
			directory for the theme (see F<HOWTO-Themes>).


			<h4> What language encoding are the templates using?</h4>

			There is a language field for templates, which is, by
			default, "en_US". However, it is not currently used by the
			code. We have not entirely decided how to handle languages yet.

			Currently, the language is based on the same method used to determine
			locales on Unix: two-letter, lowercase, ISO 639 codes for language;
			two-letter, uppercase, ISO 3166 codes for country; joined with an
			underscore. e.g., en_US, en_CA, de_DE, zh_CN, ja_JP.


			<h4>How do I generate a blank template?</h4>

			Use template-tool:

			template-tool -g filename


			</h4>Can I set my own Template options?</h4>

			You can change some of the configuration options of Template,
			(PRE_CHOMP, POST_CHOMP, and CACHE_SIZE) via the vars table.
			Most options cannot be changed, however, except by editing
			the Slash::Display module directly.


			<h4>What can I do about whitespace between template tags?</h4>

			The TRIM option (which removes whitespace before and after templates)
			is on by default. Many things in Slash will fail if TRIM is not true,
			because it is expected that whitespace will be removed before and after
			a returned template.

			PRE_CHOMP and POST_CHOMP (which remove whitespace before and
			after individual tags) are off by default, but may be turned on
			via the template_pre_chomp and template_post_chomp entries in the vars
			table. In an upcoming version of Template, there will be a third
			option, other than just "on" and "off": "collapse". This will
			collapse whitespace between tags down to a single space, and will
			most likely be ideal for use in Slash, since runs of whitespace in HTML
			is the same as a single space, in most situations.

			You can enable and disable chomping of whitespace for individual
			tags with "+" and "-". To enable chomping, write a tag like this:
			<pre>
			[% num %] comment
			[%- IF num != 1 ; 's' ; END %]
			</pre>
			That will push the "s" character up against the end of "comment",
			if it is printed.

			If CHOMP is enabled, you can disable it in the same way, with "+"
			instead of "-". See L<Template::Parser>.


			<h4>I have a really cool template for a theme/plugin, and I would like to see it added to the Slash distribution. Will you distribute mine?</h4>

			Maybe. We don't have any rules concerning this at the moment, so it will be
			on a case by case basis. At some point in the future we will come up
			with a much better answer. If the theme or plugin is one not included with
			the Slash distribution, you should contact the theme's or plugin's creator
			directly.

			<h3> SEE ALSO</h3>

			Slash::Display(3).

50.45.172.110 at 22:44, 20 February 2014

2014-02-20T22:44:14Z

← Older revision		Revision as of 22:44, 20 February 2014
Line 1:		Line 1:
	[[CssWork]] - parent of these pages		[[CssWork]] - parent of these pages
	<br>[[~~ThemeAnatomy~~]] - parent of this page		<br>[[ThemesAnatomy]] - parent of this page

50.45.172.110 at 22:43, 20 February 2014

2014-02-20T22:43:40Z

← Older revision		Revision as of 22:43, 20 February 2014
Line 1:		Line 1:
	[[CssWork]] - parent of these pages		[[CssWork]] - parent of these pages
	[[ThemeAnatomy]] - parent of this page		<br>[[ThemeAnatomy]] - parent of this page