git.s-ol.nu mmm / 4d5d48e
add ba_log 2019-12-20 s-ol 1 year, 11 months ago
3 changed file(s) with 41 addition(s) and 0 deletion(s). Raw diff Collapse all Expand all
1010 2019-10-29
1111 2019-11-01
1212 2019-11-25
13 2019-12-20
0 In the last three days I have been working extensively on support for sidenotes and academic referencing,
1 inspired by Edward Tufte's style of publishing (as seen in *Beatiful Evidence* and documented in [tufte-css][tufte-css].
2
3 To this end margin-notes have been implemented in the CSS styling of the page using two classes, `sidenote` and
4 `sidenote-container`, which are to be applied to individual sidenotes and the containing document respectively.
5 Sidenotes are then pulled out of their surrounding context using `position: absolute` and placed in a margin that is
6 left free by `sidenote-container`.
7
8 Inside of markdown files, sidenotes can then be added simply using basic HTML, like so:
9
10 ```md
11 <div class="sidenote">additional information to be found on the margin</div>
12 An example paragraph of text, describing something.
13 ```
14
15 Which will render like this:
16
17 > <div class="sidenote">additional information to be found on the margin</div>
18 > An example paragraph of text, describing something.
19
20 Additionally, conversions from `text/bibtex`, a reference specification format, to `mmm/dom` have been added, that
21 create citations using the metadata available in the BibTeX file.
22
23 For example the following BibTeX is rendered like this:
24
25 <mmm-embed nolink path="../../references/inkandswitch" facet="markdown"></mmm-embed>
26
27 > <mmm-embed raw path="../../references/inkandswitch"></mmm-embed>
28
29 I also added a special override that links to
30 BibTeX files by placing the citation in a sidenote, and adding a footnote indicator in-text.
31
32 There is also a handy convert that turns ACM Digital Library links into URLs that directly return the BibTeX file,
33 which allows me to cite the links directly without manually adding the BibTeX information to my document.
34
35 All of this is implemented in the `cites` plug-in: [`cites.moon`][cites.moon].
36
37 [cites.moon]: https://git.s-ol.nu/mmm/blob/ba/mmm/mmmfs/plugins/cites.moon
38 [tufte-css]: https://edwardtufte.github.io/tufte-css/