this-month-in-org/2021-10-31-release.org.html
Timothy 787b24749c
DRAFT update (52 files changed)
Last source commit: 7958caa
Local time: 2024-09-08 15:20:47 (UTC+0800)
2024-09-08 15:20:47 +08:00

227 lines
11 KiB
HTML

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>2021-10-31-release.org.html</title>
<style>
body { background: #fafafa; color: #2a2a2a; }
pre {
font-size: 1rem;
max-width: min(100rem, 100%);
width: max-content;
white-space: pre-wrap;
margin: auto; }
.ef-D {
color: #2a2a2a; background-color: #fafafa; font-weight: 400; }
.ef-b {
font-weight: 700; }
.ef-i {
text-decoration: italic; }
.ef-vp {
}
.ef-h {
color: #9e9e9e; }
.ef-sc {
color: #4f894c; }
.ef-w {
color: #9a7500; }
.ef-e {
color: #99324b; }
.ef-l {
color: #3b6ea8; font-weight: 700; }
.ef-lv {
color: #8b008b; font-weight: 700; }
.ef-hi {
color: #fafafa; background-color: #3b6ea8; }
.ef-c {
color: #b1b1b1; }
.ef-cd {
color: #b1b1b1; }
.ef-s {
color: #4f894c; }
.ef-d {
color: #b6b6b6; }
.ef-m {
color: #97365b; }
.ef-k {
color: #3b6ea8; }
.ef-bi {
color: #29838d; }
.ef-f {
color: #29838d; }
.ef-v {
color: #cb9aad; }
.ef-t {
color: #9a7500; }
.ef-o {
color: #97365b; }
.ef-wr {
color: #9a7500; }
.ef-nc {
color: #3b6ea8; font-weight: 700; }
.ef-pp {
color: #3b6ea8; font-weight: 700; }
.ef-rc {
color: #3b6ea8; font-weight: 700; }
.ef-rb {
color: #3b6ea8; font-weight: 700; }
.ef-ob {
background-color: #e0e0e0; }
.ef-obb {
color: #b1b1b1; background-color: #e0e0e0; }
.ef-obe {
color: #b1b1b1; background-color: #e0e0e0; }
.ef-Oa {
color: #3b6ea8; font-weight: nil; font-size: 1.25em }
.ef-Ob {
color: #97365b; font-weight: 700; font-size: 1.15em }
.ef-Oc {
color: #842879; font-weight: 700; font-size: 1.12em }
.ef-Od {
color: #6c92bd; font-weight: 600; font-size: 1.09em }
.ef-Oe {
color: #b16883; font-weight: 600; font-size: 1.06em }
.ef-Of {
color: #9db6d3; font-weight: 600; font-size: 1.03em }
.ef-Og {
color: #cb9aad; font-weight: 700; }
.ef-Oh {
color: #d7e2ed; font-weight: 600; }
.ef-hn {
color: #97365b; font-weight: 700; }
.ef-hq {
color: #3b6ea8; }
.ef-hs {
color: #9a7500; }
.ef-rda {
color: #3b6ea8; }
.ef-rdb {
color: #97365b; }
.ef-rdc {
color: #4f894c; }
.ef-rdd {
color: #842879; }
.ef-rde {
color: #29838d; }
.ef-rdf {
color: #3b6ea8; }
.ef-rdg {
color: #97365b; }
.ef-rdh {
color: #4f894c; }
.ef-rdi {
color: #842879; }
</style>
</head>
<body>
<pre>
<span style="color: #9e9e9e;">#+title:</span> <span style="font-weight: 700;">October 2021
</span><span style="color: #9e9e9e;">#+subtitle:</span> Release 9.5
<span style="color: #9e9e9e;">#+author:</span> TEC
<span style="color: #9e9e9e;">#+date:</span> 2021-10-31
<span class="ef-obb">#+begin_quote
</span>Turns out that life became busy enough that instead of delaying, last month's
post had to be cancelled. We're now back to business as usual though 🙂.
<span class="ef-obe">#+end_quote
</span>
There have been some cool recent developments in Org over the past two months,
but you'll have to learn about those is next month's edition as <span class="ef-i">/Org 9.5 has been
released/</span> 🎉. So, let's go over some of the changes I'm most excited about, in no
particular order. To get a more complete picture of the latest changes, see
<span style="color: #3b6ea8; font-weight: 700;">[[https://git.savannah.gnu.org/cgit/emacs/org-mode.git/tree/etc/ORG-NEWS?h=release_9.5#n14][ORG-NEWS]]</span>.
<span style="color: #3b6ea8; font-weight: nil; font-size: 1.25em">* The new citation engine</span>
As tempted as I am to wax lyrical about the lovely new citation engine, I've
already dedicated <span style="color: #3b6ea8; font-weight: 700;">[[file:2021-07-31-citations.org][July's post]]</span> to it, and so will simply highlight how versatile
the syntax is. Combined with the ability to swap out the default backends
(basic, CSL, natbib, and bib(la)tex) for a 3rd party backend (for example,
provided by a package) it is capable of meeting your citation and technical
document publishing needs, whatever they may be.
<span style="color: #b1b1b1;">#+caption:</span> <span class="ef-ob">The full citation syntax</span>
<span style="color: #3b6ea8; font-weight: 700;">[[file:figures/citation-structure-full.svg]]</span>
Since the announcement of org-cite, the ecosystem has continued to expand with a
number of promising packages like Bruce D'Arcus' <span style="color: #3b6ea8; font-weight: 700;">[[https://github.com/bdarcus/citar][citar]]</span> (previously
<span class="ef-i">/bibtex-actions/</span>), which currently provides what is arguably the best citation
insertion experience.
<span style="color: #b1b1b1;">#+caption:</span> <span class="ef-ob">Inserting a citation with the /citar/ package</span>
<span style="color: #b1b1b1;">#+attr_html: :class doom-one</span>
<span style="color: #3b6ea8; font-weight: 700;">[[file:figures/org-citar-insertion.png]]</span>
<span style="color: #3b6ea8; font-weight: nil; font-size: 1.25em">* Asynchronous session evaluation</span>
Since being featured in <span style="color: #3b6ea8; font-weight: 700;">[[file:2021-05-31-async.org][May's post]]</span>, we've had the initial python support
expanded with support for R too. I have good reason to believe that more
backends will join this list in the future.
To get started, just add <span style="color: #9e9e9e;">=:async=</span> to the header arguments of Python or R source
blocks with a <span style="color: #9e9e9e;">=:session=</span>.
<span style="color: #3b6ea8; font-weight: nil; font-size: 1.25em">* LaTeX environment </span><span style="color: #9e9e9e; font-weight: nil; font-size: 1.25em">=#+results=</span><span style="color: #3b6ea8; font-weight: nil; font-size: 1.25em"> are now removed</span>
LaTeX environments (i.e. <span style="color: #9e9e9e; background-color: #e0e0e0;">src_</span><span style="color: #b1b1b1; background-color: #e0e0e0;">LaTeX</span><span style="color: #9e9e9e; background-color: #e0e0e0;">{</span><span style="color: #3b6ea8; background-color: #e0e0e0;">\begin</span><span class="ef-ob">{} ... </span><span style="color: #3b6ea8; background-color: #e0e0e0;">\end</span><span class="ef-ob">{}</span><span style="color: #9e9e9e; background-color: #e0e0e0;">}</span> blocks) have been added
to the list of <span style="color: #9e9e9e;">=#+results=</span> types that will be removed. This is bigger news than
one might think, as it means that raw LaTeX environments are now a viable output
for org-babel backends. This possesses a distinct advantage over <span style="color: #9e9e9e;">=:results latex=</span>
as LaTeX environments can be rendered inline with <span style="color: #9e9e9e;">~org-latex-preview~</span> and are
exported to more formats --- for example HTML with MathJax.
This is likely going to be first seen in the new <span style="color: #9e9e9e;">=ob-julia=</span> backend (unreleased,
currently in early development), but could well be utilised by other backends
such as <span style="color: #9e9e9e;">=ob-octave=</span>, <span style="color: #9e9e9e;">=ob-mathematica=</span> (in contrib), <span style="color: #9e9e9e;">=ob-python=</span> (using <span style="color: #9e9e9e;">~SymPy~</span>), <span style="color: #9e9e9e;">=ob-calc=</span>
and more.
<span style="color: #b1b1b1;">#+caption:</span> <span class="ef-ob">Rendered LaTeX representations of some Julia values</span>
<span style="color: #b1b1b1;">#+attr_html: :class doom-one</span>
<span style="color: #b1b1b1;">#+attr_latex: :width 0.5\linewidth</span>
<span style="color: #3b6ea8; font-weight: 700;">[[file:figures/ob-julia-latexify-rendered.png]]</span>
<span style="color: #3b6ea8; font-weight: nil; font-size: 1.25em">* More fontification</span>
A number of new faces have been introduced to allow for improved theming
capability, and better contextual hints in the agenda, namely:
<span style="color: #9e9e9e;">~org-agenda-date-weekend-today~</span>, <span style="color: #9e9e9e;">~org-imminent-deadline~</span>,
<span style="color: #9e9e9e;">~org-agenda-structure-secondary~</span>, and <span style="color: #9e9e9e;">~org-agenda-structure-filter~</span>.
Inline export snippets are now also fontified using the <span style="color: #9e9e9e;">~org-tag~</span> and
<span style="color: #9e9e9e;">~font-lock-comment-face~</span> faces, to better stand out from surrounding text.
<span style="color: #3b6ea8; font-weight: nil; font-size: 1.25em">* More link formatting options with org-capture</span>
A new formatting directive, <span style="color: #9e9e9e;">~%L~</span> has been introduced which provides the bare link
target. This allows for links with automatically generated descriptions 🙂.
<span style="color: #3b6ea8; font-weight: nil; font-size: 1.25em">* Export improvements</span>
The HTML and LaTeX backends have both been given some love in this release of
Org.
The HTML backend now supports customisation of the <span style="color: #9e9e9e;">=&lt;meta&gt;=</span> tags included with
<span style="color: #9e9e9e;">~org-html-meta-tags~</span>, which should be particularly useful to anybody using
<span style="color: #9e9e9e;">=org-publish=</span> for blogs or websites (in fact, this blog has been making use of it
for some time now). A new variable has been introduced to help with styling,
<span style="color: #9e9e9e;">~org-html-content-class~</span> (<span style="color: #9e9e9e;">="content"=</span> by default) which is used as the CSS class for
the top-level content wrapper. To further improve styling capabilities,
<span style="color: #9e9e9e;">~org-html-style-default~</span> and <span style="color: #9e9e9e;">~org-html-scripts~</span> have been changed from constants to
customisable variables.
The LaTeX backend (<span style="color: #9e9e9e;">=ox-latex=</span>) no longer has obsolete LaTeX packages in
<span style="color: #9e9e9e;">~org-latex-default-packages-alist~</span> (<span style="color: #9e9e9e;">=grffile=</span> and <span style="color: #9e9e9e;">=texcomp=</span> have been removed).
It also now supports arbitrary <span style="color: #9e9e9e;">=:float=</span> argument values, and accepts a six new
arguments (in total) for verse (<span style="color: #9e9e9e;">=:lines=</span>, <span style="color: #9e9e9e;">=:center=</span>, <span style="color: #9e9e9e;">=:versewidth=</span>, and <span style="color: #9e9e9e;">=:latexcode=</span>)
and quote blocks (<span style="color: #9e9e9e;">=:environment=</span> and <span style="color: #9e9e9e;">=:options=</span>).
<span style="color: #3b6ea8; font-weight: nil; font-size: 1.25em">* Project changes</span>
To reduce the maintainer burden, the <span style="color: #9e9e9e;">=contrib/=</span> folder and a collection of
rarely-used or barely-maintained <span style="color: #9e9e9e;">=ob-*=</span> backends have been moved to a new repo,
<span style="color: #3b6ea8; font-weight: 700;">[[https://git.sr.ht/~bzg/org-contrib][org-contrib]]</span>. Support for Emacs 24 (2012--2014) has also been dropped, and Org
will now aim to support the three most recent major versions of Emacs.
</pre>
<body>
</html>