diff options
Diffstat (limited to '')
| -rw-r--r-- | 2022/captions/emacsconf-2022-eev--bidirectional-links-with-eev--eduardo-ochs--main.vtt | 577 |
1 files changed, 399 insertions, 178 deletions
diff --git a/2022/captions/emacsconf-2022-eev--bidirectional-links-with-eev--eduardo-ochs--main.vtt b/2022/captions/emacsconf-2022-eev--bidirectional-links-with-eev--eduardo-ochs--main.vtt index da9fcff7..964c9e52 100644 --- a/2022/captions/emacsconf-2022-eev--bidirectional-links-with-eev--eduardo-ochs--main.vtt +++ b/2022/captions/emacsconf-2022-eev--bidirectional-links-with-eev--eduardo-ochs--main.vtt @@ -1,269 +1,490 @@ WEBVTT +Kind: captions: +Language: en-GB -00:00.000 --> 00:06.159 -Hi, my name is Eduard Oxt, I'm the author of an MX package called EEV, and the name +00:00:00.000 --> 00:00:04.000 +Hi! My name is Eduardo Ochs. I'm the author -00:06.160 --> 00:11.439 -of this presentation is Bidirectional Links in EEV. +00:00:04.000 --> 00:00:06.000 +of an Emacs package called eev, and the name -00:11.440 --> 00:16.279 -Let me present things in a weird order, starting by the new feature and then I'm going to +00:00:06.000 --> 00:00:09.000 +of this presentation is: "Bidirectional links -00:16.280 --> 00:20.799 -explain the whole context. +00:00:09.000 --> 00:00:10.000 +in eev". -00:20.800 --> 00:25.839 -One of the main features that we are going to see here is this function here, MetaX Cla, +00:00:10.000 --> 00:00:13.000 +Let me present things in a weird order, -00:25.840 --> 00:29.279 -and Cla is a mnemonic for Q-link to anchor. +00:00:13.000 --> 00:00:16.000 +starting by the new feature, and then I'm -00:29.280 --> 00:33.159 -Let me explain, let me demonstrate how it works. +00:00:16.000 --> 00:00:20.000 +going to explain the whole context. -00:33.160 --> 00:40.239 -This thing here with the green angle brackets is an anchor, this thing between the green +00:00:20.000 --> 00:00:22.000 +One of the main features that we are -00:40.240 --> 00:48.279 -angle brackets is a tag of an anchor, and if I type MetaX Cla here, it highlights this +00:00:22.000 --> 00:00:24.000 +going to see here is this function here, -00:48.280 --> 00:53.719 -tag for a second and it says copied to the Q-link blah blah blah, and this thing here +00:00:24.000 --> 00:00:27.000 +M-x kla, and kla is a mnemonic for "kill -00:53.720 --> 00:55.079 -is a link. +00:00:27.000 --> 00:00:31.000 +Link to Anchor". Let me explain... let me -00:55.080 --> 01:02.759 -I can insert the link here, I can insert the link in my notes, and if I execute this link, +00:00:31.000 --> 00:00:33.000 +demonstrate how it works. This thing here -01:02.760 --> 01:08.319 -this link here, it goes to this anchor in this file. +00:00:33.000 --> 00:00:36.000 +with the green angle brackets is an -01:08.320 --> 01:16.119 -If you have a recent version of EEV installed, then trying this feature should be very easy. +00:00:36.000 --> 00:00:40.000 +anchor, this thing between the green -01:16.120 --> 01:21.679 -You just need to open this file here in which everything is defined, and then go to this +00:00:40.000 --> 00:00:42.000 +angle brackets is a tag of an -01:21.680 --> 01:27.479 -section at the beginning of the file, and then run the three blocks of tests that are +00:00:42.000 --> 00:00:46.000 +anchor, and if I type M-x kla here -01:27.480 --> 01:29.299 -there. +00:00:46.000 --> 00:00:49.000 +it highlights this tag for a second and -01:29.300 --> 01:34.439 -This block corresponds roughly to what we have just done. +00:00:49.000 --> 00:00:52.000 +it says "Copied to the kill ring: blah -01:34.440 --> 01:43.519 -This other block is slightly different because it shows some variants of Cla. +00:00:52.000 --> 00:00:54.000 +blah blah..." and this thing here is a link. -01:43.520 --> 01:47.959 -One is with F instead of an A here. +00:00:54.000 --> 00:00:57.000 +I can insert the link here, I -01:47.960 --> 01:49.559 -Let me show how it works. +00:00:57.000 --> 00:01:00.000 +can insert the link in my notes... -01:49.560 --> 02:00.519 -If we type MetaX eKlf or just MetaX klf, we get a link to this file that does not point +00:01:00.000 --> 00:01:03.000 +and if I execute this thing this link -02:00.520 --> 02:08.399 -to an anchor, and if we type MetaX klt, we get another kind of link that is linked to +00:01:03.000 --> 00:01:10.000 +here it goes to this anchor in this file. -02:08.400 --> 02:11.719 -an anchor in the same file. +00:01:10.000 --> 00:01:12.000 +If you have a recent version of eev -02:11.720 --> 02:21.199 -The third block is more interesting because it lets people create links to files that +00:01:12.000 --> 00:01:13.000 +installed then trying this feature -02:21.200 --> 02:26.439 -are elsewhere and that do not have anchors pointing to them. +00:01:13.000 --> 00:01:15.000 +should be very easy... -02:26.440 --> 02:28.799 -Let me execute this. +00:01:15.000 --> 00:01:18.000 +you just need to open the this file here, -02:28.800 --> 02:36.319 -This will run this extra here and display the target at the window at the right. +00:01:18.000 --> 00:01:21.000 +in which everything is defined, and then -02:36.320 --> 02:41.679 -This is one of the source files of MX. +00:01:21.000 --> 00:01:23.000 +go to this section at the beginning of -02:41.680 --> 02:45.519 -Let's imagine that I want to create a link to this string here. +00:01:23.000 --> 00:01:26.000 +the file, and then run the three blocks -02:45.520 --> 02:53.399 -Then I can type MetaX klfs, and this will create a link to a file in a string in that +00:01:26.000 --> 00:01:28.000 +of tests that are there. -02:53.400 --> 02:54.399 -file. +00:01:28.000 --> 00:01:31.000 +This block corresponds roughly to what -02:54.400 --> 03:00.959 -If I type enter here, it says copy to the kil ring, and this is a link to this file +00:01:31.000 --> 00:01:33.000 +we have just done... -03:00.960 --> 03:11.479 -here and to the first occurrence of this string in this file. +00:01:33.000 --> 00:01:36.000 +this other block -03:11.480 --> 03:14.399 -Notice this work inside. +00:01:36.000 --> 00:01:40.000 +is slightly different because it shows -03:14.400 --> 03:19.239 -When I was trying to write the documentation of this, I tried to write a summary of how +00:01:40.000 --> 00:01:44.000 +some variants of kla... one is with `f' -03:19.240 --> 03:25.359 -the algorithm works, and I failed, and I tried again, and I failed again several times, and +00:01:44.000 --> 00:01:48.000 +instead of an `a' here, let me -03:25.360 --> 03:33.419 -then I gave up and I decided to write an intro, a tutorial, this one, that explains everything +00:01:48.000 --> 00:01:51.000 +show how it works... if we type -03:33.420 --> 03:40.959 -but lots of details and lots of sections with try it that have examples that you can run +00:01:51.000 --> 00:01:57.000 +`M-x eeklf' or just `M-x klf' -03:40.960 --> 03:48.719 -to understand things, to examine how some functions work, how the data structures work, +00:01:57.000 --> 00:02:00.000 +we get a link to this file that does not -03:48.720 --> 03:51.599 -and so on. +00:02:00.000 --> 00:02:03.000 +point to an anchor, and if we type -03:51.600 --> 03:57.399 -The problem is that sometimes we have several hyperlinks that point to the same file. +00:02:03.000 --> 00:02:07.000 +`M-x klt' we get another kind of link that -03:57.400 --> 03:59.359 -Let me give an example. +00:02:07.000 --> 00:02:09.000 +is a link to an anchor in the same -03:59.360 --> 04:08.399 -In the configuration in which I am now, in this file here, the old way of generating +00:02:09.000 --> 00:02:11.000 +file... -04:08.400 --> 04:14.519 -hyperlinks to this file with find here links, which generate a temporary buffer like this, +00:02:11.000 --> 00:02:16.000 +and the third block -04:14.520 --> 04:20.239 -and then I would have to choose which one of these hyperlinks I find best, which one +00:02:16.000 --> 00:02:18.000 +is more interesting because it lets -04:20.240 --> 04:24.359 -I prefer, and then copy it to my notes. +00:02:18.000 --> 00:02:20.000 +people create links to files that -04:24.360 --> 04:31.079 -So instead of choosing a hyperlink, this thing here shows all the options. +00:02:20.000 --> 00:02:23.000 +are elsewhere, and that do not have -04:31.080 --> 04:38.639 -And in the new way, in MetaX and Friends, there's an algorithm that chooses the best +00:02:23.000 --> 00:02:25.000 +anchors in them... -04:38.640 --> 04:40.879 -short hyperlink by itself. +00:02:25.000 --> 00:02:29.000 +let me execute this... this will -04:40.880 --> 04:44.159 -And this algorithm is a bit hard to explain. +00:02:29.000 --> 00:02:32.000 +run this sexp here and display the -04:44.160 --> 04:46.639 -Let me demonstrate it here. +00:02:32.000 --> 00:02:35.000 +target at the window at the right... -04:46.640 --> 04:56.359 -Again, we have all these options here of hyperlinks to this file, and if I type MetaX klf, it +00:02:35.000 --> 00:02:41.000 +this is one of the source files of Emacs. -04:56.360 --> 04:58.839 -chooses one of them. +00:02:41.000 --> 00:02:43.000 +Let's imagine that I want to create a -04:58.840 --> 05:02.599 -And of course, I can copy it to my notes, it's going to work, it's going to point to +00:02:43.000 --> 00:02:46.000 +link to this string here... then I can -05:02.600 --> 05:04.799 -here and so on. +00:02:46.000 --> 00:02:51.000 +type `M-x klfs', and this will create a -05:04.800 --> 05:11.199 -Well, the title of this presentation was Bidirectional Links with EEV. +00:02:51.000 --> 00:02:53.000 +link to a file and to a string in that -05:11.200 --> 05:17.559 -Let me show what I mean by bidirectional hyperlinks and how we can use this thing to create bidirectional +00:02:53.000 --> 00:02:56.000 +file. So if I type ENTER here -05:17.560 --> 05:20.519 -hyperlinks very quickly. +00:02:56.000 --> 00:02:59.000 +it says: "Copied to the kill ring: ...\ -05:20.520 --> 05:22.259 -I will have to use a smaller font. +00:02:59.000 --> 00:03:02.000 +and this is a link to this file here, -05:22.260 --> 05:24.999 -Let me open these two files here. +00:03:02.000 --> 00:03:04.000 +and to the first occurrence of this -05:25.000 --> 05:31.999 -This one at the left is a program in Haskell, and this one is a file with my notes on Haskell. +00:03:04.000 --> 00:03:10.000 +string in this file. -05:32.000 --> 05:41.559 -How do I create a link to this file in Haskell to put it in this file here? +00:03:10.000 --> 00:03:14.000 +So: how does this work (inside)?... -05:41.560 --> 05:49.719 -I can put the cursor here in any position after this anchor here and type MetaX klf. +00:03:14.000 --> 00:03:16.000 +when I was trying to write the documentation -05:49.720 --> 05:56.359 -It copies this link here to the kill ring, and then I can go here and either insert it +00:03:16.000 --> 00:03:19.000 +of this I tried to write a summary of -05:56.360 --> 06:08.039 -with Ctrl Y, yank, or insert it with MetaX klf that adds a comment prefix here. +00:03:19.000 --> 00:03:21.000 +how the algorithm works, and I failed and -06:08.040 --> 06:16.559 -So this is a way to create a link from here to there in which every comment has to be +00:03:21.000 --> 00:03:23.000 +I tried again, and I failed again, -06:16.560 --> 06:19.359 -given explicitly. +00:03:23.000 --> 00:03:26.000 +several times... and then I gave up and I -06:19.360 --> 06:23.719 -But I also implemented a way to create the two links at the same time. +00:03:26.000 --> 00:03:29.000 +decided to write an intro - a tutorial, -06:23.720 --> 06:24.719 -I don't use it much. +00:03:29.000 --> 00:03:31.000 +this one - -06:24.720 --> 06:27.399 -It is mostly for demos because it is impressive. +00:03:31.000 --> 00:03:34.000 +that explains everything with lots of -06:27.400 --> 06:29.919 -I wanted to show that in this presentation. +00:03:34.000 --> 00:03:35.000 +details, and with lots of sections -06:29.920 --> 06:33.079 -Anyway, let me show it here. +00:03:35.000 --> 00:03:39.000 +with "Try it!"s, that -06:33.080 --> 06:41.339 -Note that in this file here the point is here, in this file the point is here. +00:03:39.000 --> 00:03:41.000 +have examples that you you can run to -06:41.340 --> 06:47.599 -My trick is going to create a link to this anchor and put it in this file, and it is +00:03:41.000 --> 00:03:44.000 +understand things, to examine how some -06:47.600 --> 06:51.479 -going to create a link to this anchor and put it in this file. +00:03:44.000 --> 00:03:48.000 +functions work, how the data -06:51.480 --> 06:58.599 -So here it goes, MetaX klhu, ta-da! +00:03:48.000 --> 00:03:51.000 +structures work, and so on... -06:58.600 --> 07:03.159 -It highlighted the two anchors for a second and then it created these things here and +00:03:51.000 --> 00:03:54.000 +the problem is that sometimes we have -07:03.160 --> 07:11.479 -inserted them with the right comment prefixes. +00:03:54.000 --> 00:03:56.000 +several hyperlinks that point to the to -07:11.480 --> 07:15.519 -And that's it. +00:03:56.000 --> 00:04:00.000 +the same file. Let me give an example. -07:15.520 --> 07:17.319 -So that's it. +00:04:00.000 --> 00:04:04.000 +In the configuration in which I am now, -07:17.320 --> 07:26.039 -If you found these things interesting, just install a recent version of VEV and run the +00:04:04.000 --> 00:04:07.000 +in this file here... the old way of -07:26.040 --> 07:32.159 -tutorial either with this thing here, MetaX client client intro, or by running this exp, +00:04:07.000 --> 00:04:08.000 +generating hyperlinks to this file -07:32.160 --> 07:39.599 -or open this file here in the iv directory and follow the tutorials. +00:04:08.000 --> 00:04:10.000 +with `find-here-links' -07:39.600 --> 07:46.919 -And most things there are well documented, but the thing that I don't use much and that +00:04:10.000 --> 00:04:13.000 +will generate a temporary buffer -07:46.920 --> 07:52.559 -is mostly for demos, which is the thing that creates bidirectional hyperlinks, is not yet +00:04:13.000 --> 00:04:15.000 +like this, and then I would have to -07:52.560 --> 07:55.119 -well documented, but the rest is. +00:04:15.000 --> 00:04:18.000 +choose which one of these hyperlinks I + +00:04:18.000 --> 00:04:21.000 +find best, which one I prefer, and then + +00:04:21.000 --> 00:04:25.000 +copy it to my notes... so instead + +00:04:25.000 --> 00:04:27.000 +of choosing a hyperlink this thing here + +00:04:27.000 --> 00:04:30.000 +shows all the options. + +00:04:30.000 --> 00:04:34.000 +And in the new way, in `M-x kla' + +00:04:34.000 --> 00:04:37.000 +and friends, there's an algorithm that + +00:04:37.000 --> 00:04:39.000 +chooses the best short hyperlink by + +00:04:39.000 --> 00:04:43.000 +itself, and this algorithm is a bit hard + +00:04:43.000 --> 00:04:46.000 +to explain... let me demonstrate it here. + +00:04:46.000 --> 00:04:50.000 +Again, we have all these options here, of + +00:04:50.000 --> 00:04:51.000 +hyperlinks to this file... + +00:04:51.000 --> 00:04:56.000 +and if I type `M-x klf' + +00:04:56.000 --> 00:04:58.000 +it chooses one of them. + +00:04:58.000 --> 00:05:01.000 +And of course I can copy it to my notes, + +00:05:01.000 --> 00:05:02.000 +it's going to work, it's going to point + +00:05:02.000 --> 00:05:05.000 +to here... and so on. + +00:05:05.000 --> 00:05:08.000 +Well, the title of this presentation was + +00:05:08.000 --> 00:05:11.000 +"Bidirectional links with eev"... let me + +00:05:11.000 --> 00:05:13.000 +show what I mean by bi-directional + +00:05:13.000 --> 00:05:15.000 +hyperlinks, and how we can use this thing + +00:05:15.000 --> 00:05:17.000 +to create bidirectional hyperlinks + +00:05:17.000 --> 00:05:19.000 +very quickly. + +00:05:19.000 --> 00:05:22.000 +I will have to use a smaller font... let + +00:05:22.000 --> 00:05:25.000 +me open these two files here. This one at + +00:05:25.000 --> 00:05:27.000 +the left is a program in Haskell, and + +00:05:27.000 --> 00:05:30.000 +this one is a file with my notes on + +00:05:30.000 --> 00:05:31.000 +Haskell. + +00:05:31.000 --> 00:05:35.000 +How do I create a link from... + +00:05:35.000 --> 00:05:39.000 +to this file in Haskell + +00:05:39.000 --> 00:05:42.000 +to put it in this file here? I can put + +00:05:42.000 --> 00:05:45.000 +the cursor here, in any position + +00:05:45.000 --> 00:05:48.000 +after this anchor here, and type + +00:05:48.000 --> 00:05:49.000 +`M-x kla'... + +00:05:49.000 --> 00:05:51.000 +it copies this link here to the kill + +00:05:51.000 --> 00:05:54.000 +ring and then I can can go here and + +00:05:54.000 --> 00:05:59.000 +either insert it with C-y (yank), or + +00:05:59.000 --> 00:06:06.000 +insert it with `M-k kli', that adds a -07:55.120 --> 07:56.119 -So that's it. +00:06:06.000 --> 00:06:07.000 +comment prefix here. + +00:06:07.000 --> 00:06:11.000 +So this is a way to create a link from + +00:06:11.000 --> 00:06:15.000 +here to there in which every + +00:06:15.000 --> 00:06:18.000 +comment has to be given explicitly... + +00:06:18.000 --> 00:06:21.000 +but I also implemented a way to + +00:06:21.000 --> 00:06:23.000 +create the two links at the same time. + +00:06:23.000 --> 00:06:25.000 +I don't use it much, it's mostly for + +00:06:25.000 --> 00:06:27.000 +demos, because it's impressive, I wanted + +00:06:27.000 --> 00:06:29.000 +to show that in this presentation... + +00:06:29.000 --> 00:06:33.000 +Anyway, let me show it here. Note that + +00:06:33.000 --> 00:06:36.000 +that in this file here the point is + +00:06:36.000 --> 00:06:40.000 +here, in this file the point is here... + +00:06:40.000 --> 00:06:43.000 +My trick is going to create a link to + +00:06:43.000 --> 00:06:47.000 +this anchor and put it in this file, and + +00:06:47.000 --> 00:06:49.000 +it's going to create a link to this + +00:06:49.000 --> 00:06:52.000 +anchor and put it in this file... + +00:06:52.000 --> 00:06:57.000 +So, here it goes: `M-x kla2'... ta-da! + +00:06:57.000 --> 00:07:01.000 +it highlighted the true anchors for a + +00:07:01.000 --> 00:07:03.000 +second, and it created these things here + +00:07:03.000 --> 00:07:06.000 +and inserted them with the + +00:07:06.000 --> 00:07:09.000 +right prefixes, I mean, the right + +00:07:09.000 --> 00:07:10.000 +comment prefixes. + +00:07:10.000 --> 00:07:15.000 +And that's it! + +00:07:15.000 --> 00:07:18.000 +So... that's it. If you found this thing + +00:07:18.000 --> 00:07:22.000 +interesting just + +00:07:22.000 --> 00:07:25.000 +install a recent version of eev and run + +00:07:25.000 --> 00:07:28.000 +the tutorial, either with this thing here, + +00:07:28.000 --> 00:07:30.000 +`M-x find-kla-intro', or by running + +00:07:30.000 --> 00:07:35.000 +this sexp, or open this file here in the + +00:07:35.000 --> 00:07:37.000 +eev directory, and follow the + +00:07:37.000 --> 00:07:39.000 +tutorials... + +00:07:39.000 --> 00:07:42.000 +most things that there are well + +00:07:42.000 --> 00:07:46.000 +documented, but the thing that I don't + +00:07:46.000 --> 00:07:47.000 +use much and that is mostly for demos, + +00:07:47.000 --> 00:07:50.000 +which is the the thing that creates + +00:07:50.000 --> 00:07:52.000 +bi-directional hyperlinks, is not yet + +00:07:52.000 --> 00:07:55.000 +well documented, but the rest is. -07:56.120 --> 08:17.400 -Have fun. +00:07:55.000 --> 00:07:57.000 +So: that's it! Bye! Have fun! =) |