Yuan1z0825/nature-skills / skills/nature-academic-search
nature-academic-search
FlaggedSearch literature across sources, verify or manage citations, and build MeSH strategies or citation-impact audits. Use for 文献检索、引文核对、参考文献管理、严格他引 and evidence-backed citer profiles; not for translating a paper or drafting manuscript prose.
references/ris-bibtex-format.md
View on GitHub# RIS and BibTeX Format Specifications
## Contents
- [RIS Format](#ris-format)
- [BibTeX Format](#bibtex-format)
- [ENW (EndNote Tagged) Format](#enw-endnote-tagged-format)
- [Text Escaping (ris_escape)](#text-escaping-ris_escape)
- [Format Selection Guide](#format-selection-guide)
## RIS Format
RIS is the standard import format for EndNote, Zotero, and most reference managers.
### Journal article template
```
TY - JOUR
AU - Last, First
AU - Last2, First2
TI - Article Title
JO - Journal Name (full)
JA - Journal Abbreviation
PY - 2024
VL - 10
IS - 3
SP - 123
EP - 145
DO - 10.1234/example
UR - https://doi.org/10.1234/example
AB - Abstract text
KW - keyword1
KW - keyword2
AN - PMID:12345678
DB - PubMed
ER -
```
### MEDLINE-to-RIS field mapping
| MEDLINE tag | RIS tag | Notes |
|---|---|---|
| `PMID-` | `AN - PMID:` | Accession number |
| `TI -` | `TI -` | Title |
| `AU -` | `AU -` | Last, First format |
| `JT -` | `JO -` | Full journal title |
| `TA -` | `JA -` | Journal abbreviation |
| `DP -` | `PY -` | Extract year only |
| `VI -` | `VL -` | Volume |
| `IP -` | `IS -` | Issue |
| `PG -` | `SP -` / `EP -` | Split on `-` |
| `AB -` | `AB -` | Abstract |
| `MH -` | `KW -` | MeSH as keywords |
| `LID -` | `DO -` | DOI (strip `[doi]` suffix) |
| `AID -` | `DO -` | Alternative DOI field |
| `SO -` | `JO -` | Source (journal + date + vol + pages) |
### RIS record separator
Each record must end with `ER -` followed by a blank line.
## BibTeX Format
### Journal article template
```bibtex
@article{pmid12345678,
author = {Last, First and Last2, First2},
title = {Article Title},
journal = {Journal Name},
year = {2024},
volume = {10},
number = {3},
pages = {123--145},
doi = {10.1234/example},
url = {https://doi.org/10.1234/example},
abstract = {Abstract text},
pmid = {12345678}
}
```
### Citation key convention
- Use `pmid` prefix + PMID: `pmid12345678`
- If no PMID: use `firstauthorYEAR` format, lowercase: `smith2024`
- If duplicate keys: append `a`, `b`: `smith2024a`
### MEDLINE-to-BibTeX field mapping
| MEDLINE tag | BibTeX field | Notes |
|---|---|---|
| `PMID-` | `pmid` | Custom field |
| `TI -` | `title` | Wrap in `{...}` to preserve case |
| `AU -` | `author` | `Last, First and Last, First` |
| `JT -` | `journal` | Full journal title |
| `DP -` | `year` | Extract 4-digit year |
| `VI -` | `volume` | |
| `IP -` | `number` | |
| `PG -` | `pages` | Replace `-` with `--` |
| `AB -` | `abstract` | |
| `LID -` / `AID -` | `doi` | Strip `[doi]` suffix |
### Required fields by entry type
**`@article`**: author, title, journal, year
**`@book`**: author/editor, title, publisher, year
**`@inproceedings`**: author, title, booktitle, year
**`@phdthesis`**: author, title, school, year
### BibTeX cleaning rules
- Remove unescaped `&` in author fields (replace with `\&`)
- Wrap titles with special characters in `{...}`
- Strip HTML tags from abstract
- Ensure consistent author separator: ` and `
- Sort entries alphabetically by citation key
## ENW (EndNote Tagged) Format
ENW uses percent-tagged fields for EndNote import. Supported by EndNote desktop and EndNote Web.
### Journal article template
```
%0 Journal Article
%T Article Title
%A Last, First
%A Last2, First2
%J Journal Name
%V 10
%N 3
%P 123-145
%D 2024
%R 10.1234/example
%U https://doi.org/10.1234/example
%X Abstract text
```
### MEDLINE-to-ENW field mapping
| MEDLINE tag | ENW tag | Notes |
|---|---|---|
| `TI -` | `%T` | Title |
| `AU -` | `%A` | Last, First format; one per author |
| `JT -` | `%J` | Full journal title |
| `VI -` | `%V` | Volume |
| `IP -` | `%N` | Issue |
| `PG -` | `%P` | Pages |
| `DP -` | `%D` | Year only |
| `LID -` / `AID -` | `%R` | DOI |
| — | `%U` | URL (derived from DOI) |
| `AB -` | `%X` | Abstract |
### EndNote import instruction
In EndNote: File > Import > File, choose the `.enw` file, set Import Option to EndNote generated XML or Tagged format, then import.
## Text Escaping (ris_escape)
Applied to all free-text fields (TI, AU, JO, N2/AB, KW) in RIS and ENW output:
- HTML tags stripped: `<sup>1</sup>` → `1`
- Whitespace normalized: multiple spaces/newlines → single space
- Leading/trailing whitespace trimmed
- Abstract truncated to 500 chars in RIS/ENW to keep records compact
## Format Selection Guide
| User says | Use format |
|---|---|
| "EndNote", ".enw" | ENW (EndNote tagged) or RIS |
| "Zotero" | RIS (Zotero imports RIS natively) |
| "LaTeX", "BibTeX", "Bib" | BibTeX (.bib) |
| "PubMed format", "MEDLINE", ".nbib" | .nbib (default) |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |