snac/src/index.org

7.8 KiB

Snac: from Org to HTML5

This site presents a minimal working example of the Snac authoring format, allowing to produce split, interlinked publishable HTML5 from a single Org source file.

The code source is hosted at https://jscaux.org/git/jscaux/snac.

Structure

Text for first Section.

First Subsection

Text for first Subsection.

Second Subsection

Text for second Subsection.

Contents

Section 2.

Equations

Inline example: \(\left[ \hat{H}, \hat{\boldsymbol Q} \right] = 0\).

Block example:

<<tau>>

  • KBI V.1.33
\begin{equation} \tau (\lambda) = \mbox{exp}~ \sum_{n=0}^\infty \frac{i_n}{n!} Q_n (\lambda - \xi)^n \tag{tau}\label{tau} \end{equation}

Figures

<<fig-T1>>

/jscaux/snac/media/commit/051fef5672433ffdd94f33a615dc1f2dc55253d1/src/fig/eps_type_I.jpg
Lieb-Liniger Type I dispersion relations for various values of the interaction parameter.

Interlinking

Interlinking is done via Org links. For example, we can refer to Section Structure or to the First Subsection.

For equations, we can similarly link using the dedicated link: tau is a beauty.

Figures are handled in a similar way, fig-T1.

You can cite a good book such as this one b-Gaudin or a world-changing article such as 1931.Bethe.ZP.71.

Contextual colors

As an in-built suggestion, you can use collapsible/expandable boxes with contextual colors, serving specific purposes:

Prerequisites

Specific prerequisites for understanding the upcoming material

  • you should already know this
  • and this
  • and that
Objectives

Objectives for this part: what you should learn by reading this

  • this
  • and this
  • and that
Core

Core material: all equations are useful, but some are more useful than others.

Derivation

Derivation of a particular (set of) equation(s).

Example

Example of the concepts just covered.

Info

Additional (contextual) information.

Historical Context

Additional historical context.

Literature

Books

b-Gaudin

  1. Gaudin, La fonction d'onde de Bethe, Masson (Paris), 1983.

Russian translation:

English translation: M. Gaudin, The Bethe Wavefunction (translation by J.-S. Caux), Cambridge University Press, 2014.

BibTeX
@Book{Gaudin,
  author = 	 {M. Gaudin},
  title = 	 {La fonction d'onde de {B}ethe},
  publisher = 	 {Masson, Paris},
  year = 	 {1983},
  note = 	 {{\it The Bethe Wavefunction} (translation by J.-S. Caux), Cambridge University Press, 2014.},
}

Articles

1931

1931.Bethe.ZP.71
    1. Bethe,

Zur Theorie der Metalle. I. Eigenwerte und Eigenfunktionen der linearen Atomkette, Zeit. für Physik 71, 205 (1931), doi:10.1007/BF01341708.

Extended data
Author Hans Albrecht Bethe
Title Zur Theorie der Metalle. I. Eigenwerte und Eigenfunktionen der linearen Atomkette
Journal Zeit. für Physik
Volume 71
Pages 205-226
Year 1931
doi 10.1007/BF01341708
Publication date 1931-03
Submission date 1931-06-17

Translations into English:

BibTeX
  @Article{1931.Bethe.ZP.71,
          author = {H. A. Bethe},
          title = {Zur {T}heorie der {M}etalle.  I.  {E}igenwerte und {E}igenfunktionen der linearen {A}tomkette},
          journal = {Zeit. f\"ur Physik},
          year = {1931},
          volume = {71},
          pages = {205},
          doi = {10.1007/BF01341708}
  }
Annotations

Impossible chronology: the article appeared in issue 3-4 of volume 71 of the journal, which carries the date March 1931. However, Bethe signs off dated 13 June 1931 at the end of the article, and the article header mentions 17 June 1931 as reception (in modern parlance: submission) date.