+ However, sometimes we want a “one-off” remark, containing, say, references or
+ additional explanation and we want it without the ceremony of first defining a
+ glossary term then invoking it. Enter the margin link. For
+ example:
+
+
+
+ In HTML, such “marginal remarks” appear as tooltips; in LaTeX, they appear in
+ the margin.
+
+ latex: |-
+ The \texttt{doc} link is for explanatory remarks, documentation, or personal glossary that is
+ intended to be used in multiple places.
+
+ However, sometimes we want a “one-off” remark, containing, say, references or additional
+ explanation and we want it without the ceremony of first defining a glossary term
+ then invoking it. Enter the \texttt{margin} link. For example:
+
+
+ \emph{Allah\!\!${}^{\textnormal{{\thefootnote}}}$
+ \newsavebox{\OrgSpecialBlockExtrasMarginBox}
+ \begin{lrbox}{\OrgSpecialBlockExtrasMarginBox}
+ \begin{minipage}{\paperwidth - \textwidth - \oddsidemargin - 1in - 3ex}
+ \raggedright \iffalse Otherwise default alignment is fully justified. \fi
+ \footnotesize
+ \setminted{fontsize=\footnotesize, breaklines} \iffalse HACK! \fi
+ \color{gray!80}
+ {\color{black}${}^{\textnormal{{\thefootnote}}}$}
+ \normalfont
+ The God of Abraham; known as Elohim in the Bible
+ \end{minipage}
+ \end{lrbox}
+ \marginpar{\usebox{\OrgSpecialBlockExtrasMarginBox}\stepcounter{footnote}}
+ \hspace{-1.9ex}
+ \global\let\OrgSpecialBlockExtrasMarginBox\relax does not
+ burden a soul beyond what it can bear.}
+ ---Quran 2:286
+
+ In HTML, such “marginal remarks” appear as tooltips; in \LaTeX{}, they appear in the margin.
diff --git a/tests/org-demo.yaml b/tests/org-demo.yaml
new file mode 100644
index 0000000..2ea8019
--- /dev/null
+++ b/tests/org-demo.yaml
@@ -0,0 +1,87 @@
+input: |-
+ Sometimes, we want to show verbatim source and its resulting rendition ---which
+ is a major part of this article! So, let's make a block to mitigate such an
+ error-prone tedium.
+
+ #+begin_org-demo
+ /italics/ and _underline_
+
+ $e^{i \times \pi} + 1 = 0$
+ #+end_org-demo
+
+ Output the CONTENTS of the block as both parsed Org and unparsed.
+
+ Label the source text by SOURCE and the result text by RESULT
+
+expectations:
+ html: |-
+
+ Sometimes, we want to show verbatim source and its resulting rendition
+ —which is a major part of this article! So, let's make a block to
+ mitigate such an error-prone tedium.
+
+
+ Output the CONTENTS of the block as both parsed Org and unparsed.
+
+
+ In the HTML Export, The result is 2 columns with no rule between
+ them and it contains the user's text, but ignores the
+ “#+columnbreak”.
+
+
+
+ [Soft Columns] Below, the result is 2 columns with a solid BLACK
+ rule between them and it contains the user's text, but ignores the
+ “#+columnbreak”.
+
+
+
+ [Hard Columns] The result is 3 columns with a solid GREEN rule
+ between them and it contains the user's text along with the
+ “#+columnbreak” evaluated at the expected positions.
+
+
+ latex: |-
+ In the HTML Export, The result is 2 columns with no rule between
+ them and it contains the user's text, but ignores the
+ “\#+columnbreak”.
+
+ \par \setlength{\columnseprule}{0 pt}
+ \begin{minipage}[t]{\linewidth}
+ \begin{multicols}{2}
+ Hello, to the left!
+
+ \columnbreak
+ A super duper wide middle margin!
+
+
+ \columnbreak
+ Goodbye (“God-be-with-ye”) to the right!
+
+ \columnbreak
+ woah
+
+
+ \end{multicols}\end{minipage}
+
+
+ {[}Soft Columns] Below, the result is 2 columns with a solid BLACK
+ rule between them and it contains the user's text, but ignores the
+ “\#+columnbreak”.
+
+ \par \setlength{\columnseprule}{2 pt}
+ \begin{minipage}[t]{\linewidth}
+ \begin{multicols}{2}
+ X
+
+ \columnbreak
+
+ Y
+
+ Z
+
+
+ \end{multicols}\end{minipage}
+
+
+ {[}Hard Columns] The result is 3 columns with a solid GREEN rule
+ between them and it contains the user's text along with the
+ “\#+columnbreak” evaluated at the expected positions.
+ \par \setlength{\columnseprule}{2 pt}
+ \begin{minipage}[t]{\linewidth}
+ \begin{multicols}{20% 60% 20%}
+
+ \columnbreak
+
+ Y
+
+ \columnbreak
+
+ Z
+
+
+ \end{multicols}\end{minipage}
diff --git a/tests/rename.yaml b/tests/rename.yaml
new file mode 100644
index 0000000..110453f
--- /dev/null
+++ b/tests/rename.yaml
@@ -0,0 +1,42 @@
+input: |-
+ The ~rename~ block is for Textual Substitution. For example, as a translation tool:
+
+ #+begin_rename "Allah to God, Yacoub to Jacob, Yusuf to Joseph"
+ Quran 12-4: *_Yusuf_* said to his father ( _*Yacoub*_ ), /“O my father,
+ indeed I have seen (in a dream) eleven stars and the sun and the
+ moon; I saw them prostrating to me.”/
+ #+end_rename
+
+ In the rendered result, the Arabic names are replaed with their English counterparts.
+
+expectations:
+ html: |-
+
+ The rename block is for Textual Substitution. For example, as a
+ translation tool:
+
+
+
+ Quran 12-4: Joseph said to his father (
+ Jacob ),
+ “O my father, indeed I have seen (in a dream) eleven stars and the sun and
+ the moon; I saw them prostrating to me.”
+
+
+
+ In the rendered result, the Arabic names are replaed with their English
+ counterparts.
+
+ latex: |-
+ The \texttt{rename} block is for Textual Substitution. For example, as a translation tool:
+
+
+ Quran 12-4: \textbf{\uline{Joseph}} said to his father ( \uline{\textbf{Jacob}} ), \emph{“O my father,
+ indeed I have seen (in a dream) eleven stars and the sun and the
+ moon; I saw them prostrating to me.”}
+
+
+
+ In the rendered result, the Arabic names are replaed with their English counterparts.
diff --git a/tests/show.yaml b/tests/show.yaml
new file mode 100644
index 0000000..987d214
--- /dev/null
+++ b/tests/show.yaml
@@ -0,0 +1,46 @@
+input: |-
+
+ The ~doc~ link shows documentation, but to see the value we can use ~show~ as in:
+
+ doc:user-full-name
+ show:user-full-name
+
+ This allows us to have “generic” sentences:
+
+ My name is show:user-full-name,
+ and I am using Emacs show:emacs-version ^_^
+ My favourite number is
+
+ To see values of expressions in other programming languages, use Org Babel inline source expressions.
+
+expectations:
+ html: |-
+
+ The doc link shows documentation, but to see the value we can use
+ show as in:
+
+
+
+ user-full-name
+ "Musa Al-hassy"
+
+
+ This allows us to have “generic” sentences:
+
+
+ My name is "Musa Al-hassy", and I am using Emacs "29.4" ^_^ My favourite
+ number is 7.716814692820414
+
+
+
+ To see values of expressions in other programming languages, use Org Babel
+ inline source expressions.
+
+ latex: |-
+ 🚫 The LaTex backend is intentionally unmaintained.
+ 🫠 Whoops, there seems to be an error:
+ (void-variable label)
diff --git a/tests/solution.pdf b/tests/solution.pdf
new file mode 100644
index 0000000..65a6de9
Binary files /dev/null and b/tests/solution.pdf differ
diff --git a/tests/solution.yaml b/tests/solution.yaml
new file mode 100644
index 0000000..017e0d7
--- /dev/null
+++ b/tests/solution.yaml
@@ -0,0 +1,117 @@
+input: |-
+ What is the name of Prophet Yusuf's father?
+
+ Hint: The father's name also starts with `y`.
+
+ #+begin_solution
+ Yacoub
+ #+end_solution
+working-latex: |-
+ What is the name of Prophet Yusuf's father?
+
+ Hint: The father's name also starts with `y`.
+
+ \definecolor{osbe-bg}{HTML}{e5f5e5}
+ \colorlet{osbe-fg}{green}
+
+ \begin{tcolorbox}[colback=osbe-bg, colframe=osbe-fg, title={Solution}, sharp corners, boxrule=0.4pt]
+ \begin{tcolorbox}[title={Did you actually try? Maybe see the ‘hints’ above!}, colback=blue!10!white, colframe=red!75!black, colbacktitle=yellow!50!red, coltitle=red!25!black, fonttitle=\bfseries, subtitle style={boxrule=0.4pt, colback=yellow!50!red!25!white}]
+ \begin{tcolorbox}[colback=osbe-bg, colframe=red, title={Solution, for real}, sharp corners, boxrule=0.4pt]
+ Yacoub
+ \end{tcolorbox}
+ \end{tcolorbox}
+ \end{tcolorbox}
+explanation-of-changes-for-latex: |-
+
+ The quote environment isn't designed to handle arbitrary content like tcolorbox.
+ Instead, I directly placed the tcolorbox environments without wrapping them in quote.
+
+ Removed all colors specified in quotes (e.g., "blue"), as xcolor does not support them.
+
+ 🚫 The LaTex backend is intentionally unmaintained
+required-latex-imports: |-
+ \usepackage{newunicodechar}
+ \usepackage[hmargin=15mm,top=15mm,bottom=15mm]{geometry}
+ \usepackage[dvipsnames]{xcolor}
+ \usepackage{tcolorbox}
+ \usepackage{minted}
+ \usepackage{etoolbox}
+ \usepackage{multicol}
+ \usepackage{adjustbox}
+
+ % TODO: Ideally the defblock itself would have these imports,
+ % For example, attached to the symbol's plist.
+ % Then use of the block would add the imports automatically.
+ % Moreover, we would not need this `required-latex-imports` key;
+ % instead it would be part of the `expectations` map, right before `latex`.
+
+expectations:
+ html: |-
+ What is the name of Prophet Yusuf's father?
+
+ Hint: The father's name also starts with `y`.
+
+
+
+
+ Solution
+
+
+
+
Did you actually try? Maybe see the ‘hints’ above!
+
+
+
+ Solution, for real
+
+
+ Yacoub
+
+
+ latex: |-
+ What is the name of Prophet Yusuf's father?
+
+ Hint: The father's name also starts with `y`.
+
+ \definecolor{osbe-bg}{HTML}{e5f5e5}\colorlet{osbe-fg}{green}\begin{quote}
+ \begin{tcolorbox}[colback=osbe-bg,colframe=osbe-fg,title={Solution},sharp corners,boxrule=0.4pt]
+ \begin{tcolorbox}[title={Did you actually try? Maybe see the ‘hints’ above!},colback="blue",colframe=red!75!black,colbacktitle=yellow!50!red,coltitle=red!25!black, fonttitle=\bfseries,subtitle style={boxrule=0.4pt, colback=yellow!50!red!25!white}]
+ \definecolor{osbe-bg}{HTML}{e5f5e5}\colorlet{osbe-fg}{red}\begin{quote}
+ \begin{tcolorbox}[colback=osbe-bg,colframe=osbe-fg,title={Solution, for real},sharp corners,boxrule=0.4pt]
+ Yacoub
+
+
+ \end{tcolorbox}
+ \end{quote}
+ \end{tcolorbox}
+
+ \end{tcolorbox}
+ \end{quote}
diff --git a/tests/spoiler.yaml b/tests/spoiler.yaml
new file mode 100644
index 0000000..223763e
--- /dev/null
+++ b/tests/spoiler.yaml
@@ -0,0 +1,83 @@
+input: |-
+ The ~spoiler~ block is for “fill in the blanks” or “guess, and hover
+ to see the results” style of exposition.
+
+ #+begin_spoiler
+ ((Yusuf)) said to his father ((Yacoub)), /“O my father, indeed I have seen
+ ((eleven stars)) and ((the sun and the moon)); I saw them prostrating to me.”/
+ #+end_spoiler
+
+ There are also options for the left delimiter of a hidden item, the right delimiter,
+ and the color of the hidden item. These default to ~grey, ((, ))~ respectively.
+
+ #+begin_spoiler orange :left "[" :right "]"
+ [Yusuf] said to his father [Yacoub], /“O my father, indeed I have seen
+ [eleven stars] and [the sun and the moon]; I saw them prostrating to me.”/
+ #+end_spoiler
+
+expectations:
+ html: |-
+
+ The spoiler block is for “fill in the blanks” or “guess, and
+ hover to see the results” style of exposition.
+
+
+
+
+ Yusuf said to his father Yacoub ,
+ “O my father, indeed I have seen eleven stars and
+ the sun and the moon ; I saw them prostrating to
+ me.”
+
+
+
+ There are also options for the left delimiter of a hidden item, the right
+ delimiter, and the color of the hidden item. These default to
+ grey, ((, )) respectively.
+
+
+
+
+ Yusuf said to his father Yacoub ,
+ “O my father, indeed I have seen eleven stars and
+ the sun and the moon ; I saw them prostrating to
+ me.”
+
+ latex: |-
+ The \texttt{spoiler} block is for “fill in the blanks” or “guess, and hover
+ to see the results” style of exposition.
+
+
+ \fbox{\phantom{Yusuf}}\footnote{Yusuf} said to his father \fbox{\phantom{Yacoub}}\footnote{Yacoub}, \emph{“O my father, indeed I have seen
+ \fbox{\phantom{eleven stars}}\footnote{eleven stars} and \fbox{\phantom{the sun and the moon}}\footnote{the sun and the moon}; I saw them prostrating to me.”}
+
+
+
+ There are also options for the left delimiter of a hidden item, the right delimiter,
+ and the color of the hidden item. These default to \texttt{grey, ((, ))} respectively.
+
+
+ \fbox{\phantom{Yusuf}}\footnote{Yusuf} said to his father \fbox{\phantom{Yacoub}}\footnote{Yacoub}, \emph{“O my father, indeed I have seen
+ \fbox{\phantom{eleven stars}}\footnote{eleven stars} and \fbox{\phantom{the sun and the moon}}\footnote{the sun and the moon}; I saw them prostrating to me.”}
diff --git a/tests/tree.yaml b/tests/tree.yaml
new file mode 100644
index 0000000..78ff896
--- /dev/null
+++ b/tests/tree.yaml
@@ -0,0 +1,34 @@
+input: |-
+ #+begin_box Programming ≈ Proving
+ #+begin_tree
+ + Function Application :: f(a) : B
+ - a : A
+ - f : A → B
+
+ + Modus Ponens :: q
+ - p
+ - p ⇒ q
+ #+end_tree
+ #+end_box
+
+expectations:
+ html: |-
+
+
Programming ≈ Proving
+ \[\frac{\displaystyle \qquad a : A \qquad f : A → B }{f(a) : B}[\text{Function
+ Application}]\]\[\frac{\displaystyle \qquad p \qquad p ⇒ q}{q}[\text{Modus
+ Ponens}]\]
+
+ latex: |-
+ \begin{tcolorbox}[title={Programming ≈ Proving},colback=red!5!white,colframe=red!75!black,colbacktitle=yellow!50!red,coltitle=red!25!black, fonttitle=\bfseries,subtitle style={boxrule=0.4pt, colback=yellow!50!red!25!white}]
+ \[\frac{\displaystyle \qquad a : A \qquad f : A → B
+ }{f(a) : B}[\text{Function Application}]\]\[\frac{\displaystyle \qquad p \qquad p ⇒ q}{q}[\text{Modus Ponens}]\]
+
+ \end{tcolorbox}
![](\"https://img.shields.io/badge/--nil?logo=nil\"){kind=icon}
"))
;; Badge Links:2 ends here
-;; [[file:org-special-block-extras.org::*Intro, motivating examples][Intro, motivating examples:4]]
+;; [[file:org-special-block-extras.org::#COMMENT-Intro][Intro, motivating examples:4]]
(deftest "It gives a tooltip whose title is the Lisp docs of APPLY"
[doc]
(⇝ (⟰ "doc:apply")
@@ -530,7 +530,7 @@ post")
"\">Existential Angst.
+ 
+ 
+ 
+ 
+ 
+