Borges Bibliography Builder -- WordPress 插件

开发者	dpknauss
更新时间	2026年10月26日 07:23
捐献地址:	去捐款
PHP版本:	7.4 及以上
WordPress版本:	7.1
版权:	GPLv2 or later
版权网址:	版权信息

1.15.0

Added: bulk reformat across posts. With the write routes turned on, POST /bibliography/v1/bulk/reformat switches every bibliography in up to 25 posts to one citation style and saves each post once. It needs edit_others_posts plus edit_post on each post, previews unless dry_run=false, and returns the posts it did not reach as remaining. The borges/bulk-reformat ability and wp borges reformat <post-id>... --style=<key> --user=<user> do the same.
Added: bulk deduplicate across posts. POST /bibliography/v1/bulk/deduplicate, the borges/bulk-deduplicate ability, and wp borges deduplicate remove repeated citations within each bibliography, keeping the first copy. A work listed in two bibliographies of one post is reported and left in place.
Added: a rate limit for bulk edits: 250 posts per user per 15 minutes, dry runs included, and one saving bulk request at a time per site. Responses carry RateLimit-* headers; a request over the limit gets 429 with Retry-After. Filters let hosts change the numbers. WP-CLI commands spend no budget.
Fixed: editing a citation can no longer turn it into a copy of another citation in the same bibliography. The block's field editor refuses the edit with a notice, and the REST update route and borges/update-citation ability return 409. Repeats across two bibliographies on a page are still allowed.

1.14.0

Added: WP-CLI commands. wp borges list <post-id> lists a post's bibliographies, wp borges export <post-id> prints one as CSL-JSON, plain text, or JSON, and wp borges validate <post-id> reports errors and warnings for every entry and exits 1 when there are errors. They change nothing. Without --user they read any post, as WordPress's own commands do; with --user they apply that user's permissions, the same as the REST API.
Fixed: works by the same authors in the same year are told apart in APA, Chicago author-date, Harvard, and ABNT: "Jones, T. (2020a)." and "(2020b).", lettered in the order the bibliography lists them. Saved posts stay valid; a bibliography takes its letters the next time it is formatted (when a citation is added, edited, or removed, or the style changes). The REST write routes and abilities keep the letters current too.

1.13.0

Added: richer structured data for search engines and AI crawlers. As a page renders, each cited work in the bibliography's JSON-LD gains an @id, its DOI, PMID, PMCID, arXiv, and ISBN identifiers with sameAs links, journal issue and volume, pages, editors and translators, and a closer schema.org type, and each entry links to its place on the page. Published posts get this without being edited. The bibliography_builder_enrich_json_ld filter turns it off.
Added: with Yoast SEO or Rank Math, the page's Article lists the cited works under schema.org citation. The bibliography_builder_link_page_citations filter turns it off.
Added: the bibliography_builder_output_defaults filter sets which outputs (JSON-LD, COinS, CSL-JSON, Cite / Export) a newly inserted bibliography starts with. Existing blocks keep their settings, and Borges still stores no settings.

1.12.0

Added: write abilities for AI agents and automation on WordPress 6.9+ (add, update, delete, and reorder citations; change a bibliography's settings or style). They exist only when a site turns on the write routes with the bibliography_builder_enable_write_routes filter, and follow the same rules: edit_post on the post and a preview unless asked to save.
Fixed: bibliographies in newsletters and feeds. Posts sent by email (Jetpack and WordPress.com newsletters, MailPoet, WooCommerce, Newspack) or read in a feed reader no longer show every reference in italics or a broken Cite / Export panel. Posts saved earlier are cleaned up as they are sent, and switch to the new markup the next time they are saved.
Fixed: names with particles ("van Duijnhoven", "de la Cruz") sort where each style puts them: under the surname proper in Chicago and Vancouver, under the particle in APA, MLA, Harvard, and the others.
Fixed: no period after a quoted title that ends in "?" or "!" in Chicago and MLA.
Changed: reformatting after an edit is much faster in long bibliographies: only the changed entries are formatted, about 5 ms instead of 65–105 ms for 200 entries.
Changed: internal restructuring and stricter static analysis, with no change to saved markup or output.

1.11.0

Fixed: link cards no longer credit a cited source as the post's author. The JSON-LD listed cited works as top-level objects, and Mastodon takes the first top-level WebPage on a page to be the page itself, so a post citing a museum's collection page was shared "by Albertina". Cited works are now nested in one schema.org ItemList. Published posts are corrected as they are rendered, without being edited.
Fixed: bibliographies over 50 citations. The server formatter now takes up to 200 entries per request, matching the editor, instead of falling back to plain titles with a "Formatter unavailable" notice.

1.10.0

Added: library catalog numbers. Paste an OCLC number, an LCCN, or an Open Library edition ID (or their WorldCat, lccn.loc.gov, or Open Library links) and the book is looked up through Open Library. When Open Library has no record, Borges says so and suggests the ISBN.
Added: Internet Archive items. Paste an archive.org item link, ia:<identifier>, or an Internet Archive ARK. Borges cites the edition the item names (its Open Library edition, ISBN, or LCCN) and keeps the archive.org page as the link, or tidies the scan's own record when it names none.
Added: an optional Google Books API key for the ISBN fallback, set with the BIBLIOGRAPHY_BUILDER_GOOGLE_BOOKS_API_KEY constant or a filter, so lookups no longer depend on Google's shared anonymous quota. Borges still stores no settings.
Changed: "Edit fields" now works on every citation, not only ones typed as free text. Only the fields you change are saved; untouched DOIs, URLs, authors, and dates stay exactly as imported.
Fixed: a journal name that is part of its own DOI, such as eLife, is no longer italicized inside the DOI link, which split the link. Bibliographies saved with the broken link stay valid and are fixed the next time they are saved.
Fixed: "Place: Publisher" in pasted citations (London: Boyars, 1976) is split into place and publisher.
Fixed: Chinese, Japanese, and Korean author names, and names with a gloss in parentheses, are kept whole in book lookups; a leading Dr., Prof., Mr., Mrs., Ms., Mx., or Rev. is dropped.

1.9.1

Added: pasting CSL-JSON, such as a reference manager's "CSL JSON" export, now imports each item as a citation. Items that are not valid citations are skipped and named, and JSON that is not CSL-JSON gets its own message.
Fixed: a title the citation style puts in quotation marks, such as a web page in Chicago, is no longer also italicized.
Fixed: the structured data (JSON-LD) link for a DOI keeps its slash, matching the visible link.
Bibliographies saved with the old output stay valid and pick up the fixes the next time they are saved.

1.9.0

Added: a Heading Level setting for the block's visible heading. Choose a level from 2 to 6 to print it as a real heading, so the bibliography appears in the page's heading outline and screen reader users can reach it by heading navigation. The default is still a paragraph, so existing bibliographies are unchanged. The heading keeps the same size at every level.

1.8.2

Fixed: the edit form stores Title, Authors, Container title, Publisher, and Pages as plain text, as imports and manual entry already do. Markup typed or pasted into those fields is dropped on save instead of being stored in the citation.

1.8.1

Fixed: HTML tags in a citation no longer show as text. An entry whose stored text or title carried tags, such as <i>Governing the Commons</i>, printed them literally; now <i> and <em> render as italics and other tags are dropped, in the bibliography, the editor, copied text, and exports. Affected bibliographies stay valid and pick up the fix the next time they are saved.

1.8.0

Current editions of four styles. Chicago moves to the 18th edition (2024), Harvard to Cite Them Right 13 (2025), OSCOLA to its 5th edition (2026), and ABNT to NBR 6023:2025. Chicago now lists up to six authors before "et al.", books drop the place of publication in Chicago and Harvard, and OSCOLA and ABNT need no access date for a DOI. Existing bibliographies keep their saved text until an entry is added or edited or the style is changed.
New: MLA repeated authors. In an MLA works-cited list, an entry by exactly the same authors as the one before it now starts with three hyphens, as the MLA Handbook asks. Screen readers still hear the names, and copied text and exports keep them in full. Existing MLA bibliographies stay valid and pick up the hyphens the next time they are saved.
New: Article number field. Journal articles get an Article number field in the edit form and manual entry. Cite Them Right prints it as "article 108125" in place of pages, and DOI imports fill it automatically.
Fixed: after an upgrade, cached formatting from an older style edition is no longer reused.

1.7.0

Better formatting in every citation style. All nine styles are rewritten in full from their style manuals: Chicago (notes-bibliography and author-date), APA 7, MLA 9, Harvard, IEEE, Vancouver, OSCOLA, and ABNT. Entries now keep full given names, volume, issue, and pages, editors, translators, editions, and access dates, and follow each manual's author-list and "et al." rules. ABNT now prints in Portuguese, and Harvard uses British conventions. Existing bibliographies keep their saved text until an entry is added or edited or the style is changed.
Fixed: organization authors (such as "Open Research Alliance") no longer vanish from formatted entries, and an entry after one shortened to "et al." keeps the "and" before its last author.
Fixed: "Attempt Block Recovery" in other languages. A bibliography no longer opens as invalid when an editor using a different language from the one who saved it opens the post. Cite / Export labels are now translated for visitors as the page renders.
Fixed: wrong translations. In all 19 bundled translations, seven strings such as "Copy citation" showed as "Add citations". They now fall back to English until corrected.
Fixed: whole .bib exports from reference managers. Zotero abstracts with blank lines, JabRef comments and @string macros, and EndNote reference-type names no longer lose or garble records.
Fixed: duplicated blocks no longer share IDs with the original, and pasting CSL-JSON is rejected instead of producing a nonsense citation.
New for developers: review and write routes. Users who can edit a post can validate a bibliography, list likely duplicates, and preview it in another style over REST or as WordPress 6.9 abilities, without saving anything. Sites can also opt in to write routes that change citations, block settings, and the citation style over REST. They are off by default, preview every change first, and save through normal post revisions.
Playground demo: the live demos open on a page with copy-ready samples of every input format and three example bibliographies.

1.6.0

New: PubMed Central import. Paste a PMCID (PMC3531190) and it is looked up through the same NCBI service as PubMed IDs.
New: arXiv import. Paste an arXiv ID, an arxiv.org link, or an arXiv DOI (arXiv:1706.03762, 10.48550/arXiv.1706.03762) and it is looked up through the arXiv API. arXiv DOIs used to fail because Crossref doesn't hold them.
New: ISBN import. Paste ISBN 978-0-14-032872-1 or a labeled ISBN-10 and the book is looked up through Open Library, with Google Books as a fallback. Checksums are verified before any lookup, and a Google result is used only if it carries the exact ISBN you pasted.
New: BibLaTeX import (date, journaltitle, @online, and similar) is now covered by tests. Formatted citations that contain a PMCID, arXiv ID, or labeled ISBN are looked up the same way as the bare identifier.
New: WordPress Abilities (WordPress 6.9 and later). Three read-only abilities let AI assistants and automation tools list a post's bibliographies, export one as CSL-JSON or plain text, and check citation records, with the same permissions as the existing REST routes. Nothing can be changed through them.
Fixed: invalid language tags on imported entries. BibTeX language and BibLaTeX langid values such as ngerman were saved verbatim into the entry's HTML lang attribute, which assistive technology cannot use. They now map to standard tags (ngerman → de); unknown values are left out. Already-saved entries are unchanged.
Fixed: arXiv links from BibTeX. arXiv preprints pasted as BibTeX or BibLaTeX now keep a link to the abstract page instead of dropping the eprint.
Translations: the translation template is back in sync with the plugin. A few help strings changed to name the new identifier types.
Privacy: the External Services section now also lists arXiv, Open Library, and Google Books. Each is contacted only from the editor, only when you paste that kind of identifier, and receives only the identifier.

1.5.1

WordPress 7.1 support. Verified against a 7.1 release candidate: the block registers and renders in the editor, which 7.1 now always runs inside an iframe, and bibliographies still format correctly in every citation style tested.
Fixed: copying could report failure when copying was still possible. Both Copy citation and Copy bibliography had a fallback for browsers without clipboard access, but only used it when that access was missing entirely — not when the browser offered it and then refused. A refusal now falls through to the fallback instead of reporting failure.

1.5.0 Security release. Updating is recommended for all sites.

Security: Fixed a denial-of-service weakness in the public bibliography REST route, present in 1.4.2 and earlier. Reading a bibliography ran its stored citation text through WordPress tag stripping with no length limit, and past roughly 600 KB that operation degrades badly — a single oversized value saved into a published post cost about 12 seconds of pinned CPU on every read, on a route that requires no login and can be requested repeatedly at no cost to the caller. Stored text is now truncated to 64 KB before stripping, so existing bibliographies still render. This is the change that makes updating worthwhile.
Security: Applied the same 64 KB limit to citation text sent to the formatter endpoint, where any user who can reach the block editor could otherwise tie up a CPU core per request.

The three changes below are hardening. None of them was exploitable; each was a case where the plugin happened to be safe because of how some unrelated code was written, which is a property that quietly stops holding when that code changes.

Hardening: Bibliography data in a post type registered as non-public is no longer readable without authentication. Published status alone previously satisfied the check. Anyone able to edit the post still has access.
Hardening: Links generated from citation text are now restricted to http and https, and any other scheme renders as plain text. Nothing downstream would have caught a javascript: link; the only thing preventing one was the URL-detection pattern requiring a literal http(s):// prefix, which a later improvement to that pattern could have removed.
Hardening: PubMed/PMID lookups now use WordPress's safe HTTP client, so every redirect in the chain is validated against the site's own network.
Escape two Unicode line-separator characters in the JSON-LD and CSL-JSON output blocks. Not a security issue — these blocks are never executed — but the characters terminate a line for a JavaScript parser and would break a consumer that evaluates a block instead of parsing it.
Update the Block Accessibility Checks (BAC) integration for BAC 4.0, which replaced the registration API and renamed its editor filter hooks. All four bibliography checks — empty bibliography, missing heading, raw URL link text, and all metadata outputs disabled — are now admin-configurable from BAC's unified settings screen.
The BAC integration now requires Block Accessibility Checks 4.0 or later. On BAC 3.x the integration stays dormant and no bibliography checks appear; Borges itself works normally whether BAC is outdated or not installed at all.
Add a regression test that validates every shipped bibliography markup format against the block's own deprecation chain, guarding existing posts against "Attempt Block Recovery" prompts after an upgrade.
Fix the end-to-end test covering the Block Accessibility Checks integration, which silently skipped itself and left the integration without real coverage.
Add a second WordPress Playground demo that boots the current development build alongside the released-version demo.
Add a scheduled monitor that verifies each Playground demo link stays reachable.
Publish hand-verified size, footprint, and runtime-overhead metrics, each paired with the command used to re-derive it, and add a continuous-integration check that fails when the recorded lines-of-code figures or the no-persistent-storage audit drift.

1.4.2

Resolve DOI and labeled PMID identifiers embedded in free-text citation pastes through the existing CrossRef and PubMed resolver paths.
Fall back from embedded-identifier resolution to the heuristic free-text parser before showing unsupported-input guidance.
Add free-text sample documentation for supported embedded DOI/PMID citation inputs.
Stabilize numeric citation reorder E2E coverage against editor readiness races.
Clarify that RIS is supported for export, not import.

1.4.1

Clean up after the plugin when it is deleted: uninstalling now removes the plugin's cached data — the formatter and PubMed/PMID transients (across all sites on multisite) and its object-cache groups where the host supports it. Bibliography blocks already saved in your posts are left untouched.

1.4.0

Add optional per-entry Cite / Export affordances to the public bibliography: a static, no-JS <details> disclosure panel under each entry with the citation text and one-click downloads for RIS, CSL-JSON, BibTeX, and BibLaTeX. Enable it per block with the new "Per-entry Cite / Export" toggle in the Metadata output panel; off by default.
Pre-compute BibTeX and BibLaTeX export data in the editor so the front-end downloads work without activating the plugin, and derive readable download filenames from each citation (for example, watson1953.ris).
Only pre-compute export data when the feature is enabled, so bibliographies that do not use Cite / Export incur no extra editor work.
Use a secure-context-safe helper for generating citation and bibliography IDs.
Remove a dead, never-loaded duplicate of the PMID resolver (includes/pmid.php) to eliminate a function-redeclare risk.
Fix DOI imports for works that Crossref labels with a non-standard type such as "monograph" (common for university-press books), which previously failed to import; unrecognized types now map to a sensible CSL type or fall back gracefully instead of aborting the import.
Fix the default Chicago Notes-Bibliography style (and OSCOLA and MLA) dropping the publication year on every entry; those styles used an issued-date form the formatter does not render. All bundled styles now show the year, guarded by a regression test.
Title-case author names and titles that Crossref or PubMed return in ALL CAPS (e.g. "TURING" / "I.—COMPUTING MACHINERY AND INTELLIGENCE") so they no longer render shouting; already-cased text, initials, organizations, and non-Latin scripts are left untouched.

1.3.4

Refresh the translation template and 19 seed PO/MO locale pairs from current source strings.
Add i18n artifact validation to CI so POT, PO, MO, and public language-pack wording stay aligned.
Clarify that bundled seed language files are translator/import material and WordPress.org Languages remains canonical for official packs.
Update docs for the current maintenance state and archive historical planning notes out of active paths.

1.3.3

Restore DOI imports in browser-based WordPress Playground by resolving DOI metadata through Crossref's CORS-friendly CSL transform endpoint.
Serialize DOI lookups to respect Crossref's public concurrency limit when multiple DOIs are pasted together.
Add a PubMed/PMID sample to the Playground starter content alongside DOI and BibTeX examples.

1.3.2

Add optional Block Accessibility Checks compatibility: soft-detects the BAC plugin and registers four editor checks (empty bibliography, missing heading, raw URL link text, all metadata disabled). Borges works normally when BAC is absent.
Harden Playwright E2E plugin-row locator to exclude WordPress update notice rows, fixing CI strict-mode violations.
Regenerate translation template (POT) with 81 strings, up from 41; covers PHP error messages, BAC check strings, BibLaTeX export labels, and citation reorder controls.
Extend banner generation script with locale and RTL support flags.

1.3.1

Raise per-bibliography hard cap from 50 to 200 citations. Bibliographies between 100 and 199 citations now show a dismissible editor notice warning about potential formatting slowness on shared hosting. The per-paste limit (50 entries) is unchanged.

1.3.0

Enforce an explicit 50-citation total cap per bibliography block with inline editor warnings, replacing the silent 51-entry formatter cliff.
Guard all async editor mutation flows (paste/import, manual add, delete, style switch, structured edit) against stale results from superseded in-flight format requests.
Remove redundant formatter call in the manual-entry add path; the merged bibliography is now formatted once instead of twice.
Prune non-runtime vendor documentation and images from the release zip and exclude composer.lock, reducing release package weight.
Cache successful PMID proxy responses and deduplicate pending DOI resolution requests to reduce avoidable network traffic.
Refactor editor side-effects into focused hooks: useCitationImportActions, useManualCitationActions, and useBibliographyExportActions.
Extract PHP PMID resolver, cache, and permission logic into includes/pmid.php.

1.2.0

Add BibLaTeX export from the editor exports panel.
Highlight 1.2.0 interoperability features, recent 1.1.x accessibility fixes, and ABNT (Associação Brasileira de Normas Técnicas / NBR 6023:2018) support in the readmes and changelogs.
Add PMID input resolution through an authenticated WordPress REST proxy to the NCBI/PMC Literature Citation Exporter API.
Add manual reordering controls for numeric citation styles, including keyboard Alt+Arrow movement.
Reformat the full bibliography after citation mutations so cached display text, sort order, and metadata stay aligned.
Improve sort parity with style-family dispatch, author-date tie-breakers, and JS/PHP coordination fixtures.
Improve accessibility names for saved citation URL links and block toolbar controls.
Harden Playwright accessibility and Playground smoke tests for shared WordPress Playground servers.
Add compact matrix coverage for all nine styles, formatter output, export ordering, and PMID REST proxy regression before tagging 1.2.0.

1.1.1

Fix Block Accessibility Checks (BAC) integration shipped in 1.1.0: register against the current BAC API, harden the soft opt-in, and load validation checks reliably so the empty_bibliography error and heading_missing warning fire as documented when the BAC plugin is active.
Fix editor focus-ring regression so keyboard focus on entry actions remains visible.
Fix Playground demo blueprint to install from the latest release zip rather than a stale path.

1.1.0

Add optional Block Accessibility Checks (BAC) integration: when Troy Chaplin's Block Accessibility Checks plugin is active, the bibliography block registers two authoring-time checks — an error if no citations have been added, and a warning if no heading is set so screen reader users navigating by heading can find the section.
No functional change when BAC is not installed.

1.0.2

Fix browser-based WordPress Playground demos by explicitly enabling the Playground Intl feature in addition to the kitchen-sink PHP extension bundle.
Keep the GitHub demo blueprint and WordPress.org Preview blueprint aligned for Intl-enabled citation formatting, with regression coverage.
Clarify translation wording so the readme distinguishes bundled seed PO/MO files from official WordPress.org language packs.

1.0.1

Fix Playground/editor bibliography formatting by using the WordPress REST API fetch helper for formatter requests.
Add the WordPress.org Preview blueprint at the documented assets path with the required PHP extension bundle for citation formatting.

1.0.0

Initial public release as Borges Bibliography Builder.
Add references from DOIs, DOI URLs, BibTeX entries, supported formatted citations, or manual entry.
Format bibliographies in Chicago Notes-Bibliography, Chicago Author-Date, APA 7, MLA 9, Harvard, Vancouver, IEEE, OSCOLA, and ABNT (Associação Brasileira de Normas Técnicas / NBR 6023:2018).
Automatically sort entries per style rules and skip duplicate manual or pasted entries.
Save static HTML output so bibliographies remain readable after plugin deactivation.
Output Schema.org JSON-LD by default, with optional COinS and CSL-JSON metadata layers.
Export CSL-JSON, UTF-8 BibTeX, and RIS; copy individual citations or the full bibliography as plain text.
Preserve Unicode quotation marks in BibTeX exports for Zotero, Mendeley, and other citation-manager imports.
Provide reference-manager-friendly metadata and exports for Zotero, Mendeley, EndNote, JabRef, BibDesk, LaTeX, and CSL/citeproc workflows.
Improve accessibility with keyboard navigation, visible focus, block-local notices, semantic bibliography markup, and no deprecated bibliography-entry ARIA role in newly saved output.
Provide read-only REST API endpoints for programmatic bibliography access.
Bundle seed interface locale files for translator review/import while using WordPress.org language packs as the canonical availability signal.
Harden the WordPress.org release package with third-party notices and Plugin Check cleanup.
Standardize GitHub, Playground, and release-download links on the approved borges-bibliography-builder slug and zip name.
Add CI/runtime coverage for Multisite network activation and expanded PHP utility behavior.
Confirm compatibility wording through WordPress 7.0 testing.

Borges Bibliography Builder

标签

下载

详情介绍:

安装:

屏幕截图:

升级注意事项:

常见问题:

更新日志: