Al Piskun: Created page with "'''Module:ProjectCounts''' computes the figures shown in the statistics block on the Main Page (projects listed, screensavers archived, etc.) directly from the wikitext of the relevant pages, so the numbers stay current as tables and lists are edited. It is also used for section row counts on the BOINC projects page itself. The module reads the source wikitext of target pages at parse time. Each page it reads is registered as a parser dependency, so any page usi..."

2026-10-01T15:48:45Z

Created page with "'''Module:ProjectCounts''' computes the figures shown in the statistics block on the Main Page (projects listed, screensavers archived, etc.) directly from the wikitext of the relevant pages, so the numbers stay current as tables and lists are edited. It is also used for section row counts on the BOINC projects page itself. The module reads the source wikitext of target pages at parse time. Each page it reads is registered as a parser dependency, so any page usi..."

New page

'''Module:ProjectCounts''' computes the figures shown in the statistics block on the [[Main Page]] (projects listed, screensavers archived, etc.) directly from the wikitext of the relevant pages, so the numbers stay current as tables and lists are edited. It is also used for section row counts on the [[BOINC projects]] page itself.

The module reads the source wikitext of target pages at parse time. Each page it reads is registered as a parser dependency, so any page using these invokes re-renders automatically when the target page changes. No manual purging or updating of figures is needed.

== Live test ==

The following invokes run against live data. Expected values as of October 2026 — 38, 6, 293, 337, 71, 101 — will drift upward as the wiki grows; a sudden '''0''' or a red "Script error" means something broke (check section heading names first).

Active: {{#invoke:ProjectCounts|count|Active BOINC Projects}}

Private: {{#invoke:ProjectCounts|count|Private BOINC Projects}}

Completed: {{#invoke:ProjectCounts|count|Completed BOINC Projects}}

Listed: {{#invoke:ProjectCounts|total|Active BOINC Projects|Private BOINC Projects|Completed BOINC Projects}}

Recordings: {{#invoke:ProjectCounts|recordings}}

Documented: {{PAGESINCATEGORY:BOINC projects|pages}}

== Functions ==

=== count ===

Counts the data rows in the wikitable(s) of one section of a page.

'''Usage:'''
<nowiki>{{#invoke:ProjectCounts|count|Section name|page=Page title}}</nowiki>

* <code>1</code> (required) — the section heading, exactly as written on the page (without the equals signs; any heading level works).
* <code>page</code> (optional) — page to read; defaults to <code>BOINC projects</code>.

'''Examples:'''

{| class="wikitable"
! Call !! Returns
|-
| <nowiki>{{#invoke:ProjectCounts|count|Active BOINC Projects}}</nowiki> || 38
|-
| <nowiki>{{#invoke:ProjectCounts|count|Completed BOINC Projects}}</nowiki> || 293
|-
| <nowiki>{{#invoke:ProjectCounts|count|Screensaver Gallery|page=BOINC project screensavers}}</nowiki> || 35 (project rows; see <code>recordings</code> below)
|}

''Return values recorded October 2026; they change as the tables grow.''

=== total ===

Sums the data rows of several sections of one page. This produces the "Projects listed" figure on the Main Page.

'''Usage:'''
<nowiki>{{#invoke:ProjectCounts|total|Active BOINC Projects|Private BOINC Projects|Completed BOINC Projects}}</nowiki>

Returns '''337''' (38 + 6 + 293 as of October 2026). <code>page</code> again defaults to <code>BOINC projects</code>.

=== recordings ===

Counts unique YouTube recordings in a section, by deduplicating video IDs found in <code>watch?v=</code> links, <code>youtu.be/</code> short links, and <code>img.youtube.com/vi/</code> thumbnail references. Sections where one table row holds several videos are counted correctly — this measures recordings, not rows.

'''Usage:'''
<nowiki>{{#invoke:ProjectCounts|recordings|Screensaver Gallery|page=BOINC project screensavers}}</nowiki>
<nowiki>{{#invoke:ProjectCounts|recordings}}</nowiki> 

Returns '''71''' as of October 2026.

=== documented ===

Counts distinct existing mainspace articles linked from a section — link targets must exist (redlinks are skipped) and namespaced links (<code>File:</code>, <code>Category:</code>, etc.) are ignored. Defaults to the curated project list on the Main Page.

'''Usage:'''
<nowiki>{{#invoke:ProjectCounts|documented|Local BOINC project wiki pages|page=Main Page}}</nowiki>
<nowiki>{{#invoke:ProjectCounts|documented}}</nowiki> 

Returns '''102''' as of October 2026 (101 project articles plus the link to the [[BOINC projects]] master table itself).

:''Note:'' the Main Page "Projects documented" stat currently uses <code><nowiki>{{PAGESINCATEGORY:BOINC projects|pages}}</nowiki></code> rather than this function. [[Template:Infobox software|Infobox software]] automatically adds [[:Category:BOINC projects]] to every article containing it, so the category count reflects documented project pages without relying on the curated list. <code>documented</code> remains available for counting any curated link list per se.

== How the counting works ==

; Section slicing
: The named heading is located at any heading level; the section runs until the next heading of the same or higher level (or end of page). Sub-sections are therefore included, but siblings are not. The heading name is matched exactly — a <code>== Screensaver Gallery ==</code> invoke will no longer match if the heading is later renamed, e.g. to "Gallery". If a function suddenly returns 0 after an edit, check the heading text first.
; Row counting (<code>count</code>, <code>total</code>)
: Data rows = number of <code>|-</code> row separators at line start, minus one per table for its header separator. Assumes each table has exactly one header row and that every data row begins with <code>|-</code> on its own line — the format used by all project tables on this wiki.

== Assumptions and limitations ==

* Table-format dependent in the manner described above. Free-form or multi-header tables will mis-count.
* Correct results depend on section headings staying constant; consider them part of the interface.
* Lua cannot enumerate category members or template transclusions. For "pages in a category" use <code><nowiki>{{PAGESINCATEGORY:Category name|pages}}</nowiki></code>; for "pages using a template" see [[Special:WhatLinksHere/Template:Infobox software]].

== Where the module is used ==

{| class="wikitable"
! Statistic !! Location !! Function used
|-
| Projects listed || [[Main Page]] || <code>total</code> over the three sections of [[BOINC projects]]
|-
| Screensavers archived || [[Main Page]] || <code>recordings</code> on [[BOINC project screensavers]]
|-
| Section row counts || [[BOINC projects]] section headers || <code>count</code> per section
|-
| Projects documented || [[Main Page]] || (category-based: <code><nowiki>{{PAGESINCATEGORY:BOINC projects|pages}}</nowiki></code>, powered by [[Template:Infobox software]])
|}

== Maintenance ==

An off-wiki audit script (<code>wiki_reconcile.py</code>, pure Python, no dependencies) cross-checks the curated Main Page list against pages transcluding the infobox; it reports documented-but-unlisted pages, listed pages lacking an infobox, and redlinks. Run it after large re-organizations of the project listings.

Module:ProjectCounts/doc - Revision history