[deps]
Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
DocumenterCitations = "daee34ce-89f3-4625-b898-19384cb65244"

[compat]
Documenter = "1"
DocumenterCitations = "1"

@article{GoerzQ2022,
    author = {Goerz, Michael H. and others},
    title = {Quantum Optimal Control},
    journal = {Physical Review A},
    year = {2022},
    doi = {10.1103/PhysRevA.105.032401}
}

@book{NielsenChuang2010,
    author = {Nielsen, Michael A. and Chuang, Isaac L.},
    title = {Quantum Computation and Quantum Information},
    publisher = {Cambridge University Press},
    year = {2010}
}

using Documenter
using DocumenterCitations
using MyPackage

bib = CitationBibliography(
    joinpath(@__DIR__, "src", "references.bib"),
    style = :authoryear  # or :numeric, :alpha
)

makedocs(
    plugins = [bib],
    sitename = "MyPackage.jl",
    pages = [
        "Home" => "index.md",
        "Bibliography" => "bibliography.md",
    ]
)

# Bibliography

```@bibliography

## Citation Syntax

### In Markdown

```markdown
The stabilizer formalism [gottesman1998heisenberg](@cite) enables efficient simulation.

See [NielsenChuang2010; Chapter 10](@cite) for details.

Previous work [GoerzQ2022, NielsenChuang2010](@cite) has shown...

"""
    stabilizer_simulation(circuit)

Simulate using the stabilizer formalism [gottesman1998heisenberg](@cite).
"""
function stabilizer_simulation(circuit) end

The tableaux formalism[^1] enables efficient simulation.

[^1]: [gottesman1998heisenberg](@cite)

bib = CitationBibliography("refs.bib", style = :authoryear)  # (Gottesman, 1998)
bib = CitationBibliography("refs.bib", style = :numeric)     # [1]
bib = CitationBibliography("refs.bib", style = :alpha)       # [Got98]

# All cited references
```@bibliography

Keys = ["GoerzQ2022", "NielsenChuang2010"]

*

Pages = ["chapter1.md"]

## Reference

- **[Complete Examples](references/examples.md)** - Full make.jl, BibTeX, and page examples

## Checklist

- [ ] `DocumenterCitations` in `docs/Project.toml`
- [ ] `.bib` file in `docs/src/`
- [ ] `CitationBibliography` created in `make.jl`
- [ ] Plugin passed to `makedocs(plugins = [bib], ...)`
- [ ] Bibliography page created with `@bibliography` block
- [ ] Bibliography page included in `pages`