Borges Bibliography Builder
| 开发者 | dpknauss |
|---|---|
| 更新时间 | 2026年8月19日 23:24 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
borges-bibliography-builder text domain, and official WordPress.org language packs are generated as community translations are approved on translate.wordpress.org.
Support development. If Borges saves you time by bringing order to your citations and joy to your heart, you can sponsor the author to support ongoing maintenance.
安装:
- Upload the plugin files to
/wp-content/plugins/borges-bibliography-builder/, or install directly through the WordPress plugin screen. - Activate the plugin through the 'Plugins' screen in WordPress.
- Add the "Bibliography" block to any post or page.
- Paste DOI(s), PubMed/PMID identifiers, BibTeX, CSL-JSON, or supported citations for books, articles, chapters, and webpages — or add citations manually.
屏幕截图:
常见问题:
Which translations are available?
The WordPress.org plugin page's Languages list is the canonical list of currently published language packs. English (US) is the source language and is not counted as a translated locale; other locales appear after their Stable plugin translations are approved on translate.wordpress.org and a language pack is generated.
The package includes seed PO/MO files for translator review and import in French (fr_FR), German (de_DE), Dutch (nl_NL), Swedish (sv_SE), Spanish (es_ES), Italian (it_IT), Portuguese (pt_PT), Polish (pl_PL), Russian (ru_RU), Japanese (ja), Simplified Chinese (zh_CN), Korean (ko_KR), Serbian (sr_RS), Croatian (hr), Brazilian Portuguese (pt_BR), Hindi (hi_IN), Bengali (bn_BD), Tamil (ta_IN), and Telugu (te). These files cover plugin interface strings only and should not be read as official WordPress.org language-pack availability.
What citation input formats does the Borges Bibliography Builder support?
Bare DOIs, DOI URLs, PubMed/PMID identifiers, BibTeX, CSL-JSON, manual citation entries, and supported formatted citations for books, articles, chapters, webpages, reviews, and theses/dissertations. Free-text citations that include an inline DOI or labeled PMID are routed through the DOI/PubMed resolvers before falling back to the heuristic parser. RIS is supported as an export format, not as an import format. You can paste multiple entries at once, up to 50 per paste, and each bibliography holds up to 200 citations in total.
Does the ABNT style implement NBR 6023:2018?
Yes. The ABNT option targets Associação Brasileira de Normas Técnicas bibliography formatting under NBR 6023:2018, uses the pt-BR locale, and defaults new ABNT bibliographies to the heading Referências. Always verify institutional or journal-specific ABNT variants before submission.
What happens if I deactivate the Borges Bibliography Builder?
Your bibliographies remain fully readable. The block uses static HTML output, so all formatted citations stay in your post content.
What happens if I delete the Borges Bibliography Builder?
Your bibliographies stay in your posts — they are saved as static HTML, not in a database table the plugin owns. When you delete the plugin, Borges removes only its own cached lookup data (transient and object-cache entries) and leaves your content untouched.
Does the Borges Bibliography Builder work with Zotero, Mendeley, EndNote, and other citation managers?
Yes. Borges is built around portable bibliography formats rather than lock-in. Zotero can use DOI links, BibTeX, RIS, CSL-JSON, and optional COinS metadata. Mendeley and EndNote are best supported through BibTeX/RIS exports, with DOI-backed entries also friendly to browser importers. JabRef, BibDesk, and LaTeX/Biber workflows can use UTF-8 BibTeX or BibLaTeX. CSL-JSON is available for citeproc and scholarly data workflows.
Why would I enable CSL-JSON?
Enable CSL-JSON if you want your bibliography data to be reusable by scholarly tools, scripts, or services without scraping the visible citation text.
Can I export the bibliography data?
Yes. In the editor you can download the whole bibliography as CSL-JSON, BibTeX, BibLaTeX, or RIS, copy any single citation, or copy the full bibliography as plain text. You can also enable a per-entry Cite / Export panel that places the same RIS, CSL-JSON, BibTeX, and BibLaTeX downloads — plus the citation text — directly on the published page for your readers. The reader-facing panel is static and JavaScript-free and is off by default.
Can I access bibliography data via API?
Yes. The plugin exposes read-only REST endpoints at /wp-json/bibliography/v1/posts/<post_id>/bibliographies and /wp-json/bibliography/v1/posts/<post_id>/bibliographies/<index>. Published posts are readable publicly; non-public posts require permission to edit the post. The single-bibliography route also supports format=json, format=text, and format=csl-json. Editor-only authenticated endpoints handle CSL formatting and PubMed/PMID resolution; they do not persist citations by themselves.
Does the Borges Bibliography Builder work on WordPress Multisite?
Yes. Borges works on WordPress Multisite, including network activation. If you encounter issues on a specific network configuration, please report them.
What PHP and WordPress versions are supported?
PHP 7.4+ and WordPress 6.4+. Borges Bibliography Builder is tested up to WordPress 7.1.
Does Borges work with the Block Accessibility Checks plugin?
Yes, and the integration is entirely optional. When Block Accessibility Checks 4.0 or later is active, the Bibliography block registers four authoring-time checks: an error when the block contains no citations, and warnings for a missing heading, for citations whose link text is a bare URL or DOI, and for having every machine-readable metadata output disabled. You can adjust each check's severity, or turn it off, from the Block Accessibility Checks settings screen. Version 4.0 replaced the plugin's registration API, so the integration requires 4.0 or later. On Block Accessibility Checks 3.x the integration stays dormant and no bibliography checks appear. Borges itself is unaffected and works normally whether that plugin is outdated or not installed at all.
更新日志:
- 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.
- 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.
- 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
httpandhttps, and any other scheme renders as plain text. Nothing downstream would have caught ajavascript:link; the only thing preventing one was the URL-detection pattern requiring a literalhttp(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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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_bibliographyerror andheading_missingwarning 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.
- 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.
- 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.
- 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.
- 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-builderslug and zip name. - Add CI/runtime coverage for Multisite network activation and expanded PHP utility behavior.
- Confirm compatibility wording through WordPress 7.0 testing.