Difference between revisions of "Help:Purge"
(Help page to describe how/why to purge a page's server cache) |
|||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| + | {{cleanup|Note to self: review the page and include it into the greater UniWiki navigational template [[User:Arin Mara|Arin Mara]] ([[User talk:Arin Mara|talk]]) 16:33, 10 May 2022 (UTC)}} | ||
The '''purge''' function is a handy way to clear a page's server cache. This forces the wiki software to rebuild the page completely. | The '''purge''' function is a handy way to clear a page's server cache. This forces the wiki software to rebuild the page completely. | ||
| Line 9: | Line 10: | ||
:''Note: purging may take a few minutes, though it usually happens immediately.'' | :''Note: purging may take a few minutes, though it usually happens immediately.'' | ||
| − | There are | + | There are several ways to purge your cache: |
From any wiki page: | From any wiki page: | ||
| − | |||
# At the end of the URL in the address bar of your browser, add the text <code>?action=purge</code> | # At the end of the URL in the address bar of your browser, add the text <code>?action=purge</code> | ||
| − | # Press [Enter] or click "Go" to tell the browser to go to that revised URL | + | # Press [Enter] or click "Go" to tell the browser to go to that revised URL |
| − | # The page should be refreshed in a short time | + | # The page should be refreshed in a short time |
Similarly, from any wiki page: | Similarly, from any wiki page: | ||
| − | |||
# Click the "edit" tab | # Click the "edit" tab | ||
# In the address bar in your browser, at the end of the URL, where you see <code>&action=edit</code>, replace "edit" with "purge," so it now reads <code>&action=purge</code> | # In the address bar in your browser, at the end of the URL, where you see <code>&action=edit</code>, replace "edit" with "purge," so it now reads <code>&action=purge</code> | ||
# Press [Enter] or click "Go" to tell the browser to go to that revised URL | # Press [Enter] or click "Go" to tell the browser to go to that revised URL | ||
| − | # The page should be refreshed in a short time | + | # The page should be refreshed in a short time |
| + | |||
| + | When logged on: | ||
| + | # Hover over the down pointed triangle next to the search box | ||
| + | # Click "Refresh" | ||
| + | # The page should be refreshed in a short time | ||
== How It Works == | == How It Works == | ||
| Line 35: | Line 39: | ||
Purging an image's description page can be used to force the software to regenerate all the thumbnails for that particular image. If an image thumbnail will not regenerate successfully after the original image has been purged, it is probably because the server has cached an error page with the URL of a thumbnail, but the page is not purged because the actual thumbnail does not exist. The solution is to request the thumbnail with an unusual URL, say by appending ?1 to the end. The thumbnail should then be successfully generated. Finally, do action=purge to delete the cached error. You should only do this if you have tried an ordinary action=purge and it hasn't worked. | Purging an image's description page can be used to force the software to regenerate all the thumbnails for that particular image. If an image thumbnail will not regenerate successfully after the original image has been purged, it is probably because the server has cached an error page with the URL of a thumbnail, but the page is not purged because the actual thumbnail does not exist. The solution is to request the thumbnail with an unusual URL, say by appending ?1 to the end. The thumbnail should then be successfully generated. Finally, do action=purge to delete the cached error. You should only do this if you have tried an ordinary action=purge and it hasn't worked. | ||
| + | |||
| + | [[Category:Editing]] | ||
| + | |||
| + | {{UniWikiNav}} | ||
Latest revision as of 11:26, 9 March 2023
The reason is: Note to self: review the page and include it into the greater UniWiki navigational template Arin Mara (talk) 16:33, 10 May 2022 (UTC)
The purge function is a handy way to clear a page's server cache. This forces the wiki software to rebuild the page completely.
Some pages use transclusion to incorporate subpages or templates. If you can't see the transcluded pages properly, purging might help.
You may want to try first to refresh the page using your web browser.
How to purge
- Note: purging may take a few minutes, though it usually happens immediately.
There are several ways to purge your cache:
From any wiki page:
- At the end of the URL in the address bar of your browser, add the text
?action=purge - Press [Enter] or click "Go" to tell the browser to go to that revised URL
- The page should be refreshed in a short time
Similarly, from any wiki page:
- Click the "edit" tab
- In the address bar in your browser, at the end of the URL, where you see
&action=edit, replace "edit" with "purge," so it now reads&action=purge - Press [Enter] or click "Go" to tell the browser to go to that revised URL
- The page should be refreshed in a short time
When logged on:
- Hover over the down pointed triangle next to the search box
- Click "Refresh"
- The page should be refreshed in a short time
How It Works
When a change is made to a page, the MediaWiki software saves the change to the main database. The next time a non-logged in user views the page, a copy of that page is made to a "server cache" on a set of secondary servers. Until the page is changed again, all non-logged in users who try to view that page will be shown the same copy from the server cache. That way, users who are viewing but not editing do not put a drain on the main database server, and still see the most recent version of the page. (Logged-in users have a choice in their Special:Preferences under "Misc" whether to see cached or live versions.)
Normally, when a change is made, the page is marked as "touched" and the software will create a new copy of the page for the server cache. However, when a change is made to a subpage or template, but not to the article page which transcludes it, the article page is not marked as "touched," and a new copy is not generated for the cache. Therefore anyone viewing the article page may see a cached page which includes old versions of the subpage or template.
The purge command forces the server cache to purge the old version of the page. The next time the page is viewed, the page will be rebuilt from scratch, including fresh versions of all subpages and templates, and a new copy will be made for the server cache. Note that this may take a few minutes in extreme cases.
For Images
Purging an image's description page can be used to force the software to regenerate all the thumbnails for that particular image. If an image thumbnail will not regenerate successfully after the original image has been purged, it is probably because the server has cached an error page with the URL of a thumbnail, but the page is not purged because the actual thumbnail does not exist. The solution is to request the thumbnail with an unusual URL, say by appending ?1 to the end. The thumbnail should then be successfully generated. Finally, do action=purge to delete the cached error. You should only do this if you have tried an ordinary action=purge and it hasn't worked.
| |||||||||||||||||
