Editing Template:Split portions/doc

{{Documentation subpage}}
{{Wikipedia:Article alerts/Bot use warning}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
This template is for splitting out content that may be integrated throughout an article (or other page), or a section thereof, but which 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 when at least one of the proposed split-to titles does not yet exist as an page.  {{xref|(For splitting/merging to existing pages only, see [[#Merging into existing pages|§&nbsp;Merging into existing pages]].)}}  It is also only used when the content is diffuse or partial and does not form entire identifiable sections.   {{em|The exact nature of the split is usually detailed in a proposal on the talk page of the page to be split.}}

== Usage ==
To propose [[WP:Splitting|splitting]] content from one page out to another page or pages:
# 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 whole section needs to be split, to only one new page, you can use {{tl|Split section}} instead, at the top of the section: {{tlx|Split section |date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}&nbsp;|{{var|Title to which to relocate the content}}}}. This template only supports one target title parameter.
{{Split section |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 {{tlx|Split section |...}} (whole section).

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]].

==Merging into existing pages==
{{See also|Template:Section move from}}

To propose splitting/merging an entire section from one page into another, one would normally use {{tlx|Merge from|section{{=}}y}} and {{tlx|Merge to|section{{=}}y|}}.  To propose merging an entire page into another, use {{tlx|Merge to}} and {{tlx|Merge from}}.

If several sections in the current article need to move to one or more other articles, at least one of which already exists, then using separate {{tlx|Merge to}} tags would often be visually disruptive to the article. 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}}

== 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 starts here -->
{{Wikipedia:Template messages/Splitting/List|noheading=yes}}{{Wikipedia:Template messages/Merging/List|noheading=yes}}

{{Splitting templates}}

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