2024-01-09 18:20:48 +00:00
|
|
|
|
━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
|
|
|
APRIL 2021
|
|
|
|
|
Export /&/ plot in style
|
|
|
|
|
|
|
|
|
|
TEC
|
|
|
|
|
━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2021-04-30
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
A discussion on contributor support
|
|
|
|
|
═══════════════════════════════════
|
|
|
|
|
|
2024-01-12 05:40:29 +00:00
|
|
|
|
Concerns [were raised][1] about some contributors’ patches
|
2024-01-09 18:20:48 +00:00
|
|
|
|
languishing, and it not being made clear how long it might take to get
|
|
|
|
|
a response from someone.
|
|
|
|
|
|
|
|
|
|
In [response to this], a the new role of /Contributor Steward/ has
|
|
|
|
|
been created to: help ensure contributors get a timely response, help
|
|
|
|
|
out with preliminary patch feedback, and keep [updates.orgmode.org] up
|
|
|
|
|
to date.
|
|
|
|
|
|
|
|
|
|
Org now has three Contributor Stewards to ease the process for patch
|
|
|
|
|
submitters and core maintainers:
|
|
|
|
|
⁃ Timothy / TEC
|
|
|
|
|
⁃ Tim Cross
|
|
|
|
|
⁃ John Corless
|
|
|
|
|
|
2024-01-12 05:40:29 +00:00
|
|
|
|
If you’ve been thinking about [getting involved with Org], now is a
|
2024-01-09 18:20:48 +00:00
|
|
|
|
great time to give it a shot!
|
|
|
|
|
|
|
|
|
|
*Ways you can contribute to the project*
|
|
|
|
|
|
|
|
|
|
Test patches, improve documentation, translate pages, confirm bugs,
|
|
|
|
|
feedback on a proposed feature, and more…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
[were raised]
|
|
|
|
|
<https://lists.gnu.org/archive/html/emacs-orgmode/2021-04/msg00291.html>
|
|
|
|
|
|
|
|
|
|
[response to this]
|
|
|
|
|
<https://lists.gnu.org/archive/html/emacs-orgmode/2021-04/msg00549.html>
|
|
|
|
|
|
|
|
|
|
[updates.orgmode.org] <https://updates.orgmode.org/>
|
|
|
|
|
|
|
|
|
|
[getting involved with Org] <https://orgmode.org/contribute.html>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
DOI link exporting
|
|
|
|
|
══════════════════
|
|
|
|
|
|
|
|
|
|
[Digital Document Identifiers] (DOIs) are an ISO-standardised way of
|
2024-01-12 05:40:29 +00:00
|
|
|
|
robustly linking to a particular online resource. You’ll see these a
|
2024-01-09 18:20:48 +00:00
|
|
|
|
lot with academic papers, for example.
|
|
|
|
|
|
|
|
|
|
Thanks to Nicolas Goaziou, when exporting to HTML, LaTeX, Ascii, and
|
2024-01-10 17:36:58 +00:00
|
|
|
|
texinfo DOIs are turned into links, for example
|
|
|
|
|
<https://doi.org/10.18637/jss.v046.i03> becomes:
|
2024-01-09 18:20:48 +00:00
|
|
|
|
|
|
|
|
|
┌────
|
|
|
|
|
│ <a href="https://doi.org/10.18637/jss.v046.i03">doi:10.18637/jss.v046.i03</a>
|
|
|
|
|
└────
|
|
|
|
|
┌────
|
|
|
|
|
│ \href{https://doi.org/10.18637/jss.v046.i03}{doi:10.18637/jss.v046.i03}
|
|
|
|
|
└────
|
|
|
|
|
┌────
|
|
|
|
|
│ <https://doi.org/10.18637/jss.v046.i03>
|
|
|
|
|
└────
|
|
|
|
|
┌────
|
|
|
|
|
│ @uref{https://doi.org/10.18637/jss.v046.i03}
|
|
|
|
|
└────
|
|
|
|
|
|
2024-01-12 05:40:29 +00:00
|
|
|
|
This is a minor change, but I think DOIs are great, so I’m
|
2024-01-09 18:20:48 +00:00
|
|
|
|
highlighting it.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
[Digital Document Identifiers] <https://www.doi.org/>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Org plot improvements
|
|
|
|
|
═════════════════════
|
|
|
|
|
|
|
|
|
|
Over the past month `org-plot.el' has received some attention, my two
|
|
|
|
|
favourite changes are:
|
|
|
|
|
⁃ You can now call `org-plot/gnuplot' with `C-c C-c' on a `#+plot'
|
|
|
|
|
line _TEC_
|
|
|
|
|
⁃ When an image is regenerated, all instances of the image in the
|
|
|
|
|
buffer are refreshed _TEC_
|
|
|
|
|
|
2024-01-12 05:40:29 +00:00
|
|
|
|
Other than a few minor tweaks and bug fixes, that’s it for
|
2024-01-10 17:36:58 +00:00
|
|
|
|
April. However, over the last year there have been some rather nice
|
2024-01-12 05:40:29 +00:00
|
|
|
|
improvements that I didn’t mention in the initial blog post, so let’s
|
2024-01-09 18:20:48 +00:00
|
|
|
|
go over them now.
|
|
|
|
|
|
|
|
|
|
⁃ The inbuilt plot types have been abstracted out into a new
|
2024-01-10 17:36:58 +00:00
|
|
|
|
structure: `org-plot/preset-plot-types'. This means if you have a
|
2024-01-09 18:20:48 +00:00
|
|
|
|
gnuplot template you find yourself using a lot, you can now turn it
|
|
|
|
|
into a custom plot type 😀 _TEC_
|
|
|
|
|
⁃ A new plot type has been added: a radar / spider plot _TEC_
|
|
|
|
|
⁃ Some new plot keywords have arrived too _TEC_
|
|
|
|
|
• `transpose' (`trans') — The plot internally does something very
|
|
|
|
|
similar to `M-x org-table-transpose-table-at-point' before
|
|
|
|
|
using the table data.
|
|
|
|
|
• `ymin' (`min'), `ymax' (`max'), `xmin', `xmax' — Four new keywords
|
|
|
|
|
(and two aliases) to set the bounds of a plot. Partially supported
|
|
|
|
|
by the default types.
|
|
|
|
|
• `ticks' — The number of axis ticks to use along the axis. A good
|
|
|
|
|
value is guessed based on a prime factorisation based heuristic
|
|
|
|
|
(welcome to improvements).
|
|
|
|
|
• Some new customisation functions — The new variables
|
|
|
|
|
`org-plot/gnuplot-script-preamble', `org-plot/gnuplot-term-extra',
|
|
|
|
|
and `org-plot/gnuplot-script-preamble' open up new ways to tweak
|
|
|
|
|
plots to your liking. For example, [I use this] to set line and
|
|
|
|
|
background colours based on my current Emacs theme.
|
|
|
|
|
|
2024-01-12 05:40:29 +00:00
|
|
|
|
If you haven’t used Org plot before, I think it’s a great way to
|
2024-01-09 18:20:48 +00:00
|
|
|
|
quickly visualise data in a table. To get started, all you need is a
|
2024-01-10 17:36:58 +00:00
|
|
|
|
`#+plot' line above the table, with a certain `type' specified
|
|
|
|
|
(e.g. `type:2d' for a 2d line plot). Then, if you can specify a
|
|
|
|
|
certain columns as the independent variable (x-values) with `ind', and
|
|
|
|
|
list dependant variables (y-values) with `deps'.
|
2024-01-09 18:20:48 +00:00
|
|
|
|
|
|
|
|
|
You can see these parameters set in the figure above,
|
|
|
|
|
┌────
|
|
|
|
|
│ #+plot: type:2d ind:1 deps:(2 3 4)
|
|
|
|
|
│ | Xval | Red | Blue | Green |
|
|
|
|
|
│ |------+-----+------+-------|
|
|
|
|
|
│ | 0 | 1 | 2 | 3 |
|
|
|
|
|
│ | 1 | 2 | 3 | 4 |
|
|
|
|
|
└────
|
|
|
|
|
|
|
|
|
|
This will call gnuplot and a window showing the plot will appear. If
|
|
|
|
|
you want to save the plot to a file, just use the `file' parameter,
|
2024-01-10 17:36:58 +00:00
|
|
|
|
e.g. `file:"demoplot.svg"' (note the quotes).
|
2024-01-09 18:20:48 +00:00
|
|
|
|
|
|
|
|
|
That should get you started, you can see [the manual] for the full
|
|
|
|
|
list of available keywords and find more examples of usage [on worg].
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
[I use this]
|
|
|
|
|
<https://tecosaur.github.io/emacs-config/config.html#org-plot>
|
|
|
|
|
|
|
|
|
|
[the manual] <https://orgmode.org/manual/Org-Plot.html>
|
|
|
|
|
|
|
|
|
|
[on worg] <https://orgmode.org/worg/org-tutorials/org-plot.html>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Tweaked `ox-html' style
|
|
|
|
|
═══════════════════════
|
|
|
|
|
|
|
|
|
|
As displays become more high-res, lines of text which span the whole
|
|
|
|
|
screen become … long. So long that it genuinely makes it harder to
|
|
|
|
|
read the text. A small tweak to the default style and lines are now
|
|
|
|
|
capped at `60em' wide and centred in the page — much better 🙂. _TEC_
|
|
|
|
|
|
|
|
|
|
Also, the HTML export now:
|
|
|
|
|
⁃ has a slightly nicer source block style
|
|
|
|
|
⁃ labels `authinfo' blocks
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
A collection of export improvements
|
|
|
|
|
═══════════════════════════════════
|
|
|
|
|
|
|
|
|
|
⁃ `Verbatim' in headings no longer breaks LaTeX exports _TEC_
|
|
|
|
|
⁃ Make the top level class for exported HTML customisable via
|
|
|
|
|
`org-html-content-class' / `#+HTML_CONTENT_CLASS' _Sameer Rahmani_
|
|
|
|
|
⁃ Use `<img>' tags for SVGs with `ox-html', for better behaviour and
|
|
|
|
|
W3C compliance _TEC_
|
|
|
|
|
⁃ Remove redundant `type="text/javascript"' from `<script>' elements
|
|
|
|
|
_Bastien Guerry_
|
|
|
|
|
⁃ `ox-texinfo' now generates better headlines, menus, and footnotes
|
|
|
|
|
_Nicolas Goaziou_
|
|
|
|
|
⁃ Parsing during exporting no longer aborts as soon as an `#+option'
|
|
|
|
|
key without a value is encountered, instead that key is skipped over
|
|
|
|
|
_Nicolas Goaziou_
|
|
|
|
|
⁃ `org-html-scripts' and `org-html-style-default' have been changed
|
|
|
|
|
from constants to configurable values _TEC_
|
|
|
|
|
⁃ eval macros `#+macro: ? (eval ...)' are now a little bit faster
|
|
|
|
|
_Stefan Monnier_
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Miscellaneous changes
|
|
|
|
|
═════════════════════
|
|
|
|
|
|
|
|
|
|
⁃ `org-link-descriptive' is now buffer-local, to avoid interfering
|
|
|
|
|
with other buffers _Kyle Meyer_
|
|
|
|
|
⁃ `org-colview' no longer chokes when a special property is updated
|
|
|
|
|
_Nicolas Goaziou_
|
|
|
|
|
⁃ Now coderefs have their whitespace cleaned up during tangling _Tom
|
|
|
|
|
Gillespie_
|
|
|
|
|
⁃ Allow for multiple `%(expressions)' in `org-agenda-prefix-format'
|
|
|
|
|
_Ihor Radchenko_
|
|
|
|
|
⁃ Code cleanup and refactoring _Nicolas Savage, Aaron L. Zeng, Nicolas
|
|
|
|
|
Goaziou, Bastien Guerry, Stefa Monnier, Arne Babenhauserheid_
|
|
|
|
|
⁃ Documentation improvements _Jorge Neto, Erik Hetzner, Cheong Yiu
|
|
|
|
|
Fung, Kyle Meyer_
|
|
|
|
|
⁃ New `ob-sqlite' maintainer — Nick Savage
|
|
|
|
|
⁃ Make lilypond header arguments user-configurable _Jamie Bayne_
|
2024-01-10 17:36:58 +00:00
|
|
|
|
⁃ Fix `ob-C' regression which mixed up `int', `double', and
|
|
|
|
|
`char*'. Fix another regression with table parameters _tbanel_
|
2024-01-09 18:20:48 +00:00
|
|
|
|
⁃ Fix indentation of list items and new logbook drawer notes _Bastien
|
|
|
|
|
Guerry_
|
|
|
|
|
⁃ Notice when theme changes with LaTeX previews _Yuri Lensky_
|
|
|
|
|
⁃ Iron out a few edge cases in `ol.el' (Org links) _Nicolas Goaziou_
|
|
|
|
|
⁃ Some new tests for `org-protocol' _Maxim Nikulin_
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Footnotes
|
|
|
|
|
─────────
|
|
|
|
|
|
|
|
|
|
[1] Disclosure: this is me.
|