Help:Gadget-ImageUploader
Wikisource Image Uploader is a simple tool to enable uploads to Commons or Wikisource, allowing easier uploading of relevant images for indexes.
To use
[edit]- Visit https://ws-image-uploader.toolforge.org/ and fill the form in manually.
- Install this gadget and use the "Upload image" link in the sidebar (or in the 2010 editor toolbar).
You must log in and grant access to allow this tool to upload files under your account. This tool will never see your password or store personal information, but it will have "upload" access to your account. This is the same mechanism used by IA Upload.
Filling in the form
[edit]- Set the Wikisource to use for Index page information and as an upload target if not using Commons
- Select Wikisource or Commons.
- Do not upload to Wikisource if the media can go to Commons. Only upload media at Wikisource that is not accepted at Commons: generally this is non-US media that is expired in the US, but not in the country of origin.
- Image type: select the kind of image:
- Illustration: general illustrations and drawings
- Photograph
- Headpiece or Endpiece
- Text divider (also known as a graphic rule)
- Frontispiece: large image, usually facing the title page
- Fleuron: small decorations, usually floral, for example ❦
- Title: a graphical, illuminated or decorative font title or section heading
- Initial: an illuminated initial. Also fill in the initial field in this case.
- Figure number: if given (e.g. Fig. 1)
- Caption: image caption, if any, as printed in the original text
- Title: title of the book — this will be read from the Index page if possible
- Date: date of publication
- Source: the source for the images. Usually this is the upstream source such as the Internet Archive details page from which you can get the high-resolution originals. Note: never crop images directly from a PDF or DjVu.
- Image author: the illustrator, engraver, artist or painter. This is not usually the book author.
{{unknown engraver}}and{{unknown photographer }}can be used. - License: the image license. This is usually the same as the book, but sometimes named artists retain a separate copyright, which can be important for non-US works or post-1928 works.
- Categories: any specific categories for the image. Default categories based on the image type above will also be added.
Generate and check
[edit]Click the generate button. This will use the information above to generate an information block. You may adjust this information manually, but if you click the "Generate" button, the changes will be overwritten.
Upload
[edit]Once you are happy with the information template, click upload to send the file to Commons (or Wikisource).
Note: the file will be uploaded under your account using OAuth. You, and only you, are responsible for checking that that file is correct and has appropriate metadata.
What to not use this tool for
[edit]Generally, this tool is not useful for uploading raw page images. You should extract the image carefully from the scan. This can be quite a technically demanding process. While automatic extraction can sometimes work to a very limited extent, it generally introduces unacceptable image degradation and requires manual setting of parameters.
See H:EXTRACT for instructions for extracting images effectively.
I'm bored and I want to use this tool
[edit]Help out with page with missing images:
Technical details
[edit]- This tool is written with Vue and VueBootstrap. One day it might get ported to WVUI.
- File bugs, issues and requests: https://phabricator.wikimedia.org/project/board/5221
- You can run it yourself. You will need:
- Python to run the backend
- Node to run the frontend building
- An OAuth Consumer token to allow MediaWiki API access