summaryrefslogtreecommitdiffstats
path: root/2020
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--2020/info/13.md2
-rw-r--r--2020/info/14.md2
-rw-r--r--2020/info/15.md2
-rw-r--r--2020/organizers-notebook.md6
-rw-r--r--2020/organizers-notebook.org6
-rw-r--r--2020/subtitles/emacsconf-2020--13-experience-report-steps-to-emacs-hyper-notebooks--joseph-corneli-raymond-puzio-cameron-ray-smith-autogen.vtt1081
-rw-r--r--2020/subtitles/emacsconf-2020--13-experience-report-steps-to-emacs-hyper-notebooks--joseph-corneli-raymond-puzio-cameron-ray-smith.vtt968
-rw-r--r--2020/subtitles/emacsconf-2020--14-readme-driven-design--adam-ard-autogen.vtt1426
-rw-r--r--2020/subtitles/emacsconf-2020--14-readme-driven-design--adam-ard.vtt1297
-rw-r--r--2020/subtitles/emacsconf-2020--15-moving-from-jekyll-to-orgmode-an-experience-report--adolfo-villafiorita-autogen.vtt1183
-rw-r--r--2020/subtitles/emacsconf-2020--15-moving-from-jekyll-to-orgmode-an-experience-report--adolfo-villafiorita.vtt1057
11 files changed, 3331 insertions, 3699 deletions
diff --git a/2020/info/13.md b/2020/info/13.md
index 54597d8c..3140b467 100644
--- a/2020/info/13.md
+++ b/2020/info/13.md
@@ -1,7 +1,7 @@
# Experience Report: Steps to "Emacs Hyper Notebooks"
Joseph Corneli, Raymond Puzio, and Cameron Ray Smith
-[[!template id=vid src="https://mirror.csclub.uwaterloo.ca/emacsconf/2020/emacsconf-2020--13-experience-report-steps-to-emacs-hyper-notebooks--joseph-corneli-raymond-puzio-cameron-ray-smith.webm"]]
+[[!template id=vid src="https://mirror.csclub.uwaterloo.ca/emacsconf/2020/emacsconf-2020--13-experience-report-steps-to-emacs-hyper-notebooks--joseph-corneli-raymond-puzio-cameron-ray-smith.webm" subtitles="/2020/subtitles/emacsconf-2020--13-experience-report-steps-to-emacs-hyper-notebooks--joseph-corneli-raymond-puzio-cameron-ray-smith.vtt"]]
[Download compressed .webm video (8.6M)](https://mirror.csclub.uwaterloo.ca/emacsconf/2020/smaller/emacsconf-2020--13-experience-report-steps-to-emacs-hyper-notebooks--joseph-corneli-raymond-puzio-cameron-ray-smith--vp9-q56-video-original-audio.webm)
We present a short experience report from the perspective of two
diff --git a/2020/info/14.md b/2020/info/14.md
index 55f86fcc..9d7ee315 100644
--- a/2020/info/14.md
+++ b/2020/info/14.md
@@ -1,7 +1,7 @@
# README-Driven Design
Adam Ard
-[[!template id=vid src="https://mirror.csclub.uwaterloo.ca/emacsconf/2020/emacsconf-2020--14-readme-driven-design--adam-ard.webm"]]
+[[!template id=vid src="https://mirror.csclub.uwaterloo.ca/emacsconf/2020/emacsconf-2020--14-readme-driven-design--adam-ard.webm" subtitles="/2020/subtitles/emacsconf-2020--14-readme-driven-design--adam-ard.vtt"]]
[Download compressed .webm video (21.4M)](https://mirror.csclub.uwaterloo.ca/emacsconf/2020/smaller/emacsconf-2020--14-readme-driven-design--adam-ard--vp9-q56-video-original-audio.webm)
Many source code projects these days begin with a README file. While
diff --git a/2020/info/15.md b/2020/info/15.md
index dd288c64..c61cd24f 100644
--- a/2020/info/15.md
+++ b/2020/info/15.md
@@ -1,7 +1,7 @@
# Moving from Jekyll to OrgMode, an experience report
Adolfo Villafiorita
-[[!template id=vid src="https://mirror.csclub.uwaterloo.ca/emacsconf/2020/emacsconf-2020--15-moving-from-jekyll-to-orgmode-an-experience-report--adolfo-villafiorita.webm"]]
+[[!template id=vid src="https://mirror.csclub.uwaterloo.ca/emacsconf/2020/emacsconf-2020--15-moving-from-jekyll-to-orgmode-an-experience-report--adolfo-villafiorita.webm" subtitles="/2020/subtitles/emacsconf-2020--15-moving-from-jekyll-to-orgmode-an-experience-report--adolfo-villafiorita.vtt"]]
[Download compressed .webm video (13.8M)](https://mirror.csclub.uwaterloo.ca/emacsconf/2020/smaller/emacsconf-2020--15-moving-from-jekyll-to-orgmode-an-experience-report--adolfo-villafiorita--vp9-q56-video-original-audio.webm)
I have been a long time user of static site generators, such as
diff --git a/2020/organizers-notebook.md b/2020/organizers-notebook.md
index 9fe6632c..107214e8 100644
--- a/2020/organizers-notebook.md
+++ b/2020/organizers-notebook.md
@@ -39,9 +39,9 @@ I modified the `subed` package to work with VTT files. The modified version is a
- [X] sachac <./subtitles/emacsconf-2020--09-orgmode-your-life-in-plain-text--rainer-koenig.vtt>
- [X] sachac <./subtitles/emacsconf-2020--11-the-org-gtd-package-opinions-about-getting-things-done--aldric.vtt>
- [X] sachac <./subtitles/emacsconf-2020--12-one-big-ass-org-file-or-multiple-tiny-ones-finally-the-end-of-the-debate--leo-vivier-autogen.vtt>
-- [ ] <./subtitles/emacsconf-2020--13-experience-report-steps-to-emacs-hyper-notebooks--joseph-corneli-raymond-puzio-cameron-ray-smith-autogen.vtt>
-- [ ] <./subtitles/emacsconf-2020--14-readme-driven-design--adam-ard-autogen.vtt>
-- [ ] <./subtitles/emacsconf-2020--15-moving-from-jekyll-to-orgmode-an-experience-report--adolfo-villafiorita-autogen.vtt>
+- [X] sachac <./subtitles/emacsconf-2020--13-experience-report-steps-to-emacs-hyper-notebooks--joseph-corneli-raymond-puzio-cameron-ray-smith-autogen.vtt>
+- [X] sachac <./subtitles/emacsconf-2020--14-readme-driven-design--adam-ard-autogen.vtt>
+- [X] sachac <./subtitles/emacsconf-2020--15-moving-from-jekyll-to-orgmode-an-experience-report--adolfo-villafiorita-autogen.vtt>
- [ ] <./subtitles/emacsconf-2020--16-org-roam-presentation-demonstration-and-whats-on-the-horizon--leo-vivier-autogen.vtt>
- [ ] <./subtitles/emacsconf-2020--17-org-mode-and-org-roam-for-scholars-and-researchers--noorah-alhasan-autogen.vtt>
- [ ] <./subtitles/emacsconf-2020--18-org-roam-technical-presentation--leo-vivier-autogen.vtt>
diff --git a/2020/organizers-notebook.org b/2020/organizers-notebook.org
index e7519a91..a8f2ec5c 100644
--- a/2020/organizers-notebook.org
+++ b/2020/organizers-notebook.org
@@ -39,9 +39,9 @@ I modified the =subed= package to work with VTT files. The modified version is a
- [X] sachac [[./subtitles/emacsconf-2020--09-orgmode-your-life-in-plain-text--rainer-koenig.vtt]]
- [X] sachac [[./subtitles/emacsconf-2020--11-the-org-gtd-package-opinions-about-getting-things-done--aldric.vtt]]
- [X] sachac [[./subtitles/emacsconf-2020--12-one-big-ass-org-file-or-multiple-tiny-ones-finally-the-end-of-the-debate--leo-vivier-autogen.vtt]]
-- [ ] sachac [[./subtitles/emacsconf-2020--13-experience-report-steps-to-emacs-hyper-notebooks--joseph-corneli-raymond-puzio-cameron-ray-smith-autogen.vtt]]
-- [ ] sachac [[./subtitles/emacsconf-2020--14-readme-driven-design--adam-ard-autogen.vtt]]
-- [ ] sachac [[./subtitles/emacsconf-2020--15-moving-from-jekyll-to-orgmode-an-experience-report--adolfo-villafiorita-autogen.vtt]]
+- [X] sachac [[./subtitles/emacsconf-2020--13-experience-report-steps-to-emacs-hyper-notebooks--joseph-corneli-raymond-puzio-cameron-ray-smith-autogen.vtt]]
+- [X] sachac [[./subtitles/emacsconf-2020--14-readme-driven-design--adam-ard-autogen.vtt]]
+- [X] sachac [[./subtitles/emacsconf-2020--15-moving-from-jekyll-to-orgmode-an-experience-report--adolfo-villafiorita-autogen.vtt]]
- [ ] [[./subtitles/emacsconf-2020--16-org-roam-presentation-demonstration-and-whats-on-the-horizon--leo-vivier-autogen.vtt]]
- [ ] [[./subtitles/emacsconf-2020--17-org-mode-and-org-roam-for-scholars-and-researchers--noorah-alhasan-autogen.vtt]]
- [ ] [[./subtitles/emacsconf-2020--18-org-roam-technical-presentation--leo-vivier-autogen.vtt]]
diff --git a/2020/subtitles/emacsconf-2020--13-experience-report-steps-to-emacs-hyper-notebooks--joseph-corneli-raymond-puzio-cameron-ray-smith-autogen.vtt b/2020/subtitles/emacsconf-2020--13-experience-report-steps-to-emacs-hyper-notebooks--joseph-corneli-raymond-puzio-cameron-ray-smith-autogen.vtt
deleted file mode 100644
index eb176536..00000000
--- a/2020/subtitles/emacsconf-2020--13-experience-report-steps-to-emacs-hyper-notebooks--joseph-corneli-raymond-puzio-cameron-ray-smith-autogen.vtt
+++ /dev/null
@@ -1,1081 +0,0 @@
-WEBVTT
-
-00:00:00.320 --> 00:00:03.280
-um so hi I'm joe corneli
-
-00:00:03.280 --> 00:00:05.920
-uh this is work I did with ray puzio and
-
-00:00:05.920 --> 00:00:06.879
-cameron smith
-
-00:00:06.879 --> 00:00:10.559
-um and they're the main protagonists in
-
-00:00:10.559 --> 00:00:11.599
-this story they
-
-00:00:11.599 --> 00:00:14.960
-are uh researchers who've been working
-
-00:00:14.960 --> 00:00:17.840
-on theoretical biology um so in a
-
-00:00:17.840 --> 00:00:20.160
-typical project they may use manxima
-
-00:00:20.160 --> 00:00:23.760
-and julia their work for biology physics
-
-00:00:23.760 --> 00:00:24.800
-and computer science
-
-00:00:24.800 --> 00:00:27.199
-computer science and the latest work in
-
-00:00:27.199 --> 00:00:29.439
-progress is on branching processes for
-
-00:00:29.439 --> 00:00:30.800
-cancer modeling so
-
-00:00:30.800 --> 00:00:34.719
-how can um Emacs possibly help
-
-00:00:34.719 --> 00:00:37.360
-let's let's have a look uh moving code
-
-00:00:37.360 --> 00:00:38.399
-and data between these different
-
-00:00:38.399 --> 00:00:39.680
-programs by hand is
-
-00:00:39.680 --> 00:00:42.000
-annoying on separate workflows for
-
-00:00:42.000 --> 00:00:43.200
-writing up notes and preparing
-
-00:00:43.200 --> 00:00:44.399
-publications
-
-00:00:44.399 --> 00:00:46.000
-is perhaps even more annoying all of
-
-00:00:46.000 --> 00:00:48.640
-it's time consuming and error-prone
-
-00:00:48.640 --> 00:00:52.000
-um so what about maybe using jupiter
-
-00:00:52.000 --> 00:00:53.760
-uh we found something called script of
-
-00:00:53.760 --> 00:00:55.199
-scripts and it solves some of those
-
-00:00:55.199 --> 00:00:58.399
-problems because you can use
-
-00:00:58.399 --> 00:01:01.120
-maximum and julia together but we were
-
-00:01:01.120 --> 00:01:02.640
-quite happy to explore emacs based
-
-00:01:02.640 --> 00:01:05.199
-solutions being emax enthusiasts and we
-
-00:01:05.199 --> 00:01:05.840
-even
-
-00:01:05.840 --> 00:01:07.760
-got cameron to be enthusiastic about
-
-00:01:07.760 --> 00:01:09.200
-doing emacs so that
-
-00:01:09.200 --> 00:01:11.600
-went nice so just here's a little
-
-00:01:11.600 --> 00:01:12.400
-feature grid
-
-00:01:12.400 --> 00:01:15.360
-of emacs org versus just sort of your
-
-00:01:15.360 --> 00:01:16.400
-generic
-
-00:01:16.400 --> 00:01:19.040
-um tools that are in a different more
-
-00:01:19.040 --> 00:01:20.960
-general ecosystem so as you can see it's
-
-00:01:20.960 --> 00:01:21.520
-quite
-
-00:01:21.520 --> 00:01:23.360
-feature complete you've got your maximo
-
-00:01:23.360 --> 00:01:25.520
-mode julia mode you can use both of them
-
-00:01:25.520 --> 00:01:27.119
-inside of org mode
-
-00:01:27.119 --> 00:01:28.720
-you can present things with word tree
-
-00:01:28.720 --> 00:01:30.240
-slide you can set up a
-
-00:01:30.240 --> 00:01:33.280
-wiki inside of orgrome this is one I
-
-00:01:33.280 --> 00:01:33.680
-found
-
-00:01:33.680 --> 00:01:35.759
-rather recently you can even use
-
-00:01:35.759 --> 00:01:37.759
-compatibly with orgrome something called
-
-00:01:37.759 --> 00:01:38.799
-log seek
-
-00:01:38.799 --> 00:01:41.520
-which is in the browser um so that's
-
-00:01:41.520 --> 00:01:42.159
-nice
-
-00:01:42.159 --> 00:01:44.320
-um you can do real-time collaborative
-
-00:01:44.320 --> 00:01:45.840
-editing um
-
-00:01:45.840 --> 00:01:47.840
-either in a kind of pairing style or in
-
-00:01:47.840 --> 00:01:49.280
-a more etherpad style
-
-00:01:49.280 --> 00:01:51.520
-obviously you can manage your references
-
-00:01:51.520 --> 00:01:54.159
-you can typeset whatever you want um you
-
-00:01:54.159 --> 00:01:55.759
-can publish work in progress on a blog
-
-00:01:55.759 --> 00:01:57.439
-and the fern is another one of these
-
-00:01:57.439 --> 00:01:58.159
-external
-
-00:01:58.159 --> 00:02:00.560
-org mode tools it's not actually any mac
-
-00:02:00.560 --> 00:02:01.360
-but works with
-
-00:02:01.360 --> 00:02:03.680
-org mode stuff and you know so we're
-
-00:02:03.680 --> 00:02:04.399
-good to go
-
-00:02:04.399 --> 00:02:06.640
-uh with all of that so what does that
-
-00:02:06.640 --> 00:02:08.000
-look like well here's
-
-00:02:08.000 --> 00:02:09.679
-a little example from before they were
-
-00:02:09.679 --> 00:02:11.599
-doing um
-
-00:02:11.599 --> 00:02:12.800
-before we started really thinking
-
-00:02:12.800 --> 00:02:14.560
-seriously about this stuff so this is
-
-00:02:14.560 --> 00:02:15.599
-just maxima
-
-00:02:15.599 --> 00:02:17.440
-well maximo doesn't have a long running
-
-00:02:17.440 --> 00:02:19.280
-process by default if you've ever used
-
-00:02:19.280 --> 00:02:20.160
-python
-
-00:02:20.160 --> 00:02:22.480
-uh you have something called sessions uh
-
-00:02:22.480 --> 00:02:23.920
-they don't have that for maxim at least
-
-00:02:23.920 --> 00:02:24.959
-not by default
-
-00:02:24.959 --> 00:02:27.599
-um so how what was the workaround
-
-00:02:27.599 --> 00:02:29.360
-there's this thing called uh
-
-00:02:29.360 --> 00:02:32.480
-solve for you here and um
-
-00:02:32.480 --> 00:02:34.879
-that shows up down below again in these
-
-00:02:34.879 --> 00:02:36.319
-angle brackets which you've seen maybe
-
-00:02:36.319 --> 00:02:37.360
-in someone else's talk
-
-00:02:37.360 --> 00:02:40.480
-uh which means go to the previous uh
-
-00:02:40.480 --> 00:02:41.920
-thing that was named soul for you
-
-00:02:41.920 --> 00:02:43.920
-and do that all over again so they do
-
-00:02:43.920 --> 00:02:45.280
-that over again
-
-00:02:45.280 --> 00:02:47.440
-and here's the little maxima code for
-
-00:02:47.440 --> 00:02:49.519
-defining you saw so you've now defined
-
-00:02:49.519 --> 00:02:50.560
-you saw
-
-00:02:50.560 --> 00:02:51.920
-and then you can use it in the next
-
-00:02:51.920 --> 00:02:54.000
-expression you get out a nice juicy
-
-00:02:54.000 --> 00:02:56.560
-zero at the end but it's a little bit a
-
-00:02:56.560 --> 00:02:57.200
-little bit
-
-00:02:57.200 --> 00:02:58.959
-like cartridge in a pear tree to have to
-
-00:02:58.959 --> 00:03:00.640
-redefine everything every time
-
-00:03:00.640 --> 00:03:02.560
-so this is clearly at the level of work
-
-00:03:02.560 --> 00:03:04.159
-around um maybe just
-
-00:03:04.159 --> 00:03:06.879
-one more time going looking through that
-
-00:03:06.879 --> 00:03:07.920
-um
-
-00:03:07.920 --> 00:03:11.599
-that stuff um
-
-00:03:11.599 --> 00:03:13.760
-sorry so uh looking through that stuff
-
-00:03:13.760 --> 00:03:15.280
-this is we're going to need something
-
-00:03:15.280 --> 00:03:17.200
-like that probably for stitching
-
-00:03:17.200 --> 00:03:19.599
-maxima and julie julia together so it's
-
-00:03:19.599 --> 00:03:20.319
-good to
-
-00:03:20.319 --> 00:03:21.680
-look a little bit about how that might
-
-00:03:21.680 --> 00:03:23.920
-work so first of all you can cache
-
-00:03:23.920 --> 00:03:25.680
-results so if you wanted to save the
-
-00:03:25.680 --> 00:03:26.480
-date
-
-00:03:26.480 --> 00:03:28.480
-out of block one at a certain time and
-
-00:03:28.480 --> 00:03:29.920
-then use
-
-00:03:29.920 --> 00:03:32.239
-use it again later so at the time when I
-
-00:03:32.239 --> 00:03:33.280
-ran this code
-
-00:03:33.280 --> 00:03:34.640
-you can see I've got two slightly
-
-00:03:34.640 --> 00:03:36.720
-different time stamps down below one's
-
-00:03:36.720 --> 00:03:38.560
-the cached result and the other was the
-
-00:03:38.560 --> 00:03:40.319
-result of reevaluating
-
-00:03:40.319 --> 00:03:42.640
-the block so you can move things around
-
-00:03:42.640 --> 00:03:43.760
-um and that's
-
-00:03:43.760 --> 00:03:46.000
-that's going to be useful but you know
-
-00:03:46.000 --> 00:03:47.280
-that's not really the main problem the
-
-00:03:47.280 --> 00:03:48.080
-main problem is
-
-00:03:48.080 --> 00:03:50.799
-making maxima long running so kind of
-
-00:03:50.799 --> 00:03:51.440
-the
-
-00:03:51.440 --> 00:03:53.920
-core of this talk is a new observant
-
-00:03:53.920 --> 00:03:56.400
-facility which is a general purpose
-
-00:03:56.400 --> 00:03:59.280
-way to do that kind of thing which
-
-00:03:59.280 --> 00:04:00.560
-involves a very simple
-
-00:04:00.560 --> 00:04:04.239
-change to obcor uh so we'll give a quick
-
-00:04:04.239 --> 00:04:05.360
-overview of that and show
-
-00:04:05.360 --> 00:04:08.480
-an example um so here's the example
-
-00:04:08.480 --> 00:04:11.760
-um a very simple sort of silly example
-
-00:04:11.760 --> 00:04:13.040
-uh what does it mean to have a long
-
-00:04:13.040 --> 00:04:14.640
-running process here I've set this
-
-00:04:14.640 --> 00:04:15.920
-display2d
-
-00:04:15.920 --> 00:04:18.560
-to be false um which just means that
-
-00:04:18.560 --> 00:04:19.440
-things are going to come
-
-00:04:19.440 --> 00:04:22.320
-come across in 1d and then I ask it to
-
-00:04:22.320 --> 00:04:23.040
-expand
-
-00:04:23.040 --> 00:04:25.199
-uh something and I get latex by default
-
-00:04:25.199 --> 00:04:27.280
-so so that's what it means is I've sent
-
-00:04:27.280 --> 00:04:28.639
-something in and it's going to come
-
-00:04:28.639 --> 00:04:30.240
-across in one view which is great
-
-00:04:30.240 --> 00:04:32.080
-um maybe you'll also notice that there's
-
-00:04:32.080 --> 00:04:34.560
-no semicolon if you're a maxima fan
-
-00:04:34.560 --> 00:04:36.720
-um and things are coming across as tech
-
-00:04:36.720 --> 00:04:38.400
-so those were some little bonus features
-
-00:04:38.400 --> 00:04:40.320
-and I'll show you how that works later
-
-00:04:40.320 --> 00:04:41.040
-so
-
-00:04:41.040 --> 00:04:45.440
-um the change to obcor is as follows uh
-
-00:04:45.440 --> 00:04:48.880
-um we uh actually this should say uh
-
-00:04:48.880 --> 00:04:51.520
-instead of stream here it should say um
-
-00:04:51.520 --> 00:04:52.479
-servant
-
-00:04:52.479 --> 00:04:54.800
-sorry uh we tried an experimental
-
-00:04:54.800 --> 00:04:56.160
-version what's called stream so now it's
-
-00:04:56.160 --> 00:04:58.160
-called servant but all it does is it
-
-00:04:58.160 --> 00:05:01.520
-overrides uh or babel execute laying for
-
-00:05:01.520 --> 00:05:02.639
-arbitrary laying
-
-00:05:02.639 --> 00:05:05.919
-if you have um a servant
-
-00:05:05.919 --> 00:05:07.840
-in your in your params so that's the
-
-00:05:07.840 --> 00:05:09.759
-change that hasn't been
-
-00:05:09.759 --> 00:05:11.919
-pushed out or sent as a patch to anybody
-
-00:05:11.919 --> 00:05:13.759
-but it's a pretty minor change
-
-00:05:13.759 --> 00:05:16.960
-um here's an overview without the code
-
-00:05:16.960 --> 00:05:19.080
-of just a high level overview of
-
-00:05:19.080 --> 00:05:20.720
-observant.el so
-
-00:05:20.720 --> 00:05:22.160
-it stores information about these
-
-00:05:22.160 --> 00:05:24.479
-processes in a hash table
-
-00:05:24.479 --> 00:05:26.080
-it can do pre-processing and
-
-00:05:26.080 --> 00:05:27.600
-post-processing
-
-00:05:27.600 --> 00:05:29.759
-um it does all these things it stores
-
-00:05:29.759 --> 00:05:30.720
-the output
-
-00:05:30.720 --> 00:05:32.479
-I mentioned here that in principle we
-
-00:05:32.479 --> 00:05:34.080
-could store lots of output and have a
-
-00:05:34.080 --> 00:05:35.280
-kind of browsable
-
-00:05:35.280 --> 00:05:36.560
-history although we don't do that
-
-00:05:36.560 --> 00:05:38.880
-presently um but that's what observant
-
-00:05:38.880 --> 00:05:40.639
-does is it does what you might expect
-
-00:05:40.639 --> 00:05:41.440
-and here's the
-
-00:05:41.440 --> 00:05:45.440
-here's the maxima kind of um
-
-00:05:45.440 --> 00:05:48.160
-on-ramp uh to get maxima brought in so
-
-00:05:48.160 --> 00:05:49.600
-you have to obviously have a maximum
-
-00:05:49.600 --> 00:05:51.360
-process you can call
-
-00:05:51.360 --> 00:05:54.960
-um put hash uh this is the preprocessing
-
-00:05:54.960 --> 00:05:57.840
-thing I mentioned adding in some tech um
-
-00:05:57.840 --> 00:05:58.960
-and adding in
-
-00:05:58.960 --> 00:06:01.520
-uh or deleting rather a substring and
-
-00:06:01.520 --> 00:06:03.120
-here here is why you delete the
-
-00:06:03.120 --> 00:06:03.759
-substring
-
-00:06:03.759 --> 00:06:06.960
-is because um maxima thinks it's a good
-
-00:06:06.960 --> 00:06:08.240
-idea to tell you false
-
-00:06:08.240 --> 00:06:10.080
-once you once you run check on things
-
-00:06:10.080 --> 00:06:11.759
-you've got to delete that back out to
-
-00:06:11.759 --> 00:06:13.680
-get something kind of coherent out of it
-
-00:06:13.680 --> 00:06:16.960
-but so this is how to set up maximal um
-
-00:06:16.960 --> 00:06:19.280
-that's enough really of the demo is not
-
-00:06:19.280 --> 00:06:20.000
-really a demos for
-
-00:06:20.000 --> 00:06:21.919
-show and tell but uh this is an
-
-00:06:21.919 --> 00:06:23.600
-experience report I wanted to talk about
-
-00:06:23.600 --> 00:06:25.440
-the experience of doing this
-
-00:06:25.440 --> 00:06:28.080
-so some some negatives like we tried to
-
-00:06:28.080 --> 00:06:30.160
-get emacs jupiter working
-
-00:06:30.160 --> 00:06:33.199
-prior to prior to working on the um
-
-00:06:33.199 --> 00:06:36.000
-observant and we couldn't get it doing
-
-00:06:36.000 --> 00:06:37.919
-everything we wanted despite a bit of
-
-00:06:37.919 --> 00:06:40.160
-heavy lifting and debugging and stuff so
-
-00:06:40.160 --> 00:06:41.840
-that's not not finished that was a bit
-
-00:06:41.840 --> 00:06:42.880
-difficult
-
-00:06:42.880 --> 00:06:45.360
-um on the other hand working on
-
-00:06:45.360 --> 00:06:47.759
-observing was fun and pretty lightweight
-
-00:06:47.759 --> 00:06:48.479
-and easy
-
-00:06:48.479 --> 00:06:50.400
-um we got some experience co-editing
-
-00:06:50.400 --> 00:06:52.400
-things with these real-time tools
-
-00:06:52.400 --> 00:06:54.479
-obviously the stack is somewhat work in
-
-00:06:54.479 --> 00:06:55.919
-progress um
-
-00:06:55.919 --> 00:06:58.000
-so I just wanted to give a shout out to
-
-00:06:58.000 --> 00:07:00.800
-crdt which was really fun
-
-00:07:00.800 --> 00:07:03.919
-and champion was making bug fiction
-
-00:07:03.919 --> 00:07:07.039
-bug fixes for that as we go similarly
-
-00:07:07.039 --> 00:07:08.960
-for fern and log seek the maintainers
-
-00:07:08.960 --> 00:07:10.160
-were really responsive
-
-00:07:10.160 --> 00:07:12.960
-um and so that was nice we did try to
-
-00:07:12.960 --> 00:07:14.560
-get emacs running in the browser
-
-00:07:14.560 --> 00:07:15.840
-thinking it would be really nice for
-
-00:07:15.840 --> 00:07:16.880
-people who
-
-00:07:16.880 --> 00:07:19.520
-um didn't want to install it to get a
-
-00:07:19.520 --> 00:07:21.120
-chance to just try it
-
-00:07:21.120 --> 00:07:23.120
-uh but actually browsers capture things
-
-00:07:23.120 --> 00:07:24.479
-like uh control n
-
-00:07:24.479 --> 00:07:27.120
-and so that's that was a bit annoying
-
-00:07:27.120 --> 00:07:28.479
-but we did get lots of great feedback
-
-00:07:28.479 --> 00:07:29.759
-and interaction with people including
-
-00:07:29.759 --> 00:07:31.599
-around this conference so thank you
-
-00:07:31.599 --> 00:07:33.759
-to those who we've had discussions with
-
-00:07:33.759 --> 00:07:35.599
-um
-
-00:07:35.599 --> 00:07:37.680
-so future work okay so maybe you
-
-00:07:37.680 --> 00:07:38.639
-remember I didn't
-
-00:07:38.639 --> 00:07:41.039
-give a talk a few years back on arcana
-
-00:07:41.039 --> 00:07:42.400
-so what what
-
-00:07:42.400 --> 00:07:44.479
-might this have to do with org mode and
-
-00:07:44.479 --> 00:07:45.919
-that's always the question one asks
-
-00:07:45.919 --> 00:07:47.039
-about arcata
-
-00:07:47.039 --> 00:07:48.720
-well so arcana one of the things it does
-
-00:07:48.720 --> 00:07:50.319
-is transclusions and so that could be
-
-00:07:50.319 --> 00:07:51.680
-actually very helpful
-
-00:07:51.680 --> 00:07:54.000
-in connection with this combined notes
-
-00:07:54.000 --> 00:07:55.520
-and write-up workflow so you might have
-
-00:07:55.520 --> 00:07:56.479
-a
-
-00:07:56.479 --> 00:07:58.400
-forward mode uh and some of these
-
-00:07:58.400 --> 00:08:00.800
-results we got back as raw results
-
-00:08:00.800 --> 00:08:03.199
-could go right into your write up in a
-
-00:08:03.199 --> 00:08:03.919
-kind of
-
-00:08:03.919 --> 00:08:07.520
-convenient way at a level above um
-
-00:08:07.520 --> 00:08:09.039
-transparently a level above the notebook
-
-00:08:09.039 --> 00:08:11.280
-so you'd have the notebook alongside the
-
-00:08:11.280 --> 00:08:13.440
-write-up in that case
-
-00:08:13.440 --> 00:08:15.599
-which is a sort of variation on the
-
-00:08:15.599 --> 00:08:16.800
-literate programming
-
-00:08:16.800 --> 00:08:19.120
-workflow this is speculative who knows
-
-00:08:19.120 --> 00:08:20.000
-the other thought is
-
-00:08:20.000 --> 00:08:22.080
-it just relates to the idea of network
-
-00:08:22.080 --> 00:08:23.520
-programming so we can imagine these
-
-00:08:23.520 --> 00:08:24.800
-networks of
-
-00:08:24.800 --> 00:08:26.639
-computational nodes maybe sitting inside
-
-00:08:26.639 --> 00:08:28.800
-of orgrome calling each other
-
-00:08:28.800 --> 00:08:31.199
-um and you would want to maintain some
-
-00:08:31.199 --> 00:08:32.560
-kind of model of that
-
-00:08:32.560 --> 00:08:34.959
-process and a sort of general question
-
-00:08:34.959 --> 00:08:36.640
-is how do we have a remote control for
-
-00:08:36.640 --> 00:08:38.320
-long-running processes you could do that
-
-00:08:38.320 --> 00:08:40.240
-in lisp or closure but
-
-00:08:40.240 --> 00:08:42.479
-maybe we could have something a little
-
-00:08:42.479 --> 00:08:44.080
-bit like that here
-
-00:08:44.080 --> 00:08:45.839
-um so conclusions what have we actually
-
-00:08:45.839 --> 00:08:48.080
-addressed well uh we addressed uh
-
-00:08:48.080 --> 00:08:50.080
-accessing any long-running process with
-
-00:08:50.080 --> 00:08:51.600
-a simple or mode interface
-
-00:08:51.600 --> 00:08:52.959
-obviously we're not the only people to
-
-00:08:52.959 --> 00:08:54.880
-think about notebooks but we think that
-
-00:08:54.880 --> 00:08:56.880
-emacs has some advantages
-
-00:08:56.880 --> 00:08:58.880
-related to reproducible research and
-
-00:08:58.880 --> 00:09:01.120
-interdisciplinary collaboration so let's
-
-00:09:01.120 --> 00:09:01.680
-just
-
-00:09:01.680 --> 00:09:03.120
-say that we think something is
-
-00:09:03.120 --> 00:09:04.880
-reproducible if it's actually teachable
-
-00:09:04.880 --> 00:09:07.200
-to someone new and they can do it
-
-00:09:07.200 --> 00:09:09.279
-org mode seems very useful for that many
-
-00:09:09.279 --> 00:09:11.680
-of the other talks have touched on this
-
-00:09:11.680 --> 00:09:14.399
-interdisciplinary collaboration is great
-
-00:09:14.399 --> 00:09:16.000
-this was an interdisciplinary
-
-00:09:16.000 --> 00:09:17.839
-collaboration on some level but
-
-00:09:17.839 --> 00:09:19.680
-what about you know future work for
-
-00:09:19.680 --> 00:09:21.600
-bringing in scenario planners simulation
-
-00:09:21.600 --> 00:09:22.320
-scientists
-
-00:09:22.320 --> 00:09:24.480
-and local farmers and building something
-
-00:09:24.480 --> 00:09:25.519
-that they can all
-
-00:09:25.519 --> 00:09:27.200
-use that's more than the sum of the
-
-00:09:27.200 --> 00:09:29.200
-parts so a little
-
-00:09:29.200 --> 00:09:30.720
-future work for everybody else here so
-
-00:09:30.720 --> 00:09:32.160
-we think science should be widely
-
-00:09:32.160 --> 00:09:33.120
-teachable
-
-00:09:33.120 --> 00:09:34.560
-shareable semi-automated
-
-00:09:34.560 --> 00:09:36.720
-transdisciplinary and real time
-
-00:09:36.720 --> 00:09:40.399
-like EmacsConf so you can get in touch
-
-00:09:40.399 --> 00:09:43.279
-uh via these methods and the code which
-
-00:09:43.279 --> 00:09:44.560
-is very much early stage work in
-
-00:09:44.560 --> 00:09:45.200
-progress
-
-00:09:45.200 --> 00:09:46.640
-as this was meant to be an experience
-
-00:09:46.640 --> 00:09:48.800
-report not a it's all done here it is
-
-00:09:48.800 --> 00:09:49.920
-polished report
-
-00:09:49.920 --> 00:09:51.680
-um it's also online if you'd like to
-
-00:09:51.680 --> 00:09:53.360
-have a look so that's the end of the
-
-00:09:53.360 --> 00:09:54.560
-talk and I don't know if there's time
-
-00:09:54.560 --> 00:09:55.279
-for questions
-
-00:09:55.279 --> 00:09:57.440
-or not but um I'm at your disposal now
-
-00:09:57.440 --> 00:10:00.240
-thank you you are now unmuted
-
-00:10:00.240 --> 00:10:04.079
-um many thanks for the tough job
-
-00:10:04.079 --> 00:10:07.120
-uh let's see we have about I think four
-
-00:10:07.120 --> 00:10:08.880
-minutes four questions
-
-00:10:08.880 --> 00:10:10.880
-um and we have a couple of questions on
-
-00:10:10.880 --> 00:10:12.320
-the pad would you like to read them
-
-00:10:12.320 --> 00:10:14.240
-yourself or should I read them to you
-
-00:10:14.240 --> 00:10:16.560
-uh just for sake of easy management why
-
-00:10:16.560 --> 00:10:18.079
-don't you read them out if that's okay
-
-00:10:18.079 --> 00:10:21.279
-yeah sure uh so they ask have you looked
-
-00:10:21.279 --> 00:10:22.240
-into trying
-
-00:10:22.240 --> 00:10:25.440
-sage math I've long uh long wanted
-
-00:10:25.440 --> 00:10:33.760
-nothing org files
-
-00:10:33.760 --> 00:10:36.959
-right and I and I wrote the answer that
-
-00:10:36.959 --> 00:10:39.279
-we should be possible because one can
-
-00:10:39.279 --> 00:10:44.839
-call it from a command
-
-00:10:44.839 --> 00:10:46.399
-okay
-
-00:10:46.399 --> 00:10:48.640
-and I see there's another sagemath
-
-00:10:48.640 --> 00:10:50.079
-question that you seem to have answered
-
-00:10:50.079 --> 00:10:52.100
-as well so I guess I won't repeat that
-
-00:10:52.100 --> 00:10:54.880
-[Music]
-
-00:10:54.880 --> 00:10:56.959
-there's let's not forget about embedded
-
-00:10:56.959 --> 00:11:00.640
-calc in emacs
-
-00:11:00.640 --> 00:11:03.680
-so so the first demos actually were with
-
-00:11:03.680 --> 00:11:05.040
-calc so that's that's
-
-00:11:05.040 --> 00:11:06.640
-useful uh although I think it was a
-
-00:11:06.640 --> 00:11:07.839
-different kind of a different command
-
-00:11:07.839 --> 00:11:08.240
-line
-
-00:11:08.240 --> 00:11:11.839
-well that was the next calc yeah
-
-00:11:11.839 --> 00:11:13.839
-so sure there is there is calc so that
-
-00:11:13.839 --> 00:11:15.680
-would be calculus and
-
-00:11:15.680 --> 00:11:19.120
-calc is already in org mode yeah
-
-00:11:19.120 --> 00:11:25.680
-yeah yeah
-
-00:11:25.680 --> 00:11:39.760
-um still looking for questions
-
-00:11:39.760 --> 00:11:41.760
-okay I think that's about it I don't see
-
-00:11:41.760 --> 00:11:44.320
-any questions on the ether pad
-
-00:11:44.320 --> 00:11:47.440
-and let's see
-
-00:11:47.440 --> 00:11:53.040
-anything on irc
-
-00:11:53.040 --> 00:11:55.760
-um nothing but phrases and everyone
-
-00:11:55.760 --> 00:11:56.720
-thanking you
-
-00:11:56.720 --> 00:11:59.120
-thank you all right you're welcome
-
-00:11:59.120 --> 00:12:00.240
-thanks a lot uh
-
-00:12:00.240 --> 00:12:02.880
-we'll see you guys around then cheers
-
-00:12:02.880 --> 00:12:06.800
-and see you around
diff --git a/2020/subtitles/emacsconf-2020--13-experience-report-steps-to-emacs-hyper-notebooks--joseph-corneli-raymond-puzio-cameron-ray-smith.vtt b/2020/subtitles/emacsconf-2020--13-experience-report-steps-to-emacs-hyper-notebooks--joseph-corneli-raymond-puzio-cameron-ray-smith.vtt
new file mode 100644
index 00000000..15513080
--- /dev/null
+++ b/2020/subtitles/emacsconf-2020--13-experience-report-steps-to-emacs-hyper-notebooks--joseph-corneli-raymond-puzio-cameron-ray-smith.vtt
@@ -0,0 +1,968 @@
+WEBVTT
+
+00:00:00.320 --> 00:00:03.280
+Joe: Hi, I'm Joe Corneli.
+
+00:00:03.280 --> 00:00:06.879
+This is work I did with Ray Puzio and
+Cameron Smith.
+
+00:00:06.879 --> 00:00:11.123
+They're the main protagonists in
+this story.
+
+00:00:11.123 --> 00:00:14.960
+They are researchers who've been working
+
+00:00:14.960 --> 00:00:17.490
+on theoretical biology.
+
+00:00:17.490 --> 00:00:21.357
+In a typical project, they may use
+Maxima and Julia.
+
+00:00:21.357 --> 00:00:24.800
+Their work combines biology, physics and
+computer science.
+
+00:00:24.800 --> 00:00:29.439
+The latest work-in-progress is on
+branching processes for
+
+00:00:29.439 --> 00:00:30.800
+cancer modeling.
+
+00:00:30.800 --> 00:00:34.719
+How can Emacs possibly help?
+
+00:00:34.719 --> 00:00:37.360
+Let's have a look. Moving code
+
+00:00:37.360 --> 00:00:38.399
+and data between these different
+
+00:00:38.399 --> 00:00:39.680
+programs by hand is
+
+00:00:39.680 --> 00:00:42.000
+annoying. Separate workflows for
+
+00:00:42.000 --> 00:00:44.399
+writing up notes and preparing
+publications
+
+00:00:44.399 --> 00:00:46.000
+is perhaps even more annoying. All of
+
+00:00:46.000 --> 00:00:48.640
+it is time consuming and error-prone.
+
+00:00:48.640 --> 00:00:52.000
+So what about maybe using Jupyter?
+
+00:00:52.000 --> 00:00:53.760
+We found something called Script of
+
+00:00:53.760 --> 00:00:55.199
+Scripts. It solves some of those
+
+00:00:55.199 --> 00:00:58.399
+problems because you can use
+
+00:00:58.399 --> 00:01:01.120
+Maxima and Julia together, but we were
+
+00:01:01.120 --> 00:01:02.640
+quite happy to explore Emacs-based
+
+00:01:02.640 --> 00:01:04.890
+solutions, being Emcas enthusiasts
+
+00:01:04.890 --> 00:01:07.760
+We even got Cameron to be
+enthusiastic about
+
+00:01:07.760 --> 00:01:10.057
+doing Emacs, so that went nice.
+
+00:01:10.057 --> 00:01:12.400
+Here's a little feature grid
+
+00:01:12.400 --> 00:01:15.360
+of Emacs + Org versus your
+
+00:01:15.360 --> 00:01:18.390
+generic tools that are in a
+
+00:01:18.390 --> 00:01:20.123
+different, more general ecosystem.
+
+00:01:20.123 --> 00:01:21.520
+As you can see, it's quite
+
+00:01:21.520 --> 00:01:22.957
+feature-complete. You've got your
+
+00:01:22.957 --> 00:01:25.520
+maxima-mode, julia-mode. You can use both of them
+
+00:01:25.520 --> 00:01:27.119
+inside of org-mode.
+
+00:01:27.119 --> 00:01:28.720
+You can present things with org-tree-slide.
+
+00:01:28.720 --> 00:01:31.490
+You can set up a wiki inside of org-roam.
+
+00:01:31.490 --> 00:01:33.680
+This is one I found
+
+00:01:33.680 --> 00:01:35.759
+rather recently. You can even use
+
+00:01:35.759 --> 00:01:37.759
+compatibly with org-roam, something called
+
+00:01:37.759 --> 00:01:42.159
+logseq, which is in the browser, so that's
+nice.
+
+00:01:42.159 --> 00:01:44.957
+You can do real-time collaborative
+editing,
+
+00:01:44.957 --> 00:01:47.657
+either in a kind of pairing style
+
+00:01:47.657 --> 00:01:49.280
+or in a more Etherpad style.
+
+00:01:49.280 --> 00:01:51.520
+Obviously, you can manage your references.
+
+00:01:51.520 --> 00:01:53.457
+You can typeset whatever you want.
+
+00:01:53.457 --> 00:01:55.759
+You can publish work in progress on
+a blog.
+
+00:01:55.759 --> 00:01:57.439
+Firn is another one of these
+
+00:01:57.439 --> 00:01:59.790
+external Org Mode tools.
+
+00:01:59.790 --> 00:02:00.560
+It's not actually in Emacs,
+
+00:02:00.560 --> 00:02:03.557
+but works with Org Mode stuff. And, you know...
+
+00:02:03.557 --> 00:02:05.657
+So we're good to go with all of that.
+
+00:02:05.657 --> 00:02:07.423
+So what does that look like? Well,
+
+00:02:07.423 --> 00:02:09.423
+here's a little example from before
+
+00:02:09.423 --> 00:02:12.800
+they were doing... before we started
+really thinking
+
+00:02:12.800 --> 00:02:13.890
+seriously about this stuff.
+
+00:02:13.890 --> 00:02:15.599
+So this is just Maxima.
+
+00:02:15.599 --> 00:02:17.440
+Well, Maxima doesn't have a long running
+
+00:02:17.440 --> 00:02:19.280
+process by default. If you've ever used
+
+00:02:19.280 --> 00:02:22.480
+Python, you have something called
+sessions.
+
+00:02:22.480 --> 00:02:23.920
+They don't have that for Maxima, at least
+
+00:02:23.920 --> 00:02:24.959
+not by default.
+
+00:02:24.959 --> 00:02:27.599
+So how... What was the workaround?
+
+00:02:27.599 --> 00:02:29.360
+There's this thing called
+
+00:02:29.360 --> 00:02:32.480
+solve-for-u here
+
+00:02:32.480 --> 00:02:34.879
+that shows up down below again in these
+
+00:02:34.879 --> 00:02:36.319
+angle brackets, which you've seen maybe
+
+00:02:36.319 --> 00:02:37.360
+in someone else's talk,
+
+00:02:37.360 --> 00:02:40.480
+which means go to the previous
+
+00:02:40.480 --> 00:02:41.920
+thing that was named solve-for-u
+
+00:02:41.920 --> 00:02:43.920
+and do that all over again, so they do
+
+00:02:43.920 --> 00:02:45.280
+that over again.
+
+00:02:45.280 --> 00:02:47.440
+Here's the little Maxima code for
+
+00:02:47.440 --> 00:02:48.990
+defining usol, so you've now
+
+00:02:48.990 --> 00:02:51.723
+defined usol, and then you can use it
+
+00:02:51.723 --> 00:02:54.000
+in the next expression. You get out a
+nice juicy
+
+00:02:54.000 --> 00:02:56.560
+zero at the end. It's a little bit
+
+00:02:57.200 --> 00:02:58.959
+like a partridge in a pear tree to have to
+
+00:02:58.959 --> 00:03:00.640
+redefine everything every time.
+
+00:03:00.640 --> 00:03:02.490
+So this is clearly at the level of
+
+00:03:02.490 --> 00:03:04.159
+work-around. Maybe just
+
+00:03:04.159 --> 00:03:06.223
+one more time looking through
+
+00:03:06.223 --> 00:03:11.599
+that stuff.
+
+00:03:11.599 --> 00:03:13.760
+Sorry. So, looking through that stuff,
+
+00:03:13.760 --> 00:03:15.280
+this is... We're going to need something
+
+00:03:15.280 --> 00:03:17.200
+like that, probably, for stitching
+
+00:03:17.200 --> 00:03:19.599
+Maxima and Julia together. so it's
+
+00:03:19.599 --> 00:03:20.890
+good to look a little bit
+
+00:03:20.890 --> 00:03:22.590
+about how that might work.
+
+00:03:22.590 --> 00:03:23.920
+First of all, you can cache
+
+00:03:23.920 --> 00:03:25.680
+results, so if you wanted to save the
+
+00:03:25.680 --> 00:03:28.480
+date out of block one at a certain
+time and
+
+00:03:28.480 --> 00:03:30.990
+then use it again later...
+
+00:03:30.990 --> 00:03:33.280
+At the time when I ran this code,
+
+00:03:33.280 --> 00:03:34.640
+you can see I've got two slightly
+
+00:03:34.640 --> 00:03:36.623
+different time stamps down below.
+
+00:03:36.623 --> 00:03:38.323
+One's the cached result, and the other
+
+00:03:38.323 --> 00:03:40.319
+was the result of reevaluating
+
+00:03:40.319 --> 00:03:42.640
+the block. So you can move things around.
+
+00:03:43.760 --> 00:03:46.000
+That's going to be useful. But you know,
+
+00:03:46.000 --> 00:03:46.923
+that's not really the main problem.
+
+00:03:46.923 --> 00:03:48.080
+The main problem is
+
+00:03:48.080 --> 00:03:50.799
+making Maxima long-running.
+
+00:03:50.799 --> 00:03:53.920
+The core of this talk is a new observant
+
+00:03:53.920 --> 00:03:56.400
+facility, which is a general purpose
+
+00:03:56.400 --> 00:03:59.280
+way to do that kind of thing, which
+
+00:03:59.280 --> 00:04:01.823
+involves a very simple change to ob-core.
+
+00:04:01.823 --> 00:04:04.239
+We'll give a quick
+
+00:04:04.239 --> 00:04:05.360
+overview of that and show
+
+00:04:05.360 --> 00:04:08.480
+an example. So here's the example,
+
+00:04:08.480 --> 00:04:11.760
+a very simple sort of silly example.
+
+00:04:11.760 --> 00:04:12.957
+What does it mean to have
+
+00:04:12.957 --> 00:04:13.990
+a long-running process?
+
+00:04:13.990 --> 00:04:14.640
+Here, I've set this
+
+00:04:14.640 --> 00:04:18.560
+display2d to be false, which just
+means that
+
+00:04:18.560 --> 00:04:19.440
+things are going to come
+
+00:04:19.440 --> 00:04:22.320
+come across in 1d. Then I ask it to
+
+00:04:22.320 --> 00:04:25.199
+expand something. I get LaTeX
+by default.
+
+00:04:25.199 --> 00:04:27.280
+So that's what it means. It's that I've sent
+
+00:04:27.280 --> 00:04:28.639
+something in and it's going to come
+
+00:04:28.639 --> 00:04:30.240
+across in one view, which is great.
+
+00:04:30.240 --> 00:04:32.080
+Maybe you'll also notice that there's
+
+00:04:32.080 --> 00:04:34.560
+no semicolon, if you're a Maxima fan,
+
+00:04:34.560 --> 00:04:36.720
+and things are coming across as TeX.
+
+00:04:36.720 --> 00:04:38.400
+So those were some little bonus features.
+
+00:04:38.400 --> 00:04:40.320
+I'll show you how that works later.
+
+00:04:41.040 --> 00:04:45.440
+The change to ob-core is as follows.
+
+00:04:45.440 --> 00:04:48.880
+Actually, this should say...
+
+00:04:48.880 --> 00:04:51.520
+Instead of stream here, it should say
+
+00:04:51.520 --> 00:04:54.800
+servant. Sorry. We tried an experimental
+
+00:04:54.800 --> 00:04:56.160
+version which was called stream, so now it's
+
+00:04:56.160 --> 00:04:58.160
+called servant. But all it does is it
+
+00:04:58.160 --> 00:05:01.520
+overrides org-babel-execute lang for
+
+00:05:01.520 --> 00:05:02.639
+arbitrary lang
+
+00:05:02.639 --> 00:05:05.919
+if you have a servant
+
+00:05:05.919 --> 00:05:07.840
+in your params. So that's the
+
+00:05:07.840 --> 00:05:09.759
+change that hasn't been
+
+00:05:09.759 --> 00:05:11.919
+pushed out or sent as a patch to anybody,
+
+00:05:11.919 --> 00:05:13.759
+but it's a pretty minor change.
+
+00:05:13.759 --> 00:05:16.960
+Here's an overview without the code.
+
+00:05:16.960 --> 00:05:19.080
+Just a high level overview of
+
+00:05:19.080 --> 00:05:20.720
+observant.el.
+
+00:05:20.720 --> 00:05:22.160
+It stores information about these
+
+00:05:22.160 --> 00:05:24.479
+processes in a hash table.
+
+00:05:24.479 --> 00:05:26.080
+It can do pre-processing and
+
+00:05:26.080 --> 00:05:27.600
+post-processing.
+
+00:05:27.600 --> 00:05:29.759
+It does all these things. It stores
+
+00:05:29.759 --> 00:05:30.720
+the output.
+
+00:05:30.720 --> 00:05:32.479
+I mentioned here that, in principle, we
+
+00:05:32.479 --> 00:05:34.080
+could store lots of output and have a
+
+00:05:34.080 --> 00:05:35.657
+kind of browsable history,
+
+00:05:35.657 --> 00:05:37.790
+although we don't do that
+presently.
+
+00:05:37.790 --> 00:05:38.790
+But that's what observant does.
+
+00:05:38.790 --> 00:05:40.639
+It does what you might expect.
+
+00:05:41.440 --> 00:05:46.190
+Here's the Maxima on-ramp
+
+00:05:46.190 --> 00:05:48.160
+to get Maxima brought in.
+
+00:05:48.160 --> 00:05:49.257
+You have to obviously have
+
+00:05:49.257 --> 00:05:51.360
+a Maxima process you can call.
+
+00:05:51.360 --> 00:05:54.960
+puthash... this is the preprocessing
+
+00:05:54.960 --> 00:05:57.840
+thing I mentioned, adding in some Tex
+
+00:05:57.840 --> 00:05:58.960
+and adding in--
+
+00:05:58.960 --> 00:06:01.520
+or deleting, rather--a substring.
+
+00:06:01.520 --> 00:06:03.759
+Here is why you delete the
+substring.
+
+00:06:03.759 --> 00:06:06.960
+It's because Maxima thinks it's a good
+
+00:06:06.960 --> 00:06:08.240
+idea to tell you false
+
+00:06:08.240 --> 00:06:10.080
+once you run check on things.
+
+00:06:10.080 --> 00:06:11.759
+You've got to delete that back out to
+
+00:06:11.759 --> 00:06:13.680
+get something coherent out of it.
+
+00:06:13.680 --> 00:06:16.960
+So this is how to set up Maxima.
+
+00:06:16.960 --> 00:06:19.157
+That's enough, really, of the demo.
+
+00:06:19.157 --> 00:06:20.000
+It's not really a demo for
+
+00:06:20.000 --> 00:06:21.919
+show and tell, but as this is an
+
+00:06:21.919 --> 00:06:23.600
+experience report, I wanted to talk about
+
+00:06:23.600 --> 00:06:25.440
+the experience of doing this.
+
+00:06:25.440 --> 00:06:28.080
+Some negatives, like we tried to
+
+00:06:28.080 --> 00:06:30.160
+get Emacs Jupyter working
+
+00:06:30.160 --> 00:06:34.190
+prior to working on observant.
+
+00:06:34.190 --> 00:06:36.000
+We couldn't get it doing
+
+00:06:36.000 --> 00:06:37.919
+everything we wanted, despite a bit of
+
+00:06:37.919 --> 00:06:40.160
+heavy lifting and debugging and stuff.
+
+00:06:40.160 --> 00:06:42.880
+So that's not finished. That was a bit
+difficult.
+
+00:06:42.880 --> 00:06:45.360
+On the other hand, working on
+
+00:06:45.360 --> 00:06:47.759
+observant was fun, pretty lightweight,
+
+00:06:47.759 --> 00:06:48.479
+and easy.
+
+00:06:48.479 --> 00:06:50.400
+We got some experience co-editing
+
+00:06:50.400 --> 00:06:52.400
+things with these real-time tools.
+
+00:06:52.400 --> 00:06:55.919
+Obviously, the stack is somewhat work in
+progress.
+
+00:06:55.919 --> 00:06:58.000
+I just wanted to give a shout out to
+
+00:06:58.000 --> 00:07:00.800
+crdt which was really fun,
+
+00:07:00.800 --> 00:07:03.919
+and Qiantan was making
+
+00:07:03.919 --> 00:07:06.057
+bug fixes for that as we go.
+
+00:07:06.057 --> 00:07:08.960
+Similarly, for firn and logseq,
+the maintainers
+
+00:07:08.960 --> 00:07:10.160
+were really responsive,
+
+00:07:10.160 --> 00:07:12.960
+so that was nice. We did try to
+
+00:07:12.960 --> 00:07:14.560
+get Emacs running in the browser,
+
+00:07:14.560 --> 00:07:15.840
+thinking it would be really nice for
+
+00:07:15.840 --> 00:07:19.290
+people who didn't want to install it
+
+00:07:19.290 --> 00:07:21.120
+to get a chance to just try it,
+
+00:07:21.120 --> 00:07:23.120
+but actually, browsers capture things
+
+00:07:23.120 --> 00:07:27.120
+like C-n, so that was a bit annoying.
+
+00:07:27.120 --> 00:07:28.479
+But we did get lots of great feedback
+
+00:07:28.479 --> 00:07:29.759
+and interaction with people, including
+
+00:07:29.759 --> 00:07:31.599
+around this conference. Thank you
+
+00:07:31.599 --> 00:07:33.759
+to those who we've had discussions with.
+
+00:07:35.599 --> 00:07:37.680
+So, future work. Okay, so... Maybe you
+
+00:07:37.680 --> 00:07:41.039
+remember, I gave a talk a few years back
+on Arxana.
+
+00:07:41.039 --> 00:07:44.479
+What might this have to do with Org
+Mode?
+
+00:07:44.479 --> 00:07:45.919
+That's always the question one asks
+
+00:07:45.919 --> 00:07:47.039
+about Arxana.
+
+00:07:47.039 --> 00:07:48.720
+Arxana... One of the things it does
+
+00:07:48.720 --> 00:07:50.319
+is transclusions, and so that could be
+
+00:07:50.319 --> 00:07:51.680
+actually very helpful
+
+00:07:51.680 --> 00:07:54.000
+in connection with this "combined notes
+
+00:07:54.000 --> 00:07:55.520
+and write-up" workflow. So you might have
+
+00:07:55.520 --> 00:07:58.400
+an Org Mode. Some of these
+
+00:07:58.400 --> 00:08:00.800
+results we got back as raw results
+
+00:08:00.800 --> 00:08:03.199
+could go right into your write-up in a
+
+00:08:03.919 --> 00:08:07.520
+convenient way, at a level above--
+
+00:08:07.520 --> 00:08:09.039
+transparently, a level above the notebook.
+
+00:08:09.039 --> 00:08:11.280
+So you'd have the notebook alongside the
+
+00:08:11.280 --> 00:08:13.440
+write-up in that case,
+
+00:08:13.440 --> 00:08:15.599
+which is a variation on the
+
+00:08:15.599 --> 00:08:17.423
+literate programming workflow.
+
+00:08:17.423 --> 00:08:19.120
+This is speculative. Who knows?
+
+00:08:19.120 --> 00:08:20.000
+The other thought is,
+
+00:08:20.000 --> 00:08:22.080
+it just relates to the idea of network
+
+00:08:22.080 --> 00:08:23.520
+programming. So we can imagine these
+
+00:08:23.520 --> 00:08:25.990
+networks of computational nodes
+
+00:08:25.990 --> 00:08:27.623
+sitting inside of org-roam,
+
+00:08:27.623 --> 00:08:28.800
+calling each other.
+
+00:08:28.800 --> 00:08:31.199
+You would want to maintain some
+
+00:08:31.199 --> 00:08:33.357
+kind of model of that process.
+
+00:08:33.357 --> 00:08:36.640
+A general question is: how do we have a
+remote control for
+
+00:08:36.640 --> 00:08:37.957
+long-running processes?
+
+00:08:37.957 --> 00:08:38.320
+You could do that
+
+00:08:38.320 --> 00:08:39.857
+in Lisp or Clojure,
+
+00:08:39.857 --> 00:08:41.657
+but maybe we could have something
+
+00:08:41.657 --> 00:08:44.080
+a little bit like that here.
+
+00:08:44.080 --> 00:08:45.839
+Conclusions: what have we actually
+
+00:08:45.839 --> 00:08:48.080
+addressed? Well, we addressed
+
+00:08:48.080 --> 00:08:50.080
+accessing any long-running process with
+
+00:08:50.080 --> 00:08:51.600
+a simple Org Mode interface.
+
+00:08:51.600 --> 00:08:52.959
+Obviously, we're not the only people to
+
+00:08:52.959 --> 00:08:54.880
+think about notebooks, but we think that
+
+00:08:54.880 --> 00:08:56.880
+Emacs has some advantages
+
+00:08:56.880 --> 00:08:58.880
+related to reproducible research and
+
+00:08:58.880 --> 00:09:00.757
+interdisciplinary collaboration.
+
+00:09:00.757 --> 00:09:02.590
+Let's just say that we think
+
+00:09:02.590 --> 00:09:04.880
+something is reproducible if it's
+actually teachable
+
+00:09:04.880 --> 00:09:07.200
+to someone new and they can do it.
+
+00:09:07.200 --> 00:09:09.190
+Org Mode seems very useful for that.
+
+00:09:09.190 --> 00:09:11.680
+Many of the other talks have touched
+on this.
+
+00:09:11.680 --> 00:09:14.399
+Interdisciplinary collaboration is great.
+
+00:09:14.399 --> 00:09:16.000
+This was an interdisciplinary
+
+00:09:16.000 --> 00:09:17.839
+collaboration on some level, but
+
+00:09:17.839 --> 00:09:19.680
+what about future work for
+
+00:09:19.680 --> 00:09:21.190
+bringing in scenario planners,
+
+00:09:21.190 --> 00:09:22.320
+simulation scientists,
+
+00:09:22.320 --> 00:09:24.480
+and local farmers, and building something
+
+00:09:24.480 --> 00:09:26.023
+that they can all use
+
+00:09:26.023 --> 00:09:27.857
+that's more than the sum of the
+parts?
+
+00:09:27.857 --> 00:09:30.720
+So a little future work for everybody
+else here.
+
+00:09:30.720 --> 00:09:32.160
+We think science should be widely
+
+00:09:32.160 --> 00:09:34.560
+teachable, shareable, semi-automated,
+
+00:09:34.560 --> 00:09:36.720
+transdisciplinary, and real-time
+
+00:09:36.720 --> 00:09:40.399
+like EmacsConf. So you can get in touch
+
+00:09:40.399 --> 00:09:43.279
+via these methods. The code--which
+
+00:09:43.279 --> 00:09:45.200
+is very much early stage work in
+progress,
+
+00:09:45.200 --> 00:09:46.640
+as this was meant to be an experience
+
+00:09:46.640 --> 00:09:48.800
+report, not a "it's all done, here, it is
+
+00:09:48.800 --> 00:09:49.920
+polished" report--
+
+00:09:49.920 --> 00:09:51.680
+it's also online if you'd like to
+
+00:09:51.680 --> 00:09:53.360
+have a look. That's the end of the
+
+00:09:53.360 --> 00:09:54.560
+talk. I don't know if there's time
+
+00:09:54.560 --> 00:09:57.440
+for questions or not, but um I'm at your
+disposal now.
+
+00:09:57.440 --> 00:10:00.240
+Thank you.
+
+00:10:00.240 --> 00:10:04.079
+(Amin: Many thanks for the tough job.
+
+00:10:04.079 --> 00:10:07.120
+Let's see. We have about I think four
+
+00:10:07.120 --> 00:10:08.880
+minutes for questions,
+
+00:10:08.880 --> 00:10:10.880
+and we have a couple of questions on
+
+00:10:10.880 --> 00:10:12.320
+the pad. Would you like to read them
+
+00:10:12.320 --> 00:10:14.240
+yourself or should I read them to you?)
+
+00:10:14.240 --> 00:10:16.423
+Just for the sake of easy management
+
+00:10:16.423 --> 00:10:18.079
+why don't you read them out, if
+that's okay?
+
+00:10:18.079 --> 00:10:21.279
+(Amin: yeah, sure. They ask, "Have you looked
+
+00:10:21.279 --> 00:10:25.440
+into trying Sage Math? I've long wanted
+
+00:10:25.440 --> 00:10:33.760
+to use Sage Math in Org files.")
+
+00:10:33.760 --> 00:10:36.959
+Ray: Right. I wrote the answer that
+
+00:10:36.959 --> 00:10:39.279
+it should be possible because one can
+
+00:10:39.279 --> 00:10:44.839
+call it from a command.
+
+00:10:44.839 --> 00:10:48.190
+(Amin: okay, and I see there's
+
+00:10:48.190 --> 00:10:50.079
+another Sage Math question that you seem
+to have answered
+
+00:10:50.079 --> 00:10:52.100
+as well, so I guess I won't repeat that.
+
+00:10:54.880 --> 00:10:56.959
+There's... "Let's not forget about embedded
+
+00:10:56.959 --> 00:11:00.640
+Calc in Emacs.")
+
+00:11:00.640 --> 00:11:05.040
+Joe: So the first demos actually were with
+Calc.
+
+00:11:05.040 --> 00:11:06.640
+That's useful. Although I think it was a
+
+00:11:06.640 --> 00:11:08.240
+different--kind of a different command
+line.
+
+00:11:08.240 --> 00:11:11.839
+Ray: Well, that was UNIX Calc.
+
+00:11:11.839 --> 00:11:13.839
+Joe: So, sure, there is calc, so that...
+
+00:11:15.680 --> 00:11:19.120
+Ray: Calc is already in Org Mode.
+
+00:11:25.680 --> 00:11:39.760
+(Amin: Still looking for questions.
+
+00:11:39.760 --> 00:11:41.760
+Okay, I think that's about it. I don't see
+
+00:11:41.760 --> 00:11:44.320
+any questions on the Etherpad.
+
+00:11:44.320 --> 00:11:47.440
+And let's see...
+
+00:11:47.440 --> 00:11:53.040
+Anything on irc?
+
+00:11:53.040 --> 00:11:55.760
+Nothing but praises and everyone
+
+00:11:55.760 --> 00:11:57.290
+thanking you. Thank you.)
+
+00:11:57.290 --> 00:11:59.120
+Ray: all right, you're welcome.
+
+00:11:59.120 --> 00:12:00.240
+Joe: Thanks a lot!
+
+00:12:00.240 --> 00:12:01.923
+We'll see you guys around then.
+
+00:12:01.923 --> 00:12:06.800
+Amin: Cheers, and see you around!
diff --git a/2020/subtitles/emacsconf-2020--14-readme-driven-design--adam-ard-autogen.vtt b/2020/subtitles/emacsconf-2020--14-readme-driven-design--adam-ard-autogen.vtt
deleted file mode 100644
index 3179635f..00000000
--- a/2020/subtitles/emacsconf-2020--14-readme-driven-design--adam-ard-autogen.vtt
+++ /dev/null
@@ -1,1426 +0,0 @@
-WEBVTT
-
-00:00:03.600 --> 00:00:04.400
-hello
-
-00:00:04.400 --> 00:00:06.560
-welcome to readme driven design in Emacs
-
-00:00:06.560 --> 00:00:08.400
-by adam aard
-
-00:00:08.400 --> 00:00:10.800
-if you're a programmer you're accustomed
-
-00:00:10.800 --> 00:00:12.559
-to putting a readme file at the root of
-
-00:00:12.559 --> 00:00:13.759
-your project
-
-00:00:13.759 --> 00:00:16.400
-and it's usually a markdown file but if
-
-00:00:16.400 --> 00:00:17.600
-you use an org
-
-00:00:17.600 --> 00:00:20.720
-more an org mode file instead you can
-
-00:00:20.720 --> 00:00:22.560
-take advantage of the great features
-
-00:00:22.560 --> 00:00:24.400
-that org mode provides including
-
-00:00:24.400 --> 00:00:25.920
-literate programming
-
-00:00:25.920 --> 00:00:28.000
-which lets you generate your source code
-
-00:00:28.000 --> 00:00:31.840
-and markdown documentation dynamically
-
-00:00:31.840 --> 00:00:34.719
-I want to walk you through a little bit
-
-00:00:34.719 --> 00:00:37.120
-of what this looks like
-
-00:00:37.120 --> 00:00:39.440
-when you start a project especially if
-
-00:00:39.440 --> 00:00:41.280
-if you use something like github you
-
-00:00:41.280 --> 00:00:43.320
-begin with an automatically generated
-
-00:00:43.320 --> 00:00:47.039
-readme.md file so just delete that
-
-00:00:47.039 --> 00:00:50.239
-and instead create a readme.org file
-
-00:00:50.239 --> 00:00:51.920
-starting with an empty org file like you
-
-00:00:51.920 --> 00:00:54.800
-see here you can begin
-
-00:00:54.800 --> 00:00:56.559
-by recording important information about
-
-00:00:56.559 --> 00:00:59.440
-your project goals you can add diagrams
-
-00:00:59.440 --> 00:01:01.920
-code snippets to-do lists time tracking
-
-00:01:01.920 --> 00:01:03.520
-and much more
-
-00:01:03.520 --> 00:01:05.360
-I'm going to drop in some documentation
-
-00:01:05.360 --> 00:01:07.760
-that I r that I've written about
-
-00:01:07.760 --> 00:01:10.840
-about my project here so you can kind of
-
-00:01:10.840 --> 00:01:12.240
-see
-
-00:01:12.240 --> 00:01:15.280
-what this would look like
-
-00:01:15.280 --> 00:01:17.119
-so as you can see I have a title and a
-
-00:01:17.119 --> 00:01:20.320
-description and then a sub section
-
-00:01:20.320 --> 00:01:23.840
-as well as some code snippets
-
-00:01:23.840 --> 00:01:25.520
-and you can see that orgmo does a great
-
-00:01:25.520 --> 00:01:28.240
-job of formatting lists and
-
-00:01:28.240 --> 00:01:31.280
-code sections diagrams and so forth
-
-00:01:31.280 --> 00:01:33.920
-it's good or it's as good or better than
-
-00:01:33.920 --> 00:01:35.040
-markdown
-
-00:01:35.040 --> 00:01:37.520
-but when you use it in the Emacs you can
-
-00:01:37.520 --> 00:01:38.880
-do a lot more
-
-00:01:38.880 --> 00:01:40.479
-for example you can dynamically create
-
-00:01:40.479 --> 00:01:43.360
-diagrams using graphviz
-
-00:01:43.360 --> 00:01:45.200
-from a text description so if you go to
-
-00:01:45.200 --> 00:01:46.560
-this source block here
-
-00:01:46.560 --> 00:01:49.439
-and hit control c control c you'll see
-
-00:01:49.439 --> 00:01:51.439
-that we generate a
-
-00:01:51.439 --> 00:01:55.439
-diagram dynamically you can run
-
-00:01:55.439 --> 00:01:59.200
-so you can run these code snippets in
-
-00:01:59.200 --> 00:02:00.799
-place and get the results
-
-00:02:00.799 --> 00:02:03.040
-to show up inside of your your file
-
-00:02:03.040 --> 00:02:08.000
-which is a really powerful paradigm
-
-00:02:08.000 --> 00:02:10.640
-but most important most importantly for
-
-00:02:10.640 --> 00:02:11.520
-the
-
-00:02:11.520 --> 00:02:14.800
-purposes my purpose is here
-
-00:02:14.800 --> 00:02:17.200
-orgmo provides you the ability to do
-
-00:02:17.200 --> 00:02:19.520
-literate programming
-
-00:02:19.520 --> 00:02:21.440
-so take a quick look at this diagram
-
-00:02:21.440 --> 00:02:23.200
-that I generated here
-
-00:02:23.200 --> 00:02:25.360
-and gives you a quick overview of what I
-
-00:02:25.360 --> 00:02:27.520
-mean by literate programming
-
-00:02:27.520 --> 00:02:31.200
-and how I'm using it you can see
-
-00:02:31.200 --> 00:02:33.920
-that we start with a readme.org file on
-
-00:02:33.920 --> 00:02:34.720
-top
-
-00:02:34.720 --> 00:02:36.879
-at this point we can do one of two
-
-00:02:36.879 --> 00:02:37.920
-things
-
-00:02:37.920 --> 00:02:41.280
-tangle or weave tangle is used to
-
-00:02:41.280 --> 00:02:42.720
-describe the process of
-
-00:02:42.720 --> 00:02:46.319
-generating source code while weave
-
-00:02:46.319 --> 00:02:47.599
-is the process of generating
-
-00:02:47.599 --> 00:02:49.840
-documentation these are terms that
-
-00:02:49.840 --> 00:02:51.920
-donald knuth used
-
-00:02:51.920 --> 00:02:53.840
-and he's the one that came up with the
-
-00:02:53.840 --> 00:02:55.519
-idea of literate programming
-
-00:02:55.519 --> 00:02:59.920
-in the early 1980s
-
-00:02:59.920 --> 00:03:01.519
-but this is really all that there is to
-
-00:03:01.519 --> 00:03:04.480
-it you just
-
-00:03:04.480 --> 00:03:06.400
-who are simply using literate illiterate
-
-00:03:06.400 --> 00:03:07.840
-source file
-
-00:03:07.840 --> 00:03:10.319
-in this case the readme.org to generate
-
-00:03:10.319 --> 00:03:11.680
-the rest of the project
-
-00:03:11.680 --> 00:03:17.120
-the rest of the project files basically
-
-00:03:17.120 --> 00:03:20.959
-so let's dig in to the details of how
-
-00:03:20.959 --> 00:03:22.640
-this works
-
-00:03:22.640 --> 00:03:24.560
-and I hope you hopefully you'll see how
-
-00:03:24.560 --> 00:03:26.159
-cool this is
-
-00:03:26.159 --> 00:03:28.959
-so returning to the file here let's
-
-00:03:28.959 --> 00:03:31.120
-assume we have enough documentation now
-
-00:03:31.120 --> 00:03:32.080
-that we want to get started
-
-00:03:32.080 --> 00:03:34.159
-coding so maybe we'll just start with
-
-00:03:34.159 --> 00:03:35.519
-like a hello world
-
-00:03:35.519 --> 00:03:38.159
-app just so we can make sure that our
-
-00:03:38.159 --> 00:03:41.519
-environment is set up correctly
-
-00:03:41.519 --> 00:03:47.120
-so let's get started with a code block
-
-00:03:47.120 --> 00:03:49.519
-so I created a little snippet to help me
-
-00:03:49.519 --> 00:03:50.319
-add
-
-00:03:50.319 --> 00:03:52.239
-a source block for literate programming
-
-00:03:52.239 --> 00:03:53.599
-quickly
-
-00:03:53.599 --> 00:03:56.959
-and there's not much to it
-
-00:03:56.959 --> 00:03:58.799
-but there is some important annotations
-
-00:03:58.799 --> 00:04:01.599
-here so there's
-
-00:04:01.599 --> 00:04:04.080
-excuse me there's a there's a property
-
-00:04:04.080 --> 00:04:05.200
-called tangle
-
-00:04:05.200 --> 00:04:09.360
-and that takes a value of a file name
-
-00:04:09.360 --> 00:04:13.280
-and then there's also a no web property
-
-00:04:13.280 --> 00:04:18.880
-called no export
-
-00:04:18.880 --> 00:04:23.759
-and basically
-
-00:04:23.759 --> 00:04:26.800
-basically the no export will explain
-
-00:04:26.800 --> 00:04:28.639
-that a little bit
-
-00:04:28.639 --> 00:04:32.080
-more later um it has has to do with how
-
-00:04:32.080 --> 00:04:33.919
-the tangling
-
-00:04:33.919 --> 00:04:37.600
-is uh done in the tangle step versus the
-
-00:04:37.600 --> 00:04:39.280
-weave step and I'll explain that a
-
-00:04:39.280 --> 00:04:41.199
-little bit more but the tangle
-
-00:04:41.199 --> 00:04:45.199
-field just simply tells tells uh
-
-00:04:45.199 --> 00:04:48.320
-Emacs where it needs to generate the
-
-00:04:48.320 --> 00:04:50.320
-main.go file and where it needs to put
-
-00:04:50.320 --> 00:04:55.360
-it on the file system
-
-00:04:55.360 --> 00:04:57.680
-uh you'll you'll notice that we we're
-
-00:04:57.680 --> 00:04:59.040
-going to use go
-
-00:04:59.040 --> 00:05:01.440
-that's just the language that I've been
-
-00:05:01.440 --> 00:05:02.160
-using
-
-00:05:02.160 --> 00:05:05.360
-the most lately uh but
-
-00:05:05.360 --> 00:05:07.360
-this programming strategy is language
-
-00:05:07.360 --> 00:05:08.400
-agnostic
-
-00:05:08.400 --> 00:05:12.080
-you could use any language or any mix
-
-00:05:12.080 --> 00:05:14.720
-of languages you could create some files
-
-00:05:14.720 --> 00:05:16.560
-in python some files and go
-
-00:05:16.560 --> 00:05:19.520
-some files in in lisp or whatever you
-
-00:05:19.520 --> 00:05:21.520
-want
-
-00:05:21.520 --> 00:05:24.720
-and so but let's
-
-00:05:24.720 --> 00:05:28.000
-uh let's create just a little hello
-
-00:05:28.000 --> 00:05:29.440
-world
-
-00:05:29.440 --> 00:05:32.320
-let's use another snippet here to
-
-00:05:32.320 --> 00:05:33.520
-generate
-
-00:05:33.520 --> 00:05:36.560
-the basics of a go program
-
-00:05:36.560 --> 00:05:40.240
-so I'm just going to print
-
-00:05:40.240 --> 00:05:44.960
-hello world
-
-00:05:44.960 --> 00:05:48.560
-so that's and then
-
-00:05:48.560 --> 00:05:52.320
-let's make it a section in our
-
-00:05:52.320 --> 00:05:55.280
-file so now you can see we've got this
-
-00:05:55.280 --> 00:05:56.400
-snippet
-
-00:05:56.400 --> 00:05:59.600
-um when you have a source block in
-
-00:05:59.600 --> 00:06:01.600
-inside of org mode you can easily pop
-
-00:06:01.600 --> 00:06:02.880
-into a
-
-00:06:02.880 --> 00:06:04.960
-language specific buffer by typing
-
-00:06:04.960 --> 00:06:07.680
-control c single quote
-
-00:06:07.680 --> 00:06:10.240
-so you can see now I have a a go a
-
-00:06:10.240 --> 00:06:12.160
-buffer that's in go mode
-
-00:06:12.160 --> 00:06:14.240
-and gives you all the ability to edit
-
-00:06:14.240 --> 00:06:15.520
-like you would
-
-00:06:15.520 --> 00:06:18.800
-normally if you hit ctrl c
-
-00:06:18.800 --> 00:06:20.800
-single quote again then it goes back and
-
-00:06:20.800 --> 00:06:22.639
-any changes you
-
-00:06:22.639 --> 00:06:25.280
-make would will be updated there but you
-
-00:06:25.280 --> 00:06:26.160
-can do quite a bit
-
-00:06:26.160 --> 00:06:28.000
-just inside of here too there's quite a
-
-00:06:28.000 --> 00:06:29.199
-bit of
-
-00:06:29.199 --> 00:06:33.360
-language specific
-
-00:06:33.360 --> 00:06:35.440
-functionality just in place and so you
-
-00:06:35.440 --> 00:06:36.880
-don't always have to go over to a
-
-00:06:36.880 --> 00:06:38.080
-separate buffer
-
-00:06:38.080 --> 00:06:42.319
-but it's a it's a nice option sometimes
-
-00:06:42.319 --> 00:06:44.319
-but now that you have the code in here
-
-00:06:44.319 --> 00:06:46.720
-you're going to want to run it
-
-00:06:46.720 --> 00:06:48.560
-but right now it just lives here in this
-
-00:06:48.560 --> 00:06:50.240
-documentation
-
-00:06:50.240 --> 00:06:52.160
-so you need to get a copy of it into a
-
-00:06:52.160 --> 00:06:53.840
-separate file
-
-00:06:53.840 --> 00:06:57.440
-and that's the tangle process that you
-
-00:06:57.440 --> 00:07:01.360
-you need to follow there so I'm gonna
-
-00:07:01.360 --> 00:07:03.360
-drop in a little bit more doc a little
-
-00:07:03.360 --> 00:07:05.280
-bit more
-
-00:07:05.280 --> 00:07:12.240
-documentation really quick here
-
-00:07:12.240 --> 00:07:17.360
-okay all right so just kind of as a
-
-00:07:17.360 --> 00:07:21.520
-kind of as a side note I like to follow
-
-00:07:21.520 --> 00:07:24.800
-this process uh whenever having whenever
-
-00:07:24.800 --> 00:07:26.639
-I have an operation to perform I
-
-00:07:26.639 --> 00:07:28.880
-I'd like to document it here with a
-
-00:07:28.880 --> 00:07:31.680
-snippet that can be executed in line
-
-00:07:31.680 --> 00:07:33.280
-then I don't have to leave org mode and
-
-00:07:33.280 --> 00:07:34.639
-I don't have to try to remember what I
-
-00:07:34.639 --> 00:07:36.800
-did later so instead of just
-
-00:07:36.800 --> 00:07:38.960
-trying to do an operation the first time
-
-00:07:38.960 --> 00:07:40.319
-I do something I take the
-
-00:07:40.319 --> 00:07:41.680
-take the time to figure out what it is
-
-00:07:41.680 --> 00:07:43.440
-and document it and so then it's
-
-00:07:43.440 --> 00:07:44.879
-recorded
-
-00:07:44.879 --> 00:07:48.400
-and so here we find that to do a tangle
-
-00:07:48.400 --> 00:07:49.120
-operation
-
-00:07:49.120 --> 00:07:51.680
-you run the command or babel tangled
-
-00:07:51.680 --> 00:07:52.560
-which is a
-
-00:07:52.560 --> 00:07:55.840
-e-list command so if you hit ctrl c
-
-00:07:55.840 --> 00:07:59.199
-ctrl c to run it in place you get the
-
-00:07:59.199 --> 00:08:00.080
-result
-
-00:08:00.080 --> 00:08:02.720
-of main dot go which basically is
-
-00:08:02.720 --> 00:08:03.759
-telling us that
-
-00:08:03.759 --> 00:08:07.680
-we've tangled one file called main.go
-
-00:08:07.680 --> 00:08:11.039
-and you can see that that's true
-
-00:08:11.039 --> 00:08:14.000
-if you go to the file system and you
-
-00:08:14.000 --> 00:08:14.400
-look
-
-00:08:14.400 --> 00:08:17.840
-so now in uh in our demo directory
-
-00:08:17.840 --> 00:08:20.960
-we have a readme.org we have that png
-
-00:08:20.960 --> 00:08:22.479
-that we generated but we also have a
-
-00:08:22.479 --> 00:08:23.440
-main.go
-
-00:08:23.440 --> 00:08:26.080
-and if you if you visit that file you'll
-
-00:08:26.080 --> 00:08:27.759
-see that it's just the source code that
-
-00:08:27.759 --> 00:08:29.280
-was in our documentation which is
-
-00:08:29.280 --> 00:08:31.039
-exactly what we expected and what we
-
-00:08:31.039 --> 00:08:32.880
-wanted so that's good
-
-00:08:32.880 --> 00:08:36.560
-so if we return to
-
-00:08:36.560 --> 00:08:41.120
-to where we are at
-
-00:08:41.120 --> 00:08:42.959
-now we're we're at the point where we
-
-00:08:42.959 --> 00:08:44.640
-have a file on the file system so now we
-
-00:08:44.640 --> 00:08:45.760
-need
-
-00:08:45.760 --> 00:08:48.959
-um now we need to build it and to
-
-00:08:48.959 --> 00:08:53.600
-run it so let's follow the same
-
-00:08:53.600 --> 00:08:57.040
-philosophy where let's document
-
-00:08:57.040 --> 00:08:58.720
-these operations that we're going to
-
-00:08:58.720 --> 00:09:00.160
-perform
-
-00:09:00.160 --> 00:09:04.560
-so I'm dropping in a
-
-00:09:04.560 --> 00:09:07.839
-a build instruction section and a run
-
-00:09:07.839 --> 00:09:13.360
-instruction section
-
-00:09:13.360 --> 00:09:15.279
-so as you can see here we have a little
-
-00:09:15.279 --> 00:09:17.839
-a bash source block
-
-00:09:17.839 --> 00:09:20.000
-and another batch source block this one
-
-00:09:20.000 --> 00:09:22.000
-compiles the go build command is what
-
-00:09:22.000 --> 00:09:25.440
-compiles a file and then
-
-00:09:25.440 --> 00:09:26.880
-the file that gets generated should be
-
-00:09:26.880 --> 00:09:30.080
-called demo
-
-00:09:30.080 --> 00:09:32.959
-and uh so we just run it here so if if I
-
-00:09:32.959 --> 00:09:34.000
-type control c
-
-00:09:34.000 --> 00:09:37.839
-control c we get an empty results block
-
-00:09:37.839 --> 00:09:40.640
-when you compile things no news is good
-
-00:09:40.640 --> 00:09:41.360
-news
-
-00:09:41.360 --> 00:09:44.399
-so it means there's no errors so
-
-00:09:44.399 --> 00:09:46.560
-presumably we've created an executable
-
-00:09:46.560 --> 00:09:48.000
-that's called demo
-
-00:09:48.000 --> 00:09:51.440
-so let's uh
-
-00:09:51.440 --> 00:09:54.560
-let's look again at the file system and
-
-00:09:54.560 --> 00:10:02.480
-regenerate
-
-00:10:02.480 --> 00:10:05.760
-yep and what we have here is a demo
-
-00:10:05.760 --> 00:10:07.200
-executable which is exactly what we
-
-00:10:07.200 --> 00:10:07.760
-wanted
-
-00:10:07.760 --> 00:10:12.079
-so let's go back
-
-00:10:12.079 --> 00:10:14.160
-so now we should be able to run it so
-
-00:10:14.160 --> 00:10:16.079
-ctrl c ctrl c
-
-00:10:16.079 --> 00:10:20.399
-and we get hello world as a result
-
-00:10:20.399 --> 00:10:23.440
-which was exactly what we were expecting
-
-00:10:23.440 --> 00:10:26.560
-so that's already pretty cool
-
-00:10:26.560 --> 00:10:30.839
-you can you can do that much
-
-00:10:30.839 --> 00:10:33.040
-um but
-
-00:10:33.040 --> 00:10:34.560
-that's really just kind of the tip of
-
-00:10:34.560 --> 00:10:37.839
-the iceberg to uh to really
-
-00:10:37.839 --> 00:10:41.040
-kind of um
-
-00:10:41.040 --> 00:10:43.440
-use the more impressive features of
-
-00:10:43.440 --> 00:10:46.160
-literate programming we need to uh
-
-00:10:46.160 --> 00:10:49.920
-we need to do a little bit more
-
-00:10:49.920 --> 00:10:53.200
-so or at least
-
-00:10:53.200 --> 00:10:55.519
-at least really to get the full benefit
-
-00:10:55.519 --> 00:10:56.480
-of it then
-
-00:10:56.480 --> 00:10:59.600
-we need to do
-
-00:10:59.600 --> 00:11:02.959
-add some sections that will cause uh
-
-00:11:02.959 --> 00:11:06.320
-Emacs to have to to tangle or assemble
-
-00:11:06.320 --> 00:11:06.720
-this
-
-00:11:06.720 --> 00:11:09.760
-this file from different pieces so
-
-00:11:09.760 --> 00:11:13.120
-imagine that we wanted to take this file
-
-00:11:13.120 --> 00:11:16.720
-and maybe kind of templatize it
-
-00:11:16.720 --> 00:11:19.120
-so using literature programming syntax
-
-00:11:19.120 --> 00:11:21.279
-this angle bracket syntax
-
-00:11:21.279 --> 00:11:24.399
-let's say that we want to create an in
-
-00:11:24.399 --> 00:11:29.360
-imports section
-
-00:11:29.360 --> 00:11:32.399
-in a functions section
-
-00:11:32.399 --> 00:11:35.040
-and then maybe just a main section and
-
-00:11:35.040 --> 00:11:36.240
-we'll get rid of this
-
-00:11:36.240 --> 00:11:37.920
-so now you see we've created something
-
-00:11:37.920 --> 00:11:39.760
-that looks a little bit like a
-
-00:11:39.760 --> 00:11:42.000
-like a template or a scaffolding or
-
-00:11:42.000 --> 00:11:42.880
-outline
-
-00:11:42.880 --> 00:11:46.000
-for what what our file is going to be it
-
-00:11:46.000 --> 00:11:48.399
-looks a little bit like pseudocode
-
-00:11:48.399 --> 00:11:50.800
-and what we're going to have literate
-
-00:11:50.800 --> 00:11:52.399
-programming do
-
-00:11:52.399 --> 00:11:54.800
-is dynamically insert those things into
-
-00:11:54.800 --> 00:11:56.639
-those slots
-
-00:11:56.639 --> 00:12:00.079
-so the first thing we need to do
-
-00:12:00.079 --> 00:12:03.200
-is so let's create a section
-
-00:12:03.200 --> 00:12:08.079
-maybe called say hello so we want
-
-00:12:08.079 --> 00:12:09.519
-we want to add some functionality that
-
-00:12:09.519 --> 00:12:12.720
-makes our program say hello
-
-00:12:12.720 --> 00:12:15.680
-so using a different snippet that I have
-
-00:12:15.680 --> 00:12:17.600
-for creating something
-
-00:12:17.600 --> 00:12:20.800
-that I call like a literate section
-
-00:12:20.800 --> 00:12:24.079
-um basically we create a
-
-00:12:24.079 --> 00:12:26.000
-another source block that's almost the
-
-00:12:26.000 --> 00:12:27.839
-same as the one for the file but it's
-
-00:12:27.839 --> 00:12:31.040
-it just has a few differences so say we
-
-00:12:31.040 --> 00:12:31.680
-want to
-
-00:12:31.680 --> 00:12:34.160
-drop code into the import section and we
-
-00:12:34.160 --> 00:12:36.639
-want it to be in go
-
-00:12:36.639 --> 00:12:39.120
-here we use the same noed no web no
-
-00:12:39.120 --> 00:12:40.720
-export syntax
-
-00:12:40.720 --> 00:12:43.200
-but then we've added this no web refs
-
-00:12:43.200 --> 00:12:44.560
-imports
-
-00:12:44.560 --> 00:12:48.240
-and this ties that slot
-
-00:12:48.240 --> 00:12:51.120
-basically to this reference it tells
-
-00:12:51.120 --> 00:12:53.760
-Emacs that when you tangle
-
-00:12:53.760 --> 00:12:56.880
-we want to stick whatever's in here in
-
-00:12:56.880 --> 00:12:58.240
-that spot
-
-00:12:58.240 --> 00:13:02.079
-so you skip the tangle file name section
-
-00:13:02.079 --> 00:13:03.279
-because you're not actually creating a
-
-00:13:03.279 --> 00:13:04.240
-file name you're
-
-00:13:04.240 --> 00:13:06.160
-you're putting information into an
-
-00:13:06.160 --> 00:13:07.680
-existing file
-
-00:13:07.680 --> 00:13:10.720
-so here we would just add the fmt
-
-00:13:10.720 --> 00:13:14.399
-for the imports
-
-00:13:14.399 --> 00:13:18.839
-so let's add another section for uh
-
-00:13:18.839 --> 00:13:22.240
-functions and let's create a
-
-00:13:22.240 --> 00:13:25.519
-let's just create a function called
-
-00:13:25.519 --> 00:13:30.240
-say hello that
-
-00:13:30.240 --> 00:13:32.839
-doesn't have any arguments no return
-
-00:13:32.839 --> 00:13:34.000
-types
-
-00:13:34.000 --> 00:13:35.760
-all it does is kind of pretty much the
-
-00:13:35.760 --> 00:13:37.440
-same thing as we did before
-
-00:13:37.440 --> 00:13:39.199
-just print something but let's just say
-
-00:13:39.199 --> 00:13:41.360
-hello
-
-00:13:41.360 --> 00:13:45.760
-Emacs comp this time
-
-00:13:45.760 --> 00:13:49.519
-okay so now we have a function and now
-
-00:13:49.519 --> 00:13:51.040
-the function won't do anything unless we
-
-00:13:51.040 --> 00:13:52.720
-invoke it so let's do
-
-00:13:52.720 --> 00:13:56.000
-one last literate section
-
-00:13:56.000 --> 00:13:59.920
-called main make that go
-
-00:13:59.920 --> 00:14:03.519
-source block and then let's
-
-00:14:03.519 --> 00:14:06.560
-just invoke
-
-00:14:06.560 --> 00:14:10.320
-that that function
-
-00:14:10.320 --> 00:14:13.360
-so now you can see that we've got
-
-00:14:13.360 --> 00:14:15.600
-our scaffolding scaffolding kind of
-
-00:14:15.600 --> 00:14:17.199
-outline and then we have
-
-00:14:17.199 --> 00:14:20.079
-the sections that we want to get tangled
-
-00:14:20.079 --> 00:14:21.360
-or inserted
-
-00:14:21.360 --> 00:14:25.440
-so I I've kind of used this syntax
-
-00:14:25.440 --> 00:14:27.199
-it's it's kind of borrowed from
-
-00:14:27.199 --> 00:14:28.560
-literature programming a little bit with
-
-00:14:28.560 --> 00:14:30.320
-a plus equals so really it's just saying
-
-00:14:30.320 --> 00:14:32.480
-that I want to append
-
-00:14:32.480 --> 00:14:35.760
-this item into the import section so
-
-00:14:35.760 --> 00:14:37.600
-it's really just to make a little bit
-
-00:14:37.600 --> 00:14:39.839
-more clear what's going on
-
-00:14:39.839 --> 00:14:41.519
-when you generate documentation you
-
-00:14:41.519 --> 00:14:43.519
-won't see these
-
-00:14:43.519 --> 00:14:46.160
-these these particular property
-
-00:14:46.160 --> 00:14:49.360
-annotations and so you won't know
-
-00:14:49.360 --> 00:14:51.440
-immediately that this section goes in
-
-00:14:51.440 --> 00:14:53.839
-the imports area and so I usually put
-
-00:14:53.839 --> 00:14:55.440
-a little bit of documentation on top
-
-00:14:55.440 --> 00:14:57.760
-there so that it's easy to see
-
-00:14:57.760 --> 00:15:01.120
-and you would probably if this was very
-
-00:15:01.120 --> 00:15:03.040
-complicated you'd put some
-
-00:15:03.040 --> 00:15:06.399
-documentation above to explain what you
-
-00:15:06.399 --> 00:15:07.360
-were doing
-
-00:15:07.360 --> 00:15:11.519
-maybe right here
-
-00:15:11.519 --> 00:15:13.279
-you could you could picture yourself
-
-00:15:13.279 --> 00:15:15.040
-maybe explaining
-
-00:15:15.040 --> 00:15:17.440
-a complicated algorithm or something up
-
-00:15:17.440 --> 00:15:18.079
-here
-
-00:15:18.079 --> 00:15:21.120
-and having a nice way to document it
-
-00:15:21.120 --> 00:15:22.959
-so now that we've got that here in the
-
-00:15:22.959 --> 00:15:25.600
-documentation we need to figure out
-
-00:15:25.600 --> 00:15:27.040
-we need to make sure that it's going to
-
-00:15:27.040 --> 00:15:29.920
-tangle properly so your best friend
-
-00:15:29.920 --> 00:15:33.519
-at this point is is uh
-
-00:15:33.519 --> 00:15:35.680
-is a keyboard shortcut that lets you
-
-00:15:35.680 --> 00:15:38.240
-preview the tangled operation so if you
-
-00:15:38.240 --> 00:15:38.959
-say control
-
-00:15:38.959 --> 00:15:42.560
-c control v control v
-
-00:15:42.560 --> 00:15:45.120
-it will create a new buffer with the
-
-00:15:45.120 --> 00:15:46.480
-tangled
-
-00:15:46.480 --> 00:15:49.360
-contents and so you can see here that
-
-00:15:49.360 --> 00:15:50.639
-the fmt
-
-00:15:50.639 --> 00:15:53.199
-import went to the right place that
-
-00:15:53.199 --> 00:15:54.720
-function went to the right place the
-
-00:15:54.720 --> 00:15:56.160
-function invocation went to the right
-
-00:15:56.160 --> 00:15:58.480
-place and so we're feeling good
-
-00:15:58.480 --> 00:16:01.279
-you can nest these things many layers
-
-00:16:01.279 --> 00:16:02.800
-deep
-
-00:16:02.800 --> 00:16:04.800
-actually so like if you came into the
-
-00:16:04.800 --> 00:16:07.199
-say hello function you could add
-
-00:16:07.199 --> 00:16:10.560
-more sections
-
-00:16:10.560 --> 00:16:12.160
-you know and it gets and it'll go
-
-00:16:12.160 --> 00:16:13.759
-through and it'll
-
-00:16:13.759 --> 00:16:15.680
-keep track of all that and tangle it for
-
-00:16:15.680 --> 00:16:16.959
-you so you really get a lot of freedom
-
-00:16:16.959 --> 00:16:18.320
-and flexibility for how you want to
-
-00:16:18.320 --> 00:16:19.600
-document things
-
-00:16:19.600 --> 00:16:22.320
-by doing this so now that we've
-
-00:16:22.320 --> 00:16:25.839
-previewed it and we feel good about it
-
-00:16:25.839 --> 00:16:28.639
-we need to uh we need to tangle so we
-
-00:16:28.639 --> 00:16:31.440
-get the file on the file system
-
-00:16:31.440 --> 00:16:34.480
-so ctrl c ctrl c and
-
-00:16:34.480 --> 00:16:37.199
-get just main.go comes back again
-
-00:16:37.199 --> 00:16:37.920
-control c
-
-00:16:37.920 --> 00:16:40.959
-control c and no errors come back
-
-00:16:40.959 --> 00:16:43.839
-and then if we did this right when we
-
-00:16:43.839 --> 00:16:45.600
-when we run this we should get hello
-
-00:16:45.600 --> 00:16:47.199
-Emacs comp so ctrl c
-
-00:16:47.199 --> 00:16:51.199
-ctrl c hello Emacs comp
-
-00:16:51.199 --> 00:16:54.800
-so I uh
-
-00:16:54.800 --> 00:16:57.120
-I think that's pretty pretty cool
-
-00:16:57.120 --> 00:16:58.240
-actually so we've got
-
-00:16:58.240 --> 00:17:00.160
-kind of the breadcrumbs of the process
-
-00:17:00.160 --> 00:17:02.399
-we've gone through to get to this point
-
-00:17:02.399 --> 00:17:05.520
-this initial this initial
-
-00:17:05.520 --> 00:17:08.000
-document that has some tangling in it we
-
-00:17:08.000 --> 00:17:09.919
-have documentation for how to tangle
-
-00:17:09.919 --> 00:17:12.799
-how to build how to run it's we've
-
-00:17:12.799 --> 00:17:14.079
-really built a nice
-
-00:17:14.079 --> 00:17:17.760
-foundation for
-
-00:17:17.760 --> 00:17:20.160
-moving forward on our project and a nice
-
-00:17:20.160 --> 00:17:21.439
-way of breaking things out and
-
-00:17:21.439 --> 00:17:23.280
-documenting further
-
-00:17:23.280 --> 00:17:27.120
-the last piece that we need to
-
-00:17:27.120 --> 00:17:30.559
-take care of is the weave that I
-
-00:17:30.559 --> 00:17:34.799
-that's I showed you in the diagram above
-
-00:17:34.799 --> 00:17:38.640
-so one more time we'll drop in
-
-00:17:38.640 --> 00:17:41.760
-some documentation so this time on how
-
-00:17:41.760 --> 00:17:42.400
-to weave
-
-00:17:42.400 --> 00:17:44.400
-so it's really just an export function
-
-00:17:44.400 --> 00:17:47.520
-it's not there's not a separate weave
-
-00:17:47.520 --> 00:17:49.280
-command going on here we're just going
-
-00:17:49.280 --> 00:17:50.640
-to export
-
-00:17:50.640 --> 00:17:52.799
-what we've got here into a markdown
-
-00:17:52.799 --> 00:17:55.200
-format so we're using org
-
-00:17:55.200 --> 00:17:57.440
-gfm export to markdown which is the
-
-00:17:57.440 --> 00:17:58.880
-github style
-
-00:17:58.880 --> 00:18:02.160
-markdown you can use the other just
-
-00:18:02.160 --> 00:18:05.440
-more standard type as well so hit ctrl c
-
-00:18:05.440 --> 00:18:10.320
-ctrl c now you see we've got a readme
-
-00:18:10.320 --> 00:18:15.280
-file and if you look
-
-00:18:15.280 --> 00:18:17.440
-in the file system we've got that right
-
-00:18:17.440 --> 00:18:19.120
-there and so
-
-00:18:19.120 --> 00:18:23.120
-if you go to something like ghostwriter
-
-00:18:23.120 --> 00:18:31.679
-and open that file
-
-00:18:31.679 --> 00:18:34.559
-now you can see that it's generated some
-
-00:18:34.559 --> 00:18:35.520
-documentation
-
-00:18:35.520 --> 00:18:38.320
-it puts a index at top at the top I
-
-00:18:38.320 --> 00:18:39.679
-usually just
-
-00:18:39.679 --> 00:18:42.000
-I usually turn that off it's easy to do
-
-00:18:42.000 --> 00:18:43.679
-that by putting a property at the top of
-
-00:18:43.679 --> 00:18:44.559
-your
-
-00:18:44.559 --> 00:18:46.880
-your org file but some people like to
-
-00:18:46.880 --> 00:18:48.559
-have an index
-
-00:18:48.559 --> 00:18:50.799
-but here you can see that it's generated
-
-00:18:50.799 --> 00:18:52.160
-pretty nicely and
-
-00:18:52.160 --> 00:18:55.200
-formatted snippets well
-
-00:18:55.200 --> 00:18:56.880
-put the diagram in there and then it's
-
-00:18:56.880 --> 00:18:58.240
-preserved
-
-00:18:58.240 --> 00:19:01.039
-it's preserved this literate programming
-
-00:19:01.039 --> 00:19:02.799
-syntax
-
-00:19:02.799 --> 00:19:04.960
-which is important because that's how we
-
-00:19:04.960 --> 00:19:06.480
-want to view the documentation that's
-
-00:19:06.480 --> 00:19:07.200
-what the no
-
-00:19:07.200 --> 00:19:10.559
-exports um
-
-00:19:10.559 --> 00:19:13.360
-property was was trying to maintain so
-
-00:19:13.360 --> 00:19:14.000
-that
-
-00:19:14.000 --> 00:19:16.080
-no exports means when you export do not
-
-00:19:16.080 --> 00:19:18.400
-try to tangle so that's
-
-00:19:18.400 --> 00:19:20.559
-hopefully that makes more sense now but
-
-00:19:20.559 --> 00:19:22.240
-now you can see all the documentation
-
-00:19:22.240 --> 00:19:26.080
-and I think it demonstrates a
-
-00:19:26.080 --> 00:19:29.919
-pretty useful feature that's inside of
-
-00:19:29.919 --> 00:19:33.520
-Emacs and and hopefully
-
-00:19:33.520 --> 00:19:35.039
-hopefully you'll have as much fun using
-
-00:19:35.039 --> 00:19:39.919
-that as I have
-
-00:19:39.919 --> 00:19:43.600
-so thanks
diff --git a/2020/subtitles/emacsconf-2020--14-readme-driven-design--adam-ard.vtt b/2020/subtitles/emacsconf-2020--14-readme-driven-design--adam-ard.vtt
new file mode 100644
index 00000000..608729bd
--- /dev/null
+++ b/2020/subtitles/emacsconf-2020--14-readme-driven-design--adam-ard.vtt
@@ -0,0 +1,1297 @@
+WEBVTT
+
+00:00:03.600 --> 00:00:04.400
+Adam: Hello!
+
+00:00:04.400 --> 00:00:06.560
+Welcome to Readme Driven Design in Emacs
+
+00:00:06.560 --> 00:00:08.400
+by Adam Aard.
+
+00:00:08.400 --> 00:00:10.800
+If you're a programmer, you're accustomed
+
+00:00:10.800 --> 00:00:12.559
+to putting a README file at the root of
+
+00:00:12.559 --> 00:00:13.759
+your project.
+
+00:00:13.759 --> 00:00:15.845
+It's usually a Markdown file
+
+00:00:15.845 --> 00:00:20.579
+But if you use an Org Mode file instead,
+
+00:00:20.579 --> 00:00:22.560
+you can take advantage of the
+great features
+
+00:00:22.560 --> 00:00:24.400
+that Org Mode provides, including
+
+00:00:24.400 --> 00:00:25.920
+literate programming,
+
+00:00:25.920 --> 00:00:28.000
+which lets you generate your source code
+
+00:00:28.000 --> 00:00:31.840
+and Markdown documentation dynamically.
+
+00:00:31.840 --> 00:00:34.719
+I want to walk you through a little bit
+
+00:00:34.719 --> 00:00:37.120
+of what this looks like.
+
+00:00:37.120 --> 00:00:39.440
+When you start a project, especially if
+
+00:00:39.440 --> 00:00:41.280
+if you use something like Github you
+
+00:00:41.280 --> 00:00:43.320
+begin with an automatically generated
+
+00:00:43.320 --> 00:00:47.039
+README.md file. So just delete that
+
+00:00:47.039 --> 00:00:50.239
+and instead create a README.org file.
+
+00:00:50.239 --> 00:00:51.712
+Starting with an empty Org file,
+
+00:00:51.712 --> 00:00:54.800
+like you see here, you can begin
+
+00:00:54.800 --> 00:00:56.559
+by recording important information about
+
+00:00:56.559 --> 00:00:59.440
+your project goals. You can add diagrams,
+
+00:00:59.440 --> 00:01:01.920
+code snippets, to-do lists, time tracking
+
+00:01:01.920 --> 00:01:03.520
+and much more.
+
+00:01:03.520 --> 00:01:05.360
+I'm going to drop in some documentation
+
+00:01:05.360 --> 00:01:07.760
+that that I've written about
+
+00:01:07.760 --> 00:01:12.240
+about my project here, so you can see
+
+00:01:12.240 --> 00:01:15.280
+what this would look like.
+
+00:01:15.280 --> 00:01:17.119
+As you can see, I have a title, and a
+
+00:01:17.119 --> 00:01:20.320
+description, and then a subsection
+
+00:01:20.320 --> 00:01:23.840
+as well as some code snippets.
+
+00:01:23.840 --> 00:01:25.520
+You can see that Org Mode does a great
+
+00:01:25.520 --> 00:01:28.240
+job of formatting lists,
+
+00:01:28.240 --> 00:01:31.280
+code sections, diagrams, and so forth.
+
+00:01:31.280 --> 00:01:35.040
+It's as good or better than Markdown,
+
+00:01:35.040 --> 00:01:37.179
+but when you use it in Emacs
+
+00:01:37.179 --> 00:01:38.880
+you can do a lot more.
+
+00:01:38.880 --> 00:01:40.479
+For example, you can dynamically create
+
+00:01:40.479 --> 00:01:43.360
+diagrams using Graphviz
+
+00:01:43.360 --> 00:01:45.200
+from a text description. If you go to
+
+00:01:45.200 --> 00:01:46.560
+this source block here
+
+00:01:46.560 --> 00:01:49.439
+and hit C-c C-c, you'll see
+
+00:01:49.439 --> 00:01:52.979
+that we generate a diagram dynamically
+
+00:01:55.439 --> 00:01:59.200
+You can run these code snippets in
+
+00:01:59.200 --> 00:02:00.799
+place and get the results
+
+00:02:00.799 --> 00:02:03.040
+to show up inside of your file,
+
+00:02:03.040 --> 00:02:08.000
+which is a really powerful paradigm.
+
+00:02:08.000 --> 00:02:10.640
+But most importantly, for
+
+00:02:10.640 --> 00:02:14.800
+my purposes here,
+
+00:02:14.800 --> 00:02:17.200
+Org Mode provides you the ability to do
+
+00:02:17.200 --> 00:02:19.520
+literate programming.
+
+00:02:19.520 --> 00:02:21.440
+So take a quick look at this diagram
+
+00:02:21.440 --> 00:02:23.200
+that I generated here.
+
+00:02:23.200 --> 00:02:25.312
+It gives you a quick overview of what
+
+00:02:25.312 --> 00:02:27.520
+I mean by literate programming
+
+00:02:27.520 --> 00:02:31.200
+and how I'm using it. You can see
+
+00:02:31.200 --> 00:02:34.720
+that we start with a README.org file
+on top.
+
+00:02:34.720 --> 00:02:37.920
+At this point, we can do one of two
+things:
+
+00:02:37.920 --> 00:02:41.280
+tangle or weave. Tangle is used to
+
+00:02:41.280 --> 00:02:42.720
+describe the process of
+
+00:02:42.720 --> 00:02:46.319
+generating source code, while weave
+
+00:02:46.319 --> 00:02:47.599
+is the process of generating
+
+00:02:47.599 --> 00:02:49.840
+documentation. These are terms that
+
+00:02:49.840 --> 00:02:51.920
+Donald Knuth used.
+
+00:02:51.920 --> 00:02:53.840
+He's the one that came up with the
+
+00:02:53.840 --> 00:02:55.519
+idea of literate programming
+
+00:02:55.519 --> 00:02:59.920
+in the early 1980s.
+
+00:02:59.920 --> 00:03:01.945
+But this is really all that there is to
+it.
+
+00:03:01.945 --> 00:03:05.412
+You just... You are simply
+
+00:03:05.412 --> 00:03:07.840
+using a literate source file,
+
+00:03:07.840 --> 00:03:10.319
+in this case the README.org, to generate
+
+00:03:11.680 --> 00:03:17.120
+the rest of the project files, basically.
+
+00:03:17.120 --> 00:03:22.640
+So let's dig in to the details of how
+this works.
+
+00:03:22.640 --> 00:03:24.560
+I hope you... Hopefully you'll see how
+
+00:03:24.560 --> 00:03:26.159
+cool this is.
+
+00:03:26.159 --> 00:03:27.545
+So returning to the file here.
+
+00:03:27.545 --> 00:03:31.120
+Let's assume we have enough
+documentation now,
+
+00:03:31.120 --> 00:03:32.679
+that we want to get started
+coding.
+
+00:03:32.679 --> 00:03:34.159
+So maybe we'll just start with
+
+00:03:34.159 --> 00:03:35.845
+like a Hello World app,
+
+00:03:35.845 --> 00:03:38.159
+just so we can make sure that our
+
+00:03:38.159 --> 00:03:41.519
+environment is set up correctly.
+
+00:03:41.519 --> 00:03:47.120
+Let's get started with a code block.
+
+00:03:47.120 --> 00:03:49.519
+So I created a little snippet to help me
+
+00:03:49.519 --> 00:03:51.612
+add a source block for
+
+00:03:51.612 --> 00:03:53.599
+literate programming quickly.
+
+00:03:53.599 --> 00:03:56.959
+There's not much to it,
+
+00:03:56.959 --> 00:03:59.479
+but there are some important annotations
+here.
+
+00:04:01.599 --> 00:04:04.080
+Excuse me. There's a property
+
+00:04:04.080 --> 00:04:05.200
+called :tangle
+
+00:04:05.200 --> 00:04:09.360
+and that takes a value of a file name.
+
+00:04:09.360 --> 00:04:13.280
+Then there's also a :noweb property
+
+00:04:13.280 --> 00:04:18.880
+called no-export.
+
+00:04:23.759 --> 00:04:26.800
+Basically, the noexport--we'll explain
+
+00:04:26.800 --> 00:04:29.645
+that a little bit more later
+
+00:04:29.645 --> 00:04:32.080
+It has has to do with how
+
+00:04:32.080 --> 00:04:36.845
+the tangling is done in the tangle
+step
+
+00:04:36.845 --> 00:04:38.479
+versus the weave step.
+
+00:04:38.479 --> 00:04:40.212
+I'll explain that a little bit more.
+
+00:04:40.212 --> 00:04:45.199
+But the tangle field just simply tells
+
+00:04:45.199 --> 00:04:48.320
+Emacs where it needs to generate the
+
+00:04:48.320 --> 00:04:50.320
+main.go file and where it needs to put
+
+00:04:50.320 --> 00:04:55.360
+it on the file system.
+
+00:04:55.360 --> 00:04:57.680
+You'll notice that we we're
+
+00:04:57.680 --> 00:04:59.040
+going to use Go.
+
+00:04:59.040 --> 00:05:01.440
+That's just the language that I've been
+
+00:05:01.440 --> 00:05:03.379
+using the most lately,
+
+00:05:03.379 --> 00:05:06.845
+but this programming strategy
+
+00:05:06.845 --> 00:05:08.400
+is language-agnostic.
+
+00:05:08.400 --> 00:05:11.279
+You could use any language
+
+00:05:11.279 --> 00:05:13.145
+or any mix of languages.
+
+00:05:13.145 --> 00:05:14.720
+You could create some files
+
+00:05:14.720 --> 00:05:16.560
+in Python, some files in Go,
+
+00:05:16.560 --> 00:05:19.179
+some files in Lisp,
+
+00:05:19.179 --> 00:05:21.520
+or whatever you want.
+
+00:05:24.720 --> 00:05:29.440
+Let's create just a little
+Hello World.
+
+00:05:29.440 --> 00:05:31.379
+Let's use another snippet here
+
+00:05:31.379 --> 00:05:36.560
+to generate the basics of a Go program.
+
+00:05:36.560 --> 00:05:40.240
+I'm just going to print
+
+00:05:40.240 --> 00:05:44.960
+Hello World.
+
+00:05:44.960 --> 00:05:48.560
+So that's... And then
+
+00:05:48.560 --> 00:05:52.779
+let's make it a section in our file.
+
+00:05:52.779 --> 00:05:55.045
+So now you can see, we've got
+
+00:05:55.045 --> 00:05:56.400
+this snippet.
+
+00:05:56.400 --> 00:05:59.600
+When you have a source block in
+
+00:05:59.600 --> 00:06:01.600
+inside of Org Mode, you can easily pop
+
+00:06:01.600 --> 00:06:04.960
+into a language-specific buffer
+by typing
+
+00:06:04.960 --> 00:06:07.680
+C-c ' (single quote).
+
+00:06:07.680 --> 00:06:10.240
+So you can see, now I have a
+
+00:06:10.240 --> 00:06:12.160
+buffer that's in go-mode
+
+00:06:12.160 --> 00:06:14.240
+and gives you all the ability to edit
+
+00:06:14.240 --> 00:06:15.520
+like you would
+
+00:06:15.520 --> 00:06:19.945
+normally. If you hit C-c '
+(single quote)
+
+00:06:19.945 --> 00:06:20.800
+again, it goes back and
+
+00:06:20.800 --> 00:06:25.045
+any changes you make will be
+updated there.
+
+00:06:25.045 --> 00:06:26.160
+But you can do quite a bit
+
+00:06:26.160 --> 00:06:27.879
+just inside of here too.
+
+00:06:27.879 --> 00:06:29.199
+There's quite a bit of
+
+00:06:29.199 --> 00:06:34.479
+language-specific functionality
+
+00:06:34.479 --> 00:06:35.312
+just in place,
+
+00:06:35.312 --> 00:06:36.880
+so you don't always have to go over to a
+
+00:06:36.880 --> 00:06:38.080
+separate buffer.
+
+00:06:38.080 --> 00:06:42.319
+It's a nice option sometimes.
+
+00:06:42.319 --> 00:06:44.319
+Now that you have the code in here,
+
+00:06:44.319 --> 00:06:46.720
+you're going to want to run it.
+
+00:06:46.720 --> 00:06:48.179
+Right now, it just lives here
+
+00:06:48.179 --> 00:06:50.240
+in this documentation.
+
+00:06:50.240 --> 00:06:52.160
+You need to get a copy of it into a
+
+00:06:52.160 --> 00:06:53.840
+separate file,
+
+00:06:53.840 --> 00:06:57.440
+and that's the tangle process that you
+
+00:06:57.440 --> 00:07:01.360
+you need to follow there. So I'm gonna
+
+00:07:01.360 --> 00:07:03.360
+drop in a little bit more doc, a little
+
+00:07:03.360 --> 00:07:12.240
+bit more documentation really quick here.
+
+00:07:12.240 --> 00:07:19.112
+Okay, all right. So just as a side note,
+
+00:07:19.112 --> 00:07:22.845
+I like to follow this process.
+
+00:07:22.845 --> 00:07:26.639
+Whenever I have an operation to perform,
+
+00:07:26.639 --> 00:07:28.880
+I'd like to document it here with a
+
+00:07:28.880 --> 00:07:31.680
+snippet that can be executed inline.
+
+00:07:31.680 --> 00:07:33.280
+Then I don't have to leave Org Mode, and
+
+00:07:33.280 --> 00:07:34.639
+I don't have to try to remember what I
+
+00:07:34.639 --> 00:07:36.800
+did later. So instead of just
+
+00:07:36.800 --> 00:07:38.960
+trying to do an operation, the first time
+
+00:07:38.960 --> 00:07:40.319
+I do something,
+
+00:07:40.319 --> 00:07:41.680
+I take the time to figure out what it is
+
+00:07:41.680 --> 00:07:44.879
+and document it, so then it's
+recorded.
+
+00:07:44.879 --> 00:07:49.120
+So here we find that to do a tangle
+operation,
+
+00:07:49.120 --> 00:07:51.680
+you run the command org-babel-tangle,
+
+00:07:51.680 --> 00:07:53.779
+which is an Elisp command.
+
+00:07:53.779 --> 00:07:58.712
+If you hit C-c C-c to run it in place,
+
+00:07:58.712 --> 00:08:00.080
+you get the result
+
+00:08:00.080 --> 00:08:02.720
+of main.go, which basically is
+
+00:08:02.720 --> 00:08:03.759
+telling us that
+
+00:08:03.759 --> 00:08:07.680
+we've tangled one file called main.go.
+
+00:08:07.680 --> 00:08:11.039
+You can see that that's true
+
+00:08:11.039 --> 00:08:12.879
+if you go to the file system
+
+00:08:12.879 --> 00:08:14.400
+and you look.
+
+00:08:14.400 --> 00:08:17.840
+Now in our demo directory,
+
+00:08:17.840 --> 00:08:19.712
+we have a README.org,
+
+00:08:19.712 --> 00:08:22.045
+we have that PNG that we generated,
+
+00:08:22.045 --> 00:08:23.440
+but we also have a main.go.
+
+00:08:23.440 --> 00:08:25.945
+If you visit that file,
+
+00:08:25.945 --> 00:08:27.045
+you'll see that it's just
+
+00:08:27.045 --> 00:08:28.212
+the source code that was
+
+00:08:28.212 --> 00:08:29.280
+in our documentation, which is
+
+00:08:29.280 --> 00:08:30.679
+exactly what we expected
+
+00:08:30.679 --> 00:08:32.880
+and what we wanted. So that's good.
+
+00:08:32.880 --> 00:08:41.120
+So if we return to where we were at...
+
+00:08:41.120 --> 00:08:42.959
+Now we're at the point where we
+
+00:08:42.959 --> 00:08:44.479
+have a file on the file system.
+
+00:08:45.760 --> 00:08:48.379
+Now we need to build it
+
+00:08:48.379 --> 00:08:49.612
+and to run it.
+
+00:08:49.612 --> 00:08:57.040
+So let's follow the same philosophy,
+where let's document
+
+00:08:57.040 --> 00:09:00.160
+these operations that we're going to
+perform.
+
+00:09:00.160 --> 00:09:04.560
+I'm dropping in a
+
+00:09:04.560 --> 00:09:07.112
+a build instruction section
+
+00:09:07.112 --> 00:09:13.360
+and a run instruction section.
+
+00:09:13.360 --> 00:09:15.279
+As you can see here, we have a little
+
+00:09:15.279 --> 00:09:17.839
+a bash source block,
+
+00:09:17.839 --> 00:09:19.245
+and another bash source block.
+
+00:09:19.245 --> 00:09:21.812
+This one compiles. The go build command
+
+00:09:21.812 --> 00:09:25.440
+is what compiles a file. Then
+
+00:09:25.440 --> 00:09:26.579
+the file that gets generated
+
+00:09:26.579 --> 00:09:30.080
+should be called demo.
+
+00:09:30.080 --> 00:09:32.412
+So we just run it here.
+
+00:09:32.412 --> 00:09:37.839
+If I type C-c C-c, we get an
+empty results block.
+
+00:09:37.839 --> 00:09:38.979
+When you compile things,
+
+00:09:38.979 --> 00:09:41.360
+no news is good news.
+
+00:09:41.360 --> 00:09:43.012
+It means there's no errors
+
+00:09:43.012 --> 00:09:45.912
+So presumably, we've created
+
+00:09:45.912 --> 00:09:48.000
+an executable that's called demo.
+
+00:09:51.440 --> 00:09:53.312
+Let's look again at the file system
+
+00:09:53.312 --> 00:10:02.480
+and regenerate...
+
+00:10:02.480 --> 00:10:06.479
+Yep. What we have here is a demo
+executable,
+
+00:10:06.479 --> 00:10:07.760
+which is exactly what we
+wanted.
+
+00:10:07.760 --> 00:10:12.079
+Let's go back.
+
+00:10:12.079 --> 00:10:14.160
+Now we should be able to run it.
+
+00:10:14.160 --> 00:10:16.079
+C-c C-c,
+
+00:10:16.079 --> 00:10:20.399
+and we get Hello World as a result,
+
+00:10:20.399 --> 00:10:23.440
+which was exactly what we were expecting.
+
+00:10:23.440 --> 00:10:26.560
+So that's already pretty cool.
+
+00:10:26.560 --> 00:10:30.839
+You can do that much.
+
+00:10:33.040 --> 00:10:34.560
+That's really just the tip of
+
+00:10:34.560 --> 00:10:37.839
+the iceberg. To really
+
+00:10:41.040 --> 00:10:43.440
+use the more impressive features of
+
+00:10:43.440 --> 00:10:46.160
+literate programming,
+
+00:10:46.160 --> 00:10:49.920
+we need to do a little bit more
+
+00:10:53.200 --> 00:10:54.512
+at least. Really,
+
+00:10:54.512 --> 00:10:56.480
+to get the full benefit of it,
+
+00:10:56.480 --> 00:11:01.079
+we need to add some sections
+
+00:11:01.079 --> 00:11:04.412
+that will cause Emacs to have to
+
+00:11:04.412 --> 00:11:06.720
+tangle or assemble
+
+00:11:06.720 --> 00:11:09.760
+this file from different pieces.
+
+00:11:09.760 --> 00:11:13.120
+Imagine that we wanted to take this file
+
+00:11:13.120 --> 00:11:16.720
+and maybe kind of templatize it.
+
+00:11:16.720 --> 00:11:19.120
+So, using literature programming syntax,
+
+00:11:19.120 --> 00:11:21.279
+this angle bracket syntax,
+
+00:11:21.279 --> 00:11:24.399
+let's say that we want to create an
+
+00:11:24.399 --> 00:11:29.360
+imports section,
+
+00:11:29.360 --> 00:11:32.399
+a functions section,
+
+00:11:32.399 --> 00:11:35.040
+and then maybe just a main section.
+
+00:11:35.040 --> 00:11:36.240
+We'll get rid of this.
+
+00:11:36.240 --> 00:11:37.920
+So now you see, we've created something
+
+00:11:37.920 --> 00:11:39.760
+that looks a little bit like a
+
+00:11:39.760 --> 00:11:42.880
+template or a scaffolding or outline
+
+00:11:42.880 --> 00:11:45.812
+for what our file is going to be.
+
+00:11:45.812 --> 00:11:48.399
+It looks a little bit like pseudocode.
+
+00:11:48.399 --> 00:11:50.612
+What we're going to have
+
+00:11:50.612 --> 00:11:52.399
+literate programming do
+
+00:11:52.399 --> 00:11:54.800
+is dynamically insert those things into
+
+00:11:54.800 --> 00:11:56.639
+those slots.
+
+00:11:56.639 --> 00:12:00.079
+So the first thing we need to do
+
+00:12:00.079 --> 00:12:03.200
+is... So let's create a section
+
+00:12:03.200 --> 00:12:08.079
+called "Say Hello."
+
+00:12:08.079 --> 00:12:09.519
+We want to add some functionality that
+
+00:12:09.519 --> 00:12:12.720
+makes our program say hello.
+
+00:12:12.720 --> 00:12:15.680
+So using a different snippet that I have
+
+00:12:15.680 --> 00:12:17.600
+for creating something
+
+00:12:17.600 --> 00:12:20.800
+that I call like a literate section,
+
+00:12:20.800 --> 00:12:24.079
+basically, we create a
+
+00:12:24.079 --> 00:12:26.000
+another source block that's almost the
+
+00:12:26.000 --> 00:12:27.839
+same as the one for the file.
+
+00:12:27.839 --> 00:12:29.412
+It just has a few differences
+
+00:12:29.412 --> 00:12:34.079
+Say we want to drop code into the import
+section
+
+00:12:34.079 --> 00:12:36.639
+and we want it to be in Go.
+
+00:12:36.639 --> 00:12:40.720
+Here we use the same :noweb no-export syntax,
+
+00:12:40.720 --> 00:12:44.560
+but then we've added this :noweb-ref imports,
+
+00:12:44.560 --> 00:12:48.240
+and this ties that slot
+
+00:12:48.240 --> 00:12:51.120
+to this reference. It tells
+
+00:12:51.120 --> 00:12:53.760
+Emacs that when you tangle,
+
+00:12:53.760 --> 00:12:55.479
+we want to stick whatever's in here
+
+00:12:55.479 --> 00:12:58.240
+in that spot.
+
+00:12:58.240 --> 00:13:02.079
+You skip the tangle file name section
+
+00:13:02.079 --> 00:13:03.279
+because you're not actually creating a
+
+00:13:03.279 --> 00:13:04.240
+file name.
+
+00:13:04.240 --> 00:13:06.160
+You're putting information into an
+
+00:13:06.160 --> 00:13:07.680
+existing file.
+
+00:13:07.680 --> 00:13:10.720
+So here, we would just add the "fmt"
+
+00:13:10.720 --> 00:13:14.399
+for the imports.
+
+00:13:14.399 --> 00:13:16.145
+Let's add another section
+
+00:13:16.145 --> 00:13:22.240
+for functions.
+
+00:13:22.240 --> 00:13:23.812
+Let's just create a function
+
+00:13:23.812 --> 00:13:28.079
+called sayHello
+
+00:13:28.079 --> 00:13:31.745
+that doesn't have any arguments.
+
+00:13:31.745 --> 00:13:34.000
+No return types.
+
+00:13:34.000 --> 00:13:35.760
+All it does is pretty much the
+
+00:13:35.760 --> 00:13:37.440
+same thing as we did before:
+
+00:13:37.440 --> 00:13:38.479
+just print something.
+
+00:13:38.479 --> 00:13:45.760
+Let's just say "Hello EmacsConf"
+this time.
+
+00:13:45.760 --> 00:13:47.279
+Now we have a function,
+
+00:13:47.279 --> 00:13:50.779
+and now the function won't do anything
+
+00:13:50.779 --> 00:13:52.720
+unless we invoke it. Let's do
+
+00:13:52.720 --> 00:13:56.000
+one last literate section
+
+00:13:56.000 --> 00:13:59.920
+called main. Make that Go
+
+00:13:59.920 --> 00:14:03.519
+source block. Then let's
+
+00:14:03.519 --> 00:14:10.320
+invoke that function.
+
+00:14:10.320 --> 00:14:13.360
+Now you can see that we've got
+
+00:14:13.360 --> 00:14:15.600
+our scaffolding
+
+00:14:15.600 --> 00:14:17.199
+outline, and then we have
+
+00:14:17.199 --> 00:14:20.079
+the sections that we want to get tangled
+
+00:14:20.079 --> 00:14:21.360
+or inserted.
+
+00:14:21.360 --> 00:14:25.440
+I've used this syntax.
+
+00:14:25.440 --> 00:14:27.199
+It's kinda borrowed from
+
+00:14:27.199 --> 00:14:28.479
+literate programming a little bit
+
+00:14:28.479 --> 00:14:30.320
+with a +=, so really it's just saying
+
+00:14:30.320 --> 00:14:32.480
+that I want to append
+
+00:14:32.480 --> 00:14:35.760
+this item into the import section
+
+00:14:35.760 --> 00:14:37.600
+It's really just to make a little bit
+
+00:14:37.600 --> 00:14:39.839
+more clear what's going on.
+
+00:14:39.839 --> 00:14:41.445
+When you generate documentation,
+
+00:14:41.445 --> 00:14:43.519
+you won't see these
+
+00:14:43.519 --> 00:14:46.979
+particular property annotations,
+
+00:14:46.979 --> 00:14:50.145
+and so you won't know immediately
+
+00:14:50.145 --> 00:14:51.779
+that this section goes in the
+
+00:14:51.779 --> 00:14:53.839
+imports area. So I usually put
+
+00:14:53.839 --> 00:14:55.440
+a little bit of documentation on top
+
+00:14:55.440 --> 00:14:57.760
+there, so that it's easy to see.
+
+00:14:57.760 --> 00:15:01.120
+You would, probably, if this was very
+
+00:15:01.120 --> 00:15:03.040
+complicated, you'd put some
+
+00:15:03.040 --> 00:15:06.245
+documentation above to explain
+
+00:15:06.245 --> 00:15:07.360
+what you were doing,
+
+00:15:07.360 --> 00:15:11.519
+maybe right here.
+
+00:15:11.519 --> 00:15:13.279
+You could picture yourself
+
+00:15:13.279 --> 00:15:15.040
+maybe explaining
+
+00:15:15.040 --> 00:15:16.745
+a complicated algorithm
+
+00:15:16.745 --> 00:15:18.079
+or something up here
+
+00:15:18.079 --> 00:15:21.120
+and having a nice way to document it.
+
+00:15:21.120 --> 00:15:22.959
+So now that we've got that here in the
+
+00:15:22.959 --> 00:15:25.600
+documentation, we need to figure out...
+
+00:15:25.600 --> 00:15:27.040
+We need to make sure that it's going to
+
+00:15:27.040 --> 00:15:28.045
+tangle properly.
+
+00:15:28.045 --> 00:15:33.519
+Your best friend at this point
+
+00:15:33.519 --> 00:15:35.680
+is a keyboard shortcut that lets you
+
+00:15:35.680 --> 00:15:37.945
+preview the tangled operation.
+
+00:15:37.945 --> 00:15:42.560
+If you say C-c C-v C-v,
+
+00:15:42.560 --> 00:15:44.079
+it will create a new buffer
+
+00:15:44.079 --> 00:15:47.212
+with the tangled contents
+
+00:15:47.212 --> 00:15:49.179
+and so you can see here
+
+00:15:49.179 --> 00:15:52.345
+that the fmt import went to the right
+place,
+
+00:15:52.345 --> 00:15:54.679
+that function went to the right place,
+
+00:15:54.679 --> 00:15:56.079
+the function invocation went to
+
+00:15:56.079 --> 00:15:58.480
+the right place. We're feeling good.
+
+00:15:58.480 --> 00:16:00.912
+You can nest these things
+
+00:16:00.912 --> 00:16:02.800
+many layers deep.
+
+00:16:02.800 --> 00:16:06.045
+If you came into the sayHello function,
+
+00:16:06.045 --> 00:16:10.560
+you could add more sections.
+
+00:16:10.560 --> 00:16:13.759
+It'll go through and it'll
+
+00:16:13.759 --> 00:16:15.345
+keep track of all that
+
+00:16:15.345 --> 00:16:16.212
+and tangle it for you
+
+00:16:16.212 --> 00:16:16.959
+so you really get a lot of freedom
+
+00:16:16.959 --> 00:16:18.320
+and flexibility for how you want to
+
+00:16:18.320 --> 00:16:20.479
+document things by doing this.
+
+00:16:20.479 --> 00:16:23.079
+So now that we've previewed it
+
+00:16:23.079 --> 00:16:25.839
+and we feel good about it,
+
+00:16:25.839 --> 00:16:28.639
+we need to tangle so
+
+00:16:28.639 --> 00:16:31.440
+we get the file on the file system.
+
+00:16:31.440 --> 00:16:34.979
+so C-c C-c and get...
+
+00:16:34.979 --> 00:16:37.199
+just main.go comes back again.
+
+00:16:37.199 --> 00:16:40.959
+C-c C-cc and no errors come back.
+
+00:16:40.959 --> 00:16:43.279
+Then if we did this right,
+
+00:16:43.279 --> 00:16:45.079
+when we run this, we should get
+
+00:16:45.079 --> 00:16:45.600
+"Hello, EmacsConf."
+
+00:16:45.600 --> 00:16:51.199
+So C-c C-c, Hello EmacsConf.
+
+00:16:54.800 --> 00:16:57.645
+I think that's pretty, pretty cool,
+actually.
+
+00:16:57.645 --> 00:16:59.579
+So we've got the breadcrumbs
+
+00:16:59.579 --> 00:17:01.212
+of the process we've gone through
+
+00:17:01.212 --> 00:17:02.399
+to get to this point,
+
+00:17:02.399 --> 00:17:07.545
+this initial document that has some
+tangling in it.
+
+00:17:07.545 --> 00:17:09.919
+We have documentation for how to tangle,
+
+00:17:09.919 --> 00:17:11.345
+how to build, how to run.
+
+00:17:11.345 --> 00:17:15.045
+We've really built a nice foundation
+
+00:17:15.045 --> 00:17:19.379
+for moving forward on our project
+
+00:17:19.379 --> 00:17:21.439
+and a nice way of breaking things
+out
+
+00:17:21.439 --> 00:17:23.280
+and documenting further.
+
+00:17:23.280 --> 00:17:27.120
+The last piece that we need to
+
+00:17:27.120 --> 00:17:30.559
+take care of is the weave that
+
+00:17:30.559 --> 00:17:34.799
+I showed you in the diagram above.
+
+00:17:34.799 --> 00:17:38.640
+So one more time, we'll drop in
+
+00:17:38.640 --> 00:17:41.760
+some documentatio, this time on how
+
+00:17:41.760 --> 00:17:42.400
+to weave.
+
+00:17:42.400 --> 00:17:44.400
+It's really just an export function.
+
+00:17:44.400 --> 00:17:46.245
+it's not... There's not a separate
+
+00:17:46.245 --> 00:17:49.012
+weave command going on here.
+
+00:17:49.012 --> 00:17:50.640
+we're just going to export
+
+00:17:50.640 --> 00:17:53.512
+what we've got here into a Markdown
+format.
+
+00:17:53.512 --> 00:17:57.045
+We're using org-gfm-export-to-markdown,
+
+00:17:57.045 --> 00:17:59.745
+which is the Github style markdown.
+
+00:17:59.745 --> 00:18:02.160
+You can use the other,
+
+00:18:02.160 --> 00:18:03.812
+more standard type as well.
+
+00:18:03.812 --> 00:18:08.479
+Hit C-c C-c. Now you see
+
+00:18:08.479 --> 00:18:11.312
+we've got a README file,
+
+00:18:11.312 --> 00:18:16.512
+and if you look in the file system,
+
+00:18:16.512 --> 00:18:19.120
+we've got that right there.
+
+00:18:19.120 --> 00:18:23.120
+If you go to something like ghostwriter
+
+00:18:23.120 --> 00:18:31.679
+and open that file,
+
+00:18:31.679 --> 00:18:32.879
+now you can see that
+
+00:18:32.879 --> 00:18:35.520
+it's generated some documentation.
+
+00:18:35.520 --> 00:18:37.645
+It puts a index at top at the top.
+
+00:18:39.679 --> 00:18:41.145
+I usually turn that off.
+
+00:18:41.145 --> 00:18:42.379
+It's easy to do that by
+
+00:18:42.379 --> 00:18:43.179
+putting a property at the
+
+00:18:43.179 --> 00:18:46.145
+top of your Org file,
+
+00:18:46.145 --> 00:18:46.880
+but some people like to
+
+00:18:46.880 --> 00:18:48.559
+have an index.
+
+00:18:48.559 --> 00:18:50.799
+Here you can see that it has generated
+
+00:18:50.799 --> 00:18:55.200
+pretty nicely and formatted
+snippets well,
+
+00:18:55.200 --> 00:18:56.880
+put the diagram in there, and then
+
+00:18:58.240 --> 00:19:02.799
+it's preserved this
+literate programming syntax,
+
+00:19:02.799 --> 00:19:04.960
+which is important because that's how we
+
+00:19:04.960 --> 00:19:06.112
+want to view the documentation.
+
+00:19:06.112 --> 00:19:11.312
+That's what the no-exports property
+
+00:19:11.312 --> 00:19:13.360
+was trying to maintain.
+
+00:19:13.360 --> 00:19:15.979
+no-exports means when you export,
+
+00:19:15.979 --> 00:19:18.400
+do not try to tangle.
+
+00:19:18.400 --> 00:19:20.559
+Hopefully that makes more sense now.
+
+00:19:20.559 --> 00:19:22.240
+Now you can see all the documentation.
+
+00:19:22.240 --> 00:19:26.080
+I think it demonstrates a
+
+00:19:26.080 --> 00:19:33.520
+pretty useful feature that's inside of
+Emacs.
+
+00:19:33.520 --> 00:19:34.979
+Hopefully you'll have as much fun
+
+00:19:34.979 --> 00:19:39.919
+using that as I have.
+
+00:19:39.919 --> 00:19:43.600
+So thanks!
diff --git a/2020/subtitles/emacsconf-2020--15-moving-from-jekyll-to-orgmode-an-experience-report--adolfo-villafiorita-autogen.vtt b/2020/subtitles/emacsconf-2020--15-moving-from-jekyll-to-orgmode-an-experience-report--adolfo-villafiorita-autogen.vtt
deleted file mode 100644
index 21202a4a..00000000
--- a/2020/subtitles/emacsconf-2020--15-moving-from-jekyll-to-orgmode-an-experience-report--adolfo-villafiorita-autogen.vtt
+++ /dev/null
@@ -1,1183 +0,0 @@
-WEBVTT
-
-00:00:00.080 --> 00:00:03.120
-okay okay excellent sorry okay so
-
-00:00:03.120 --> 00:00:06.960
-uh hello everyone um and um
-
-00:00:06.960 --> 00:00:10.080
-uh nice meeting you and let me
-
-00:00:10.080 --> 00:00:12.400
-thank the the organizer for all the
-
-00:00:12.400 --> 00:00:13.920
-organization and all the work they are
-
-00:00:13.920 --> 00:00:15.200
-doing to support us
-
-00:00:15.200 --> 00:00:18.400
-my name is adolfo villaferita
-
-00:00:18.400 --> 00:00:19.920
-I'm teaching at the university of
-
-00:00:19.920 --> 00:00:21.920
-trenton I'm also
-
-00:00:21.920 --> 00:00:24.480
-work will shortly be working at
-
-00:00:24.480 --> 00:00:26.240
-shared.tech which is a comp
-
-00:00:26.240 --> 00:00:29.359
-a non-profit organization developing an
-
-00:00:29.359 --> 00:00:30.530
-applications to
-
-00:00:30.530 --> 00:00:32.399
-[Music]
-
-00:00:32.399 --> 00:00:35.680
-recover surplus food but the the
-
-00:00:35.680 --> 00:00:38.960
-reason of the talk today and the reason
-
-00:00:38.960 --> 00:00:40.079
-I'm here today
-
-00:00:40.079 --> 00:00:42.719
-is to talk about my experience in moving
-
-00:00:42.719 --> 00:00:44.000
-from jekyll uh
-
-00:00:44.000 --> 00:00:47.200
-static website generator to org mode and
-
-00:00:47.200 --> 00:00:49.200
-the reason
-
-00:00:49.200 --> 00:00:52.079
-I move to work mode is to have better
-
-00:00:52.079 --> 00:00:53.039
-support for
-
-00:00:53.039 --> 00:00:56.800
-literary programming on the websites
-
-00:00:56.800 --> 00:00:58.399
-at the university of trento where we
-
-00:00:58.399 --> 00:01:00.480
-make available the content for the
-
-00:01:00.480 --> 00:01:04.720
-the students okay so
-
-00:01:04.720 --> 00:01:08.000
-first of all what is a static website
-
-00:01:08.000 --> 00:01:10.080
-generator it is basically a tool which
-
-00:01:10.080 --> 00:01:11.360
-allows you to
-
-00:01:11.360 --> 00:01:15.360
-generate html files out of text files
-
-00:01:15.360 --> 00:01:17.439
-containing basically two types of
-
-00:01:17.439 --> 00:01:19.280
-information metadata
-
-00:01:19.280 --> 00:01:23.119
-and content metadata is let's say a
-
-00:01:23.119 --> 00:01:26.159
-set of key pairs describing the the
-
-00:01:26.159 --> 00:01:28.560
-content of the file such as the title
-
-00:01:28.560 --> 00:01:30.000
-author
-
-00:01:30.000 --> 00:01:31.759
-tags and so on and so forth and the
-
-00:01:31.759 --> 00:01:34.560
-content is what you actually want to to
-
-00:01:34.560 --> 00:01:37.040
-get published on the on the internet in
-
-00:01:37.040 --> 00:01:38.880
-the html file
-
-00:01:38.880 --> 00:01:41.439
-and usually the content is written in
-
-00:01:41.439 --> 00:01:44.560
-some kind of
-
-00:01:44.560 --> 00:01:47.520
-markup language such as markdown or
-
-00:01:47.520 --> 00:01:49.759
-possibly
-
-00:01:49.759 --> 00:01:53.200
-org mode and well jackie is a very
-
-00:01:53.200 --> 00:01:55.759
-popular website uh
-
-00:01:55.759 --> 00:01:58.719
-a static website generator it is written
-
-00:01:58.719 --> 00:01:59.840
-in a ruby
-
-00:01:59.840 --> 00:02:03.280
-and what it does it it it systematically
-
-00:02:03.280 --> 00:02:06.840
-let's say transforms all the input files
-
-00:02:06.840 --> 00:02:09.440
-by making the content into
-
-00:02:09.440 --> 00:02:11.599
-html and systematically applying a
-
-00:02:11.599 --> 00:02:14.000
-template in order to generate the
-
-00:02:14.000 --> 00:02:17.120
-html files which you can then deploy
-
-00:02:17.120 --> 00:02:19.840
-on your server of choice to make them
-
-00:02:19.840 --> 00:02:22.160
-available on the on the internet
-
-00:02:22.160 --> 00:02:26.160
-and one of the features uh most
-
-00:02:26.160 --> 00:02:28.480
-well I would say all static website
-
-00:02:28.480 --> 00:02:30.239
-generators have
-
-00:02:30.239 --> 00:02:32.560
-is a debt of being able to let's say
-
-00:02:32.560 --> 00:02:34.879
-collect the metadata information
-
-00:02:34.879 --> 00:02:38.400
-uh of the files being part of your of
-
-00:02:38.400 --> 00:02:39.440
-your project
-
-00:02:39.440 --> 00:02:45.280
-and the reason they do that is because
-
-00:02:45.280 --> 00:02:47.840
-you sometimes want to generate pages
-
-00:02:47.840 --> 00:02:49.280
-based on the content
-
-00:02:49.280 --> 00:02:53.200
-of your um of your projects
-
-00:02:53.200 --> 00:02:56.239
-such as for instance the the list of
-
-00:02:56.239 --> 00:02:59.040
-posts you have recently published or
-
-00:02:59.040 --> 00:03:00.400
-maybe the list of tags
-
-00:03:00.400 --> 00:03:03.840
-uh you uh have defined for your post and
-
-00:03:03.840 --> 00:03:07.280
-so on and so forth so so
-
-00:03:07.280 --> 00:03:09.760
-dracula gives the possibility of
-
-00:03:09.760 --> 00:03:12.400
-generating this kind of dynamic
-
-00:03:12.400 --> 00:03:15.760
-content by using liquid which is a
-
-00:03:15.760 --> 00:03:18.800
-templating language which
-
-00:03:18.800 --> 00:03:21.840
-looks like these
-
-00:03:21.840 --> 00:03:24.879
-so basically you you have all the
-
-00:03:24.879 --> 00:03:26.879
-constructs you can
-
-00:03:26.879 --> 00:03:29.120
-expect in a programming language this
-
-00:03:29.120 --> 00:03:29.920
-for instance
-
-00:03:29.920 --> 00:03:33.360
-is a fourth cycle which
-
-00:03:33.360 --> 00:03:37.440
-iterates over all the post or the
-
-00:03:37.440 --> 00:03:39.599
-files in a specific directory of the
-
-00:03:39.599 --> 00:03:41.040
-jacket project
-
-00:03:41.040 --> 00:03:45.040
-and for each post it takes the the title
-
-00:03:45.040 --> 00:03:48.400
-and the url and generates a link
-
-00:03:48.400 --> 00:03:51.840
-okay so dracule is
-
-00:03:51.840 --> 00:03:55.200
-nice and sweet but over the years
-
-00:03:55.200 --> 00:03:57.760
-I started using more and more
-
-00:03:57.760 --> 00:03:59.519
-systematically
-
-00:03:59.519 --> 00:04:02.959
-or mode to write all my files and I
-
-00:04:02.959 --> 00:04:05.439
-moved from markdown to word mode I am a
-
-00:04:05.439 --> 00:04:07.439
-long time Emacs user so I've been using
-
-00:04:07.439 --> 00:04:09.680
-imax for 30 years now so
-
-00:04:09.680 --> 00:04:12.799
-or mode is a more recent discovery
-
-00:04:12.799 --> 00:04:15.280
-but it is a very nice uh let's say
-
-00:04:15.280 --> 00:04:16.239
-discovery I
-
-00:04:16.239 --> 00:04:19.680
-I made and the reason I like org mode
-
-00:04:19.680 --> 00:04:22.320
-is because for instance you can write
-
-00:04:22.320 --> 00:04:23.600
-formulas using
-
-00:04:23.600 --> 00:04:26.639
-mac jacks and you can generate diagrams
-
-00:04:26.639 --> 00:04:30.320
-or plots with new plots and
-
-00:04:30.320 --> 00:04:32.240
-also important is the fact that you have
-
-00:04:32.240 --> 00:04:34.080
-the possibility of let's say publishing
-
-00:04:34.080 --> 00:04:35.919
-your documents
-
-00:04:35.919 --> 00:04:39.520
-to multiple ends backhands such as pdf
-
-00:04:39.520 --> 00:04:40.400
-or
-
-00:04:40.400 --> 00:04:43.600
-maybe a review presentations or
-
-00:04:43.600 --> 00:04:47.199
-or html and this is all made possible
-
-00:04:47.199 --> 00:04:50.479
-by bubble which is
-
-00:04:50.479 --> 00:04:52.560
-exactly what we just saw in the the
-
-00:04:52.560 --> 00:04:54.639
-previous talk
-
-00:04:54.639 --> 00:04:57.440
-namely the possibility of executing a
-
-00:04:57.440 --> 00:04:59.520
-snippet of code
-
-00:04:59.520 --> 00:05:02.560
-embedded in in your pages
-
-00:05:02.560 --> 00:05:06.400
-um and our model can also be used
-
-00:05:06.400 --> 00:05:09.600
-within let's say jackie and in fact
-
-00:05:09.600 --> 00:05:10.720
-there is a
-
-00:05:10.720 --> 00:05:15.199
-a nice gem a nice library called jackie
-
-00:05:15.199 --> 00:05:18.880
-org which allows you to use org modifies
-
-00:05:18.880 --> 00:05:19.680
-directly
-
-00:05:19.680 --> 00:05:22.880
-into jekyll but when you start using
-
-00:05:22.880 --> 00:05:26.560
-org mode when I started using
-
-00:05:26.560 --> 00:05:30.560
-mode I realized I could move
-
-00:05:30.560 --> 00:05:34.240
-all my workflow to or my publishing
-
-00:05:34.240 --> 00:05:36.840
-workflow to image
-
-00:05:36.840 --> 00:05:39.520
-and and and in fact
-
-00:05:39.520 --> 00:05:41.600
-org mode is also static website
-
-00:05:41.600 --> 00:05:42.880
-generator because
-
-00:05:42.880 --> 00:05:46.240
-it has got the possibility of publishing
-
-00:05:46.240 --> 00:05:50.880
-um projects made of org mode files
-
-00:05:50.880 --> 00:05:53.840
-and one of the nice things about let's
-
-00:05:53.840 --> 00:05:55.759
-say that the publishing features of work
-
-00:05:55.759 --> 00:05:56.479
-mode
-
-00:05:56.479 --> 00:05:58.880
-is that it allows you to define in the
-
-00:05:58.880 --> 00:05:59.840
-org publish
-
-00:05:59.840 --> 00:06:03.199
-project a list of the components
-
-00:06:03.199 --> 00:06:06.479
-which are part of your project and in a
-
-00:06:06.479 --> 00:06:07.520
-sense it is
-
-00:06:07.520 --> 00:06:10.479
-also more flexible than jackie lee's
-
-00:06:10.479 --> 00:06:12.400
-because it also allows you for instance
-
-00:06:12.400 --> 00:06:12.880
-to
-
-00:06:12.880 --> 00:06:15.120
-let's say publish a single file rather
-
-00:06:15.120 --> 00:06:17.440
-than having to recompile everything
-
-00:06:17.440 --> 00:06:20.080
-every time you want to publish your
-
-00:06:20.080 --> 00:06:23.919
-your project to your website however
-
-00:06:23.919 --> 00:06:25.840
-there are some short comments I would
-
-00:06:25.840 --> 00:06:27.120
-say or some some
-
-00:06:27.120 --> 00:06:29.520
-areas of improvement improvement let me
-
-00:06:29.520 --> 00:06:30.400
-say
-
-00:06:30.400 --> 00:06:32.720
-the first is that let's say support for
-
-00:06:32.720 --> 00:06:33.600
-templating
-
-00:06:33.600 --> 00:06:36.639
-is not so obvious as it is let's say
-
-00:06:36.639 --> 00:06:39.280
-in jackie or even though there are some
-
-00:06:39.280 --> 00:06:40.560
-let's say
-
-00:06:40.560 --> 00:06:44.560
-nice extensions such as argo t html
-
-00:06:44.560 --> 00:06:46.160
-for instance which allows you to use
-
-00:06:46.160 --> 00:06:48.400
-templates and
-
-00:06:48.400 --> 00:06:51.840
-more important to me was the fact that
-
-00:06:51.840 --> 00:06:54.080
-apparently there is little support for
-
-00:06:54.080 --> 00:06:55.520
-the creation of dynamic
-
-00:06:55.520 --> 00:06:58.240
-content so I was very curious and very
-
-00:06:58.240 --> 00:06:59.360
-keen to use
-
-00:06:59.360 --> 00:07:02.800
-or mode for let's say publishing my blog
-
-00:07:02.800 --> 00:07:05.440
-and my the the courses at the university
-
-00:07:05.440 --> 00:07:08.720
-but then uh I had to find a way
-
-00:07:08.720 --> 00:07:11.440
-to let's say being able to publish these
-
-00:07:11.440 --> 00:07:13.599
-dynamic pages finding some kind of
-
-00:07:13.599 --> 00:07:16.000
-replacement so to speak for uh the
-
-00:07:16.000 --> 00:07:16.720
-liquid
-
-00:07:16.720 --> 00:07:19.759
-the liquid engine and and the solution
-
-00:07:19.759 --> 00:07:20.160
-was
-
-00:07:20.160 --> 00:07:24.160
-that at hand actually because
-
-00:07:24.160 --> 00:07:27.280
-basically I realized I could use bubble
-
-00:07:27.280 --> 00:07:30.800
-for exactly this purpose so rather than
-
-00:07:30.800 --> 00:07:32.720
-using bubble for generating
-
-00:07:32.720 --> 00:07:35.759
-plots or let's say my other computation
-
-00:07:35.759 --> 00:07:37.919
-or whatever I was using them for
-
-00:07:37.919 --> 00:07:41.039
-I realized they could use bubble to
-
-00:07:41.039 --> 00:07:42.080
-generate
-
-00:07:42.080 --> 00:07:45.120
-html which could be let's say
-
-00:07:45.120 --> 00:07:48.960
-uh then published uh uh
-
-00:07:48.960 --> 00:07:52.720
-in the project so uh so all I needed to
-
-00:07:52.720 --> 00:07:53.680
-do then
-
-00:07:53.680 --> 00:07:56.240
-was defining some kind of functions some
-
-00:07:56.240 --> 00:07:58.319
-kind of code in order to read
-
-00:07:58.319 --> 00:08:01.840
-all the org mode uh the metadata of all
-
-00:08:01.840 --> 00:08:02.400
-the
-
-00:08:02.400 --> 00:08:05.759
-opmod files of my web project so that
-
-00:08:05.759 --> 00:08:09.680
-I could let's say then publish uh
-
-00:08:09.680 --> 00:08:13.280
-generate the dynamic content and
-
-00:08:13.280 --> 00:08:18.080
-this is a snippet taken from
-
-00:08:18.080 --> 00:08:21.759
-one of my html projects
-
-00:08:21.759 --> 00:08:24.800
-which basically shows the way in which
-
-00:08:24.800 --> 00:08:27.599
-I generate the um the list of posts on
-
-00:08:27.599 --> 00:08:29.360
-my on my page it is uh
-
-00:08:29.360 --> 00:08:32.560
-exactly how the the liquid that we saw
-
-00:08:32.560 --> 00:08:34.320
-in a couple of a couple of slides
-
-00:08:34.320 --> 00:08:35.680
-earlier that looks like
-
-00:08:35.680 --> 00:08:39.200
-uh in inner mode
-
-00:08:39.200 --> 00:08:42.320
-and basically what I'm doing I'm using I
-
-00:08:42.320 --> 00:08:46.720
-wrote a ruby script which
-
-00:08:46.720 --> 00:08:49.680
-reads all the metadata so this uh
-
-00:08:49.680 --> 00:08:51.040
-highlighted code
-
-00:08:51.040 --> 00:08:53.440
-basically loads the script which is
-
-00:08:53.440 --> 00:08:54.240
-stored
-
-00:08:54.240 --> 00:08:56.800
-externally and then it collects all the
-
-00:08:56.800 --> 00:08:58.320
-metadata from the
-
-00:08:58.320 --> 00:09:00.880
-org mode files in the current uh in the
-
-00:09:00.880 --> 00:09:02.240
-current directory
-
-00:09:02.240 --> 00:09:04.800
-and then the the following the the code
-
-00:09:04.800 --> 00:09:06.480
-you can see here
-
-00:09:06.480 --> 00:09:09.839
-basically iterate over all the
-
-00:09:09.839 --> 00:09:12.959
-past red the at the previous step
-
-00:09:12.959 --> 00:09:16.399
-and it generates um
-
-00:09:16.399 --> 00:09:19.519
-a list with the title and uh
-
-00:09:19.519 --> 00:09:22.959
-and the urls and so basically
-
-00:09:22.959 --> 00:09:27.440
-replicating what jackie does so
-
-00:09:27.440 --> 00:09:30.240
-okay so there are some some other things
-
-00:09:30.240 --> 00:09:32.399
-I have to to deal with in order to let's
-
-00:09:32.399 --> 00:09:33.200
-say
-
-00:09:33.200 --> 00:09:36.480
-accommodate my workflow and but that was
-
-00:09:36.480 --> 00:09:39.200
-relatively easy in the sense that one of
-
-00:09:39.200 --> 00:09:40.240
-the
-
-00:09:40.240 --> 00:09:43.279
-uh problem one of the issue I had to
-
-00:09:43.279 --> 00:09:45.360
-solve was that of let's say having
-
-00:09:45.360 --> 00:09:48.480
-a common navigation on all my
-
-00:09:48.480 --> 00:09:51.040
-pages uh but that was easily solved
-
-00:09:51.040 --> 00:09:51.920
-using
-
-00:09:51.920 --> 00:09:54.959
-uh the include feature so I basically
-
-00:09:54.959 --> 00:09:56.000
-made available
-
-00:09:56.000 --> 00:09:57.839
-and include with all the navigation
-
-00:09:57.839 --> 00:10:00.560
-which is uh embedded in all the pages of
-
-00:10:00.560 --> 00:10:01.839
-my websites
-
-00:10:01.839 --> 00:10:04.959
-uh through the could include and another
-
-00:10:04.959 --> 00:10:06.160
-nice feature which
-
-00:10:06.160 --> 00:10:08.560
-jackie las is the possibility of
-
-00:10:08.560 --> 00:10:09.760
-previewing
-
-00:10:09.760 --> 00:10:12.800
-a website before deploying it and but
-
-00:10:12.800 --> 00:10:13.200
-then
-
-00:10:13.200 --> 00:10:16.079
-Emacs also has got a node which allows
-
-00:10:16.079 --> 00:10:17.839
-you to
-
-00:10:17.839 --> 00:10:21.200
-launch a web server and in fact
-
-00:10:21.200 --> 00:10:24.320
-I wrote a quick ack
-
-00:10:24.320 --> 00:10:26.959
-which allows you to which allows to
-
-00:10:26.959 --> 00:10:28.000
-basically
-
-00:10:28.000 --> 00:10:31.519
-invoke a node on a on our
-
-00:10:31.519 --> 00:10:34.720
-mode project and start a local preview
-
-00:10:34.720 --> 00:10:37.920
-and then use rsync
-
-00:10:37.920 --> 00:10:44.839
-in order to deploy the the website
-
-00:10:44.839 --> 00:10:46.240
-um
-
-00:10:46.240 --> 00:10:48.720
-five minutes left okay okay more than
-
-00:10:48.720 --> 00:10:51.200
-enough okay
-
-00:10:51.200 --> 00:10:53.200
-thanks thank you thank you very much I'm
-
-00:10:53.200 --> 00:10:55.440
-nearly done so then I can take some some
-
-00:10:55.440 --> 00:10:56.480
-questions
-
-00:10:56.480 --> 00:11:00.560
-so okay just to give you maybe
-
-00:11:00.560 --> 00:11:03.680
-a slightly more in-depth uh
-
-00:11:03.680 --> 00:11:06.480
-view of what the pages look like so
-
-00:11:06.480 --> 00:11:07.200
-these are
-
-00:11:07.200 --> 00:11:11.120
-one of the pages or the source files
-
-00:11:11.120 --> 00:11:14.720
-of one of the websites it is
-
-00:11:14.720 --> 00:11:18.480
-in literate programming so basically uh
-
-00:11:18.480 --> 00:11:20.399
-you see there is some metadata here I
-
-00:11:20.399 --> 00:11:22.640
-mean this is a regular old mod file
-
-00:11:22.640 --> 00:11:26.640
-and this part here
-
-00:11:26.640 --> 00:11:29.920
-basically defines some common options
-
-00:11:29.920 --> 00:11:31.519
-for publication
-
-00:11:31.519 --> 00:11:35.920
-and these two includes here
-
-00:11:35.920 --> 00:11:41.120
-put some extra html in the head part and
-
-00:11:41.120 --> 00:11:44.480
-the navigation and here as you can see
-
-00:11:44.480 --> 00:11:48.079
-is the code generating the
-
-00:11:48.079 --> 00:11:50.160
-the list in chronological order it is
-
-00:11:50.160 --> 00:11:52.240
-slightly more complex than the example I
-
-00:11:52.240 --> 00:11:53.839
-made in the slide
-
-00:11:53.839 --> 00:11:56.240
-because uh there is some more
-
-00:11:56.240 --> 00:11:57.839
-elaboration to
-
-00:11:57.839 --> 00:11:59.760
-uh to do including putting some
-
-00:11:59.760 --> 00:12:01.839
-javascript to identify
-
-00:12:01.839 --> 00:12:05.120
-according to let's say the the tags
-
-00:12:05.120 --> 00:12:08.160
-so to go back to the to the presentation
-
-00:12:08.160 --> 00:12:11.200
-um so the okay so
-
-00:12:11.200 --> 00:12:13.600
-I I managed this migration uh a few
-
-00:12:13.600 --> 00:12:14.560
-months ago
-
-00:12:14.560 --> 00:12:17.680
-and then uh all my workflow is within
-
-00:12:17.680 --> 00:12:20.399
-with old mode and within imax and um
-
-00:12:20.399 --> 00:12:23.079
-I'm very happy with it because it's
-
-00:12:23.079 --> 00:12:24.240
-simplified
-
-00:12:24.240 --> 00:12:26.800
-uh quite a bit let's say my public
-
-00:12:26.800 --> 00:12:28.480
-publication process
-
-00:12:28.480 --> 00:12:31.839
-and uh one of the advantages so another
-
-00:12:31.839 --> 00:12:34.240
-advantage so the first advantage is that
-
-00:12:34.240 --> 00:12:36.959
-everything is in ork mode and dmax
-
-00:12:36.959 --> 00:12:38.160
-second advantage
-
-00:12:38.160 --> 00:12:41.680
-is that everything is based on the
-
-00:12:41.680 --> 00:12:44.880
-standard machinery provided by orb mode
-
-00:12:44.880 --> 00:12:47.760
-so in a sense it is kind of let's say
-
-00:12:47.760 --> 00:12:50.079
-more robust with respect to
-
-00:12:50.079 --> 00:12:53.040
-dependencies and possible errors and so
-
-00:12:53.040 --> 00:12:54.320
-on and so forth
-
-00:12:54.320 --> 00:12:56.639
-and um and the fact that the old mode
-
-00:12:56.639 --> 00:12:58.240
-allows you to publish
-
-00:12:58.240 --> 00:13:00.880
-a single file in a project is is also
-
-00:13:00.880 --> 00:13:03.839
-very interesting because
-
-00:13:03.839 --> 00:13:07.839
-it allows to let's say be more robust to
-
-00:13:07.839 --> 00:13:11.040
-problems you might introduce when
-
-00:13:11.040 --> 00:13:14.079
-you're changing when I'm changing the
-
-00:13:14.079 --> 00:13:14.959
-setup
-
-00:13:14.959 --> 00:13:16.880
-and another interesting thing which I
-
-00:13:16.880 --> 00:13:18.320
-realized that I
-
-00:13:18.320 --> 00:13:21.519
-uh I could have is that
-
-00:13:21.519 --> 00:13:23.600
-in a sense the specification of the
-
-00:13:23.600 --> 00:13:24.880
-website
-
-00:13:24.880 --> 00:13:27.360
-is uh can be embedded in the website
-
-00:13:27.360 --> 00:13:28.480
-itself
-
-00:13:28.480 --> 00:13:30.800
-so in a sense this is some kind of let's
-
-00:13:30.800 --> 00:13:31.839
-say self
-
-00:13:31.839 --> 00:13:35.120
-the command it's a real set documenting
-
-00:13:35.120 --> 00:13:37.200
-uh what I'm actually doing so for
-
-00:13:37.200 --> 00:13:38.560
-instance
-
-00:13:38.560 --> 00:13:43.199
-uh here on my
-
-00:13:43.199 --> 00:13:46.399
-website you can see let's say the
-
-00:13:46.399 --> 00:13:48.240
-specification of the
-
-00:13:48.240 --> 00:13:51.519
-of the of the project which is uh loaded
-
-00:13:51.519 --> 00:13:52.320
-from my
-
-00:13:52.320 --> 00:13:55.519
-initialization file but then it is also
-
-00:13:55.519 --> 00:13:56.320
-published
-
-00:13:56.320 --> 00:13:59.440
-together with my home page and it leaves
-
-00:13:59.440 --> 00:14:01.360
-with the repository where
-
-00:14:01.360 --> 00:14:05.360
-I keep all the sources of my website
-
-00:14:05.360 --> 00:14:08.079
-which is kind of nice because it
-
-00:14:08.079 --> 00:14:09.839
-basically isolates
-
-00:14:09.839 --> 00:14:14.079
-everything in a single in a single place
-
-00:14:14.079 --> 00:14:16.880
-okay so there are some examples I'm
-
-00:14:16.880 --> 00:14:18.000
-showing them
-
-00:14:18.000 --> 00:14:20.320
-more because of the let's say source
-
-00:14:20.320 --> 00:14:21.760
-code which
-
-00:14:21.760 --> 00:14:25.519
-you can grab from the git repositories
-
-00:14:25.519 --> 00:14:26.160
-if you are
-
-00:14:26.160 --> 00:14:28.399
-interested of course I'm also available
-
-00:14:28.399 --> 00:14:30.079
-to provide some
-
-00:14:30.079 --> 00:14:32.959
-support and help if you are interested
-
-00:14:32.959 --> 00:14:34.480
-in this kind of stuff
-
-00:14:34.480 --> 00:14:37.760
-the the next step for me will be that of
-
-00:14:37.760 --> 00:14:38.560
-let's say trying
-
-00:14:38.560 --> 00:14:41.600
-making this kind of machinery available
-
-00:14:41.600 --> 00:14:45.199
-for more general use at the moment
-
-00:14:45.199 --> 00:14:47.120
-if you are interested in trying out my
-
-00:14:47.120 --> 00:14:48.800
-suggestion is let's say grabbing the
-
-00:14:48.800 --> 00:14:49.839
-sources
-
-00:14:49.839 --> 00:14:52.959
-or one of the let's say websites to see
-
-00:14:52.959 --> 00:14:56.000
-what how they look like and maybe try
-
-00:14:56.000 --> 00:14:56.720
-and
-
-00:14:56.720 --> 00:15:00.160
-customize it for your purposes
-
-00:15:00.160 --> 00:15:02.720
-and this is basically the content of my
-
-00:15:02.720 --> 00:15:03.839
-talk so
-
-00:15:03.839 --> 00:15:06.959
-I'm open to two questions and thank you
-
-00:15:06.959 --> 00:15:07.279
-for
-
-00:15:07.279 --> 00:15:10.880
-your attention you are now unmuted uh
-
-00:15:10.880 --> 00:15:12.880
-thank you very much adolfo for your
-
-00:15:12.880 --> 00:15:14.480
-awesome presentation
-
-00:15:14.480 --> 00:15:17.360
-um I think we have time for maybe like
-
-00:15:17.360 --> 00:15:19.360
-one or two questions
-
-00:15:19.360 --> 00:15:21.279
-um and then the rest maybe you could
-
-00:15:21.279 --> 00:15:22.880
-take up um
-
-00:15:22.880 --> 00:15:26.639
-after the stream after sure
-
-00:15:26.639 --> 00:15:30.000
-uh I we should do um would you like me
-
-00:15:30.000 --> 00:15:31.839
-to read you the questions
-
-00:15:31.839 --> 00:15:35.199
-uh yeah probably better because
-
-00:15:35.199 --> 00:15:40.399
-I kind of lost there okay no problem um
-
-00:15:40.399 --> 00:15:42.480
-okay so someone asks do you have any
-
-00:15:42.480 --> 00:15:45.440
-opinion on fern
-
-00:15:45.440 --> 00:15:48.639
-fan I I don't know fans
-
-00:15:48.639 --> 00:15:51.839
-so I'll give it a try and uh and uh
-
-00:15:51.839 --> 00:15:55.040
-and check it out okay
-
-00:15:55.040 --> 00:15:57.839
-thanks and um people are also asking do
-
-00:15:57.839 --> 00:15:59.680
-you discuss this for example in a blog
-
-00:15:59.680 --> 00:16:01.279
-or anywhere else they could find more
-
-00:16:01.279 --> 00:16:02.800
-about it
-
-00:16:02.800 --> 00:16:05.600
-oh yes I'm going to publish the let's
-
-00:16:05.600 --> 00:16:08.560
-say the talk and the content on the
-
-00:16:08.560 --> 00:16:11.120
-on my website and then I'll link it from
-
-00:16:11.120 --> 00:16:12.320
-the max conf
-
-00:16:12.320 --> 00:16:14.720
-conference so that it will be easier for
-
-00:16:14.720 --> 00:16:15.680
-people to
-
-00:16:15.680 --> 00:16:19.040
-to reach it so I will shortly make it
-
-00:16:19.040 --> 00:16:22.880
-available right after the conference
-
-00:16:22.880 --> 00:16:25.440
-wonderful and I think that's all for the
-
-00:16:25.440 --> 00:16:26.160
-questions
-
-00:16:26.160 --> 00:16:28.560
-thank you very much okay thank you very
-
-00:16:28.560 --> 00:16:29.600
-much thank you
-
-00:16:29.600 --> 00:16:34.800
-and cheers bye cheers bye
diff --git a/2020/subtitles/emacsconf-2020--15-moving-from-jekyll-to-orgmode-an-experience-report--adolfo-villafiorita.vtt b/2020/subtitles/emacsconf-2020--15-moving-from-jekyll-to-orgmode-an-experience-report--adolfo-villafiorita.vtt
new file mode 100644
index 00000000..5d0b0b57
--- /dev/null
+++ b/2020/subtitles/emacsconf-2020--15-moving-from-jekyll-to-orgmode-an-experience-report--adolfo-villafiorita.vtt
@@ -0,0 +1,1057 @@
+WEBVTT
+
+00:00:00.080 --> 00:00:03.120
+Adolfo: Okay, excellent.
+
+00:00:03.120 --> 00:00:06.960
+Hello, everyone and
+
+00:00:06.960 --> 00:00:10.080
+nice meeting you. Let me
+
+00:00:10.080 --> 00:00:12.400
+thank the the organizer for all the
+
+00:00:12.400 --> 00:00:13.920
+organization and all the work they are
+
+00:00:13.920 --> 00:00:15.200
+doing to support us.
+
+00:00:15.200 --> 00:00:18.400
+My name is Adolfo Villafiorita.
+
+00:00:18.400 --> 00:00:20.733
+I'm teaching at the University of
+Trento.
+
+00:00:20.733 --> 00:00:24.480
+I will shortly be working at
+
+00:00:24.480 --> 00:00:26.240
+shared.tech, which is
+
+00:00:26.240 --> 00:00:29.359
+a non-profit organization developing
+
+00:00:29.359 --> 00:00:30.530
+applications to
+
+00:00:32.399 --> 00:00:35.680
+recover surplus food.
+
+00:00:35.680 --> 00:00:38.600
+The reason of the talk today
+
+00:00:38.600 --> 00:00:40.079
+and the reason I'm here today
+
+00:00:40.079 --> 00:00:42.719
+is to talk about my experience in moving
+
+00:00:42.719 --> 00:00:47.200
+from Jekyll static website generator to
+Org Mode.
+
+00:00:47.200 --> 00:00:50.700
+The reason I moved to Org Mode
+
+00:00:50.700 --> 00:00:53.100
+is to have better support for
+
+00:00:53.100 --> 00:00:56.800
+literate programming on the websites
+
+00:00:56.800 --> 00:00:58.399
+at the University of Trento, where we
+
+00:00:58.399 --> 00:01:00.480
+make available the content for the
+
+00:01:00.480 --> 00:01:04.720
+the students.
+
+00:01:04.720 --> 00:01:08.900
+First of all, what is a static
+website generator?
+
+00:01:08.900 --> 00:01:10.080
+It is basically a tool which
+
+00:01:10.080 --> 00:01:11.360
+allows you to
+
+00:01:11.360 --> 00:01:15.360
+generate HTML files out of text files
+
+00:01:15.360 --> 00:01:17.439
+containing basically two types of
+
+00:01:17.439 --> 00:01:20.700
+information: metadata and content.
+
+00:01:20.700 --> 00:01:23.119
+Metadata is a
+
+00:01:23.119 --> 00:01:26.159
+set of key pairs describing the
+
+00:01:26.159 --> 00:01:28.560
+content of the file, such as the title,
+
+00:01:28.560 --> 00:01:31.733
+author, tags, and so on and so forth.
+
+00:01:31.733 --> 00:01:34.560
+The content is what you actually
+want to
+
+00:01:34.560 --> 00:01:37.040
+get published on the Internet in
+
+00:01:37.040 --> 00:01:38.880
+the HTML file.
+
+00:01:38.880 --> 00:01:41.439
+Usually the content is written in
+
+00:01:41.439 --> 00:01:45.800
+some kind of markup language,
+
+00:01:45.800 --> 00:01:49.759
+such as Markdown or possibly
+
+00:01:49.759 --> 00:01:53.200
+Org Mode. Jekyll is a very
+
+00:01:53.200 --> 00:01:57.900
+popular static website generator.
+
+00:01:57.900 --> 00:01:59.840
+It is written in Ruby.
+
+00:01:59.840 --> 00:02:03.280
+What it does: it systematically
+
+00:02:03.280 --> 00:02:06.840
+transforms all the input files
+
+00:02:06.840 --> 00:02:09.440
+by making the content into
+
+00:02:09.440 --> 00:02:11.599
+HTML and systematically applying a
+
+00:02:11.599 --> 00:02:14.000
+template in order to generate the
+
+00:02:14.000 --> 00:02:17.120
+HTML files, which you can then deploy
+
+00:02:17.120 --> 00:02:19.840
+on your server of choice to make them
+
+00:02:19.840 --> 00:02:22.160
+available on the Internet.
+
+00:02:22.160 --> 00:02:26.160
+One of the features most--
+
+00:02:26.160 --> 00:02:27.500
+well, I would say all
+
+00:02:27.500 --> 00:02:30.239
+static website generators have
+
+00:02:30.239 --> 00:02:32.560
+is that of being able to
+
+00:02:32.560 --> 00:02:34.879
+collect the metadata information
+
+00:02:34.879 --> 00:02:38.400
+of the files being part of
+
+00:02:38.400 --> 00:02:39.440
+your project.
+
+00:02:39.440 --> 00:02:45.280
+The reason they do that is because
+
+00:02:45.280 --> 00:02:47.840
+you sometimes want to generate pages
+
+00:02:47.840 --> 00:02:49.280
+based on the content
+
+00:02:49.280 --> 00:02:53.200
+of your projects,
+
+00:02:53.200 --> 00:02:56.239
+such as, for instance, the list of
+
+00:02:56.239 --> 00:02:59.040
+posts you have recently published, or
+
+00:02:59.040 --> 00:03:00.400
+maybe the list of tags
+
+00:03:00.400 --> 00:03:03.840
+you have defined for your post,
+
+00:03:03.840 --> 00:03:07.280
+and so on and so forth.
+
+00:03:07.280 --> 00:03:09.760
+Jekyll gives the possibility of
+
+00:03:09.760 --> 00:03:12.400
+generating this kind of dynamic
+
+00:03:12.400 --> 00:03:14.400
+content by using Liquid,
+
+00:03:14.400 --> 00:03:18.800
+which is a templating language which
+
+00:03:18.800 --> 00:03:21.840
+looks like this.
+
+00:03:21.840 --> 00:03:24.879
+So basically, you have all the
+
+00:03:24.879 --> 00:03:26.879
+constructs you can
+
+00:03:26.879 --> 00:03:28.800
+expect in a programming language.
+
+00:03:28.800 --> 00:03:29.920
+This, for instance,
+
+00:03:29.920 --> 00:03:33.360
+is a for cycle which
+
+00:03:33.360 --> 00:03:37.440
+iterates over all the posts or the
+
+00:03:37.440 --> 00:03:39.599
+files in a specific directory of the
+
+00:03:39.599 --> 00:03:41.040
+Jekyll project.
+
+00:03:41.040 --> 00:03:45.040
+For each post, it takes the title
+
+00:03:45.040 --> 00:03:48.400
+and the URL and generates a link.
+
+00:03:48.400 --> 00:03:52.867
+So Jekyll is nice and sweet,
+
+00:03:52.867 --> 00:03:55.200
+but over the years
+
+00:03:55.200 --> 00:03:57.760
+I started using more and more
+
+00:03:57.760 --> 00:03:59.519
+systematically
+
+00:03:59.519 --> 00:04:02.000
+Org Mode to write all my files.
+
+00:04:02.000 --> 00:04:04.833
+I moved from Markdown to Org Mode
+
+00:04:04.833 --> 00:04:07.200
+I am a long time Emacs user.
+
+00:04:07.200 --> 00:04:09.167
+I've been using Emacs for 30 years now,
+
+00:04:09.167 --> 00:04:12.799
+so Org Mode is a more recent discovery,
+
+00:04:12.799 --> 00:04:17.033
+but it is a very nice discovery I made.
+
+00:04:17.033 --> 00:04:19.680
+The reason I like Org Mode
+
+00:04:19.680 --> 00:04:22.320
+is because, for instance, you can write
+
+00:04:22.320 --> 00:04:24.933
+formulas using MathJax
+
+00:04:24.933 --> 00:04:26.639
+and you can generate diagrams
+
+00:04:26.639 --> 00:04:30.320
+or plots with Gnuplot.
+
+00:04:30.320 --> 00:04:32.240
+Also important is the fact that you have
+
+00:04:32.240 --> 00:04:34.080
+the possibility of publishing
+
+00:04:34.080 --> 00:04:39.520
+your documents to multiple backends
+such as PDF,
+
+00:04:39.520 --> 00:04:43.600
+or maybe a Reveal presentation,
+
+00:04:43.600 --> 00:04:47.199
+or HTML. This is all made possible
+
+00:04:47.199 --> 00:04:50.479
+by Babel, which is
+
+00:04:50.479 --> 00:04:52.560
+exactly what we just saw in the
+
+00:04:52.560 --> 00:04:54.639
+previous talk:
+
+00:04:54.639 --> 00:04:57.440
+Namely, the possibility of executing a
+
+00:04:57.440 --> 00:04:59.520
+snippet of code
+
+00:04:59.520 --> 00:05:02.560
+embedded in in your pages.
+
+00:05:02.560 --> 00:05:06.400
+Our model can also be used
+
+00:05:06.400 --> 00:05:09.600
+within Jekyll. In fact,
+
+00:05:09.600 --> 00:05:13.667
+there is a a nice gem, a nice library,
+
+00:05:13.667 --> 00:05:17.233
+called jekyll-org which allows you
+
+00:05:17.233 --> 00:05:19.680
+to use Org Mode files directly
+
+00:05:19.680 --> 00:05:22.880
+into jekyll. But when you start using
+
+00:05:22.880 --> 00:05:26.560
+Org Mode... When I started using
+
+00:05:26.560 --> 00:05:30.560
+Org Mode, I realized I could move
+
+00:05:30.560 --> 00:05:34.240
+all my workflow, all my publishing
+
+00:05:34.240 --> 00:05:36.840
+workflow to Emacs.
+
+00:05:36.840 --> 00:05:41.100
+In fact, Org Mode is also a
+
+00:05:41.100 --> 00:05:42.880
+static website generator because
+
+00:05:42.880 --> 00:05:46.240
+it has got the possibility of publishing
+
+00:05:46.240 --> 00:05:50.880
+projects made of Org Mode files.
+
+00:05:50.880 --> 00:05:53.840
+One of the nice things about
+
+00:05:53.840 --> 00:05:56.479
+the publishing features of Org Mode
+
+00:05:56.479 --> 00:05:58.880
+is that it allows you to define in the
+
+00:05:58.880 --> 00:06:01.300
+org-publish-project-alist,
+
+00:06:01.300 --> 00:06:03.199
+all the the components
+
+00:06:03.199 --> 00:06:05.367
+which are part of your project.
+
+00:06:05.367 --> 00:06:07.520
+In a sense, it is
+
+00:06:07.520 --> 00:06:10.479
+also more flexible than Jekyll,
+
+00:06:10.479 --> 00:06:12.880
+because it also allows you, for instance,
+
+00:06:12.880 --> 00:06:15.120
+to publish a single file rather
+
+00:06:15.120 --> 00:06:17.440
+than having to recompile everything
+
+00:06:17.440 --> 00:06:20.080
+every time you want to publish your
+
+00:06:20.080 --> 00:06:22.333
+your project to your website.
+
+00:06:22.333 --> 00:06:25.333
+However, there are some short comments
+
+00:06:25.333 --> 00:06:29.520
+I would say, or some areas
+of improvement.
+
+00:06:30.400 --> 00:06:33.600
+The first is that support for
+templating
+
+00:06:33.600 --> 00:06:36.639
+is not so obvious as it is
+
+00:06:36.639 --> 00:06:39.280
+in Jekyll, even though there are some
+
+00:06:40.560 --> 00:06:44.560
+nice extensions such as org-thtml,
+
+00:06:44.560 --> 00:06:48.400
+for instance, which allows you to use
+templates.
+
+00:06:48.400 --> 00:06:51.840
+More important to me was the fact that
+
+00:06:51.840 --> 00:06:54.080
+apparently, there is little support for
+
+00:06:54.080 --> 00:06:56.133
+the creation of dynamic content
+
+00:06:56.133 --> 00:06:57.900
+So I was very curious
+
+00:06:57.900 --> 00:06:59.360
+and very keen to use
+
+00:06:59.360 --> 00:07:02.800
+Org Mode for publishing my blog
+
+00:07:02.800 --> 00:07:05.440
+and the courses at the university,
+
+00:07:05.440 --> 00:07:08.720
+but then I had to find a way
+
+00:07:08.720 --> 00:07:11.440
+to being able to publish these
+
+00:07:11.440 --> 00:07:13.599
+dynamic pages, finding some kind of
+
+00:07:13.599 --> 00:07:16.000
+replacement, so to speak,
+
+00:07:16.720 --> 00:07:17.900
+for the liquid engine.
+
+00:07:17.900 --> 00:07:24.160
+The solution was there at hand,
+actually, because
+
+00:07:24.160 --> 00:07:27.280
+basically, I realized I could use Babel
+
+00:07:27.280 --> 00:07:30.800
+for exactly this purpose. Rather than
+
+00:07:30.800 --> 00:07:32.720
+using Babel for generating
+
+00:07:32.720 --> 00:07:35.759
+plots or my other computations
+
+00:07:35.759 --> 00:07:37.919
+or whatever I was using them for,
+
+00:07:37.919 --> 00:07:41.039
+I realized I could use Babel to
+
+00:07:41.039 --> 00:07:45.120
+generate HTML which could be
+
+00:07:45.120 --> 00:07:49.967
+then published in the project
+
+00:07:49.967 --> 00:07:53.680
+All I needed to do then
+
+00:07:53.680 --> 00:07:56.100
+was defining some kind of functions,
+
+00:07:56.100 --> 00:07:58.319
+some kind of code in order to read
+
+00:07:58.319 --> 00:08:01.840
+the metadata of all
+
+00:08:01.840 --> 00:08:04.767
+the Org Mode files of my web project,
+
+00:08:04.767 --> 00:08:09.680
+so that I could then publish--
+
+00:08:09.680 --> 00:08:13.280
+generate the dynamic content.
+
+00:08:13.280 --> 00:08:18.080
+This is a snippet taken from
+
+00:08:18.080 --> 00:08:21.759
+one of my HTML projects,
+
+00:08:21.759 --> 00:08:24.800
+which basically shows the way in which
+
+00:08:24.800 --> 00:08:27.599
+I generate the list of posts on
+
+00:08:27.599 --> 00:08:32.560
+my page. It is exactly how the
+Liquid that we saw
+
+00:08:32.560 --> 00:08:35.680
+a couple of slides earlier that
+looks like
+
+00:08:35.680 --> 00:08:39.200
+in Org Mode.
+
+00:08:39.200 --> 00:08:42.320
+Basically, what I'm doing...
+I'm using...
+
+00:08:42.320 --> 00:08:46.720
+I wrote a Ruby script which
+
+00:08:46.720 --> 00:08:49.680
+reads all the metadata. So this
+
+00:08:49.680 --> 00:08:51.040
+highlighted code
+
+00:08:51.040 --> 00:08:53.100
+basically loads the script
+
+00:08:53.100 --> 00:08:55.300
+which is stored externally.
+
+00:08:55.300 --> 00:08:56.800
+Then it collects all the
+
+00:08:56.800 --> 00:08:58.320
+metadata from the
+
+00:08:58.320 --> 00:09:00.880
+Org Mode files in the
+
+00:09:00.880 --> 00:09:02.240
+current directory.
+
+00:09:02.240 --> 00:09:04.800
+And then the following... The code
+
+00:09:04.800 --> 00:09:06.480
+you can see here
+
+00:09:06.480 --> 00:09:09.839
+basically iterates over all the
+
+00:09:09.839 --> 00:09:12.959
+posts read at the previous step.
+
+00:09:12.959 --> 00:09:16.399
+It generates
+
+00:09:16.399 --> 00:09:19.519
+a list with the title
+
+00:09:19.519 --> 00:09:22.959
+and the URLS, basically
+
+00:09:22.959 --> 00:09:27.440
+replicating what Jekyll does.
+
+00:09:27.440 --> 00:09:30.240
+There are some other things
+
+00:09:30.240 --> 00:09:32.399
+I have to deal with in order to
+
+00:09:33.200 --> 00:09:36.480
+accommodate my workflow. But that was
+
+00:09:36.480 --> 00:09:39.200
+relatively easy in the sense that one of
+
+00:09:39.200 --> 00:09:43.279
+the problems, one of the issues I had to
+
+00:09:43.279 --> 00:09:45.360
+solve was that of having
+
+00:09:45.360 --> 00:09:48.480
+a common navigation on all my
+
+00:09:48.480 --> 00:09:51.040
+pages. That was easily solved
+
+00:09:51.040 --> 00:09:53.867
+using the #+INCLUDE feature.
+
+00:09:53.867 --> 00:09:54.959
+So I basically
+
+00:09:54.959 --> 00:09:56.000
+made available
+
+00:09:56.000 --> 00:09:57.839
+an #+INCLUDE with all the navigation
+
+00:09:57.839 --> 00:10:00.560
+which is embedded in all the pages of
+
+00:10:00.560 --> 00:10:01.839
+my websites
+
+00:10:01.839 --> 00:10:03.733
+through the #+INCLUDE.
+
+00:10:03.733 --> 00:10:06.160
+Another nice feature which
+
+00:10:06.160 --> 00:10:08.560
+Jekyll has is the possibility of
+
+00:10:08.560 --> 00:10:12.800
+previewing a website before deploying it.
+
+00:10:13.200 --> 00:10:16.079
+Emacs also has got a node which allows
+
+00:10:16.079 --> 00:10:21.200
+you to launch a web server. In fact,
+
+00:10:21.200 --> 00:10:24.320
+I wrote a quick hack
+
+00:10:24.320 --> 00:10:26.959
+which allows you to
+
+00:10:26.959 --> 00:10:31.519
+invoke a node on an Org Mode
+
+00:10:31.519 --> 00:10:34.720
+project, start a local preview,
+
+00:10:34.720 --> 00:10:37.920
+and then use rsync
+
+00:10:37.920 --> 00:10:44.839
+in order to deploy the the website.
+
+00:10:46.240 --> 00:10:48.720
+Five minutes left. More than
+
+00:10:48.720 --> 00:10:51.200
+enough. Okay.
+
+00:10:51.200 --> 00:10:52.967
+Thanks. Thank you, thank you very much.
+
+00:10:52.967 --> 00:10:56.480
+I'm nearly done. So then I can take
+some questions.
+
+00:10:56.480 --> 00:11:00.560
+Just to give you maybe
+
+00:11:00.560 --> 00:11:03.680
+a slightly more in-depth
+
+00:11:03.680 --> 00:11:06.480
+view of what the pages look like,
+
+00:11:06.480 --> 00:11:07.200
+so these are
+
+00:11:07.200 --> 00:11:11.120
+one of the pages, or the source files
+
+00:11:11.120 --> 00:11:14.720
+of one of the websites. It is
+
+00:11:14.720 --> 00:11:18.480
+in literate programming. Basically,
+
+00:11:18.480 --> 00:11:20.399
+you see there is some metadata here.
+
+00:11:20.399 --> 00:11:22.640
+I mean this is a regular Org Mode file.
+
+00:11:22.640 --> 00:11:26.640
+This part here
+
+00:11:26.640 --> 00:11:29.920
+basically defines some common options
+
+00:11:29.920 --> 00:11:31.519
+for publication.
+
+00:11:31.519 --> 00:11:35.920
+These two includes here
+
+00:11:35.920 --> 00:11:41.120
+put some extra HTML in the head part and
+
+00:11:41.120 --> 00:11:44.480
+the navigation. Here, as you can see,
+
+00:11:44.480 --> 00:11:48.079
+is the code generating the
+
+00:11:48.079 --> 00:11:50.160
+the list in chronological order. It is
+
+00:11:50.160 --> 00:11:52.240
+slightly more complex than the example I
+
+00:11:52.240 --> 00:11:53.839
+made in the slide
+
+00:11:53.839 --> 00:11:56.240
+because there is some more
+
+00:11:56.240 --> 00:11:59.760
+elaboration to do, including
+putting some
+
+00:11:59.760 --> 00:12:01.839
+Javascript to identify
+
+00:12:01.839 --> 00:12:05.120
+according to the tags.
+
+00:12:05.120 --> 00:12:08.160
+To go back to the presentation...
+
+00:12:11.200 --> 00:12:13.067
+I managed this migration
+
+00:12:13.067 --> 00:12:14.560
+a few months ago,
+
+00:12:14.560 --> 00:12:17.680
+and then all my workflow is within
+
+00:12:17.680 --> 00:12:20.399
+Org Mode and within Emacs.
+
+00:12:20.399 --> 00:12:23.079
+I'm very happy with it because it's
+
+00:12:23.079 --> 00:12:26.800
+simplified quite a bit
+
+00:12:26.800 --> 00:12:28.480
+my publication process.
+
+00:12:28.480 --> 00:12:31.839
+One of the advantages... Another
+
+00:12:31.839 --> 00:12:34.240
+advantage... So the first advantage is that
+
+00:12:34.240 --> 00:12:36.959
+everything is in Org Mode and Emacs.
+
+00:12:36.959 --> 00:12:38.160
+Second advantage
+
+00:12:38.160 --> 00:12:41.680
+is that everything is based on the
+
+00:12:41.680 --> 00:12:44.880
+standard machinery provided by Org Mode.
+
+00:12:44.880 --> 00:12:47.760
+So in a sense, it is
+
+00:12:47.760 --> 00:12:50.079
+more robust with respect to
+
+00:12:50.079 --> 00:12:53.040
+dependencies, possible errors, and so
+
+00:12:53.040 --> 00:12:54.320
+on and so forth.
+
+00:12:54.320 --> 00:12:56.639
+The fact that Org Mode
+
+00:12:56.639 --> 00:12:58.240
+allows you to publish
+
+00:12:58.240 --> 00:13:00.880
+a single file in a project is also
+
+00:13:00.880 --> 00:13:03.839
+very interesting because
+
+00:13:03.839 --> 00:13:07.839
+it allows to be more robust to
+
+00:13:07.839 --> 00:13:11.040
+problems you might introduce when
+
+00:13:11.040 --> 00:13:14.959
+you're changing--when I'm changing the
+setup.
+
+00:13:14.959 --> 00:13:16.880
+Another interesting thing which I
+
+00:13:16.880 --> 00:13:21.519
+realized that I could have is that
+
+00:13:21.519 --> 00:13:23.600
+in a sense, the specification of the
+
+00:13:23.600 --> 00:13:28.480
+website can be embedded in the website
+itself.
+
+00:13:28.480 --> 00:13:30.800
+In a sense this is some kind of
+
+00:13:30.800 --> 00:13:31.839
+self-documenting...
+
+00:13:31.839 --> 00:13:35.120
+It's a way of self-documenting
+
+00:13:35.120 --> 00:13:36.600
+what I'm actually doing.
+
+00:13:36.600 --> 00:13:44.133
+For instance, here on my website,
+
+00:13:44.133 --> 00:13:46.399
+you can see the
+
+00:13:46.399 --> 00:13:48.240
+specification of the
+
+00:13:48.240 --> 00:13:51.519
+project which is loaded
+
+00:13:51.519 --> 00:13:53.933
+from my initialization file,
+
+00:13:53.933 --> 00:13:56.320
+but then it is also published
+
+00:13:56.320 --> 00:13:59.440
+together with my home page. It lives
+
+00:13:59.440 --> 00:14:01.360
+with the repository where
+
+00:14:01.360 --> 00:14:05.360
+I keep all the sources of my website,
+
+00:14:05.360 --> 00:14:08.079
+which is kind of nice because it
+
+00:14:08.079 --> 00:14:09.839
+basically isolates
+
+00:14:09.839 --> 00:14:14.079
+everything in a single place.
+
+00:14:14.079 --> 00:14:16.880
+So there are some examples. I'm
+
+00:14:16.880 --> 00:14:19.433
+showing them more because of the
+
+00:14:19.433 --> 00:14:21.760
+source code which
+
+00:14:21.760 --> 00:14:25.519
+you can grab from the git repositories
+
+00:14:25.519 --> 00:14:26.933
+if you are interested.
+
+00:14:26.933 --> 00:14:28.399
+Of course I'm also available
+
+00:14:28.399 --> 00:14:31.600
+to provide some support and help
+
+00:14:31.600 --> 00:14:32.959
+if you are interested
+
+00:14:32.959 --> 00:14:34.480
+in this kind of stuff.
+
+00:14:34.480 --> 00:14:37.760
+The the next step for me will be that of
+
+00:14:37.760 --> 00:14:41.600
+trying, making this kind of
+machinery available
+
+00:14:41.600 --> 00:14:45.199
+for more general use at the moment.
+
+00:14:45.199 --> 00:14:47.120
+If you are interested in trying out my
+
+00:14:47.120 --> 00:14:48.800
+suggestion, grabbing the
+
+00:14:48.800 --> 00:14:51.933
+sources for one of the websites
+
+00:14:51.933 --> 00:14:54.700
+to seehow they look like,
+
+00:14:54.700 --> 00:14:56.720
+and maybe try and
+
+00:14:56.720 --> 00:15:00.160
+customize it for your purposes...
+
+00:15:00.160 --> 00:15:03.839
+This is basically the content of my talk.
+
+00:15:03.839 --> 00:15:06.959
+I'm open to questions and thank you
+
+00:15:06.959 --> 00:15:10.880
+for your attention.
+
+00:15:10.880 --> 00:15:12.880
+(Amin: Thank you very much, Adolfo, for your
+
+00:15:12.880 --> 00:15:14.480
+awesome presentation.
+
+00:15:14.480 --> 00:15:17.360
+I think we have time for maybe like
+
+00:15:17.360 --> 00:15:19.360
+one or two questions,
+
+00:15:19.360 --> 00:15:21.279
+and then the rest maybe you could
+
+00:15:21.279 --> 00:15:26.639
+take up after the stream.)
+
+00:15:26.639 --> 00:15:28.033
+Adolfo: What should we do?
+
+00:15:28.033 --> 00:15:30.000
+(Amin: Would you like me
+
+00:15:30.000 --> 00:15:31.839
+to read you the questions?)
+
+00:15:31.839 --> 00:15:35.199
+Adolfo: Yeah, probably better because
+
+00:15:35.199 --> 00:15:36.700
+I'm kind of lost there.
+
+00:15:36.700 --> 00:15:40.399
+(Amin: Okay, no problem.
+
+00:15:40.399 --> 00:15:42.480
+So someone asks, "Do you have any
+
+00:15:42.480 --> 00:15:45.440
+opinion on Firn?")
+
+00:15:45.440 --> 00:15:48.639
+Adolfo: Firn. I don't know Firn,
+
+00:15:48.639 --> 00:15:51.839
+so I'll give it a try
+
+00:15:51.839 --> 00:15:55.040
+and check it out.
+
+00:15:55.040 --> 00:15:57.839
+(Amin: Thanks. People are also asking,
+
+00:15:57.839 --> 00:15:59.680
+do you discuss this, for example, in a blog
+
+00:15:59.680 --> 00:16:01.279
+or anywhere else they could find more
+
+00:16:01.279 --> 00:16:02.800
+about it?)
+
+00:16:02.800 --> 00:16:05.600
+Adolfo: Oh yes. I'm going to publish the
+
+00:16:05.600 --> 00:16:08.560
+the talk and the content
+
+00:16:08.560 --> 00:16:11.120
+on my website, and then I'll link it from
+
+00:16:11.120 --> 00:16:13.067
+the EmacsConf conference
+
+00:16:13.067 --> 00:16:14.720
+so that it will be easier for
+
+00:16:14.720 --> 00:16:16.533
+people to to reach it
+
+00:16:16.533 --> 00:16:19.040
+I will shortly make it
+
+00:16:19.040 --> 00:16:22.880
+available right after the conference.
+
+00:16:22.880 --> 00:16:26.160
+(Amin: Wonderful. I think that's all
+for the questions.
+
+00:16:26.160 --> 00:16:27.667
+Thank you very much.)
+
+00:16:27.667 --> 00:16:29.600
+Adolfo: Thank you very much. Thank you.
+
+00:16:29.600 --> 00:16:34.800
+(Amin: Cheers.) Adolfo: Bye, cheers. (Amin: Bye.)