ProofSource finds every page that is proofread on Wikisource during a contest, lets reviewers (juries) accept or reject them, and keeps a live leaderboard. It works on any language edition of Wikisource, and several projects can join one central contest with a combined leaderboard.
📖 This is the user guide (বাংলা সংস্করণ). For the technical design, see ARCHITECTURE.md; for the security review, docs/SECURITY_AUDIT.md.
- Features
- Getting started
- For participants
- Which pages count
- For reviewers (juries)
- For contest admins
- Central contests
- For Wikisource administrators
- For tool admins
- FAQ
| 🔍 Automatic tracking | Pages proofread inside the contest window are detected from the wiki history. |
| ✅ Review workflow | Accept, Needs fix or Reject, with notes, quick feedback chips and optional bonus points. |
| ⚖️ Fair review distribution | Open for all reviewers, or pages split equally among them in book order. |
| 📝 Three ways to submit | Automatic, semi-automatic (participants enrol) or manual (participants pick and submit their pages). |
| ↩️ Nothing silently disappears | A page set back to Not proofread stays on record as Reverted with 0 points. |
| 📦 Bulk review | Select many pages (Shift+click) and accept or reject them at once. |
| 🌐 Central contests | Several wikis under one control panel and a combined leaderboard. |
| 📚 Flexible books | Per-book points, excluded pages (1-5, 12) and per-book time windows. |
| 💾 Backups | Full JSON backup and restore, CSV exports, automatic snapshots and reminders. |
| 📝 Activity log | Every admin action is recorded and cannot be edited. |
| 🌙 Comfortable UI | ProofSource's Wikisource-blue theme with Wikimedia (Codex) style components, English and Bangla (Hind Siliguri / Tiro Bangla fonts), light theme with an optional dark mode, mobile friendly, keyboard shortcuts. |
| 🔒 Private & safe | No third-party CDNs or trackers; OAuth tokens encrypted at rest; CSRF, CSP and signed backups. |
- Open https://proofsource.toolforge.org.
- Click MediaWiki Login (top right) and press Allow on Meta-Wiki. The tool never sees your password.
- Use the বাংলা / EN button to switch the language (English is the default) and Dark / Light for the theme. The tool always opens in the light theme until you choose dark; your choice is remembered. The AA button changes the text size of the whole tool (small, default, large, extra large); on phones the same button also holds the theme switch.
All dates and times are shown in UTC.
On the home page, contests are grouped into Active, Upcoming, Ended and Pending Approval. Use the search box and the language / project filter to find yours. Central contests appear as a folder: expanded while running, folded otherwise. Click the arrow to toggle.
- Open the contest from the home page, or use the direct link from the organizers (for example
/contest/bn/wcnov26). - The Index Books tab lists the books in the contest, their points per page and any book-specific time window.
- Click Proofread Any Page (you need to be logged in) to open a random unproofread page on Wikisource. You can pick a book first. The page is reserved for you for 20 minutes.
- Proofread it on Wikisource as usual and save it as Proofread. The tool picks it up automatically. Press Sync (↻) to refresh immediately.
The organizers choose one of three submission modes; the contest page shows which one is used.
| Mode | What you do |
|---|---|
| Automatic submission | Nothing. Every page of yours that meets the rules is listed automatically. |
| Semi-automatic (enrol) | Press Enrol once (next to My Pages). From then on your qualifying pages are listed automatically — including the ones you proofread in this contest before enrolling. Pages of people who did not enrol are not listed. |
| Manual submission | Press Submit pages. A list of your qualifying pages that are not submitted yet appears; tick the ones you want (or Select all) and press Submit. Use Check the wiki again if a page you just proofread is missing. Submissions stay open until 24 hours after the contest ends. |
My Pages opens your own page (…/me) with:
- your rank, proofread, accepted and pending counts and total points; Needs fix and Rejected appear when you have such pages
- a breakdown by book
- every page with its status and the reviewer's note (on phones: page names are shortened, status and points share one line, and the note appears only when there is one)
Click any name on the leaderboard to see that participant's pages in the same way.
Pages a reviewer sends back appear at the top of the contest page under Pages Requiring Your Revision, with the note. Click Edit on Wiki, fix the page, and it goes back to the review queue.
A page counts for you when both of these are true:
- ✅ It reaches Proofread for the first time ever inside the contest window (or the book's own window).
- ✅ You worked on the text yourself. You can set Proofread in the first edit that creates the page, in the same edit as your corrections, or after several edits of your own.
A page does not count when:
- ❌ Someone only changes the status on text written by others.
- ❌ The page was already proofread or validated before the contest.
- ❌ A validated page is moved back to proofread. The credit stays with whoever proofread it first.
- ❌ The page is later reverted to Not proofread.
- ❌ It is an excluded page (e.g. table of contents), or by an excluded user or a bot.
Reverted pages. Once a page is in the contest it is never silently removed. If it later stops qualifying — for example someone sets it back to Not proofread on the wiki — it stays on record as Reverted with 0 points, it is not sent for review, and the change is written to the activity log. You can see reverted pages in the Reverted pages tab, on the leaderboard and on everyone's page list. If the page is proofread again, it returns to the review queue automatically.
Points: in contests with review, points are added when a page is accepted. In contests without review, every eligible page counts directly. Validation earns points only if the contest gives validation points.
If you are a reviewer, the contest page shows a Review (n) button.
- Filters: book, participant and status (pending / accepted / needs fix / rejected / all).
- Page chips: all pages in the filter are listed at the top; click one to open it.
- Views: rendered text, wikitext editor, and a diff of the first vs. latest revision. The scanned page is on the right, with zoom.
- Quick feedback: one-click notes such as "Spelling errors", or write your own.
- Bonus: if the contest allows it, add bonus points when accepting.
- Decisions: Accept, Needs fix or Reject. The next page loads immediately.
If the contest uses "Validate directly on Wikisource", accepting also sets the page to Validated on Wikisource under your name. With "Immediately revert", rejecting sets it back to Not proofread.
They work with any keyboard layout, including Bangla/Avro, and never fire while you are typing a note.
| Shortcut | Action |
|---|---|
| Alt + A | Accept (and next) |
| Alt + F | Needs fix |
| Alt + R | Reject |
| Alt + N | Next page |
- You can never review your own pages. They do not appear in your queue.
- In Equal share mode you only see the pages assigned to you; the panel shows Reviewed by me and Assigned to me (remaining).
- An open page is locked to you for 10 minutes so two reviewers don't work on it at once.
If the admin has enabled it, the panel shows Select pages:
- Filter as needed (for example by book or by participant).
- Click Select pages, then click page chips. Shift+click selects a range, and Select shown selects every visible chip.
- Click Accept selected or Reject selected, then confirm.
- A summary shows done, skipped (own) and failed pages. A failure never undoes the pages that succeeded.
Contest admins also get Select all in filter, for example to accept every page of one participant.
Click Create Contest on the home page and fill in:
| Field | Notes |
|---|---|
| Name, project, description | The project list holds every Wikisource and updates itself when a new one is created. Open it and scroll, or type a language code (bn, as) or a name and press Enter. For a wiki that is not listed yet choose Other Wikisource and type only its language code; .wikisource.org is already there. The project cannot be changed once pages are recorded. |
| Link slug | e.g. wcnov26 → /contest/bn/wcnov26. Leave empty for a random one. |
| Start / end (UTC) | |
| Points | Default points per page; validation points (0 = validation is not counted or shown); max bonus. |
| Admins, reviewers | Comma-separated Wikimedia usernames. |
| Excluded users | Bots are excluded automatically. |
| Review | With review, or Without review (like a Proofread Week). |
| Review distribution | Open for all or Equal share. |
| Review mode | Accept/reject in the tool only, or validate directly on Wikisource. |
| Submission | Automatic, Semi-automatic (enrol) or Manual submission (see How your pages enter the contest). Switching to automatic lists every page that is waiting; switching to semi-automatic lists the waiting pages of enrolled participants. |
| Rejected pages | Revert in one batch after the contest, or immediately. |
| Announcements | English and Bangla. |
| Books (the Books tab) | Start typing an index name and pick a suggestion, or type the full name and press Enter; a pasted list (one book per line) is added in one go. Each book is checked on the wiki and shown with its page count before it is added. Points per page and an own start/end can be set for all the listed books at once. |
Press Save Configuration: a short summary of the settings appears. Check it and press Confirm & save (or go back to editing). The same summary appears when you save changes later.
If you are an administrator of that Wikisource, the contest is active immediately. Otherwise it waits until a local administrator or the tool admin approves it.
- New contest: the tabs are walked through with Next; only the last tab (Books) has Save configuration.
- Existing contest: edits made on one tab are kept when you switch tabs or save a book; a dot marks tabs with unsaved edits, and the confirmation lists only what changed.
- Required fields are marked with a red
*: contest name, Wikisource project, start and end time (central: also at least one project). - Once the contest has started its start time, link slug and Wikisource project are fixed; the end time can still move (but not into the past). Risky changes to a running contest (points, excluded users, review mode, submission mode) show a ⚠ explanation in the confirmation. A book's own dates must stay inside the contest's dates.
- Every setting can be changed later, and each change is recorded in the Activity Log.
- The configuration page has tabs: General, Rules & points, Review, Books and Backup. The first three are saved together with Save configuration.
- Books: every book is one row; Edit opens it to set custom points, excluded pages and a book-specific time window, then press Save book. Books are saved one at a time, not with Save configuration.
- Excluded pages:
1-5, 12excludes pages 1 to 5 and page 12. Invalid input is rejected with a message. - An empty book window means the contest window applies. A book window may extend outside the contest dates.
- Excluded pages:
- Removing a book: Retain pages & points stops tracking but keeps earned points; Delete book removes its pages and points.
- Changing the slug keeps old links working; they redirect to the new one.
- Notice board: shown on the dashboard when filled in, completely hidden when empty. Supports
[[Page|text]],[https://link text]and'''bold'''.
With Equal share, pending pages are divided equally among reviewers, keeping consecutive pages of the same book together.
- Turned on before the contest, new pages are shared out as they arrive.
- Turned on midway, pages already reviewed count toward each reviewer's share. Example: 1000 pages and 5 reviewers means 200 each, so a reviewer who already did 20 gets 180 more.
- Changing the reviewer list re-balances the pages.
- As an admin, switch between Mine / All in the review panel.
- Generate WikiTable result code: the leaderboard and reviewer statistics as wiki tables, ready to paste on-wiki.
- Download leaderboard CSV
- A daily proofreading chart.
- Revert rejected pages: with the batch rule, set rejected pages back to Not proofread after the contest (up to 50 per click; press again if more remain).
On a participant's page, reviewers and admins see Message about pages when that person has pages that need a fix or were not accepted. A message is prefilled (with the reviewer's reasons), freely editable wikitext, and is posted on the participant's talk page on the wiki with your account. A page already mentioned is not offered again until it gets a new decision.
Deleting moves a contest to the Trash (visible to tool admins only). It is restorable for 7 days, after which it is removed for good; the trash can also be emptied at any time.
Visible to admins only. It records who changed what and when, with old and new values: configuration, books, points, review decisions, bulk reviews, backups and more. Nobody can edit or delete it.
At the bottom of the configuration page:
- Download full backup (JSON): the complete contest, restorable. A copy is also kept on the server.
- Download all pages (CSV): for spreadsheets.
- Restore: choose a JSON backup. It is verified first, then press Restore this backup. A safety copy of the current data is saved automatically. Only an intact backup of this same contest is accepted. Every backup is signed by the server; backups made elsewhere (or old, unsigned ones) can only be restored by the tool admin. A restore never changes the contest's approval, creator, wiki or link.
- Reminders: you are reminded on the dashboard if no backup was taken for 7 days.
Admins cannot delete a contest themselves. In the Danger zone of the configuration page, click Request deletion and give a reason. The tool admin reviews the request and deletes the contest, saving a full backup on the server first. You can cancel the request at any time before that.
Use a central contest when several Wikisource projects run one event together, for example an "Indic Wikisource Contest". The central contest is a control panel: it sets the shared rules, and each project configures its own part.
- Click New Central Contest on the home page.
- Enter the name, slug, description, event page link, start/end (UTC), points per page, validation points and the central admins.
- Under Rules for all projects, choose Allowed / Not allowed / Project decides for:
- custom points per book
- bonus points
- jury review
- page submission (Automatic / Semi-automatic / Manual / Project decides)
- Under Included projects, add each project and its project admins.
- Save. One contest is created for each project, and they appear as a tree under the central contest on the home page.
Created by the tool admin or by an administrator of any included Wikisource, the central contest is active immediately. Otherwise it waits for their approval.
- Open your project from the central contest page or from the home-page tree.
- In Configuration, add Index books, reviewers, announcements, excluded pages and so on, just like a normal contest.
- Dates, points per page, validation points and the centrally fixed rules are locked (greyed out). Rules marked Project decides are yours to choose.
- Global leaderboard: points from all projects combined. The same username on different wikis counts as one person, with a per-project breakdown.
- Included projects: each project's admins, books, participants and points.
- Results & statistics: a combined WikiTable result generator (with a copy button), a daily chart and a project comparison.
If you are an administrator (sysop) of a Wikisource:
- Contests you create on your wiki are active immediately.
- Contests created by others on your wiki show Approve & Activate and Reject at the top.
- You can also approve central contests that include your wiki.
The Pending Approval tab on the home page lists everything waiting.
Tool admins can approve any contest, delete contests when their admins ask for it and take database snapshots. Open Tool admins in the top menu to see the list:
- Permanent tool admins come from the server configuration (
PROOFSOURCE_SUPER_ADMINS; by default MS Sakib) and cannot be removed from the page. - Any tool admin can add another tool admin by Wikimedia username, or remove one that was added there. Every change is recorded.
Every text of the interface is in translations/en.json (English, the reference) and translations/bn.json (Bangla). To fix a wording, edit the JSON file; to add a language, copy en.json to <code>.json and translate it. Keep placeholders such as {n} unchanged. Check your work with python3 manage.py check-i18n (same keys in every language, same placeholders, nothing missing).
My proofread page is not on the leaderboard. Why?
Press Sync (↻) first. Then check:
- Is the page in one of the contest books?
- Was it proofread for the first time inside the contest or book window?
- Did you work on the text yourself?
- Is it in the excluded pages?
See Which pages count.
Why don't I see my own pages in the review panel?
Reviewers can never review their own pages, so they are hidden from your queue.
Why do I see only some of the pages?
The contest probably uses Equal share, so you see only the pages assigned to you.
Login does not work.
Reload the page (Ctrl+F5) and click MediaWiki Login again. If it still fails, contact the tool maintainer.
Does it work on mobile?
Yes. The whole tool works on phones, tablets and desktops. On phones the tables (leaderboards, reviewer statistics, activity log, results, a participant's pages) turn into cards instead of scrolling sideways. The person who runs the tool can bring back the old scrolling leaderboard on phones with the setting PROOFSOURCE_PHONE_LEADERBOARD=table.




