Template:Ins/doc
| This is a documentation subpage for Template:Ins. It contains usage information, categories and other content that is not part of the original template page. |
Contents
Usage
The templates {{ins}} and {{del}} correct the display of content marked up as inserted or deleted, when that display is improperly line-broken inside block quotations due to a bug documented below.
Syntax
{{ins|text marked as inserted}}
{{del|text marked as deleted}}
These templates must be used as inline elements (i.e. inside a paragraph or other block), not as block elements (i.e. not enclosing multiple paragraphs or other blocks). To mark up multiple blocks, use multiple instances.
Rationale
The {{ins}} template and its counterpart {{del}} exist to work around a known bug in the MediaWiki software's handling of the <ins>...</ins> and <del>...</del> [X]HTML elements under certain conditions.
The result of the bug is that the first (and only first) occurrence of either <ins>...</ins> or <del>...</del> inside a <blockquote>...</blockquote> segment (or inside a template, like {{quotation}}, that uses <blockquote>) will be rendered with an inappropriate newline preceding it. It is recommended that all use of <ins> and <del> be replaced with {{ins}} and {{del}} inside block quotations not just the first occurrence (since material in articles can change at any time, and there is no guarantee that the first-occurring case will always remain the first-occurring case).
The workaround is not required for cases of indentation with the ":" wikimarkup style, only for actual block quotations.
The purpose of these elements is to show inserted or deleted text in a passage, such as quotation of a draft document. They may also be used in Wikipedia processes like RFA and AFD by editors to change their comments on issues up for discussion (although some editors prefer <s>...</s> strike-through for deletions, and <s> does not share <del>'s block quotation bug).
Example
This example, with both deleted and inserted material marked up
Lorem ipsum odionsequip feu enim tionulla commodo elit autat, elit posuere adiamiscinim, inciduipit feugiat dunt aute. {{del|Odionsequip feu enim tionulla commodo elit autat, elit posuere adiamiscinim, inciduipit feugiat dunt aute.}} {{ins|Pretium vendre atinit essequis turpis felis adionsequat alisit uteisi, loris faciduisit duismolobore.}} Pretium vendre atinit essequis turpis felis adionsequat alisit uteisi, loris faciduisit duismolobore.
renders as
Lorem ipsum odionsequip feu enim tionulla commodo elit autat, elit posuere adiamiscinim, inciduipit feugiat dunt aute.
This Template:Pagetype may meet Wikipedia's criteria for speedy deletion because: Odionsequip feu enim tionulla commodo elit autat, elit posuere adiamiscinim, inciduipit feugiat dunt aute.. For valid criteria, see CSD. If this Template:Pagetype does not meet the criteria for speedy deletion, or you intend to fix it, please remove this notice, but do not remove this notice from pages that you have created yourself. If you created this page and you disagree with the given reason for deletion, you can click the button below and leave a message explaining why you believe it should not be deleted. You can also visit the talk page to check if you have received a response to your message.
Note that this Template:Pagetype may be deleted at any time if it unquestionably meets the speedy deletion criteria, or if an explanation posted to the talk page is found to be insufficient.
- Nominator: Please consider placing the template:
{{subst:db-reason-notice|Template:Ins/doc|header=1|Odionsequip feu enim tionulla commodo elit autat, elit posuere adiamiscinim, inciduipit feugiat dunt aute.}} ~~~~- on the talk page of the author.
Administrators: check links, history (last), and logs before deletion. Consider checking Google.Note to page author: you have not edited the talk page yet. If you wish to contest this speedy deletion, clicking the button above will allow you to leave a talk page message explaining why you think this Template:Pagetype should not be deleted.
If you have already posted to the talk page but this message is still showing up, try purging the page cache.
This page was last edited by [[User:Template:REVISIONUSER2|Template:REVISIONUSER2]] Template:Toolbar at 18:48, 26 November 2009 (UTC) (Template:Time ago)Template:NOINDEX Pretium vendre atinit essequis turpis felis adionsequat alisit uteisi, loris faciduisit duismolobore. Pretium vendre atinit essequis turpis felis adionsequat alisit uteisi, loris faciduisit duismolobore.
while when using bare <del> and <ins> markup rather than this template as
Lorem ipsum odionsequip feu enim tionulla commodo elit autat, elit posuere adiamiscinim, inciduipit feugiat dunt aute. <del>Odionsequip feu enim tionulla commodo elit autat, elit posuere adiamiscinim, inciduipit feugiat dunt aute.</del> <ins>Pretium vendre atinit essequis turpis felis adionsequat alisit uteisi, loris faciduisit duismolobore.</ins> Pretium vendre atinit essequis turpis felis adionsequat alisit uteisi, loris faciduisit duismolobore.
it mis-renders as
Lorem ipsum odionsequip feu enim tionulla commodo elit autat, elit posuere adiamiscinim, inciduipit feugiat dunt aute.
Odionsequip feu enim tionulla commodo elit autat, elit posuere adiamiscinim, inciduipit feugiat dunt aute.Pretium vendre atinit essequis turpis felis adionsequat alisit uteisi, loris faciduisit duismolobore. Pretium vendre atinit essequis turpis felis adionsequat alisit uteisi, loris faciduisit duismolobore.
(note the undesired line break before the deleted, struck-through material, but that it only happens at the first occurence, with no line break before the inserted, underlined material).
See also
- {{del}}