path: root/2020/subtitles/emacsconf-2020--22-powering-up-special-blocks--musa-al-hassy-autogen.sbv

0:00:01.680,0:00:07.359
oh you are now muted

0:00:04.080,0:00:09.840
all right then well uh hello everyone

0:00:07.359,0:00:11.519
i hope uh you're all enjoying the emacs

0:00:09.840,0:00:14.480
conf

0:00:11.519,0:00:15.040
my name is musa alhassi and i hope

0:00:14.480,0:00:17.920
you're

0:00:15.040,0:00:19.840
excited to learn about uh powering up

0:00:17.920,0:00:22.880
special blocks

0:00:19.840,0:00:24.800
um so let's let's first off uh find out

0:00:22.880,0:00:27.920
what these special blocks are and

0:00:24.800,0:00:30.240
and see what we can uh go from so

0:00:27.920,0:00:32.719
uh yesterday i saw a lot of cool talks

0:00:30.240,0:00:33.200
and uh people were chatting about how do

0:00:32.719,0:00:35.520
you

0:00:33.200,0:00:37.200
i know how should you present should you

0:00:35.520,0:00:38.640
do it this way or that way and

0:00:37.200,0:00:41.120
i thought maybe i should try a different

0:00:38.640,0:00:42.239
way uh but but i'm talking about special

0:00:41.120,0:00:45.039
blocks and if i

0:00:42.239,0:00:47.039
show you an emax then i have to export

0:00:45.039,0:00:47.840
the html so you can see what it looks

0:00:47.039,0:00:50.800
like

0:00:47.840,0:00:51.920
or export to a pdf so you can see what

0:00:50.800,0:00:54.239
it looks like

0:00:51.920,0:00:56.399
uh so i ended up writing an org reveal

0:00:54.239,0:00:58.960
and

0:00:56.399,0:01:00.879
joyously this this just works you can

0:00:58.960,0:01:02.960
you can just see things here

0:01:00.879,0:01:04.559
uh i was worried that i'd have to take

0:01:02.960,0:01:07.600
pictures and then you know

0:01:04.559,0:01:09.760
uh uh you know insert pings so that that

0:01:07.600,0:01:12.159
was a delight

0:01:09.760,0:01:12.960
okay uh so special blocks are these

0:01:12.159,0:01:16.000
things like

0:01:12.960,0:01:17.280
a center small quote uh that's what a

0:01:16.000,0:01:19.360
special block is

0:01:17.280,0:01:20.720
and with a bit of lisp we can we can

0:01:19.360,0:01:23.200
make special blocks

0:01:20.720,0:01:24.799
and link types right so uh using a

0:01:23.200,0:01:26.720
single interface

0:01:24.799,0:01:27.840
um and the interface is going to be

0:01:26.720,0:01:29.439
similar to one

0:01:27.840,0:01:32.560
many people are familiar with in

0:01:29.439,0:01:35.840
particular org babel's

0:01:32.560,0:01:37.840
source interface as well as using global

0:01:35.840,0:01:39.680
header arguments for link types

0:01:37.840,0:01:41.200
and the idea is to write it once and

0:01:39.680,0:01:44.159
generate many different kinds

0:01:41.200,0:01:44.720
right you write uh an org markup and you

0:01:44.159,0:01:47.680
can have

0:01:44.720,0:01:48.560
uh html you can have pdf and and

0:01:47.680,0:01:51.840
joyously

0:01:48.560,0:01:53.600
uh org reveal so that was uh that was an

0:01:51.840,0:01:56.640
unexpected delight

0:01:53.600,0:01:57.840
um so here is a few that you'll you'll

0:01:56.640,0:02:01.759
just see as we

0:01:57.840,0:02:04.000
uh in this presentation you know some uh

0:02:01.759,0:02:05.040
uh i won't show some of these uh link

0:02:04.000,0:02:06.799
only ones

0:02:05.040,0:02:08.080
but we'll see a few of these other ones

0:02:06.799,0:02:09.920
just to make the uh

0:02:08.080,0:02:11.520
presentation look nice so the

0:02:09.920,0:02:14.000
presentation is really going to

0:02:11.520,0:02:15.120
present these blocks and the mechanism

0:02:14.000,0:02:18.400
at the same time

0:02:15.120,0:02:21.280
so uh so this no no html was written

0:02:18.400,0:02:22.000
look ma no html just pure org mode and

0:02:21.280,0:02:23.520
and

0:02:22.000,0:02:25.840
you get all these beautiful boxes and

0:02:23.520,0:02:27.680
things okay

0:02:25.840,0:02:29.120
so the motivation for this is you know

0:02:27.680,0:02:31.200
what uh

0:02:29.120,0:02:32.239
you're you're online you run into a blog

0:02:31.200,0:02:33.120
and you see something you like and

0:02:32.239,0:02:35.280
you're like man

0:02:33.120,0:02:36.640
you know i wish i could uh you know

0:02:35.280,0:02:39.519
produce that

0:02:36.640,0:02:40.160
um uh but you you check in the author

0:02:39.519,0:02:44.239
wrote raw

0:02:40.160,0:02:46.800
html you know plus html everywhere

0:02:44.239,0:02:47.840
and uh that's that's you know gonna

0:02:46.800,0:02:49.680
obscure

0:02:47.840,0:02:51.200
your your real content it's going to be

0:02:49.680,0:02:54.239
surrounded by all this uh

0:02:51.200,0:02:56.400
styling information that's unfortunate

0:02:54.239,0:02:58.959
uh the author decides to use an org

0:02:56.400,0:03:01.120
macro all right a bit better

0:02:58.959,0:03:03.360
but then what if you decide hey i want

0:03:01.120,0:03:06.000
to make a

0:03:03.360,0:03:07.840
not pdf great and then the worst of all

0:03:06.000,0:03:10.159
the author doesn't give you the source

0:03:07.840,0:03:10.879
and then you have to view page source

0:03:10.159,0:03:13.760
and

0:03:10.879,0:03:14.239
learn cascading style sheets and and you

0:03:13.760,0:03:16.159
know

0:03:14.239,0:03:18.080
sit in a corner and cry decide to do

0:03:16.159,0:03:20.959
other things with your life

0:03:18.080,0:03:22.640
so uh we want to give you org users

0:03:20.959,0:03:26.000
numerous styles

0:03:22.640,0:03:27.200
and uh and an extensible mechanism to

0:03:26.000,0:03:28.799
add more of these

0:03:27.200,0:03:31.200
aesthetically pleasing styles you know

0:03:28.799,0:03:34.720
to have really nice things

0:03:31.200,0:03:35.599
look one way in the html and look almost

0:03:34.720,0:03:39.120
the same way

0:03:35.599,0:03:41.680
in the pdf and other uh back ends and

0:03:39.120,0:03:42.159
if by having these newer ones you know

0:03:41.680,0:03:44.879
people

0:03:42.159,0:03:45.519
might be encouraged to try making new

0:03:44.879,0:03:47.920
ones

0:03:45.519,0:03:49.040
especially when the interface is uh not

0:03:47.920,0:03:54.080
so difficult

0:03:49.040,0:03:54.080
uh that's the that's the aim okay

0:03:54.159,0:03:59.120
uh so let's let's have a a real story to

0:03:57.360,0:04:02.319
motivate this even more

0:03:59.120,0:04:03.599
um so here's three friends uh i hope i

0:04:02.319,0:04:04.640
don't butcher their names but these

0:04:03.599,0:04:07.040
friends are called

0:04:04.640,0:04:08.720
amin sasha and corwin and then they're

0:04:07.040,0:04:12.080
organizing a conference

0:04:08.720,0:04:14.239
uh emacs conf 2020.

0:04:12.080,0:04:16.479
so sasha decides to write an org file

0:04:14.239,0:04:19.199
and and she would like some feedback

0:04:16.479,0:04:19.840
okay and and just uh make it clear

0:04:19.199,0:04:22.960
there's no

0:04:19.840,0:04:27.199
uh just how easy this looks

0:04:22.960,0:04:27.199
let's look at the source for this block

0:04:27.280,0:04:30.720
notice it's just the word green then a

0:04:30.000,0:04:34.560
colon

0:04:30.720,0:04:37.759
than amine uh so no

0:04:34.560,0:04:38.479
no div style coloring just just you know

0:04:37.759,0:04:41.520
green color

0:04:38.479,0:04:43.600
immune a very pleasant uh or markup

0:04:41.520,0:04:44.960
so that's that's quite nice put some

0:04:43.600,0:04:47.840
bold around it

0:04:44.960,0:04:49.040
not not too difficult so hopefully uh

0:04:47.840,0:04:51.680
this will be useful to

0:04:49.040,0:04:52.240
other people as well so what kind of

0:04:51.680,0:04:56.639
feedback

0:04:52.240,0:04:59.120
uh would sasha expect to get um so maybe

0:04:56.639,0:04:59.680
she would expect top level remarks

0:04:59.120,0:05:01.759
visible

0:04:59.680,0:05:04.400
in the export you know when she makes an

0:05:01.759,0:05:07.840
html she can see right there a big block

0:05:04.400,0:05:09.840
right maybe

0:05:07.840,0:05:11.120
amin will suggest to sasha please

0:05:09.840,0:05:12.960
replace this part

0:05:11.120,0:05:14.639
with this other part or replace this

0:05:12.960,0:05:16.960
word with this other word

0:05:14.639,0:05:17.680
right um this is not really possible

0:05:16.960,0:05:21.919
with raw

0:05:17.680,0:05:24.000
html or uh yeah or with even latex

0:05:21.919,0:05:25.360
you'd have to have multiple arguments

0:05:24.000,0:05:27.840
the first argument and then

0:05:25.360,0:05:28.800
the replacement argument and it's a bit

0:05:27.840,0:05:30.960
clunky

0:05:28.800,0:05:32.080
um but with our setup you just write

0:05:30.960,0:05:34.479
some text

0:05:32.080,0:05:36.240
write hashtag plus replace with and then

0:05:34.479,0:05:39.440
write more text and you're good to go

0:05:36.240,0:05:40.720
normal uh org markup um

0:05:39.440,0:05:42.479
everyone speaks different languages

0:05:40.720,0:05:45.919
maybe they want to use a

0:05:42.479,0:05:48.000
uh one word or they're arguing about

0:05:45.919,0:05:49.759
whether we talk about frames or windows

0:05:48.000,0:05:50.560
um so maybe they want to have some

0:05:49.759,0:05:52.479
translations

0:05:50.560,0:05:55.360
right so there's different kinds of

0:05:52.479,0:05:59.360
feedbacks uh let's let's take an example

0:05:55.360,0:06:02.560
uh look at what they are okay

0:05:59.360,0:06:06.160
uh so for example sasha might write

0:06:02.560,0:06:08.319
uh this org mode right here and uh

0:06:06.160,0:06:09.759
and then in her html exports you might

0:06:08.319,0:06:12.080
see this

0:06:09.759,0:06:13.840
and uh her feedback might look really

0:06:12.080,0:06:14.560
nicely from anyone who says you know

0:06:13.840,0:06:16.639
let's uh

0:06:14.560,0:06:18.560
let's do some lisp instead of uh

0:06:16.639,0:06:20.960
mathematics let's just do some list

0:06:18.560,0:06:22.479
and and corwin says you know let's let's

0:06:20.960,0:06:25.120
not be so silly

0:06:22.479,0:06:27.360
maybe let's just say 9 a.m and move on

0:06:25.120,0:06:27.360
okay

0:06:28.080,0:06:33.039
um so amin likes to export to pdf

0:06:31.360,0:06:34.720
and so he writes his top-level remarks

0:06:33.039,0:06:37.600
using latex that's how

0:06:34.720,0:06:38.960
so to get this uh square i mean please

0:06:37.600,0:06:41.440
change whatever

0:06:38.960,0:06:43.120
he might write like this hashtag you

0:06:41.440,0:06:46.960
know plus latex

0:06:43.120,0:06:50.000
hashtag plus latex right but then

0:06:46.960,0:06:50.880
sasha only exports to p to html uh for

0:06:50.000,0:06:54.880
example

0:06:50.880,0:06:57.199
um and uh so she doesn't look at the pdf

0:06:54.880,0:06:58.560
and she may not see his top-level

0:06:57.199,0:06:59.440
feedback you know with those nice

0:06:58.560,0:07:02.160
brackets and

0:06:59.440,0:07:03.120
and bold right and so she might think

0:07:02.160,0:07:06.160
everything's good

0:07:03.120,0:07:09.039
right and that can be a bit disastrous

0:07:06.160,0:07:09.440
um so maybe sasha will will then uh make

0:07:09.039,0:07:13.199
some

0:07:09.440,0:07:16.160
of her own feedback all right uh but

0:07:13.199,0:07:16.560
and to produce it she might write html

0:07:16.160,0:07:20.639
uh

0:07:16.560,0:07:21.680
um html commands hashtag plus html to

0:07:20.639,0:07:24.240
get that

0:07:21.680,0:07:25.680
uh but then amin will make a pdf and

0:07:24.240,0:07:27.759
this won't stick out

0:07:25.680,0:07:30.160
and then so he might think everything's

0:07:27.759,0:07:33.520
okay even even though it's not

0:07:30.160,0:07:36.240
um then corwin actually decides hey

0:07:33.520,0:07:36.800
uh let me read the exported result and

0:07:36.240,0:07:38.319
these

0:07:36.800,0:07:39.919
there's all those feedback from two

0:07:38.319,0:07:42.080
people who haven't uh

0:07:39.919,0:07:43.840
read anything because maybe they were in

0:07:42.080,0:07:46.400
a russian and didn't

0:07:43.840,0:07:48.160
see the top level feedback and so they

0:07:46.400,0:07:50.000
agree hey let's have a uniform org

0:07:48.160,0:07:53.280
interface that exports

0:07:50.000,0:07:54.080
to both html and pdf make both of us

0:07:53.280,0:07:57.280
happy

0:07:54.080,0:07:58.160
okay so they decide to use org special

0:07:57.280,0:08:01.840
blocks

0:07:58.160,0:08:04.400
right um and to set this up they need to

0:08:01.840,0:08:04.879
you know maybe read a little bit of lisp

0:08:04.400,0:08:08.879
hooks

0:08:04.879,0:08:10.840
advice macros to get all of this set up

0:08:08.879,0:08:12.319
and then they'll use org as the main

0:08:10.840,0:08:14.400
interface okay

0:08:12.319,0:08:16.479
it's a lot of work but it's worth it

0:08:14.400,0:08:19.360
right maybe

0:08:16.479,0:08:19.759
um but then corwin corbin's a bit tears

0:08:19.360,0:08:22.960
so

0:08:19.759,0:08:24.800
uh corwin maybe doesn't want to write

0:08:22.960,0:08:26.080
uh using blocks he thinks they're

0:08:24.800,0:08:29.360
overkill and

0:08:26.080,0:08:31.840
and sasha wants html and uh and

0:08:29.360,0:08:32.560
i mean wants pdf and corwin wants org

0:08:31.840,0:08:34.240
reveal

0:08:32.560,0:08:36.320
so now they have to reformat all their

0:08:34.240,0:08:37.120
code and then they need to use org link

0:08:36.320,0:08:39.599
types to

0:08:37.120,0:08:41.519
reduce the overkill all right so they

0:08:39.599,0:08:44.000
can try to avoid duplication by

0:08:41.519,0:08:46.800
factoring things out into self-contained

0:08:44.000,0:08:50.320
uh defined functions or defunds

0:08:46.800,0:08:53.440
um but now to set up or links

0:08:50.320,0:08:54.399
uh we'll have uh to learn a new

0:08:53.440,0:08:57.040
interface

0:08:54.399,0:08:58.000
org setup link um learn a little bit

0:08:57.040,0:09:02.160
about fonts

0:08:58.000,0:09:05.040
follow links exports handles

0:09:02.160,0:09:06.800
it's so much that's so much but but then

0:09:05.040,0:09:08.399
you know the friends they learn a lot

0:09:06.800,0:09:11.120
you know they learn about defund all

0:09:08.399,0:09:12.480
right so these these words are red

0:09:11.120,0:09:14.320
you get a little explanation i think

0:09:12.480,0:09:16.720
it's a bit too small for anyone to read

0:09:14.320,0:09:18.000
this is lisp documentation right for

0:09:16.720,0:09:19.680
defund

0:09:18.000,0:09:21.600
advice ad there's some list

0:09:19.680,0:09:23.600
documentation right

0:09:21.600,0:09:25.279
they learn about destructuring let's so

0:09:23.600,0:09:26.959
this is from the dash library

0:09:25.279,0:09:28.800
here's all that you know glorious

0:09:26.959,0:09:29.360
glorious documentation with examples

0:09:28.800,0:09:31.680
sorry

0:09:29.360,0:09:33.760
i like that they might make an ad-hoc

0:09:31.680,0:09:36.000
mechanism to simulate

0:09:33.760,0:09:37.040
arguments for special blocks so

0:09:36.000,0:09:40.399
something maybe called

0:09:37.040,0:09:41.920
extract arguments and then of course to

0:09:40.399,0:09:42.480
make new link types they have to learn

0:09:41.920,0:09:45.120
about

0:09:42.480,0:09:46.480
org link set parameters and then it's

0:09:45.120,0:09:49.920
numerous uh

0:09:46.480,0:09:50.720
bits and pieces all right so let's oh

0:09:49.920,0:09:53.600
let's uh

0:09:50.720,0:09:55.040
close all these ones down and and uh of

0:09:53.600,0:09:56.080
course they also need to be uh

0:09:55.040,0:09:58.720
comfortable with

0:09:56.080,0:09:59.920
uh loops and maps and matching and

0:09:58.720,0:10:02.560
string functions

0:09:59.920,0:10:03.360
so it's it's a bit of a pain it's a bit

0:10:02.560,0:10:05.839
of a pain

0:10:03.360,0:10:06.560
um so it's probably not worth it so

0:10:05.839,0:10:09.360
maybe i'll just

0:10:06.560,0:10:10.320
rush things quickly or do an ad hoc you

0:10:09.360,0:10:13.680
know

0:10:10.320,0:10:15.920
we have things to do right

0:10:13.680,0:10:17.839
so maybe maybe the squad wants to have a

0:10:15.920,0:10:21.120
modular

0:10:17.839,0:10:23.040
and unified interface so everyone's

0:10:21.120,0:10:25.279
comfortable with defunct to define a

0:10:23.040,0:10:26.480
function and they say you know what

0:10:25.279,0:10:29.440
it would be nice if we could just you

0:10:26.480,0:10:32.959
know define simultaneously

0:10:29.440,0:10:34.880
both a block and the link type right

0:10:32.959,0:10:36.000
and uh that way we have a single

0:10:34.880,0:10:38.240
interface

0:10:36.000,0:10:39.040
org mode for for these things and it

0:10:38.240,0:10:42.079
would be nice was

0:10:39.040,0:10:43.680
modular so if i defined a

0:10:42.079,0:10:45.519
one kind of block and you defined

0:10:43.680,0:10:47.600
another we could compose them

0:10:45.519,0:10:49.360
right and then get a you know a nice

0:10:47.600,0:10:52.320
bigger block like lego

0:10:49.360,0:10:54.160
that would be nice building box okay and

0:10:52.320,0:10:56.240
uh this is uh what we

0:10:54.160,0:10:57.600
have come up with called death block and

0:10:56.240,0:11:00.240
it also has a

0:10:57.600,0:11:01.760
long documentation string containing

0:11:00.240,0:11:04.800
examples and things

0:11:01.760,0:11:08.320
so that way you can try to be useful

0:11:04.800,0:11:10.880
okay um so let's let's look at a a

0:11:08.320,0:11:12.800
solution to these friends uh trilemma

0:11:10.880,0:11:14.320
all right so here's here's a way to

0:11:12.800,0:11:17.040
define a block

0:11:14.320,0:11:19.200
um it looks it's it doesn't look that

0:11:17.040,0:11:22.320
difficult but this is how they can

0:11:19.200,0:11:25.920
define a block for um

0:11:22.320,0:11:27.680
for uh their top-level feedback right

0:11:25.920,0:11:28.959
so let's let's look at the three main

0:11:27.680,0:11:31.920
parts together

0:11:28.959,0:11:33.040
it's not that uh difficult i hope just

0:11:31.920,0:11:34.720
six lines

0:11:33.040,0:11:36.160
and that's including a documentation

0:11:34.720,0:11:39.440
string and you know

0:11:36.160,0:11:41.279
uh new lines and things okay so in line

0:11:39.440,0:11:42.000
one we just define the block just like

0:11:41.279,0:11:44.880
you define

0:11:42.000,0:11:46.399
a function we define a block the flag

0:11:44.880,0:11:49.680
the block name is going to be called

0:11:46.399,0:11:53.360
feedback it has an author who

0:11:49.680,0:11:56.160
right the author has no default

0:11:53.360,0:11:57.760
value it has a color and the color has a

0:11:56.160,0:12:00.560
default value of red

0:11:57.760,0:12:01.680
okay so just just as when you define

0:12:00.560,0:12:04.880
functions they

0:12:01.680,0:12:08.639
they uh you start by uh define

0:12:04.880,0:12:10.720
or def block than the name some

0:12:08.639,0:12:13.440
mandatory argument and some optional

0:12:10.720,0:12:15.760
arguments okay

0:12:13.440,0:12:18.480
then the next stage is well and

0:12:15.760,0:12:20.880
definition a documentation you know

0:12:18.480,0:12:22.880
uh the people who use this which are

0:12:20.880,0:12:25.519
future you or future me you know

0:12:22.880,0:12:27.839
uh might want to know what this is all

0:12:25.519,0:12:30.560
right so let's get to document this

0:12:27.839,0:12:32.079
uh and uh for for corwin who might want

0:12:30.560,0:12:34.560
to use uh tooltips

0:12:32.079,0:12:35.120
uh when corwin writes feedback whatever

0:12:34.560,0:12:37.120
and

0:12:35.120,0:12:38.639
emacs they'll see a nice little tooltip

0:12:37.120,0:12:41.279
and the tooltip will have

0:12:38.639,0:12:43.279
this uh documentation string right so

0:12:41.279,0:12:45.200
that'll be nice

0:12:43.279,0:12:46.480
okay and then here's the third part the

0:12:45.200,0:12:49.440
last three lines are

0:12:46.480,0:12:49.680
not not so difficult if the back end is

0:12:49.440,0:12:52.800
in

0:12:49.680,0:12:55.360
is html the backend is html

0:12:52.800,0:12:57.440
please use this template string

0:12:55.360,0:13:00.639
otherwise use the other string

0:12:57.440,0:13:01.279
okay and for each of these uh string

0:13:00.639,0:13:03.600
markers

0:13:01.279,0:13:04.959
please put in the color who wrote it and

0:13:03.600,0:13:07.279
then the contents

0:13:04.959,0:13:08.160
of the special block or the link type

0:13:07.279,0:13:10.639
okay

0:13:08.160,0:13:11.600
um so that's pretty neat not not so

0:13:10.639,0:13:14.639
difficult

0:13:11.600,0:13:15.519
so i thought that was kind of cool and

0:13:14.639,0:13:18.480
then notice it's

0:13:15.519,0:13:19.519
anaphoric it's it's a this this def

0:13:18.480,0:13:21.760
block

0:13:19.519,0:13:22.560
gives you two new names it gives you a

0:13:21.760,0:13:25.120
name called

0:13:22.560,0:13:26.480
uh contents and it gives you a name

0:13:25.120,0:13:29.040
called back end

0:13:26.480,0:13:31.040
right and so even if you're writing a

0:13:29.040,0:13:32.560
def block and you intend it to be used

0:13:31.040,0:13:35.440
only for links

0:13:32.560,0:13:37.600
uh like the uh these colors for example

0:13:35.440,0:13:38.399
uh these colors were defined using dev

0:13:37.600,0:13:41.279
block

0:13:38.399,0:13:43.360
uh and i used them as links right here

0:13:41.279,0:13:44.880
and you don't need to worry

0:13:43.360,0:13:48.160
where does the text come from in the

0:13:44.880,0:13:48.959
link you know if i say red colon bob uh

0:13:48.160,0:13:50.720
is it bob

0:13:48.959,0:13:52.000
or if i put a description is it the

0:13:50.720,0:13:54.000
description so

0:13:52.000,0:13:56.720
it's whatever is available will will

0:13:54.000,0:13:59.199
become uh the value of contents

0:13:56.720,0:14:00.320
and if you're really you know interested

0:13:59.199,0:14:03.839
and you want to do some

0:14:00.320,0:14:04.959
intricate stuff uh def block also gives

0:14:03.839,0:14:08.160
you something called

0:14:04.959,0:14:09.360
raw dash contents if you really want to

0:14:08.160,0:14:11.920
touch the raw

0:14:09.360,0:14:12.639
uh contents with all of the org markups

0:14:11.920,0:14:16.000
still there

0:14:12.639,0:14:18.320
okay so let's uh let's see

0:14:16.000,0:14:19.440
how uh everyone can uh communicate

0:14:18.320,0:14:22.480
amongst themselves

0:14:19.440,0:14:26.000
using this new interface okay so

0:14:22.480,0:14:28.399
uh uh sasha speculates and she how does

0:14:26.000,0:14:31.440
she speculate for her organ html

0:14:28.399,0:14:34.800
she might just write hey look at that no

0:14:31.440,0:14:37.519
no no html nice and and

0:14:34.800,0:14:39.600
amin wants to have some green and so he

0:14:37.519,0:14:42.240
just says hey here's some color green

0:14:39.600,0:14:42.959
and and uh there you go it looks almost

0:14:42.240,0:14:46.560
the same

0:14:42.959,0:14:49.680
right uh notice that the main argument

0:14:46.560,0:14:52.480
is right here def block took an author

0:14:49.680,0:14:53.920
and here's the author again and now the

0:14:52.480,0:14:57.360
optional argument

0:14:53.920,0:14:58.000
uses the org babel source interface you

0:14:57.360,0:15:00.639
just say

0:14:58.000,0:15:01.440
colon and then a key and then the

0:15:00.639,0:15:05.040
argument

0:15:01.440,0:15:05.519
quite quite nice and and corwin doesn't

0:15:05.040,0:15:07.920
want to

0:15:05.519,0:15:09.760
use blocks it's a bit of an overkill and

0:15:07.920,0:15:12.959
can just write a

0:15:09.760,0:15:16.000
a little um right

0:15:12.959,0:15:17.440
so the main argument is now the uh uh

0:15:16.000,0:15:19.360
the label of the link

0:15:17.440,0:15:21.600
all right and then the description of

0:15:19.360,0:15:24.959
the link is the contents

0:15:21.600,0:15:25.680
of uh of the feedback so that was quite

0:15:24.959,0:15:28.079
nice

0:15:25.680,0:15:29.360
so it looks like uh everyone uses the

0:15:28.079,0:15:32.800
same interface on the left

0:15:29.360,0:15:34.480
and can have varying uh outputs

0:15:32.800,0:15:36.639
and it looks i think it looks quite nice

0:15:34.480,0:15:40.000
and i hope you do too

0:15:36.639,0:15:42.160
um and there's a few more maybe

0:15:40.000,0:15:43.920
as you saw in some previous ones we had

0:15:42.160,0:15:46.800
text side beside side

0:15:43.920,0:15:47.440
right now um or we folded some regions

0:15:46.800,0:15:49.360
away

0:15:47.440,0:15:50.959
that was quite nice we put some things

0:15:49.360,0:15:54.000
in pretty boxes

0:15:50.959,0:15:57.120
um uh we had some spoilers at the very

0:15:54.000,0:15:58.160
beginning that we we uh hit some text uh

0:15:57.120,0:15:59.600
we demoed uh

0:15:58.160,0:16:01.680
some texts right you know here's some

0:15:59.600,0:16:04.480
org and here's what it looks like

0:16:01.680,0:16:05.199
um and and most importantly uh they they

0:16:04.480,0:16:08.320
compose

0:16:05.199,0:16:12.639
right there's uh uh there's a

0:16:08.320,0:16:14.720
a macro called uh uh thread block

0:16:12.639,0:16:16.160
uh thread block a thread block call and

0:16:14.720,0:16:18.000
it lets you thread the

0:16:16.160,0:16:20.639
the contents through a number of blocks

0:16:18.000,0:16:22.480
treating them as if they were functions

0:16:20.639,0:16:23.680
and so really you can think of a block

0:16:22.480,0:16:26.560
as a as a

0:16:23.680,0:16:27.360
as a string valued function so that's

0:16:26.560,0:16:30.959
pretty neat

0:16:27.360,0:16:31.759
i i think and uh thank you for listening

0:16:30.959,0:16:34.320
and uh

0:16:31.759,0:16:34.880
i i hope you've uh enjoyed this little

0:16:34.320,0:16:37.600
uh

0:16:34.880,0:16:38.160
happy fun time with uh with the emacs

0:16:37.600,0:16:40.720
and friends

0:16:38.160,0:16:41.759
and uh i'll i'm i'll happy happily

0:16:40.720,0:16:43.730
answer questions

0:16:41.759,0:16:45.360
uh right now um

0:16:43.730,0:16:48.160
[Music]

0:16:45.360,0:16:50.480
so uh someone says why did you put

0:16:48.160,0:16:53.600
optional arguments in a separate list

0:16:50.480,0:16:54.560
rather than using cl style argument

0:16:53.600,0:16:58.399
lists

0:16:54.560,0:17:01.680
um so that's a very good question

0:16:58.399,0:17:04.400
and i will answer that by

0:17:01.680,0:17:04.880
showing you a more involved definition

0:17:04.400,0:17:08.959
of

0:17:04.880,0:17:12.079
feedback so let's look at a

0:17:08.959,0:17:12.079
a more involved one

0:17:13.039,0:17:19.280
right right here so for example

0:17:16.079,0:17:21.760
this one is called rural mark all right

0:17:19.280,0:17:23.439
and uh please let me know if my text is

0:17:21.760,0:17:26.799
not sufficiently big

0:17:23.439,0:17:29.520
so here is here is why uh we have

0:17:26.799,0:17:30.720
two arguments that takes two arguments

0:17:29.520,0:17:33.360
uh instead of one

0:17:30.720,0:17:34.799
for for its argument list right so you

0:17:33.360,0:17:37.679
you have def block

0:17:34.799,0:17:38.400
then you have the name right then you

0:17:37.679,0:17:40.960
have

0:17:38.400,0:17:42.880
the first uh argument list and the

0:17:40.960,0:17:46.080
second argument list

0:17:42.880,0:17:49.280
the first argument list uh takes the

0:17:46.080,0:17:51.760
takes the text right after the begin

0:17:49.280,0:17:52.320
right the text right after the begin is

0:17:51.760,0:17:55.760
the main

0:17:52.320,0:17:57.039
argument okay and then the remaining key

0:17:55.760,0:18:00.320
value pairs

0:17:57.039,0:18:03.280
are in the second argument list okay

0:18:00.320,0:18:04.640
now the reason we have two is because uh

0:18:03.280,0:18:06.799
in order to

0:18:04.640,0:18:08.880
streamline the interface to account for

0:18:06.799,0:18:12.320
both uh special blocks

0:18:08.880,0:18:13.360
and or link types uh what we do is we

0:18:12.320,0:18:16.160
say hey

0:18:13.360,0:18:18.000
uh in the first argument list uh you can

0:18:16.160,0:18:21.039
give a name to the first argument

0:18:18.000,0:18:24.240
give it a default value and anything

0:18:21.039,0:18:27.760
else you provide will become uh

0:18:24.240,0:18:30.000
uh part of the i'll co link

0:18:27.760,0:18:32.000
information so for example this link we

0:18:30.000,0:18:34.799
decided to make its face

0:18:32.000,0:18:35.840
angry red um you might want to give

0:18:34.799,0:18:37.919
other features to

0:18:35.840,0:18:39.679
links so we're trying to streamline the

0:18:37.919,0:18:42.320
interface for both

0:18:39.679,0:18:42.880
special blocks and org link types and we

0:18:42.320,0:18:46.240
thought

0:18:42.880,0:18:49.840
this way was quite nice um so

0:18:46.240,0:18:52.480
that was the main reason uh someone asks

0:18:49.840,0:18:55.039
uh so if if you uh if that's uh if you

0:18:52.480,0:18:57.600
need if you have follow-up please ask

0:18:55.039,0:19:00.559
someone asks do you intend to try to

0:18:57.600,0:19:03.600
upstream this amazing work into org

0:19:00.559,0:19:04.559
well i'm glad you like it i i don't know

0:19:03.600,0:19:06.880
how to upstream

0:19:04.559,0:19:08.799
but but i i will look into it and any

0:19:06.880,0:19:11.840
advice or guidance would be

0:19:08.799,0:19:14.640
much appreciated um you know

0:19:11.840,0:19:17.120
lisp is awesome and just as defunded as

0:19:14.640,0:19:20.240
a macro deathblock is a macro and then

0:19:17.120,0:19:21.919
source blocks are awesome and then now

0:19:20.240,0:19:24.080
maybe we can have arguments and special

0:19:21.919,0:19:25.280
blocks and motivate and encourage more

0:19:24.080,0:19:28.799
people to uh

0:19:25.280,0:19:32.559
to uh learn lisp right

0:19:28.799,0:19:35.280
so another person asks

0:19:32.559,0:19:38.559
um what is used to produce colorful

0:19:35.280,0:19:40.400
boxes around the cursor

0:19:38.559,0:19:41.840
i i'm not quite sure if you're asking

0:19:40.400,0:19:42.559
are you talking about my cursor right

0:19:41.840,0:19:47.840
here

0:19:42.559,0:19:47.840
or are you talking about in the slide um

0:19:48.400,0:19:52.400
so this this this cursor is some

0:19:50.559,0:19:55.440
application called

0:19:52.400,0:19:57.679
a stream brush that i had to purchase uh

0:19:55.440,0:19:59.039
unfortunately i could not find a a

0:19:57.679,0:20:02.159
suitable free one

0:19:59.039,0:20:03.840
um and the blocks i can demonstrate some

0:20:02.159,0:20:05.679
emacs list but i can open up my emacs if

0:20:03.840,0:20:06.320
people like and we can try some things

0:20:05.679,0:20:09.440
out

0:20:06.320,0:20:12.480
happy to do that uh

0:20:09.440,0:20:14.880
you're welcome uh someone asks

0:20:12.480,0:20:15.520
a side question about org reveal how do

0:20:14.880,0:20:17.440
you get

0:20:15.520,0:20:19.120
bespoke or multiple column layouts

0:20:17.440,0:20:22.559
without using html

0:20:19.120,0:20:24.640
ah excellent question that's what we do

0:20:22.559,0:20:26.000
that's that's what this uh project is

0:20:24.640,0:20:28.960
about so it's not

0:20:26.000,0:20:29.440
org reveal it's it's our fancy parallel

0:20:28.960,0:20:32.240
uh

0:20:29.440,0:20:33.440
uh block so we have this thing you say

0:20:32.240,0:20:35.679
begin parallel

0:20:33.440,0:20:37.120
you say how many columns you would like

0:20:35.679,0:20:39.679
uh do you want a bar

0:20:37.120,0:20:40.960
or not and then you write some text and

0:20:39.679,0:20:42.480
then you uh

0:20:40.960,0:20:44.400
you get some text and according with the

0:20:42.480,0:20:47.520
bar or not right so that's

0:20:44.400,0:20:50.080
that's how we achieve that in our slides

0:20:47.520,0:20:52.559
so i'm not uh i'm not quite sure where

0:20:50.080,0:20:52.559
this was

0:20:52.880,0:20:55.919
somewhere here i think

0:20:59.520,0:21:03.840
let me try to find this for you

0:21:06.240,0:21:09.440
i can't seem to find where the parallel

0:21:08.320,0:21:12.159
blocks were

0:21:09.440,0:21:15.039
apologies let's move on to the next

0:21:12.159,0:21:17.760
question i suppose

0:21:15.039,0:21:18.400
uh i'm pretty sure they're here ah there

0:21:17.760,0:21:21.360
they are

0:21:18.400,0:21:22.640
yes so these these uh were just

0:21:21.360,0:21:25.440
instances of using

0:21:22.640,0:21:26.480
uh the parallel block and it makes

0:21:25.440,0:21:29.600
things parallel

0:21:26.480,0:21:33.360
so that's quite nice um another person

0:21:29.600,0:21:36.720
asks uh yes

0:21:33.360,0:21:37.840
excellent um how does this relate to

0:21:36.720,0:21:39.360
banda pandoc

0:21:37.840,0:21:40.960
which is used for converting between

0:21:39.360,0:21:43.919
markup formats

0:21:40.960,0:21:44.400
so all we're doing is we're we're saying

0:21:43.919,0:21:46.799
hey

0:21:44.400,0:21:47.679
please write org because org is just

0:21:46.799,0:21:50.400
fantastic

0:21:47.679,0:21:51.760
and we love it and it's the dream and if

0:21:50.400,0:21:55.039
you would like to view things

0:21:51.760,0:21:58.559
in html or in org reveal or

0:21:55.039,0:22:02.320
in pdf that's up to the user so

0:21:58.559,0:22:05.039
here is a um oh

0:22:02.320,0:22:06.080
made it too small now so here is a an

0:22:05.039,0:22:08.880
example

0:22:06.080,0:22:10.240
so here's an uh how here's how parallel

0:22:08.880,0:22:13.120
is implemented

0:22:10.240,0:22:14.320
uh just as a quick example uh not too

0:22:13.120,0:22:16.880
long

0:22:14.320,0:22:18.400
uh about half of the implementation is

0:22:16.880,0:22:20.720
documentation so

0:22:18.400,0:22:22.720
uh hopefully that speaks for for how

0:22:20.720,0:22:25.280
useful this feature is

0:22:22.720,0:22:28.080
uh so we decide if there's a rule or not

0:22:25.280,0:22:29.760
um we look for the column break

0:22:28.080,0:22:31.840
and really here we're looking at the

0:22:29.760,0:22:34.960
back end if the back end is latex

0:22:31.840,0:22:37.679
uh please use this uh incantation with

0:22:34.960,0:22:38.559
multi columns mini pages what have you

0:22:37.679,0:22:41.039
and if the

0:22:38.559,0:22:41.600
back end is something else uh please uh

0:22:41.039,0:22:44.960
do this

0:22:41.600,0:22:46.640
uh div and style and uh other uh

0:22:44.960,0:22:48.080
gibberish that we don't really wanna

0:22:46.640,0:22:51.760
look at uh so

0:22:48.080,0:22:55.280
uh when you pandoc works from org

0:22:51.760,0:22:58.080
so it might not work directly since our

0:22:55.280,0:22:59.679
interface the way we set it up is when

0:22:58.080,0:23:01.919
you try to export

0:22:59.679,0:23:03.039
uh we hook in and we do a bunch of

0:23:01.919,0:23:05.919
pre-processing

0:23:03.039,0:23:07.440
so this this uh def block is a is a

0:23:05.919,0:23:10.880
string valued function

0:23:07.440,0:23:13.919
and so whenever we see these uh begin

0:23:10.880,0:23:16.480
parallel uh when you do an export

0:23:13.919,0:23:16.960
i tell emacs hold up look for those

0:23:16.480,0:23:19.360
begin

0:23:16.960,0:23:20.320
parallels please oh you found them grab

0:23:19.360,0:23:22.400
that text

0:23:20.320,0:23:24.080
you grabbed it great now please apply

0:23:22.400,0:23:27.120
this person's uh function

0:23:24.080,0:23:29.760
onto that text and splice in the result

0:23:27.120,0:23:30.400
okay so so when you export uh we're

0:23:29.760,0:23:33.600
performing

0:23:30.400,0:23:35.120
arbitrary computations on your uh uh on

0:23:33.600,0:23:38.799
your text

0:23:35.120,0:23:40.159
so uh um some people might not find that

0:23:38.799,0:23:43.039
comforting to have

0:23:40.159,0:23:45.039
arbitrary uh computations happening so

0:23:43.039,0:23:47.520
in this article there's a few where

0:23:45.039,0:23:48.320
uh we change your text upon export we

0:23:47.520,0:23:51.760
translate it

0:23:48.320,0:23:55.360
we do other things to it um

0:23:51.760,0:23:57.360
so someone says uh if you export to

0:23:55.360,0:23:58.640
latex to pdf does that work well with

0:23:57.360,0:24:00.320
beamer as well

0:23:58.640,0:24:02.080
to create slides with columns for

0:24:00.320,0:24:05.200
example for uh

0:24:02.080,0:24:08.000
um so uh actually uh

0:24:05.200,0:24:09.200
so uh i i made a bunch of these changes

0:24:08.000,0:24:12.320
earlier this morning

0:24:09.200,0:24:14.480
and it just says latex right here um

0:24:12.320,0:24:15.360
so if you want to go to beamer i think

0:24:14.480,0:24:18.240
the back end for me

0:24:15.360,0:24:18.960
beamer is called well beamer so instead

0:24:18.240,0:24:21.200
of a

0:24:18.960,0:24:22.000
a p case what we would do is we would

0:24:21.200,0:24:25.360
say oh

0:24:22.000,0:24:29.279
if it's a latex or it's a beamer

0:24:25.360,0:24:31.120
then uh use this uh otherwise

0:24:29.279,0:24:33.039
it's not a latex it will simply default

0:24:31.120,0:24:36.400
to this one which could be

0:24:33.039,0:24:39.679
dangerous for your needs um i think it's

0:24:36.400,0:24:41.279
a bad practice to put a underscore but i

0:24:39.679,0:24:43.679
did it really quickly because i just

0:24:41.279,0:24:46.559
wanted to show you that it works fine in

0:24:43.679,0:24:47.440
org reveal contributions are more than

0:24:46.559,0:24:51.039
welcome

0:24:47.440,0:24:52.240
i i uh happily uh would love any

0:24:51.039,0:24:56.080
assistance

0:24:52.240,0:24:58.640
um and and i have a uh we have a

0:24:56.080,0:25:00.159
list a reference cheat sheet here to to

0:24:58.640,0:25:02.000
learn a little bit about lisp if you're

0:25:00.159,0:25:04.640
not comfortable or to

0:25:02.000,0:25:06.400
ask some questions lots of helpful

0:25:04.640,0:25:09.440
people

0:25:06.400,0:25:11.679
so there's another question that says uh

0:25:09.440,0:25:13.120
does typing in a block mess up with a

0:25:11.679,0:25:15.679
syntax highlighting

0:25:13.120,0:25:17.279
usually you use a single color inside an

0:25:15.679,0:25:21.279
example block for example

0:25:17.279,0:25:25.279
ah you found my crutch you found

0:25:21.279,0:25:27.440
my crutch um so i so there's

0:25:25.279,0:25:29.760
emax's is all encompassing and i'm not

0:25:27.440,0:25:32.559
quite sure how fonts work or are

0:25:29.760,0:25:33.840
you know i i learned enough to get by i

0:25:32.559,0:25:37.440
learned enough to get by

0:25:33.840,0:25:39.760
so let me um but here's

0:25:37.440,0:25:40.799
here's how links work they're they're a

0:25:39.760,0:25:42.960
bit complicated

0:25:40.799,0:25:43.919
this this is a bit scary i don't

0:25:42.960,0:25:47.039
recommend anyone

0:25:43.919,0:25:49.840
uh read it um

0:25:47.039,0:25:50.559
but uh actually let me open up an email

0:25:49.840,0:25:53.600
and you can

0:25:50.559,0:25:54.799
you can see what i see uh so here's an

0:25:53.600,0:25:56.799
emacs

0:25:54.799,0:25:58.400
all right let's make that a bit bigger

0:25:56.799,0:26:01.200
uh let's change this

0:25:58.400,0:26:01.919
slightly nope that's worse there you go

0:26:01.200,0:26:05.760
so

0:26:01.919,0:26:09.360
here's here's some words um so here's

0:26:05.760,0:26:12.000
red hello um

0:26:09.360,0:26:12.400
but you're worried about uh preserving

0:26:12.000,0:26:15.679
uh

0:26:12.400,0:26:18.480
uh uh um quantification

0:26:15.679,0:26:18.880
so let's make an emax list block all

0:26:18.480,0:26:22.840
right

0:26:18.880,0:26:27.520
and let's say plus one two ah

0:26:22.840,0:26:27.520
where's the fun hello

0:26:28.000,0:26:34.880
um bye okay where's the coloring

0:26:32.080,0:26:36.000
if we if we zoom in on this on this

0:26:34.880,0:26:39.200
begin source block

0:26:36.000,0:26:42.159
if we zoom in you can see down here

0:26:39.200,0:26:43.279
uh we have our our coloring all right

0:26:42.159,0:26:46.960
when we zoom in

0:26:43.279,0:26:50.080
if we if we zoom out ah no coloring

0:26:46.960,0:26:50.880
zoom in coloring it's about ah no

0:26:50.080,0:26:53.840
coloring

0:26:50.880,0:26:55.679
let's take off these bad boys and oh

0:26:53.840,0:26:59.360
look my coloring's back

0:26:55.679,0:27:02.320
so um in a previous

0:26:59.360,0:27:03.760
uh iteration of the system i was able to

0:27:02.320,0:27:06.400
maintain coloring

0:27:03.760,0:27:08.559
uh in this new iteration i am not i

0:27:06.400,0:27:11.039
don't know how to do it i haven't uh

0:27:08.559,0:27:13.279
had the time to to implement it i spent

0:27:11.039,0:27:17.279
a lot of time writing this uh

0:27:13.279,0:27:19.679
48 page uh documentation uh with uh

0:27:17.279,0:27:20.320
with some fun examples to to to try to

0:27:19.679,0:27:21.760
help

0:27:20.320,0:27:23.760
people learn so but but i would

0:27:21.760,0:27:26.240
appreciate any help or guidance on

0:27:23.760,0:27:28.000
how to uh maintain the quantification i

0:27:26.240,0:27:29.200
i really would like to keep those colors

0:27:28.000,0:27:31.840
in

0:27:29.200,0:27:32.640
um musa we have time for maybe one more

0:27:31.840,0:27:34.960
question

0:27:32.640,0:27:37.039
um one or two more questions and then we

0:27:34.960,0:27:39.120
have to move on to the next talk

0:27:37.039,0:27:40.799
um but yeah you're more than welcome to

0:27:39.120,0:27:42.559
take continue taking the questions via

0:27:40.799,0:27:45.760
irc or the pad

0:27:42.559,0:27:48.480
okay thank you thank you

0:27:45.760,0:27:48.880
let's uh the final question we'll take

0:27:48.480,0:27:52.320
is

0:27:48.880,0:27:54.399
um should packages implement

0:27:52.320,0:27:55.840
interface to one specific format or

0:27:54.399,0:27:57.279
attempt to be conclusive to all the

0:27:55.840,0:27:58.880
potential output targets

0:27:57.279,0:28:01.120
i think you should just make them as you

0:27:58.880,0:28:02.559
go and you know add them as you need

0:28:01.120,0:28:05.600
them we'll make uh

0:28:02.559,0:28:07.840
help requests or things and uh

0:28:05.600,0:28:09.279
we can we can share recipes in this uh

0:28:07.840,0:28:12.799
document and then

0:28:09.279,0:28:16.000
try to add other uh techniques and then

0:28:12.799,0:28:19.200
and we can uh use these blocks as a

0:28:16.000,0:28:22.240
common uh interface for

0:28:19.200,0:28:26.000
for exporting to pdf and other things

0:28:22.240,0:28:28.399
and since someone asked here is a um

0:28:26.000,0:28:30.159
here is uh what a pdf looks like this is

0:28:28.399,0:28:33.840
the same pdf and

0:28:30.159,0:28:34.960
uh rendered uh just i made no effort to

0:28:33.840,0:28:37.840
make it look good

0:28:34.960,0:28:38.559
but it surprisingly does look good so so

0:28:37.840,0:28:41.600
uh that was

0:28:38.559,0:28:44.320
uh that was nice um that was a

0:28:41.600,0:28:44.880
terrible magenta but that is life uh

0:28:44.320,0:28:47.279
anyhow

0:28:44.880,0:28:48.960
i hope you all enjoyed this talk i hope

0:28:47.279,0:28:51.679
you will find um

0:28:48.960,0:28:52.799
death block uh useful to you it is

0:28:51.679,0:28:54.960
available on melbourne

0:28:52.799,0:28:57.679
uh in a rush to make it available for

0:28:54.960,0:29:00.159
emacs conf 2020 some melba

0:28:57.679,0:29:00.960
guidelines may not have been in here too

0:29:00.159,0:29:03.200
please do not

0:29:00.960,0:29:04.720
hit me um and i hope everyone enjoys the

0:29:03.200,0:29:08.559
rest of the emacs conf

0:29:04.720,0:29:08.559
2020 thank you