Template:Script doc auto - Revision history

Iritscen: +docs

2011-06-14T20:43:00Z

+docs

← Older revision		Revision as of 20:43, 14 June 2011
Line 8:		Line 8:
	\| pagelen = {{#len:{{FULLPAGENAME}} }}		\| pagelen = {{#len:{{FULLPAGENAME}} }}
	}}		}}
	}}<noinclude>		}}<noinclude>'''Script doc auto''' is a clever system composed of this template page, two subpages ([[Template:Script doc auto/core\|/core]] and [[Template:Script doc auto/core2\|/core2]]), and the built-in MediaWiki page [[MediaWiki:Clearyourcache\|Clearyourcache]], designed to automatically lead the reader to documentation for code pages (.css and .js pages) on the wiki. The idea behind the design is that you never have to place this template anywhere; the Clearyourcache page, which is already hardcoded to appear on code pages, will transclude this template if the namespace is MediaWiki. (Code pages can also appear in the User namespace, but we don't need to encourage documentation for personalized code, so we screen for just the MediaWiki namespace.)

			The template uses ParserFunctions' string functions to look at the name of the page and search for sister pages and docs pages, and display a link to them in a message box above the code. For instance, the page [[MediaWiki:Common.css]] will link to its sister page, [[MediaWiki:Common.js]], as well as the docs page. If there is no docs page, you will be given a redlink for making one. (The template is basically enforcing a system whereby a .js or .css page is documented on a page with the same address as the code page, minus the suffix.)

			Why go through all this trouble? On an ordinary page, including a template page, you would simply put the documentation right on the page inside <nowiki><noinclude></nowiki> tags or transclude it from a /doc page, but that's not possible on a code page. This system gets around the limitation by piggy-backing on the existing "Clear your cache" header message in the MediaWiki software.

			P.S.: A hidden ability of this template is that, if you desire, you can transclude it manually somewhere and pass it a "page=pagename" parameter, and it will run the same checks and present the same messages, but for the page that you supplied the name of, not the page the template is on.
	[[Category:Header and footer templates]]		[[Category:Header and footer templates]]
	</noinclude>		</noinclude>

Iritscen: hmm, let's call 'str len' an alternate way

2011-06-02T20:14:22Z

hmm, let's call 'str len' an alternate way

← Older revision		Revision as of 20:14, 2 June 2011
Line 2:		Line 2:
	\| {{script doc auto/core		\| {{script doc auto/core
	\| page = {{{page\|}}}		\| page = {{{page\|}}}
	\| pagelen = {{~~str~~ len\| {{{page\|}}} }}		\| pagelen = {{#len:{{{page\|}}} }}
	}}		}}
	\| {{script doc auto/core		\| {{script doc auto/core
	\| page = {{FULLPAGENAME}}		\| page = {{FULLPAGENAME}}
	\| pagelen = {{~~str~~ len\| {{FULLPAGENAME}} }}		\| pagelen = {{#len:{{FULLPAGENAME}} }}
	}}		}}
	}}<noinclude>		}}<noinclude>
	[[Category:Header and footer templates]]		[[Category:Header and footer templates]]
	</noinclude>		</noinclude>

Iritscen: Undo revision 18056 by Iritscen (Talk)

2011-05-31T12:30:06Z

Undo revision 18056 by Iritscen (Talk)

← Older revision		Revision as of 12:30, 31 May 2011
Line 9:		Line 9:
	}}		}}
	}}<noinclude>		}}<noinclude>
			[[Category:Header and footer templates]]
	</noinclude>		</noinclude>

Iritscen at 12:29, 31 May 2011

2011-05-31T12:29:44Z

← Older revision		Revision as of 12:29, 31 May 2011
Line 9:		Line 9:
	}}		}}
	}}<noinclude>		}}<noinclude>
	~~[[Category:Header and footer templates]]~~
	</noinclude>		</noinclude>

Iritscen: Created page with '{{#if: {{{page|}}} | {{script doc auto/core | page = {{{page|}}} | pagelen = {{str len| {{{page|}}} }} }} | {{script doc auto/core | page = {{FULLPAGENAME}} | pagelen =…'

2011-05-31T12:19:25Z

Created page with '{{#if: {{{page|}}} | {{script doc auto/core | page = {{{page|}}} | pagelen = {{str len| {{{page|}}} }} }} | {{script doc auto/core | page = {{FULLPAGENAME}} | pagelen =…'

New page

{{#if: {{{page|}}}
| {{script doc auto/core
| page = {{{page|}}}
| pagelen = {{str len| {{{page|}}} }}
}}
| {{script doc auto/core
| page = {{FULLPAGENAME}}
| pagelen = {{str len| {{FULLPAGENAME}} }}
}}
}}<noinclude>
[[Category:Header and footer templates]]
</noinclude>