Jump to content

Wikipedia:ReFill: Difference between revisions

From Wikipedia, the free encyclopedia
Browse history interactively
← Previous edit
Content deleted Content added
VisualWikitext
→‎See also: Citation Style 1
 
(44 intermediate revisions by 25 users not shown)
Line 1: Line 1:
⚫
{{Soft redirect|toolforge:refill}}
<!-- The ugly trailing slash is needed for HTTPS to work -->
</br>If the above link is down, please instead use [https://refill.toolforge.org/ng/ https://refill.toolforge.org/ng/] or jump to [[Wikipedia:ReFill#To_use_reFill_yourself|this section]].
⚫
{{Soft redirect|toolforge:refill|toolforge:refill}}
⚫
{{lowercase title}}

⚫
{{shortcut|WP:REFILL|WP:RFL}}
⚫
<!-- Let's abuse the image CSS a little bit to show an example... -->
⚫
'''reFill''' (formerly '''Reflinks''') is a tool that expands [[WP:BURL|bare URL references]] semi-automatically, hosted on [[wikitech:Portal:Toolforge|Toolforge]]. It adds information (page title, work/website, author and publication date, if metadata is included) to bare URL references, and does additional fixes as well (e.g. combining duplicated references). The tool is written in [[Python (programming language)|Python]] and licensed under [[BSD licenses#2-clause|Simplified BSD License]]. The tool is an open-source replacement of [[User:Dispenser/Reflinks|Dispenser's Reflinks]]. The source code is available [https://github.com/CurbSafeCharmer/refill on GitHub]. The templates created automatically by the tool need to be reviewed to ensure that they are accurate, as they are often not.
⚫
<!-- Let's use the image CSS a little bit to show an example... -->
<div class="thumb floatright" style="max-width:30%;">
<div class="thumb floatright" style="max-width:30%;">
<div class="thumbinner">
<div class="thumbinner">
Line 10: Line 12:
</div>
</div>
<div class="thumbcaption">reFill converts bare references (red) into more complete ones (green)</div>
<div class="thumbcaption">reFill converts bare references (red) into more complete ones (green)</div>
</div>
</div></div>
</div>
⚫
{{lowercase title}}
⚫
{{shortcut|WP:REFILL|WP:RFL}}
⚫
'''reFill''' (formerly '''Reflinks''') is a tool that expands [[WP:BURL|bare references]] semi-automatically, hosted on [[wikitech:Portal:Toolforge|Toolforge]]. It adds information (page title, work/website, author and publication date, if metadata is included) to bare references, and does additional fixes as well (e.g. combining duplicated references). The tool is written in [[Python (programming language)|Python]] and licensed under [[BSD licenses#2-clause|Simplified BSD License]]. The tool is an open-source replacement of [[User:Dispenser/Reflinks|Dispenser's Reflinks]]. The source code is available [https://github.com/CurbSafeCharmer/refill on GitHub]. The templates created automatically by the tool need to be reviewed to ensure that they are accurate, as they are often not.


==Usage==
==Usage==

===Tagging bare URLs for cleanup===
===Tagging bare URLs for cleanup===
If there is a particular article which contains [[Wikipedia:Bare URLs|bare URLs]] in the references, like this one,<ref>https://www.cnn.com/</ref> and you would like to request a Wikipedian that already has reFill [[installation (computer programs)|installed]] (and is familiar with how it works) to help you fix the problem:
If there is a particular article which contains [[Wikipedia:Bare URLs|bare URLs]] in the references, like this one,<ref>https://www.cnn.com/</ref> and you would like to request a Wikipedian that already has reFill [[installation (computer programs)|installed]] (and is familiar with how it works) to help you fix the problem:
Line 23: Line 20:
# Open the article in question in your browser
# Open the article in question in your browser
# Click the 'edit' button
# Click the 'edit' button
# Paste the following line into the ''very top'' of the article: <br><code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{{tl|Cleanup-bare URLs}}</code>
# Paste the following line into the ''very top'' of the article: <br /><code>{{spaces|8}}{{tl|Cleanup bare URLs}}</code>
# Click the 'preview' button to verify that your change did not interfere with any other parts of the article
# Click the 'preview' button to verify that your change did not interfere with any other parts of the article
# Click the 'save' button
# Click the 'save' button
This will display a visible message (the text of which is shown at the top of [[Template:Cleanup-bare URLs]]) at the top of the Wikipedia article, and will also add the article to an 'invisible' category which requests that a Wikipedian experienced with reFill, apply it to the bare URLs ''in'' that article. It may take [[WP:VOLUNTEER|up to a week]] before someone notices your request, but if it has been several days and you have received no response, you can ask for additional assistance at the [[WP:TEAHOUSE]].
This will display a visible message (the text of which is shown at the top of [[Template:Cleanup bare URLs]]) at the top of the Wikipedia article, and will also add the article to a [[WP:HIDDENCAT|hidden category]] which requests that a Wikipedian experienced with reFill, apply it to the bare URLs ''in'' that article. {{As of|January 2023}} there were over 88,000 articles tagged as needing such attention from a volunteer, so don't hold your breath!


===To use reFill ''yourself''===
===To use reFill ''yourself''===
*https://refill.toolforge.org/ – Paste the title of the article into the ''Page name'' textbox. You can choose to output [[WP:CS1|plain CS1 citations]] or {{tl|cite web}} templates.
* https://refill.toolforge.org/ng/ – Paste the title of the article into the ''Page name'' textbox. You can choose to output [[WP:CS1|plain CS1 citations]] or {{tl|cite web}} templates.


===Options===
===Options===
Line 46: Line 43:
===[[Bookmarklet]]===
===[[Bookmarklet]]===
<pre style="overflow:auto">
<pre style="overflow:auto">
javascript:options='defaults=y&nowatch=y';location.href='https://tools.wmflabs.org/refill/result.php?wiki='+mw.config.get('wgContentLanguage')+'&page='+encodeURIComponent(mw.config.get('wgPageName'))+'&'+options;
javascript:options='defaults=y&nowatch=y';location.href='https://refill.toolforge.org/ng/result.php?wiki='+mw.config.get('wgContentLanguage')+'&page='+encodeURIComponent(mw.config.get('wgPageName'))+'&'+options;
</pre>
</pre>


Line 58: Line 55:
}}
}}
{{FAQ row
{{FAQ row
|q=Q2: Why does reFill change various characters to "#"?
|q=Q2: How can I run my own reFill instance for testing?
|a=A2: reFill has zero Toolforge dependency, and can be easily installed. For Linux users, see [https://github.com/CurbSafeCharmer/refill/blob/master/README.md README.md] and for Windows users, see [[Wikipedia:Refill/Windows]].
|a=A2: The hash signs are being inserted by Internet Explorer's [[cross-site scripting]] (XSS) filter. You can disable the filter by going to [[File:Gear-16px.png]]→"Internet options"→"Security"→{{button|Custom level...}}, scrolling to near the bottom of the list to "Enable XSS filter", and choosing "Disable". You can also work around the filter by copying everything in reFill's "New Wiki Markup" box and manually pasting it into Wikipedia or by using another [[web browser]]. <p>See [[phabricator:T34013|MediaWiki Bug T34013]]
}}
}}
{{FAQ row
{{FAQ row
|q=Q3: How can I run my own reFill instance for testing?
|q=Q3: Can you add support for other Wikipedias?
⚫
|a=A3: Yes! Just add a request on [[User talk:Zhaofeng Li/reFill|the talk page]].{{check}} Try using https://refill.toolforge.org/ng/ as well.
|a=A3: See [https://github.com/CurbSafeCharmer/refill/blob/master/README.md README.md]. reFill has zero Toolforge dependency, and can be easily installed.
}}
}}
{{FAQ row
{{FAQ row
|q=Q4: Can you add support for other Wikipedias?
|q=Q4: How to find articles which can be improved using reFill?
|a=A4: See [[:Category:Articles with bare URLs for citations]], [[:Category:CS1 errors]], and [https://en.wikipedia.org/w/index.php?title=Special%3ASearch&profile=default&search=insource%3A%2F%5C%3Cref%5C%3Ehtt%28p%7Cps%29%5C%3A%2F&fulltext=Search&ns0=1 this search].
⚫
|a=A4: Yes! Just add a request on [[User talk:Zhaofeng Li/reFill|the talk page]].
}}
}}
{{FAQ row
{{FAQ row
|q=Q5: How to find articles which can be improved using reFill?
|q=Q5: It's not working right now! What alternatives can I use while you're fixing it?
⚫
|a=A5: The [[mw:citoid|citoid service]] in the [[Help:VisualEditor/User guide|visual editor]] provides a "Convert" button. You can also use [http://tools.wmflabs.org/citation-template-filling/cgi-bin/index.cgi Diberri's tool] and similar scripts to generate citation templates, which you can paste into articles. You can also use [http://69.142.160.183/~dispenser/view/Reflinks reflinks] This tool has the advantage of marking some (though not all) dead links with the proper template.
|a=A5: You can use these categories: [[:Category:All articles with bare URLs for citations]] (for articles tagged with <nowiki>{{linkrot}}</nowiki> or <nowiki>{{</nowiki>[[Template:Cleanup bare URLs|Cleanup bare URLs]]<nowiki>}}</nowiki>), [[:Category:CS1 errors]] and [[:Category:Wikipedia references cleanup]].
}}
{{FAQ row
|q=Q6: It's not working right now! What alternatives can I use while you're fixing it?
⚫
|a=A6: The [[mw:citoid|citoid service]] in the [[Help:VisualEditor/User guide|visual editor]] provides a "Convert" button. You can also use [http://tools.wmflabs.org/citation-template-filling/cgi-bin/index.cgi Diberri's tool] and similar scripts to generate citation templates, which you can paste into articles. You can also use [https://web.archive.org/web/20181124142017/https://dispenser.info.tm/~dispenser/cgi-bin/webreflinks.py reflinks] This tool has the advantage of marking some (though not all) dead links with the proper template.
}}
}}


== Health warning ==
== Health warning ==
ReFill is not perfect, and never will be. You are responsible for every edit that ReFill 2 suggests so you must take the time to inspect every citation that this tool creates and fix anything that isn't quite right. Do not make work for other editors to clean up. Some publications misuse the HTML metadata tags that ReFill extracts such as:
ReFill is not perfect, and never will be. You are responsible for every edit that ReFill 2 suggests so you must take the time to inspect every citation that this tool creates and fix anything that isn't quite right. Do not make work for other editors to clean up. Some publications misuse the HTML metadata tags that ReFill extracts such as:
* the author name (first= and last=) containing the name of the publication e.g. {{code |lang=html|code=first=Deutsche{{!}}last=Welle (www.dw.com)}} representing [[Deutsche Welle]], rather than the author's name, or {{code |lang=html+handlebars|code=first=Editorial{{!}}last=team}}
* the author name (first= and last=) containing the name of the publication e.g. {{code |lang=html|code=first=Deutsche{{!}}last=Welle (www.dw.com)}} representing [[Deutsche Welle]], rather than the author's name, or {{code |lang=wikitext|code=first=Editorial{{!}}last=team}}
* the title including metadata elements that shouldn't be in the title, e.g. {{code |lang=html|Kosovo MPs elect lawyer Vjosa Osmani as president &amp;#124; DW &amp;#124; 04.04.2021}} – the title here is "Kosovo MPs elect lawyer Vjosa Osmani as president" and the text that follows it – such as the article's date – should be stripped out and a date= element added if not already present.
* the title including metadata elements that shouldn't be in the title, e.g. {{code |lang=html|Kosovo MPs elect lawyer Vjosa Osmani as president &amp;#124; DW &amp;#124; 04.04.2021}} – the title here is "Kosovo MPs elect lawyer Vjosa Osmani as president" and the text that follows it – such as the article's date – should be stripped out and a date= element added if not already present.
You'll need to remove these issues yourself.
You'll need to remove these issues yourself.
Line 87: Line 80:


== How it works ==
== How it works ==
{{main|Wikipedia:Refill/technical}}
{{main|Wikipedia:ReFill/technical}}
ReFill2 is based on [[mw:citoid|Citoid]] which is maintained by the [[Wikimedia Foundation]]. Citoid depends on technology called [[Zotero]], which is the bit that actually extracts [[Metadata#On_the_Internet|metadata]] from web pages. Zotero uses hundreds of 'translators' which contain [[JavaScript]] code that knows how to extract useful metadata from different layouts of web page, particularly academic resources. [[Wikipedia:Citing sources with Zotero]] explains how to use Zotero yourself, enabling you to get closer to how the metadata is extracted.
ReFill2 is based on [[mw:citoid|Citoid]] which is maintained by the [[Wikimedia Foundation]]. Citoid depends on technology called [[Zotero]], which is the bit that actually extracts [[Metadata#On_the_Internet|metadata]] from web pages. Zotero uses hundreds of 'translators' which contain [[JavaScript]] code that knows how to extract useful metadata from different layouts of web page, particularly academic resources. [[Wikipedia:Citing sources with Zotero]] explains how to use Zotero yourself, enabling you to get closer to how the metadata is extracted.


This is the same way that the [[Help:VisualEditor#Using_Citoid|'Cite' button]] on the toolbar of [[Wikipedia:VisualEditor|Wikipedia's visual editor]] works.
This is the same way that the [[Help:VisualEditor#Using_Citoid|'Cite' button]] on the toolbar of [[Wikipedia:VisualEditor|Wikipedia's visual editor]] works.

[https://www.youtube.com/watch?v=ltEL-kPURKs This tech talk] explains how this works and how Wikipedia editors can help improve how well tools like reFill and the cite button work.

⚫
[https://github.com/zotero/translators List of Zotero translators]


== Known issues ==
== Known issues ==
Line 101: Line 90:
* adds the discontinued <code>deadurl=y</code> rather than the current <code>url-status=dead</code> parameter
* adds the discontinued <code>deadurl=y</code> rather than the current <code>url-status=dead</code> parameter
* does not add the mandatory <code>archive-date</code> parameter
* does not add the mandatory <code>archive-date</code> parameter
You will need to fix such references yourself manually to avoid an error showing in red in the references section. If your edit results in such an error, please fix it. The archive date can be found embedded in Wayback Machine links.
You will need to fix such references yourself manually to avoid an error showing in red in the references section. If your edit results in such an error, please fix it. The archive date can be found embedded in Wayback Machine links.{{efn|The date appears after the fourth slash in the form YYYYMMDD, i.e. an url like: ''...//web.archive.org/web/20090719002615/...'' has an archive date of 2009-07-19.}}


If using an editor that supports global replace, <code>archiveurl</code> can be globally replaced by <code>archive-url</code> and <code>deadurl=y</code> by <code>url-status=dead</code>.
If using an editor that supports global replace, <code>archiveurl</code> can be globally replaced by <code>archive-url</code> and <code>deadurl=y</code> by <code>url-status=dead</code>.


When combining duplicate references, if one of them is already named, pointers to that name's reference are not updated when the name is changed.
When combining duplicate references, if one of them is already named, pointers to that name's reference are not updated when the name is changed.

[[CAPTCHA]] pages should be ignored.<ref>In {{diff4|old=921772932|921772227|this change}}, bare url "https://www.sportskeeda.com/player/sukesh-hegde" should have mapped to "|website=www.sportskeeda.com |url=https://www.sportskeeda.com/player/sukesh-hegde|title=Sukesh Hegde" but instead resulted in "|url=http://validate.perfdrive.com/sportskeeda/captcha?ssa=ff55a3c6-f57b-a88e-465b-29b5a0640586&ssc=http%3A%2F%2Fwww.sportskeeda.com%2Fplayer%2Fsukesh-hegde&ssi=56c5fac1-a33a-c8a4-85e3-788b215fdd3f&[email protected]&ssm=17830260681708870104190720594593&ssn=3de4acad11585936007e4e404e43a79a5324c63ccaff-503c-f05c-20ab89&sso=c2cd6084-e08cfc34bc4df9670373ac6a989be7c31878c211001d86bb&ssp=62190422811571384179157137342726414&ssq=21011194250024033237542500057184896752304&ssr=MjA4LjgwLjE1NC40OQ==&sst=ZoteroTranslationServer/WMF%20(mailto:[email protected])&ssw=|title=ShieldSquare Captcha|website=validate.perfdrive.com"</ref>


==Reporting problems==
==Reporting problems==
If the tool is stuck displaying "waiting for an available worker", [https://phabricator.wikimedia.org/maniphest/task/create/?projects=Tool-refill&title=Refill%20tool%20stuck%20%22waiting%20for%20an%20available%20worker%22 use this link] to raise a report to get it restarted. You will need to register for a [[Wikipedia:Phabricator|Phabricator]] account, which you will be able to link to your Wikipedia account. Fill in the description field and hit the "Create New Task" button.
If the tool is stuck displaying "waiting for an available worker", [https://phabricator.wikimedia.org/maniphest/task/create/?projects=Tool-refill&title=Refill%20tool%20stuck%20%22waiting%20for%20an%20available%20worker%22 use this link] to raise a report to get it restarted. You will need to register for a [[Wikipedia:Phabricator|Phabricator]] account, which you will be able to link to your Wikipedia account. Fill in the description field and hit the "Create New Task" button.


If you have found a bug or want extra features, please post to [[Wikipedia talk:ReFill|the talk page]]. Alternatively, you can also create an issue on [https://github.com/CurbSafeCharmer/refill/issues GitHub].
If you have found a bug or want extra features, please either:
* add a task to [https://phabricator.wikimedia.org/project/board/5013/ the Phabricator board] if you are able (Phabricator account required) - preferred method - either a
** [https://phabricator.wikimedia.org/maniphest/task/edit/form/102/ feature request] or
** [https://phabricator.wikimedia.org/maniphest/task/edit/form/43/ bug report]
*: being sure to enter Tool-refill as the tag
oder
* post to [[Wikipedia talk:ReFill|the talk page]].


==Contributing==
==Contributing==
Having no [[mw:Wikimedia Labs|Wikimedia Labs]] dependency, reFill can be installed on your own computer so that you can work on it. To contribute to reFill, create a fork on [https://github.com/CurbSafeCharmer/refill/fork GitHub], make your changes and submit a [[pull request]]. Thank you for your contributions!
Having no [[wikitech:Help:Cloud Services introduction|Wikimedia Cloud Services]] dependency, reFill can be installed on your own computer so that you can work on it. To contribute to reFill, create a [[Fork (software development)|fork]] on [https://github.com/CurbSafeCharmer/refill/fork reFill's GitHub repository], make your changes and submit a [[pull request]]. Note that refill on toolforge uses the <code>labs-stable</code> branch. Thank you for your contributions!


Volunteers are needed to help support and maintain reFill. If you are a software developer with experience with [[Python (programming language)|Python]], [[Celery (software)|Celery]] and [[Node.js]] and you are willing to help to any extent then please [[User talk:Curb Safe Charmer|leave a message]].
Volunteers are needed to help support and maintain reFill. If you are a software developer with experience in [[Python (programming language)|Python]], [[Celery (software)|Celery]] and [[Node.js]] and you are willing to help to any extent then please [[User talk:Curb Safe Charmer|leave a message]].


To translate the tool, please head over to [[translatewiki:Special:Translate/int-refill|translatewiki.net]].
To translate the tool, please head over to [[translatewiki:Special:Translate/int-refill|translatewiki.net]].
Line 124: Line 121:
*[[User:Dispenser/Reflinks]], the original tool by Dispenser
*[[User:Dispenser/Reflinks]], the original tool by Dispenser
*[[Wikipedia:The Wikipedia Library/Citoid]]
*[[Wikipedia:The Wikipedia Library/Citoid]]
*[[meta:Web2Cit|Web2Cit]]


===Userbox===
*Userbox: {{tlu|User:UBX/reFill}}
{{Ubxdisplay|User:UBX/reFill|nt=yes}}
⚫
{{Clear}}


==Notes==
{{User:UBX/reFill|nocat=true}}
{{notelist}}


==References==
⚫
{{Clear}}
{{reflist}}

==External links==
* {{YouTube|id=ltEL-kPURKs|title=Tech Talk: Automated citations in Wikipedia: Citoid and the technology behind it}}, explains how this works
⚫
* [https://github.com/zotero/translators List of Zotero translators] at GitHub


⚫
[[Category:Wikipedia references cleanup]]
[[Category:Wikipedia citation/link tools]]
[[Category:Wikipedia citation/link tools]]
⚫
[[Category:Wikipedia references cleanup]]


[[bn:ব্যবহারকারী:Zhaofeng Li/reFill]]
[[bn:ব্যবহারকারী:Zhaofeng Li/reFill]]

Latest revision as of 22:16, 29 July 2024

Soft redirect to:toolforge:refill
This page is a soft redirect.
If the above link is down, please instead use https://refill.toolforge.org/ng/ or jump to this section.

Shortcuts

reFill (formerly Reflinks) is a tool that expands bare URL references semi-automatically, hosted on Toolforge. It adds information (page title, work/website, author and publication date, if metadata is included) to bare URL references, and does additional fixes as well (e.g. combining duplicated references). The tool is written in Python and licensed under Simplified BSD License. The tool is an open-source replacement of Dispenser's Reflinks. The source code is available on GitHub. The templates created automatically by the tool need to be reviewed to ensure that they are accurate, as they are often not.

<ref>http://example.com</ref>
→<ref>{{cite web|url=http://example.com |title=Example Domain|publisher=}}</ref>

reFill converts bare references (red) into more complete ones (green)

Usage

[edit]

Tagging bare URLs for cleanup

[edit]

If there is a particular article which contains bare URLs in the references, like this one,[1] and you would like to request a Wikipedian that already has reFill installed (and is familiar with how it works) to help you fix the problem:

References

  1. ^ https://www.cnn.com/
  1. Open the article in question in your browser
  2. Click the 'edit' button
  3. Paste the following line into the very top of the article:
            {{Cleanup bare URLs}}
  4. Click the 'preview' button to verify that your change did not interfere with any other parts of the article
  5. Click the 'save' button

This will display a visible message (the text of which is shown at the top of Template:Cleanup bare URLs) at the top of the Wikipedia article, and will also add the article to a hidden category which requests that a Wikipedian experienced with reFill, apply it to the bare URLs in that article. As of January 2023 there were over 88,000 articles tagged as needing such attention from a volunteer, so don't hold your breath!

To use reFill yourself

[edit]

Options

[edit]
  • Use plain formatting instead of {{cite web}}: If selected, the tool will fill out bare references in plain CS1 format instead of {{cite web}}. All available metadata is included.
  • Do not remove link rot tags: If selected, the tool will not remove any link rot tags from the source, even if no bare references are skipped.
  • Add blank metadata fields when the information is unavailable If selected, the tool will insert blank |author= and/or |date= for filling in manually, when the corresponding metadata is unavailable.
  • Do not add access dates: If selected, access dates will be omitted from the result.
  • Use the base domain name as work when this information cannot be parsed: If selected, the base domain of the link will be used in the |website= field if the website does not supply its name in embedded metadata.
[edit]

Insert this code into your common.js: 

mw.loader.load( "https://meta.wikimedia.org/w/index.php?title=User:Zhaofeng_Li/Reflinks.js&action=raw&ctype=text/javascript" );

Bookmarklet

[edit]
javascript:options='defaults=y&nowatch=y';location.href='https://refill.toolforge.org/ng/result.php?wiki='+mw.config.get('wgContentLanguage')+'&page='+encodeURIComponent(mw.config.get('wgPageName'))+'&'+options;

API

[edit]

An API is available, enabling user script and bot developers to take advantage of the APIs exposed by reFill to complete bare references programmatically.

Frequently asked questions

[edit]
Q1: Why is there an empty |publisher=?
A1: There isn't any reliable way to parse that field, and an empty one is intentionally left when |work= cannot be parsed. Please fill it in manually.
Q2: How can I run my own reFill instance for testing?
A2: reFill has zero Toolforge dependency, and can be easily installed. For Linux users, see README.md and for Windows users, see Wikipedia:Refill/Windows.
Q3: Can you add support for other Wikipedias?
A3: Yes! Just add a request on the talk page.[verification needed] Try using https://refill.toolforge.org/ng/ as well.
Q4: How to find articles which can be improved using reFill?
A4: See Category:Articles with bare URLs for citations, Category:CS1 errors, and this search.
Q5: It's not working right now! What alternatives can I use while you're fixing it?
A5: The citoid service in the visual editor provides a "Convert" button. You can also use Diberri's tool and similar scripts to generate citation templates, which you can paste into articles. You can also use reflinks This tool has the advantage of marking some (though not all) dead links with the proper template.

Health warning

[edit]

ReFill is not perfect, and never will be. You are responsible for every edit that ReFill 2 suggests so you must take the time to inspect every citation that this tool creates and fix anything that isn't quite right. Do not make work for other editors to clean up. Some publications misuse the HTML metadata tags that ReFill extracts such as:

  • the author name (first= and last=) containing the name of the publication e.g. first=Deutsche|last=Welle (www.dw.com) representing Deutsche Welle, rather than the author's name, or first=Editorial|last=team
  • the title including metadata elements that shouldn't be in the title, e.g. Kosovo MPs elect lawyer Vjosa Osmani as president &#124; DW &#124; 04.04.2021 – the title here is "Kosovo MPs elect lawyer Vjosa Osmani as president" and the text that follows it – such as the article's date – should be stripped out and a date= element added if not already present.

You'll need to remove these issues yourself.

ReFill extracts the date from the date meta tag. On some web pages there isn't such a meta tag, but the date can easily be found at the top of the body of the page. ReFill will not find it, but you can add it manually.

Wie es funktioniert

[edit]
Main page: Wikipedia:ReFill/technical

ReFill2 is based on Citoid which is maintained by the Wikimedia Foundation. Citoid depends on technology called Zotero, which is the bit that actually extracts metadata from web pages. Zotero uses hundreds of 'translators' which contain JavaScript code that knows how to extract useful metadata from different layouts of web page, particularly academic resources. Wikipedia:Citing sources with Zotero explains how to use Zotero yourself, enabling you to get closer to how the metadata is extracted.

This is the same way that the 'Cite' button on the toolbar of Wikipedia's visual editor works.

Known issues

[edit]

When ReFill encounters a bare URL which is an archive site, such as in this example:

  • it writes the archive URL to the deprecated archiveurl parameter rather than the newer archive-url parameter
  • adds the discontinued deadurl=y rather than the current url-status=dead parameter
  • does not add the mandatory archive-date parameter

You will need to fix such references yourself manually to avoid an error showing in red in the references section. If your edit results in such an error, please fix it. The archive date can be found embedded in Wayback Machine links.[a]

If using an editor that supports global replace, archiveurl can be globally replaced by archive-url and deadurl=y by url-status=dead.

When combining duplicate references, if one of them is already named, pointers to that name's reference are not updated when the name is changed.

CAPTCHA pages should be ignored.[1]

Reporting problems

[edit]

If the tool is stuck displaying "waiting for an available worker", use this link to raise a report to get it restarted. You will need to register for a Phabricator account, which you will be able to link to your Wikipedia account. Fill in the description field and hit the "Create New Task" button.

If you have found a bug or want extra features, please either:

oder

Contributing

[edit]

Having no Wikimedia Cloud Services dependency, reFill can be installed on your own computer so that you can work on it. To contribute to reFill, create a fork on reFill's GitHub repository, make your changes and submit a pull request. Note that refill on toolforge uses the labs-stable branch. Thank you for your contributions!

Volunteers are needed to help support and maintain reFill. If you are a software developer with experience in Python, Celery and Node.js and you are willing to help to any extent then please leave a message.

To translate the tool, please head over to translatewiki.net.

See also

[edit]

Userbox

[edit]

{{User:UBX/reFill}}

This user uses reFill to expand bare references.

Notes

[edit]
  1. ^ The date appears after the fourth slash in the form YYYYMMDD, i.e. an url like: ...//web.archive.org/web/20090719002615/... has an archive date of 2009-07-19.

References

[edit]
  1. ^ In this change, bare url "https://www.sportskeeda.com/player/sukesh-hegde" should have mapped to "|website=www.sportskeeda.com |url=https://www.sportskeeda.com/player/sukesh-hegde%7Ctitle=Sukesh Hegde" but instead resulted in "|url=http://validate.perfdrive.com/sportskeeda/captcha?ssa=ff55a3c6-f57b-a88e-465b-29b5a0640586&ssc=http%3A%2F%2Fwww.sportskeeda.com%2Fplayer%2Fsukesh-hegde&ssi=56c5fac1-a33a-c8a4-85e3-788b215fdd3f&[email protected]&ssm=17830260681708870104190720594593&ssn=3de4acad11585936007e4e404e43a79a5324c63ccaff-503c-f05c-20ab89&sso=c2cd6084-e08cfc34bc4df9670373ac6a989be7c31878c211001d86bb&ssp=62190422811571384179157137342726414&ssq=21011194250024033237542500057184896752304&ssr=MjA4LjgwLjE1NC40OQ==&sst=ZoteroTranslationServer/WMF%20(mailto:[email protected])&ssw=%7Ctitle=ShieldSquare Captcha|website=validate.perfdrive.com"
[edit]
Retrieved from "https://en.wikipedia.org/w/index.php?title=Wikipedia:ReFill&oldid=1237459427"