summaryrefslogtreecommitdiffstats
path: root/2021/captions
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--2021/captions/emacsconf-2021-babel--babel-for-academics--asilata-bapat--main.vtt802
1 files changed, 802 insertions, 0 deletions
diff --git a/2021/captions/emacsconf-2021-babel--babel-for-academics--asilata-bapat--main.vtt b/2021/captions/emacsconf-2021-babel--babel-for-academics--asilata-bapat--main.vtt
new file mode 100644
index 00000000..5b4a23c5
--- /dev/null
+++ b/2021/captions/emacsconf-2021-babel--babel-for-academics--asilata-bapat--main.vtt
@@ -0,0 +1,802 @@
+WEBVTT
+
+00:00.799 --> 00:02.560
+Hi! My name is Asilata Bapat,
+
+00:02.560 --> 00:04.960
+and I'm talking about Babel for academics.
+
+00:04.960 --> 00:06.879
+So, I'm an academic at a university,
+
+00:06.879 --> 00:09.040
+and I use Emacs, Org mode, and Babel
+
+00:09.040 --> 00:11.280
+for a whole bunch of work related tasks.
+
+00:11.280 --> 00:12.559
+And there are many other tools
+
+00:12.559 --> 00:14.240
+that one could use to help with
+
+00:14.240 --> 00:15.200
+this workflow.
+
+00:15.200 --> 00:16.597
+I won't be going through all of these,
+
+00:16.597 --> 00:18.160
+and the ones that I've listed are just
+
+00:18.160 --> 00:20.240
+a few of the many that are available.
+
+00:20.240 --> 00:22.000
+Today, I'll really be talking about
+
+00:22.000 --> 00:24.080
+my teaching workflow.
+
+00:24.080 --> 00:27.840
+Let's just dive right in to a demo.
+
+00:27.840 --> 00:29.243
+So, the first file that I want to
+
+00:29.243 --> 00:31.599
+show you is the notes and admin file.
+
+00:31.599 --> 00:33.040
+From this file, I'll generate
+
+00:33.040 --> 00:35.440
+a nice-looking PDF document of notes,
+
+00:35.440 --> 00:36.963
+and I'll also keep track of some
+
+00:36.963 --> 00:38.399
+course admin.
+
+00:38.399 --> 00:43.200
+So, the file that I have here is this one,
+
+00:43.200 --> 00:44.719
+and all of the files that I'm going to
+
+00:44.719 --> 00:46.320
+show you today are taken from a course
+
+00:46.320 --> 00:48.096
+that I'm teaching at the moment
+
+00:48.096 --> 00:49.680
+this semester.
+
+00:49.680 --> 00:53.147
+What I want to do is export this
+
+00:53.147 --> 00:55.520
+entire document to LaTeX
+
+00:55.520 --> 00:56.320
+because this is where
+
+00:56.320 --> 00:58.800
+I'll be writing my course notes.
+
+00:58.800 --> 01:00.480
+But before I do that,
+
+01:00.480 --> 01:03.199
+I have some setup that I want to do,
+
+01:03.199 --> 01:05.199
+and you'll notice some of these headings
+
+01:05.199 --> 01:06.509
+are tagged as noexport,
+
+01:06.509 --> 01:08.400
+and they won't be exported.
+
+01:08.400 --> 01:11.680
+The startup setting I'll skip,
+
+01:11.680 --> 01:13.499
+and then the main thing here
+
+01:13.499 --> 01:14.880
+is the LaTeX setup.
+
+01:14.880 --> 01:18.560
+So, I'm using these #+ option lines,
+
+01:18.560 --> 01:21.360
+and I've told Org that
+
+01:21.360 --> 01:23.280
+I want to use an unusual LaTeX class,
+
+01:23.280 --> 01:24.880
+I'll have to tell Org about it later,
+
+01:24.880 --> 01:26.240
+I'll do that in a moment,
+
+01:26.240 --> 01:27.001
+and I have some
+
+01:27.001 --> 01:29.600
+LaTeX header lines, and so on.
+
+01:29.600 --> 01:31.360
+And then I have some export settings,
+
+01:31.360 --> 01:32.941
+the first export setting is
+
+01:32.941 --> 01:35.119
+to export into a different directory,
+
+01:35.119 --> 01:36.799
+not just at the same level
+
+01:36.799 --> 01:38.560
+because I want everything to go into
+
+01:38.560 --> 01:39.716
+the artifacts directory,
+
+01:39.716 --> 01:41.360
+and then I can ignore that artifacts
+
+01:41.360 --> 01:44.399
+directory using Git.
+
+01:44.399 --> 01:45.600
+This is the first
+
+01:45.600 --> 01:47.280
+source code block that we see,
+
+01:47.280 --> 01:49.759
+which is the Babel side of things,
+
+01:49.759 --> 01:52.079
+and I've called it export-setup.
+
+01:52.079 --> 01:55.759
+The way I write it is, #+begin_src,
+
+01:55.759 --> 01:56.965
+the language that I want to use,
+
+01:56.965 --> 01:58.159
+which is emacs-lisp,
+
+01:58.159 --> 01:59.600
+and maybe some options,
+
+01:59.600 --> 02:01.119
+and this is collapsed at the moment,
+
+02:01.119 --> 02:03.600
+if I expand it, you'll see
+
+02:03.600 --> 02:05.155
+inside here, this is really
+
+02:05.155 --> 02:07.600
+just Elisp, Emacs Lisp.
+
+02:07.600 --> 02:09.592
+So, the first thing I've done is,
+
+02:09.592 --> 02:12.440
+I've added this LaTeX class
+
+02:12.440 --> 02:15.360
+to the list of known LaTeX classes.
+
+02:15.360 --> 02:17.433
+And the second thing I've done is,
+
+02:17.433 --> 02:19.599
+I have locally set the value of
+
+02:19.599 --> 02:21.112
+org-latex-pdf-process,
+
+02:21.112 --> 02:24.720
+which is the compiler, to something…,
+
+02:24.720 --> 02:27.200
+this command is complicated I guess,
+
+02:27.200 --> 02:29.440
+but what the main thing it's doing
+
+02:29.440 --> 02:32.160
+is that it's moving the generated output…,
+
+02:32.160 --> 02:34.160
+sorry, the generated image files
+
+02:34.160 --> 02:35.169
+to the output directory,
+
+02:35.169 --> 02:37.519
+so that everything can remain
+
+02:37.519 --> 02:39.680
+inside of this artifacts directory,
+
+02:39.680 --> 02:41.519
+and maybe it's doing some other things.
+
+02:41.519 --> 02:43.680
+And then there are some other
+
+02:43.680 --> 02:47.120
+setup options that I'll skip.
+
+02:47.120 --> 02:49.360
+So, this is a source code block,
+
+02:49.360 --> 02:50.640
+inside of the source code block
+
+02:50.640 --> 02:52.319
+everything is basically Emacs Lisp.
+
+02:52.319 --> 02:54.640
+How do I evaluate this?
+
+02:54.640 --> 02:56.319
+I just press Control c Control c (C-c C-c),
+
+02:56.319 --> 02:57.920
+and it evaluates everything,
+
+02:57.920 --> 03:00.319
+but if I want to automate the evaluation,
+
+03:00.319 --> 03:02.080
+there's one other thing I can do.
+
+03:02.080 --> 03:04.658
+So, let me jump down to
+
+03:04.658 --> 03:06.720
+the local variables section.
+
+03:06.720 --> 03:09.740
+In this local variable section
+
+03:09.740 --> 03:11.680
+I have an eval block,
+
+03:11.680 --> 03:14.681
+so, I've added a certain hook to the
+
+03:14.681 --> 03:16.879
+org-export-before-processing-hook,
+
+03:16.879 --> 03:18.319
+and that just resolves
+
+03:18.319 --> 03:19.519
+this reference from this file.
+
+03:19.519 --> 03:23.040
+It looks for a code block titled
+
+03:23.040 --> 03:24.859
+export-setup, and it runs it
+
+03:24.859 --> 03:26.000
+right before exporting,
+
+03:26.000 --> 03:29.200
+and this is all local to this buffer.
+
+03:29.200 --> 03:30.799
+So, before I export,
+
+03:30.799 --> 03:34.000
+it'll then read the correct options.
+
+03:34.000 --> 03:37.519
+And after this setup,
+
+03:37.519 --> 03:39.760
+I have the course plan,
+
+03:39.760 --> 03:41.599
+which is just what goes into my agenda
+
+03:41.599 --> 03:43.360
+as to-dos, I'll skip that.
+
+03:43.360 --> 03:45.519
+And after that, I have the actual notes,
+
+03:45.519 --> 03:48.640
+and what they actually look like…,
+
+03:48.640 --> 03:54.400
+so, this is what they actually look like,
+
+03:54.400 --> 03:57.040
+nicely LaTeXed with diagrams and so on,
+
+03:57.040 --> 03:57.920
+everything generated
+
+03:57.920 --> 04:00.720
+from that single Org file.
+
+04:00.720 --> 04:04.480
+I'll say more about diagrams later.
+
+04:04.480 --> 04:06.080
+I also have to write assignments
+
+04:06.080 --> 04:07.260
+and assignment solutions,
+
+04:07.260 --> 04:10.239
+so let me jump to that.
+
+04:10.239 --> 04:11.840
+Again, this is a very similar file,
+
+04:11.840 --> 04:14.080
+but I want to now export
+
+04:14.080 --> 04:15.760
+different headings to different files.
+
+04:15.760 --> 04:16.639
+This is not going to be
+
+04:16.639 --> 04:18.320
+exported all at once.
+
+04:18.320 --> 04:19.759
+So, again I have some setup,
+
+04:19.759 --> 04:22.400
+some general setup that I'll skip,
+
+04:22.400 --> 04:25.120
+export setup just like before,
+
+04:25.120 --> 04:29.280
+code setup for Python, really,
+
+04:29.280 --> 04:31.280
+I have a various…, a bunch of different
+
+04:31.280 --> 04:33.199
+languages here, so Shell and Python,
+
+04:33.199 --> 04:35.967
+and some helper functions.
+
+04:36.088 --> 04:38.160
+So, let me jump to this one called
+
+04:38.160 --> 04:39.756
+togglesolutions, this is again
+
+04:39.756 --> 04:41.919
+an Emacs Lisp code block.
+
+04:41.919 --> 04:43.600
+What this does is,
+
+04:43.600 --> 04:48.632
+it tells LaTeX to either toggle the
+
+04:48.632 --> 04:50.336
+display of solutions on, or off
+
+04:50.336 --> 04:53.096
+based on what the tag is
+
+04:53.096 --> 04:54.240
+for that particular assignment.
+
+04:54.240 --> 04:57.520
+So, whether if the assignment
+
+04:57.520 --> 04:58.800
+is tagged as solved,
+
+04:58.800 --> 05:00.240
+then the solution should be displayed,
+
+05:00.240 --> 05:03.280
+otherwise they shouldn't be.
+
+05:03.280 --> 05:05.447
+And here most of the assignments
+
+05:05.447 --> 05:07.120
+are tagged as solved,
+
+05:07.120 --> 05:08.880
+so in this case if I export this,
+
+05:08.880 --> 05:11.840
+the solutions will be displayed.
+
+05:11.840 --> 05:20.800
+Let's look at that.
+
+05:20.800 --> 05:23.919
+So, I see the solutions blocks,
+
+05:23.919 --> 05:27.036
+and this is because it's calling
+
+05:27.036 --> 05:29.919
+the toggle solutions piece of code.
+
+05:29.919 --> 05:32.240
+And the properties,
+
+05:32.240 --> 05:33.840
+if I expand this properties drawer,
+
+05:33.840 --> 05:39.280
+you see this output file name
+
+05:39.280 --> 05:41.440
+has a homework one dash solved,
+
+05:41.440 --> 05:43.360
+so it has a solved suffix,
+
+05:43.360 --> 05:45.912
+and this is related to the fact that
+
+05:45.912 --> 05:47.680
+I have a solved tag up here.
+
+05:47.680 --> 05:48.960
+So, let's see what happens
+
+05:48.960 --> 05:51.199
+if I delete the solved tag,
+
+05:51.199 --> 05:52.639
+so nothing's happened yet,
+
+05:52.639 --> 05:54.000
+but if I save the file,
+
+05:54.000 --> 05:55.919
+then suddenly this homework one
+
+05:55.919 --> 05:58.240
+dash solved becomes homework one,
+
+05:58.240 --> 06:00.080
+and this is desired behavior,
+
+06:00.080 --> 06:02.084
+this is what I want because
+
+06:02.084 --> 06:03.222
+I want to keep the solved
+
+06:03.222 --> 06:04.497
+and unsolved files separate.
+
+06:04.497 --> 06:07.120
+So, once again, if I put in
+
+06:07.120 --> 06:09.440
+the solved tag, and if I save,
+
+06:09.440 --> 06:11.440
+I get back the different file name.
+
+06:11.440 --> 06:12.720
+And how did I achieve this?
+
+06:12.720 --> 06:16.479
+This is again back in the setup section,
+
+06:16.479 --> 06:19.280
+it's the process-export-filenames block.
+
+06:19.280 --> 06:21.120
+It's some big piece of Elisp
+
+06:21.120 --> 06:22.349
+that I won't go through,
+
+06:22.349 --> 06:24.240
+but basically it's mapping over
+
+06:24.240 --> 06:26.720
+Org entries, and it's either
+
+06:26.720 --> 06:30.080
+adding or removing this solved suffix
+
+06:30.080 --> 06:34.560
+based on what tag it sees.
+
+06:34.560 --> 06:36.781
+Okay, when does this
+
+06:36.781 --> 06:37.919
+code block get evaluated?
+
+06:37.919 --> 06:39.840
+Well, I want it to be evaluated
+
+06:39.840 --> 06:41.039
+right before I save
+
+06:41.039 --> 06:43.199
+because I change something,
+
+06:43.199 --> 06:45.840
+I save, and I want the properties
+
+06:45.840 --> 06:49.199
+to be get updated accordingly.
+
+06:49.199 --> 06:51.364
+If I go down to the
+
+06:51.364 --> 06:52.639
+local variables section again.
+
+06:52.639 --> 06:55.840
+Again, I have a local variables
+
+06:55.840 --> 06:56.800
+section here,
+
+06:56.800 --> 06:58.479
+and I'm evaluating this Elisp,
+
+06:58.479 --> 07:01.199
+which is setting the before-save-hook
+
+07:01.199 --> 07:04.240
+to resolve the process-export-filenames
+
+07:04.240 --> 07:05.716
+function, and so that's what
+
+07:05.716 --> 07:09.199
+gives me that functionality.
+
+07:09.199 --> 07:12.720
+And finally,
+
+07:12.720 --> 07:16.240
+I have some skeletons, which are….
+
+07:16.240 --> 07:19.360
+Emacs has this skeleton language,
+
+07:19.360 --> 07:22.240
+which is a rudimentary templating language.
+
+07:22.240 --> 07:24.220
+So, I've defined some templates
+
+07:24.220 --> 07:26.319
+for my assignment and worksheet
+
+07:26.319 --> 07:29.440
+in this little Emacs Lisp block,
+
+07:29.440 --> 07:31.120
+which I think I usually just evaluate
+
+07:31.120 --> 07:33.280
+manually, and then if I just call it,
+
+07:33.280 --> 07:35.199
+I get a nice-looking skeleton
+
+07:35.199 --> 07:37.360
+that gives me this assignment.
+
+07:37.360 --> 07:40.080
+One thing I want to show you
+
+07:40.080 --> 07:43.199
+in these assignments, or I mean,
+
+07:43.199 --> 07:44.720
+in this file in particular,
+
+07:44.720 --> 07:46.560
+are these dot source code blocks.
+
+07:46.560 --> 07:49.840
+So, I've had to type in or draw in
+
+07:49.840 --> 07:52.000
+some graphs in this assignment,
+
+07:52.000 --> 07:54.720
+and I can do that right from Org.
+
+07:54.720 --> 07:56.400
+So, this is some piece of code
+
+07:56.400 --> 07:59.199
+that's creating a file,
+
+07:59.199 --> 08:00.879
+which has this name,
+
+08:00.879 --> 08:05.840
+and if I evaluate this block,
+
+08:05.840 --> 08:10.720
+I see a results drawer with this file.
+
+08:10.720 --> 08:12.711
+And this is a PNG file,
+
+08:12.711 --> 08:13.759
+which now gets embedded
+
+08:13.759 --> 08:15.680
+into my LaTeX document.
+
+08:15.680 --> 08:16.639
+So, this is nice,
+
+08:16.639 --> 08:18.720
+I can actually delete this from here,
+
+08:18.720 --> 08:20.479
+and when I export,
+
+08:20.479 --> 08:23.919
+the file will get attached automatically.
+
+08:23.919 --> 08:26.639
+And similarly,
+
+08:26.639 --> 08:28.800
+in some other assignments here,
+
+08:28.800 --> 08:30.639
+I have some Python source,
+
+08:30.639 --> 08:33.284
+so I've had to type in
+
+08:33.284 --> 08:34.527
+some complicated matrices,
+
+08:34.527 --> 08:36.128
+and some complicated matrix products,
+
+08:36.128 --> 08:36.640
+and so on,
+
+08:36.640 --> 08:38.000
+which I didn't want to do by hand,
+
+08:38.000 --> 08:39.760
+so that I didn't introduce errors,
+
+08:39.760 --> 08:41.599
+so I've written some Python code.
+
+08:41.599 --> 08:44.240
+If I Control c Control c (C-c C-c)
+
+08:44.240 --> 08:45.920
+on this block, you'll notice,
+
+08:45.920 --> 08:47.120
+it's in the session matrix,
+
+08:47.120 --> 08:49.200
+so it's using the previous,
+
+08:49.200 --> 08:52.399
+the same kind of session.
+
+08:52.399 --> 08:55.440
+And you'll see that the results,
+
+08:55.440 --> 08:57.760
+because of the way I chose to format them,
+
+08:57.760 --> 08:59.920
+look like a nice drawer with
+
+08:59.920 --> 09:01.600
+nicely formatted LaTeX.
+
+09:01.600 --> 09:03.920
+Once again these results
+
+09:03.920 --> 09:05.519
+I can cut from the file,
+
+09:05.519 --> 09:07.600
+and the file will get exported…,
+
+09:07.600 --> 09:09.200
+when the file gets exported,
+
+09:09.200 --> 09:10.480
+these source code blocks will get
+
+09:10.480 --> 09:12.000
+evaluated, and the answer
+
+09:12.000 --> 09:19.200
+will show up in the file.
+
+09:19.200 --> 09:20.097
+And finally,
+
+09:20.097 --> 09:21.363
+the last thing I want to show you
+
+09:21.363 --> 09:23.531
+very briefly is the web page
+
+09:23.531 --> 09:26.720
+for this course.
+
+09:26.720 --> 09:28.399
+The only thing I want to show you here
+
+09:28.399 --> 09:30.399
+is that I have a Python source code block,
+
+09:30.399 --> 09:33.279
+which pulls in my handwritten course notes,
+
+09:33.279 --> 09:36.399
+and makes them into a nice-looking list
+
+09:36.399 --> 09:38.880
+with a nice-looking order,
+
+09:38.880 --> 09:41.680
+and then just exports as HTML.
+
+09:41.680 --> 09:44.600
+So, this is what
+
+09:44.600 --> 09:46.080
+the web page looks like,
+
+09:46.080 --> 09:48.880
+and you can see it at this URL.
+
+09:48.880 --> 09:49.892
+If you go click on
+
+09:49.892 --> 09:52.800
+the 2021 link at this URL.
+
+09:52.800 --> 09:54.880
+So, that's all that I wanted to say.
+
+09:54.880 --> 09:58.360
+Thank you very much!