DocumenterCitations.jl integration

This page shows the DocumenterCitations.jl integration and what it looks like. You can use DocumenterCitations in DocumenterVitepress in the same way that you use them in Documenter!

This page's source was taken from the DocumenterCitations docs and rendered via DocumenterVitepress.

Citation Style Gallery

The citation style is determined when instantiating the CitationBibliography, via the style argument.

The built-in styles are:

Numeric style

This is the default style (style=:numeric) used throughout the other pages of this documentation, cf. the Syntax examples.

  • [GoerzQ2022](@cite) renders as "[1]"
  • [FuerstNJP2014,SolaAAMOP2018](@cite) renders as "[2, 3]"
  • [GoerzQ2022](@citet) renders as "Goerz et al. [1]"
  • [GoerzQ2022](@citep) renders as "[1]" — @citep is the same as @cite for this style
  • [GoerzQ2022; Eq. (1)](@cite) renders as "[1, Eq. (1)]"
  • [GoerzQ2022; Eq. (1)](@citet) renders as "Goerz et al. [1], Eq. (1)"
  • [GoerzQ2022](@citet*) renders as "Goerz, Carrasco and Malinovsky [1]"
  • [GoerzQ2022; Eq. (1)](@citet*) renders as "Goerz, Carrasco and Malinovsky [1], Eq. (1)"
  • [WinckelIP2008](@citet) renders as "von Winckel and Borzì [4]"
  • [WinckelIP2008](@Citet) renders as "Von Winckel and Borzì [4]"
  • [BrumerShapiro2003, BrifNJP2010, Shapiro2012, KochJPCM2016; and references therein](@cite) renders as "[5–8, and references therein]"
  • [BrumerShapiro2003, BrifNJP2010, Shapiro2012, KochJPCM2016; and references therein](@Citet) renders as "Brumer and Shapiro [5], Brif et al. [6], Shapiro and Brumer [7], Koch [8], and references therein"
  • [arbitrary text](@cite GoerzQ2022) renders as "arbitrary text"

References:

[1]
M. H. Goerz, S. C. Carrasco and V. S. Malinovsky. Quantum Optimal Control via Semi-Automatic Differentiation. Quantum 6, 871 (2022).
[2]
H. A. Fürst, M. H. Goerz, U. G. Poschinger, M. Murphy, S. Montangero, T. Calarco, F. Schmidt-Kaler, K. Singer and C. P. Koch. Controlling the transport of an ion: Classical and quantum mechanical solutions. New J. Phys. 16, 075007 (2014). Special issue on coherent control of complex quantum systems.
[3]
I. R. Sola, B. Y. Chang, S. A. Malinovskaya and V. S. Malinovsky. Quantum Control in Multilevel Systems. In: Advances In Atomic, Molecular, and Optical Physics, Vol. 67, edited by E. Arimondo, L. F. DiMauro and S. F. Yelin (Academic Press, 2018); Chapter 3, pp. 151–256.
[4]
G. von Winckel and A. Borzì. Computational techniques for a quantum control problem with H$^1$-cost. Inverse Problems 24, 034007 (2008).
[5]
P. Brumer and M. Shapiro. Principles and Applications of the Quantum Control of Molecular Processes (Wiley Interscience, 2003).
[6]
C. Brif, R. Chakrabarti and H. Rabitz. Control of quantum phenomena: past, present and future. New J. Phys. 12, 075008 (2010).
[7]
M. Shapiro and P. Brumer. Quantum Control of Molecular Processes. Second Edition (Wiley and Sons, 2012).
[8]
C. P. Koch. Controlling open quantum systems: tools, achievements, and limitations. J. Phys.: Condens. Matter 28, 213001 (2016).

Author-year style

The author-year style (style=:authoryear) formats citations with the author name and publication year. This is the citation style used, e.g., in Rev. Mod. Phys. (rmp option in REVTeX). The bibliography is sorted alphabetically by author name. The default @cite command is parenthetical (@cite and @citep are equivalent) which is different from the authoryear style in natbib.

  • [GoerzQ2022](@cite) renders as "(Goerz et al., 2022)"
  • [FuerstNJP2014,SolaAAMOP2018](@cite) renders as "(Fürst et al., 2014; Sola et al., 2018)"
  • [GoerzQ2022](@citet) renders as "Goerz et al. (2022)"
  • [GoerzQ2022](@citep) renders as "(Goerz et al., 2022)" — @citep is the same as @cite for this style
  • [GoerzQ2022; Eq. (1)](@cite) renders as "(Goerz et al., 2022; Eq. (1))"
  • [GoerzQ2022; Eq. (1)](@citet) renders as "Goerz et al. (2022), Eq. (1)"
  • [GoerzQ2022](@cite*) renders as "(Goerz, Carrasco and Malinovsky, 2022)"
  • [GoerzQ2022](@citet*) renders as "Goerz, Carrasco and Malinovsky (2022)"
  • [GoerzQ2022; Eq. (1)](@cite*) renders as "(Goerz, Carrasco and Malinovsky, 2022; Eq. (1))"
  • [GoerzQ2022; Eq. (1)](@citet*) renders as "Goerz, Carrasco and Malinovsky (2022), Eq. (1)"
  • [WinckelIP2008](@citet) renders as "von Winckel and Borzì (2008)"
  • [WinckelIP2008](@Citet) renders as "Von Winckel and Borzì (2008)"
  • [BrumerShapiro2003, BrifNJP2010, Shapiro2012, KochJPCM2016; and references therein](@cite) renders as "(Brumer and Shapiro, 2003; Brif et al., 2010; Shapiro and Brumer, 2012; Koch, 2016; and references therein)"
  • [BrumerShapiro2003, BrifNJP2010, Shapiro2012, KochJPCM2016; and references therein](@Citet) renders as "Brumer and Shapiro (2003), Brif et al. (2010), Shapiro and Brumer (2012), Koch (2016), and references therein"
  • [arbitrary text](@cite GoerzQ2022) renders as "arbitrary text"

References:

  • Brif, C.; Chakrabarti, R. and Rabitz, H. (2010). Control of quantum phenomena: past, present and future. New J. Phys. 12, 075008.
  • Brumer, P. and Shapiro, M. (2003). Principles and Applications of the Quantum Control of Molecular Processes (Wiley Interscience).
  • Fürst, H. A.; Goerz, M. H.; Poschinger, U. G.; Murphy, M.; Montangero, S.; Calarco, T.; Schmidt-Kaler, F.; Singer, K. and Koch, C. P. (2014). Controlling the transport of an ion: Classical and quantum mechanical solutions. New J. Phys. 16, 075007. Special issue on coherent control of complex quantum systems.
  • Goerz, M. H.; Carrasco, S. C. and Malinovsky, V. S. (2022). Quantum Optimal Control via Semi-Automatic Differentiation. Quantum 6, 871.
  • Koch, C. P. (2016). Controlling open quantum systems: tools, achievements, and limitations. J. Phys.: Condens. Matter 28, 213001.
  • Shapiro, M. and Brumer, P. (2012). Quantum Control of Molecular Processes. Second Edition (Wiley and Sons).
  • Sola, I. R.; Chang, B. Y.; Malinovskaya, S. A. and Malinovsky, V. S. (2018). Quantum Control in Multilevel Systems. In: Advances In Atomic, Molecular, and Optical Physics, Vol. 67, edited by Arimondo, E.; DiMauro, L. F. and Yelin, S. F. (Academic Press); Chapter 3, pp. 151–256.
  • von Winckel, G. and Borzì, A. (2008). Computational techniques for a quantum control problem with H$^1$-cost. Inverse Problems 24, 034007.

Alphabetic style

The style=:alpha formats citations and references like :numeric, except that it uses labels derived from the author names and publication year and sorts the references alphabetically.

  • [GoerzQ2022](@cite) renders as "[GCM22]"
  • [FuerstNJP2014,SolaAAMOP2018](@cite) renders as "[FGP+14, SCMM18]"
  • [GoerzQ2022](@citet) renders as "Goerz et al. [GCM22]"
  • [GoerzQ2022](@citep) renders as "[GCM22]" — @citep is the same as @cite for this style
  • [GoerzQ2022; Eq. (1)](@cite) renders as "[GCM22, Eq. (1)]"
  • [GoerzQ2022; Eq. (1)](@citet) renders as "Goerz et al. [GCM22], Eq. (1)"
  • [GoerzQ2022](@citet*) renders as "Goerz, Carrasco and Malinovsky [GCM22]"
  • [GoerzQ2022; Eq. (1)](@citet*) renders as "Goerz, Carrasco and Malinovsky [GCM22], Eq. (1)"
  • [WinckelIP2008](@citet) renders as "von Winckel and Borzì [vWB08]"
  • [WinckelIP2008](@Citet) renders as "Von Winckel and Borzì [vWB08]"
  • [BrumerShapiro2003, BrifNJP2010, Shapiro2012, KochJPCM2016; and references therein](@cite) renders as "[BS03, BCR10, SB12, Koc16, and references therein]". Note that unlike for style=:numeric, the citations are not compressed.
  • [BrumerShapiro2003, BrifNJP2010, Shapiro2012, KochJPCM2016; and references therein](@Citet) renders as "Brumer and Shapiro [BS03], Brif et al. [BCR10], Shapiro and Brumer [SB12], Koch [Koc16], and references therein"
  • [arbitrary text](@cite GoerzQ2022) renders as "arbitrary text"

References:

[BCR10]
C. Brif, R. Chakrabarti and H. Rabitz. Control of quantum phenomena: past, present and future. New J. Phys. 12, 075008 (2010).
[BS03]
P. Brumer and M. Shapiro. Principles and Applications of the Quantum Control of Molecular Processes (Wiley Interscience, 2003).
[FGP+14]
H. A. Fürst, M. H. Goerz, U. G. Poschinger, M. Murphy, S. Montangero, T. Calarco, F. Schmidt-Kaler, K. Singer and C. P. Koch. Controlling the transport of an ion: Classical and quantum mechanical solutions. New J. Phys. 16, 075007 (2014). Special issue on coherent control of complex quantum systems.
[GCM22]
M. H. Goerz, S. C. Carrasco and V. S. Malinovsky. Quantum Optimal Control via Semi-Automatic Differentiation. Quantum 6, 871 (2022).
[Koc16]
C. P. Koch. Controlling open quantum systems: tools, achievements, and limitations. J. Phys.: Condens. Matter 28, 213001 (2016).
[SB12]
M. Shapiro and P. Brumer. Quantum Control of Molecular Processes. Second Edition (Wiley and Sons, 2012).
[SCMM18]
I. R. Sola, B. Y. Chang, S. A. Malinovskaya and V. S. Malinovsky. Quantum Control in Multilevel Systems. In: Advances In Atomic, Molecular, and Optical Physics, Vol. 67, edited by E. Arimondo, L. F. DiMauro and S. F. Yelin (Academic Press, 2018); Chapter 3, pp. 151–256.
[vWB08]
G. von Winckel and A. Borzì. Computational techniques for a quantum control problem with H$^1$-cost. Inverse Problems 24, 034007 (2008).

Note that the :alpha style is able to automatically disambiguate labels:

[GBR+07a]
M. Grace, C. Brif, H. Rabitz, I. A. Walmsley, R. L. Kosut and D. A. Lidar. Optimal control of quantum gates and suppression of decoherence in a system of interacting two-level particles. J. Phys. B 40, S103 (2007), arXiv:quant-ph/0702147.
[GBR+07b]
M. D. Grace, C. Brif, H. Rabitz, D. A. Lidar, I. A. Walmsley and R. L. Kosut. Fidelity of optimally controlled quantum gates with randomly coupled multiparticle environments. J. Mod. Opt. 54, 2339 (2007), arXiv:0712.2935.

This works because the DocumenterCitations plugin automatically upgrades style=:alpha to the internal

DocumenterCitations.AlphaStyle

Custom styles

In the following, we show two examples for user-defined styles. See the notes on customization on how to generally define a custom style.

Custom style: enumerated author-year

In this example, the :authoryear style is used, but the references are shown in an enumerated list.

The important part of the definition is in the last line, indicating that the References should be shown as an enumeration (ordered list, <ol>, in HTML), see below. Meanwhile, citations render exactly as with style=:authoryear:

  • [GoerzQ2022](@cite) renders as "(Goerz et al., 2022)"
  • [FuerstNJP2014,SolaAAMOP2018](@cite) renders as "(Fürst et al., 2014; Sola et al., 2018)"
  • [WinckelIP2008](@Citet) renders as "Von Winckel and Borzì (2008)"

References:

  1. Brif, C.; Chakrabarti, R. and Rabitz, H. (2010). Control of quantum phenomena: past, present and future. New J. Phys. 12, 075008.
  2. Brumer, P. and Shapiro, M. (2003). Principles and Applications of the Quantum Control of Molecular Processes (Wiley Interscience).
  3. Fürst, H. A.; Goerz, M. H.; Poschinger, U. G.; Murphy, M.; Montangero, S.; Calarco, T.; Schmidt-Kaler, F.; Singer, K. and Koch, C. P. (2014). Controlling the transport of an ion: Classical and quantum mechanical solutions. New J. Phys. 16, 075007. Special issue on coherent control of complex quantum systems.
  4. Goerz, M. H.; Carrasco, S. C. and Malinovsky, V. S. (2022). Quantum Optimal Control via Semi-Automatic Differentiation. Quantum 6, 871.
  5. Koch, C. P. (2016). Controlling open quantum systems: tools, achievements, and limitations. J. Phys.: Condens. Matter 28, 213001.
  6. Shapiro, M. and Brumer, P. (2012). Quantum Control of Molecular Processes. Second Edition (Wiley and Sons).
  7. Sola, I. R.; Chang, B. Y.; Malinovskaya, S. A. and Malinovsky, V. S. (2018). Quantum Control in Multilevel Systems. In: Advances In Atomic, Molecular, and Optical Physics, Vol. 67, edited by Arimondo, E.; DiMauro, L. F. and Yelin, S. F. (Academic Press); Chapter 3, pp. 151–256.
  8. Von Winckel, G. and Borzì, A. (2008). Computational techniques for a quantum control problem with H$^1$-cost. Inverse Problems 24, 034007.

Custom style: Citation-key labels

In this less trivial example, a style similar to :alpha is used, using the citation keys in the .bib file as labels. This would be somewhat more appropriate with citation keys that are shorter that the ones used here (keys similar to those automatically generated with the :alpha style).

  • [GoerzQ2022](@cite) renders as "[GoerzQ2022]"
  • [FuerstNJP2014,SolaAAMOP2018](@cite) renders as "[FuerstNJP2014, SolaAAMOP2018]"
  • [GoerzQ2022](@citet) renders as "Goerz et al. [GoerzQ2022]"
  • [GoerzQ2022](@citep) renders as "[GoerzQ2022]" — @citep is the same as @cite for this style
  • [GoerzQ2022; Eq. (1)](@cite) renders as "[GoerzQ2022, Eq. (1)]"
  • [GoerzQ2022; Eq. (1)](@citet) renders as "Goerz et al. [GoerzQ2022], Eq. (1)"
  • [GoerzQ2022](@citet*) renders as "Goerz, Carrasco and Malinovsky [GoerzQ2022]"
  • [GoerzQ2022; Eq. (1)](@citet*) renders as "Goerz, Carrasco and Malinovsky [GoerzQ2022], Eq. (1)"
  • [WinckelIP2008](@citet) renders as "von Winckel and Borzì [WinckelIP2008]"
  • [WinckelIP2008](@Citet) renders as "Von Winckel and Borzì [WinckelIP2008]"
  • [arbitrary text](@cite GoerzQ2022) renders as "arbitrary text"

References:

[BrifNJP2010]
C. Brif, R. Chakrabarti and H. Rabitz. Control of quantum phenomena: past, present and future. New J. Phys. 12, 075008 (2010).
[BrumerShapiro2003]
P. Brumer and M. Shapiro. Principles and Applications of the Quantum Control of Molecular Processes (Wiley Interscience, 2003).
[FuerstNJP2014]
H. A. Fürst, M. H. Goerz, U. G. Poschinger, M. Murphy, S. Montangero, T. Calarco, F. Schmidt-Kaler, K. Singer and C. P. Koch. Controlling the transport of an ion: Classical and quantum mechanical solutions. New J. Phys. 16, 075007 (2014). Special issue on coherent control of complex quantum systems.
[GoerzQ2022]
M. H. Goerz, S. C. Carrasco and V. S. Malinovsky. Quantum Optimal Control via Semi-Automatic Differentiation. Quantum 6, 871 (2022).
[KochJPCM2016]
C. P. Koch. Controlling open quantum systems: tools, achievements, and limitations. J. Phys.: Condens. Matter 28, 213001 (2016).
[Shapiro2012]
M. Shapiro and P. Brumer. Quantum Control of Molecular Processes. Second Edition (Wiley and Sons, 2012).
[SolaAAMOP2018]
I. R. Sola, B. Y. Chang, S. A. Malinovskaya and V. S. Malinovsky. Quantum Control in Multilevel Systems. In: Advances In Atomic, Molecular, and Optical Physics, Vol. 67, edited by E. Arimondo, L. F. DiMauro and S. F. Yelin (Academic Press, 2018); Chapter 3, pp. 151–256.
[WinckelIP2008]
G. von Winckel and A. Borzì. Computational techniques for a quantum control problem with H$^1$-cost. Inverse Problems 24, 034007 (2008).