# Source for html export

#+EXCLUDE_TAGS: noexport draft torevise

#+HTML_HEAD_EXTRA: <link rel="stylesheet" type="text/css" href="snac.css" />

#+html_link_home: index.html

#+OPTIONS: html_self_link_headlines:nil
#+OPTIONS: ^:nil

#+OPTIONS: toc:4 num:nil


#+TITLE: Snac: from Org to HTML5
#+SUBTITLE: Minimal Working Example

#+AUTHOR: Author Name

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
:PROPERTIES:
:CUSTOM_ID: s
:END:

Text for first Section.

** First Subsection
:PROPERTIES:
:CUSTOM_ID: s_ss1
:END:

Text for first Subsection.

** Second Subsection
:PROPERTIES:
:CUSTOM_ID: s_ss2
:END:

Text for second Subsection.


* Contents
:PROPERTIES:
:CUSTOM_ID: c
:END:

Section 2.

** Equations
:PROPERTIES:
:CUSTOM_ID: c_eq
:END:

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

Block example:
#+begin_eqlabel
<<tau>>
#+begin_alteqlabels
- KBI V.1.33
#+end_alteqlabels
#+end_eqlabel
\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
:PROPERTIES:
:CUSTOM_ID: c_figs
:END:

#+begin_eqlabel
<<fig-T1>>
#+end_eqlabel
#+caption: Lieb-Liniger Type I dispersion relations for various values of the interaction parameter.
#+attr_html: :width 100%
[[./fig/eps_type_I.jpg]]


** Interlinking
:PROPERTIES:
:CUSTOM_ID: c_inter
:END:

Interlinking is done via Org links. For example, we can refer to Section [[id:s][Structure]] or to the [[id:s_ss1][First Subsection]].

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

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

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


** Contextual colors
:PROPERTIES:
:CUSTOM_ID: c_cc
:END:

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

#+attr_html: :class prereq :open
#+begin_details
#+begin_summary
#+html: Prerequisites
#+end_summary
Specific prerequisites for understanding the upcoming material
- you should already know this
- and this
- and that
#+end_details

#+attr_html: :class objectives
#+begin_details
#+begin_summary
#+html: Objectives
#+end_summary
Objectives for this part: what you should learn by reading this
- this
- and this
- and that
#+end_details

#+attr_html: :class core
#+begin_details
#+begin_summary
#+html: Core
#+end_summary
Core material: all equations are useful, but some are more useful than others.
#+end_details

#+attr_html: :class derivation
#+begin_details
#+begin_summary
#+html: Derivation
#+end_summary
Derivation of a particular (set of) equation(s).
#+end_details

#+attr_html: :class example
#+begin_details
#+begin_summary
#+html: Example
#+end_summary
Example of the concepts just covered.
#+end_details

#+attr_html: :class info
#+begin_details
#+begin_summary
#+html: Info
#+end_summary
Additional (contextual) information.
#+end_details

#+attr_html: :class context
#+begin_details
#+begin_summary
#+html: Historical Context
#+end_summary
Additional historical context.
#+end_details


* Literature
:PROPERTIES:
:CUSTOM_ID: l
:END:

** entry templates                                               :noexport:

*** template
:PROPERTIES:
:CUSTOM_ID: template_id
:END:

**** article

| <20>             | <60> |
| Extended data    |      |
|------------------+------|
| Author           |      |
| Title            |      |
| Journal          |      |
| Volume           |      |
| Pages            |      |
| Year             |      |
| doi              |      |
| Publication date |      |
|------------------+------|
| Submission date  |      |


#+begin_details
#+begin_summary
#+html: BibTeX
#+end_summary
#+begin_src bibtex
#+end_src
#+end_details

#+attr_html: :open true
#+begin_details
#+begin_summary
#+html: Annotations
#+end_summary
#+end_details





** Books
:PROPERTIES:
:CUSTOM_ID: l_b
:END:

*** b-Gaudin
:PROPERTIES:
:CUSTOM_ID: b-Gaudin
:HTML_HEADLINE_CLASS: reference
:END:

M. 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.



#+begin_details
#+begin_summary
#+html: BibTeX
#+end_summary
#+begin_src 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.},
}
#+end_src
#+end_details




** Articles
:PROPERTIES:
:CUSTOM_ID: l_a
:END:

*** 1931
:PROPERTIES:
:CUSTOM_ID: l_a_1931
:END:

**** 1931.Bethe.ZP.71
:PROPERTIES:
:CUSTOM_ID: 1931.Bethe.ZP.71
:END:

H. A. Bethe,
/Zur Theorie der Metalle.  I.  Eigenwerte und Eigenfunktionen der linearen Atomkette/,
Zeit. für Physik
**71**, 205 (1931),
[[https://doi.org/10.1007/BF01341708][doi:10.1007/BF01341708]].


| <20>             | <60>                                                                                |
| 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              | [[https://doi.org/10.1007/BF01341708][10.1007/BF01341708]]                                                                  |
| Publication date | 1931-03                                                                             |
| Submission date  | 1931-06-17                                                                          |
|------------------+-------------------------------------------------------------------------------------|


**Translations into English:**
- by Vince Frederick (1992): ON THE THEORY OF METALS, I., in book: Daniel C. Mattis, /The Many-Body Problem - An Encyclopedia of Exactly Solved Models in One Dimension/, World Scientific (1993), ISBN 981-02-0975-4 (paperback: 981-02-1476-6).
- by [[https://homepages.dias.ie/dorlas/][Teunis C. Dorlas]] (2009): [[https://homepages.dias.ie/dorlas/Papers/Bethe.pdf][On the Theory of Metals. I. Eigenvalues and eigenfunctions of a linear chain of atoms]]


#+begin_details
#+begin_summary
#+html: BibTeX
#+end_summary
#+begin_src 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}
  }
#+end_src
#+end_details

#+attr_html: :open true
#+begin_details
#+begin_summary
#+html: Annotations
#+end_summary
**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.
#+end_details