Template:Assistant/extract section/doc

Usage

This template extracts the content of a section of a web page. Two required unnamed parameters are the name of the page and the name of the section. Wikilink markup is stripped from the section headings for comparison with the unnamed parameter.

Subsections are included in the extract. The section heading at the top of the section is not included unless optional named parameter heading is non-blank. Categorization is filtered out, so extracted material won't categorize the transcluding page.

If a third unnamed parameter is provided, extraction does not stop at the end of the section named by the second parameter, but instead continues until-and-unless the section named by the third unnamed parameter.

{{Assistant/extract section|WN:SG|Status}} would produce

The Wikinews style guide, like all style guides at working news organisations, is a work in progress and subject to change as new issues emerge and the language of news coverage evolves. Changes to the guide are not applied retroactively. Conventions Elements of punctuation and grammar are not addressed by exactly the same terms universally. There is no intention to be regionalist in this manual; however, in the interests of causing the least confusion, the following terms are used for clarity: Period: The American term for the dot which punctuates the end of a sentence; also known as a full-stop.

{{Assistant/extract section|WN:SG|Status|heading=1}} would produce

Status The Wikinews style guide, like all style guides at working news organisations, is a work in progress and subject to change as new issues emerge and the language of news coverage evolves. Changes to the guide are not applied retroactively. Conventions Elements of punctuation and grammar are not addressed by exactly the same terms universally. There is no intention to be regionalist in this manual; however, in the interests of causing the least confusion, the following terms are used for clarity: Period: The American term for the dot which punctuates the end of a sentence; also known as a full-stop.

{{Assistant/extract section|WN:SG|The first paragraph|Writing tone and structure|heading=1}} would produce

The first paragraph Shortcut: WN:LEDE The first paragraph (known as the lede) should summarize the article with at least 100 words, using four or five sentences. Try to answer the basic questions of who, what, where, when, why and how. Try to fit most of these into the first paragraph. This is known as the "five W's (and an H)", and is the first thing to learn about news writing. Don't feel stifled by this suggestion. Those experienced in reporting learn to determine which of those six questions are the most relevant to the story (and, more importantly, the reader). This gets easier with practice, as does most writing. If you don't have the answer to one or two of them, skip it — but explain if possible why you don't know later in your story. Don't make your first paragraph a boring list of facts — it's the first thing the reader sees, so make it interesting. Every fact or issue mentioned in the first paragraph should be later backed up or expanded in the main body of the article. You needn't explain everything fully in the intro, but what is mentioned should be fully explained before the reader finishes reading the article. Article length Shortcut: WN:LENGTH Most complete articles should have a minimum of one paragraph with at least one hundred words. Don't submit articles containing only a link to a story on an external news site and no story text. Such pages are quickly deleted. If there is significant breaking news whose article is likely to be expanded, do go ahead and write a short (but useful!) summary as breaking news, and tag it with {{breaking review}}. You can add an {{expand}}-tag. This will invite other editors to work on the article. Note that just because a story has just broken does not mean it is in the process of breaking. Try to write at least a paragraph where news is breaking, but beware the pitfall that by the time it is reviewed the story may have already moved on to the point where it is no longer appropriate to publish a minimalist piece without expansion. See Wikinews:Breaking news.

Internals

Precisely, extraction starts at the first section heading named by the second unnamed parameter. If the third unnamed parameter is blank or omitted, inclusion stops at the next section heading that is no deeper than the start heading. If the third unnamed parameter is non-blank, inclusion continues until the next section heading that is no deeper than the start heading and is named by either the second or third parameter.