View source for Template:Split portions/doc

{{Documentation subpage}}
This template is for splitting out content that may be integrated throughout an page, article, or a section thereof; but would be more relevant as a separate page or multiple pages, and should be relocated there, leaving the relevant content in the original page.

This template is useful especially since its parameters offer you options which all other splitting templates do, hence we do not need to transclude the additional six others on our wiki.

== Usage ==

# At the top of the page to split the content from, put {{tlx|Split portions |date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}&nbsp;|{{var|Title to which to relocate the content}}}}.
# If there is more than one suggested title to which to relocate the content, include each: {{tlx|Split portions |date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}&nbsp;|{{var|First target title}}&nbsp;|{{var|Second target title}}}}. Up to 20 articles (already existing or not) can be specified.
# This template is mostly used to suggest splits to {{em|new}} pages. If any of the suggested target pages already exists, then at the top of it put {{tlx|Merge portions from |date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}&nbsp;|{{var|Title of article to split the content from}}}}.
*See also the {{para|portion}} and {{para|discuss}} parameters. 

{{strong|You are encouraged to be specific}}: The {{para|portion}} (or {{para|portions}}) parameter allows you to replace the word "portions" with something more specific. Examples:
* {{tlx|Split portions |'''portion{{=}}the material about book/comic and film/TV characters'''&nbsp;|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}&nbsp;|List of fictional hedgehogs}}.
* {{tlx|Split portions |'''portions{{=}}the details about specific Gothic peoples'''&nbsp;|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}&nbsp;|Art of the Visigoths&nbsp;|Art of the Ostrogoths}}
The parameter {{para|small|y}} will reduce the size of the template to a left-hand box instead of a banner.

This template will add articles (but not other pages) to [[:Category:All articles to be split]] and the proper dated subcategory of [[:Category:Articles to be split]].

=== For sections only ===

If portions of one section need to be split out, use {{tlx|Split portions}} at the top of that section, and use the {{para|section|y}} parameter: {{tlx|Split portions |'''section{{=}}y'''&nbsp;|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}&nbsp;|{{var|Title to which to relocate the content}}}}. This will change the wording to "portions of this section". This can be done at two or more places in the article to suggest multiple specific splits, instead of a more vague multi-split template at the top of the article.
{{Split portions |section=y |date=November 2015 |Title to which to relocate the content|demopage=y}}

If portions of several subsections of a single section need to relocate, leaving the rest of the section in place, you can put the template at the top of that section, and use the {{para|subsections|y}} parameter (or {{para|section|y}}{{para|sections|y}}, which has the same effect): {{tlx|Split portions |'''subsections{{=}}y'''&nbsp;|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}&nbsp;|{{var|Title to which to relocate the content}}}}. This will change the wording to "subsections of this section".

'''However, if will probably be more helpful to use {{para|section}}, and use a separate template in each of the subsections to be split.'''
{{Split portions |subsections=y |date=November 2015 |Title to which to relocate the content|demopage=y}}

If a proposed section split (whole or partial) is to more than one page, use: {{tlx|Split portions |'''portion{{=}}this section'''&nbsp;|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}&nbsp;|{{var|First title to which to relocate the content}}&nbsp;|{{var|Second title to which to relocate the content}}}}
{{Split portions |portion=this section |date=November 2015 |First title to which to relocate the content |Second title to which to relocate the content|demopage=y}}

If multiple sections or portions thereof need to be split out, you can put the template at the top of the page, and use the {{para|sections|y}} parameter: {{tlx|Split portions |'''sections{{=}}y'''&nbsp;|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}&nbsp;|{{var|Title to which to relocate the content}}}}. This will change the wording to "sections of this article" (or "sections of this page", in other namespaces).
{{Split portions |sections=y |date=November 2015 |Title to which to relocate the content|demopage=y}}
{{em|This is usually the least desirable option}} because of its vagueness, and it will probably be more helpful to tag each of the subsections to be split, with either {{tlx|Split portions |section{{y}} |...}} (partial) or <s>{{tlx|Split section |...}} (whole section)</s>. Use this template for splitting sections as well.

The {{para|sections}} and {{para|subsections}} options will, when used in mainspace, also categorize the split-from article into the proper dated subcategory of [[:Category:Article sections to be split]]. Hence, there is no need to add additional split templates, when this one already does the same thing.

=== Merging into existing pages ===

Instead, the {{para|existing}} parameter of this template can be used, with {{para|sections}}:

{{in5}}{{tlx|Split portions|existing{{=}}y|portions{{=}}sections "Foo", "Bar", and "Baz"|Article Foo|Article Bar|Article Baz}}
{{Split portions|existing=y|portions=sections "Foo", "Bar", and "Baz"|Article Foo|Article Bar|Article Baz|demopage=y}}

{{in5}}{{tlx|Split portions|existing{{=}}y|portions{{=}}sections about Foo|Article Foo}}
{{Split portions|existing=y|portions=sections about Foo|Article Foo|demopage=y}}

== Recommended Addition ==

When splitting large amounts of a page, you should probably inform other readers of this change, in the form of another template, which should hopefully be visible after I've transcluded it. However, do keep in mind that the Copied ''"Template"'' is just an invocation of a Lua Module. As such, only use it when absolutely necessary.

{{#invoke:Copied|main}}

== TemplateData ==
{{TemplateData header}}
<templatedata>
{
	"description": "Use this template to suggest that portions of this article be split out into another article.",
	"format": "inline",
	"params": {
		"date": {
			"label": "Month and year",
			"description": "The month and year that the template was placed (in full). \"{{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}\" inserts the current month and year automatically.",
			"type": "line",
			"autovalue": "{{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}",
			"example": "January 2013",
			"suggested": true
		},
		"1": {
			"label": "First new page title",
			"type": "string",
			"required": true
		},
		"2": {
			"label": "Second new page title",
			"type": "string",
			"suggested": true
		},
		"3": {
			"label": "Third new page title",
			"type": "string"
		},
		"4": {
			"label": "Fourth new page title",
			"type": "string"
		},
		"5": {
			"label": "Fifth new page title",
			"type": "string"
		},
		"6": {
			"label": "Sixth new page title",
			"type": "string"
		},
		"7": {
			"label": "Seventh new page title",
			"type": "string"
		},
		"8": {
			"label": "Eighth new page title",
			"type": "string"
		},
		"9": {
			"label": "Ninth new page title",
			"type": "string"
		},
		"10": {
			"label": "Tenth new page title",
			"type": "string"
		},
		"11": {
			"label": "Eleventh new page title",
			"type": "string"
		},
		"12": {
			"label": "Twelfth new page title",
			"type": "string"
		},
		"13": {
			"label": "Thirteenth new page title",
			"type": "string"
		},
		"14": {
			"label": "Fourteenth new page title",
			"type": "string"
		},
		"15": {
			"label": "Fifteenth new page title",
			"type": "string"
		},
		"16": {
			"label": "Sixteenth new page title",
			"type": "string"
		},
		"17": {
			"label": "Seventeenth new page title",
			"type": "string"
		},
		"18": {
			"label": "Eighteenth new page title",
			"type": "string"
		},
		"19": {
			"label": "Nineteenth new page title",
			"type": "string"
		},
		"20": {
			"label": "Twentieth new page title",
			"type": "string"
		},
		"discuss": {
			"label": "Talk page discussion",
			"description": "Talk page and section where the split discussion is taking place",
			"example": "Talk:Microsoft#Split proposed",
			"type": "wiki-page-name",
			"suggested": true
		},
		"sections": {
			"label": "Sections, not portions?",
			"description": "Enter any text here to replace the word \"portions\" with \"sections\". If \"Section, not article?\" is also enabled, this will become \"subsections\".",
			"type": "line",
			"autovalue": "y",
			"example": "y"
		},
		"section": {
			"label": "Section, not article?",
			"description": "Enter any text here to replace the word \"article\" with \"section\". If \"Sections, not portions?\" is also enabled, \"sections\" will become \"subsections\".",
			"type": "line",
			"autovalue": "y",
			"example": "y"
		},
		"subsections": {
			"label": "Subsections of a section?",
			"description": "Enter any text here to replace \"portions of this article\" with \"subsections of this section\".",
			"type": "line",
			"autovalue": "y",
			"example": "y"
		},
		"portions": {
			"aliases": [
				"portion"
			],
			"label": "Text to replace \"portions\"",
			"description": "Custom text to replace \"portions\" in the template",
			"type": "string",
			"example": "parts"
		},
		"existing": {
			"label": "Page already exists?",
			"description": "Enter any text here to indicate that one or more of the proposed articles already exists.",
			"type": "line",
			"autovalue": "y",
			"example": "y"
		},
		"small": {
			"label": "Make template small",
			"description": "Enter any text here to make the template box small and aligned to the left.",
			"type": "line",
			"autovalue": "y",
			"example": "y"
		}
	},
	"paramOrder": [
		"date",
		"1",
		"2",
		"3",
		"4",
		"5",
		"6",
		"7",
		"8",
		"9",
		"10",
		"11",
		"12",
		"13",
		"14",
		"15",
		"16",
		"17",
		"18",
		"19",
		"20",
		"discuss",
		"sections",
		"section",
		"subsections",
		"portions",
		"existing",
		"small"
	]
}
</templatedata>

== See also ==

{{See also|Template:Very long|noheading=yes}}
{{See more|Template:Copied|noheading=yes}}

<includeonly>{{sandbox other||
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Maintenance templates]]
}}</includeonly>