Borges Bibliography Builder
| 开发者 | dpknauss |
|---|---|
| 更新时间 | 2026年5月11日 21:40 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | 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.
安装:
- 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 entries, or supported citations for books, articles, chapters, and webpages.
屏幕截图:
常见问题:
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 entries, and supported formatted citations for books, articles, chapters, webpages, reviews, and theses/dissertations. You can paste multiple entries at once, up to 50 entries per add.
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.
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. The editor currently includes Download CSL-JSON, Download BibTeX, Download BibLaTeX, Download RIS, per-entry Copy citation, and Copy bibliography actions for exporting or reusing bibliography data.
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. CI includes a Multisite runtime smoke lane with 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.0.
更新日志:
- 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.