|
|
<!-- Automatically generated by emacsconf-publish-after-page -->
<div class="transcript transcript-mainVideo"><a name="papers-mainVideo-transcript"></a><h1>Transcript</h1>
<div class="transcript-heading">[[!template new="1" text="""Introduction""" start="00:00:00.000" video="mainVideo-papers" id="subtitle"]]</div>[[!template text="""Okay. Hi, everyone. My name is Vincent. I'm a PhD student in""" start="00:00:00.000" video="mainVideo-papers" id="subtitle"]]
[[!template text="""Nanzan University, Japan. Today I'm going to present to""" start="00:00:04.800" video="mainVideo-papers" id="subtitle"]]
[[!template text="""you how I'm using Org notes and Org Roam to write academic""" start="00:00:07.440" video="mainVideo-papers" id="subtitle"]]
[[!template text="""papers. The slides I'm going to present here are available""" start="00:00:11.800" video="mainVideo-papers" id="subtitle"]]
[[!template text="""in the Git repository, so you can check them later""" start="00:00:15.000" video="mainVideo-papers" id="subtitle"]]
[[!template text="""if you want to.""" start="00:00:17.306" video="mainVideo-papers" id="subtitle"]]
<div class="transcript-heading">[[!template new="1" text="""What?""" start="00:00:20.130" video="mainVideo-papers" id="subtitle"]]</div>[[!template text="""Firstly what are we talking about here?""" start="00:00:20.130" video="mainVideo-papers" id="subtitle"]]
[[!template text="""So in general, it's possible, if you have any Org nodes,""" start="00:00:21.911" video="mainVideo-papers" id="subtitle"]]
[[!template text="""to export them as LaTeX. Given some extra configuration,""" start="00:00:26.693" video="mainVideo-papers" id="subtitle"]]
[[!template text="""it's possible, basically, to reproduce any LaTeX setup""" start="00:00:31.316" video="mainVideo-papers" id="subtitle"]]
[[!template text="""that you would use to create documents with an Org file.""" start="00:00:34.957" video="mainVideo-papers" id="subtitle"]]
[[!template text="""In my case, I'm using that system to take some notes""" start="00:00:42.032" video="mainVideo-papers" id="subtitle"]]
[[!template text="""that I have in my org-roam system""" start="00:00:46.754" video="mainVideo-papers" id="subtitle"]]
[[!template text="""and to export that into finished academic papers""" start="00:00:48.454" video="mainVideo-papers" id="subtitle"]]
[[!template text="""that you can submit eventually to a conference and so on.""" start="00:00:52.240" video="mainVideo-papers" id="subtitle"]]
[[!template text="""Actually, before I submit that proposal, after I submit""" start="00:00:56.280" video="mainVideo-papers" id="subtitle"]]
[[!template text="""that proposal, I just noticed that Mike Hamrick in last""" start="00:00:59.440" video="mainVideo-papers" id="subtitle"]]
[[!template text="""year's EmacsConf made a very extensive presentation about""" start="00:01:03.560" video="mainVideo-papers" id="subtitle"]]
[[!template text="""org export. But in here, I just want to showcase my usage of""" start="00:01:07.880" video="mainVideo-papers" id="subtitle"]]
[[!template text="""org-roam and to present what are the configuration I'm""" start="00:01:13.040" video="mainVideo-papers" id="subtitle"]]
[[!template text="""using to be able to achieve that. Why do that?""" start="00:01:16.960" video="mainVideo-papers" id="subtitle"]]
<div class="transcript-heading">[[!template new="1" text="""Why?""" start="00:01:21.377" video="mainVideo-papers" id="subtitle"]]</div>[[!template text="""In general, like I said, I'm using that""" start="00:01:21.377" video="mainVideo-papers" id="subtitle"]]
[[!template text="""as part of my writing system, so in""" start="00:01:23.038" video="mainVideo-papers" id="subtitle"]]
[[!template text="""having org-roam notes that can be exported as a document""" start="00:01:26.640" video="mainVideo-papers" id="subtitle"]]
[[!template text="""make for a great workflow in my opinion. It makes Org even""" start="00:01:30.240" video="mainVideo-papers" id="subtitle"]]
[[!template text="""more versatile, so if you use that for maybe writing code in""" start="00:01:34.160" video="mainVideo-papers" id="subtitle"]]
[[!template text="""the literate programming, now you're going to be also able""" start="00:01:38.840" video="mainVideo-papers" id="subtitle"]]
[[!template text="""to export that into any format you want.""" start="00:01:41.600" video="mainVideo-papers" id="subtitle"]]
[[!template text="""The Org notes are very clean. In my opinion, it looks""" start="00:01:47.560" video="mainVideo-papers" id="subtitle"]]
[[!template text="""better to work in Org rather than editing LaTeX code""" start="00:01:49.880" video="mainVideo-papers" id="subtitle"]]
[[!template text="""directly. The centralized bibliography system is also""" start="00:01:53.800" video="mainVideo-papers" id="subtitle"]]
[[!template text="""great because it allows to have just a few notes that you can""" start="00:01:58.960" video="mainVideo-papers" id="subtitle"]]
[[!template text="""reference everywhere and have links to them. Of course""" start="00:02:02.560" video="mainVideo-papers" id="subtitle"]]
[[!template text="""everything is happening inside of Emacs so you have access""" start="00:02:06.600" video="mainVideo-papers" id="subtitle"]]
[[!template text="""to all the tools you are used to like Magit or Projectile and""" start="00:02:09.480" video="mainVideo-papers" id="subtitle"]]
[[!template text="""whatnot.""" start="00:02:13.360" video="mainVideo-papers" id="subtitle"]]
<div class="transcript-heading">[[!template new="1" text="""Challenges""" start="00:02:16.215" video="mainVideo-papers" id="subtitle"]]</div>[[!template text="""However, to quote one of the funniest recent""" start="00:02:16.215" video="mainVideo-papers" id="subtitle"]]
[[!template text="""video about Emacs: "[With LaTeX,] I used to spend hours trying to""" start="00:02:18.600" video="mainVideo-papers" id="subtitle"]]
[[!template text="""get the image on the right page. Now I use Org Mode LaTeX and""" start="00:02:23.000" video="mainVideo-papers" id="subtitle"]]
[[!template text="""just accept it's impossible." Like all the jokes in that""" start="00:02:25.600" video="mainVideo-papers" id="subtitle"]]
[[!template text="""video, it lands in very well because there is some truth to""" start="00:02:28.760" video="mainVideo-papers" id="subtitle"]]
[[!template text="""that in that with that system you are not getting rid of""" start="00:02:32.800" video="mainVideo-papers" id="subtitle"]]
[[!template text="""the complexity of LaTeX, so if you have problems, you're going to""" start="00:02:38.240" video="mainVideo-papers" id="subtitle"]]
[[!template text="""have to deal with the very long logs. It's a layer on top of""" start="00:02:41.240" video="mainVideo-papers" id="subtitle"]]
[[!template text="""LaTeX, so if you need to debug your configuration, if you""" start="00:02:45.960" video="mainVideo-papers" id="subtitle"]]
[[!template text="""want to adjust something specific, you would need to be""" start="00:02:50.520" video="mainVideo-papers" id="subtitle"]]
[[!template text="""proficient in LaTeX and also in being very at ease with""" start="00:02:53.000" video="mainVideo-papers" id="subtitle"]]
[[!template text="""your Emacs configuration. The way to use the Org export is""" start="00:02:58.880" video="mainVideo-papers" id="subtitle"]]
[[!template text="""less documented than using LaTeX so if you want to implement""" start="00:03:03.120" video="mainVideo-papers" id="subtitle"]]
[[!template text="""something, probably it's going to be described in pure LaTeX,""" start="00:03:06.640" video="mainVideo-papers" id="subtitle"]]
[[!template text="""and then you're going to need to adjust that to make it work""" start="00:03:09.960" video="mainVideo-papers" id="subtitle"]]
[[!template text="""inside your Org files. I explained before that the""" start="00:03:13.600" video="mainVideo-papers" id="subtitle"]]
[[!template text="""bibliography system is great, although it's very picky""" start="00:03:17.680" video="mainVideo-papers" id="subtitle"]]
[[!template text="""on the way it works, especially to be exported. Depending""" start="00:03:20.960" video="mainVideo-papers" id="subtitle"]]
[[!template text="""on the template you are using, you might run into issues""" start="00:03:26.360" video="mainVideo-papers" id="subtitle"]]
[[!template text="""with some packages that are in conflict, so there is""" start="00:03:29.240" video="mainVideo-papers" id="subtitle"]]
[[!template text="""that to be taken in mind.""" start="00:03:33.200" video="mainVideo-papers" id="subtitle"]]
<div class="transcript-heading">[[!template new="1" text="""Basic Org to PDF""" start="00:03:35.320" video="mainVideo-papers" id="subtitle"]]</div>[[!template text="""In general, if you have a Org note, you can simply export it""" start="00:03:35.320" video="mainVideo-papers" id="subtitle"]]
[[!template text="""with a C-c C-e and l o with the menu that appears. I can""" start="00:03:41.520" video="mainVideo-papers" id="subtitle"]]
[[!template text="""show that briefly: C-e, then you have the menu. You can select""" start="00:03:46.200" video="mainVideo-papers" id="subtitle"]]
[[!template text="""l and o to export. That works very well. In general,""" start="00:03:49.480" video="mainVideo-papers" id="subtitle"]]
[[!template text="""with that, you are able to deal with everything that you have""" start="00:03:53.520" video="mainVideo-papers" id="subtitle"]]
[[!template text="""in your normal Org notes. If you have images, tables,""" start="00:03:56.960" video="mainVideo-papers" id="subtitle"]]
[[!template text="""links, it's going to be exported in a way that looks decent.""" start="00:03:59.960" video="mainVideo-papers" id="subtitle"]]
[[!template text="""That's what we are starting with.""" start="00:04:03.560" video="mainVideo-papers" id="subtitle"]]
<div class="transcript-heading">[[!template new="1" text="""How to LaTeX properly, though?""" start="00:04:08.061" video="mainVideo-papers" id="subtitle"]]</div>[[!template text="""However, if you want to make a publication,""" start="00:04:08.061" video="mainVideo-papers" id="subtitle"]]
[[!template text="""if you have a template that you receive""" start="00:04:11.544" video="mainVideo-papers" id="subtitle"]]
[[!template text="""from a conference or whatnot, you want to be able to adapt""" start="00:04:13.480" video="mainVideo-papers" id="subtitle"]]
[[!template text="""your Org notes to be able to export it exactly the way you""" start="00:04:17.480" video="mainVideo-papers" id="subtitle"]]
[[!template text="""want. I'm going to present the four points that I'm""" start="00:04:20.520" video="mainVideo-papers" id="subtitle"]]
[[!template text="""showing here that are, for me, the elements that you need to""" start="00:04:23.040" video="mainVideo-papers" id="subtitle"]]
[[!template text="""be careful with when you try to work with templates and""" start="00:04:25.920" video="mainVideo-papers" id="subtitle"]]
[[!template text="""exporting to LaTeX.""" start="00:04:29.880" video="mainVideo-papers" id="subtitle"]]
<div class="transcript-heading">[[!template new="1" text="""LaTeX-specific headers""" start="00:04:32.304" video="mainVideo-papers" id="subtitle"]]</div>[[!template text="""Firstly, you have headers. So basically,""" start="00:04:32.304" video="mainVideo-papers" id="subtitle"]]
[[!template text="""this allows to add LaTeX elements that are going""" start="00:04:34.526" video="mainVideo-papers" id="subtitle"]]
[[!template text="""to be at the top of the file. You're going to have the title.""" start="00:04:37.120" video="mainVideo-papers" id="subtitle"]]
[[!template text="""You're going to have your extra packages here. You're going""" start="00:04:41.560" video="mainVideo-papers" id="subtitle"]]
[[!template text="""to have your class. I'm going to present that later. That's""" start="00:04:44.120" video="mainVideo-papers" id="subtitle"]]
[[!template text="""the part that you're going to adjust to make it look like the""" start="00:04:46.960" video="mainVideo-papers" id="subtitle"]]
[[!template text=""".tex template that you receive.""" start="00:04:50.480" video="mainVideo-papers" id="subtitle"]]
<div class="transcript-heading">[[!template new="1" text="""Using a formatting class file""" start="00:04:54.625" video="mainVideo-papers" id="subtitle"]]</div>[[!template text="""Then you have the formatting class file. That's a .cls file""" start="00:04:54.625" video="mainVideo-papers" id="subtitle"]]
[[!template text="""that you would receive as a part of the template.""" start="00:04:58.626" video="mainVideo-papers" id="subtitle"]]
[[!template text="""This one is used instead of the typical doc class like article.""" start="00:05:01.787" video="mainVideo-papers" id="subtitle"]]
[[!template text="""The way I'm using them is to add an entry,""" start="00:05:08.148" video="mainVideo-papers" id="subtitle"]]
[[!template text="""like add an element to the list or get a""" start="00:05:10.589" video="mainVideo-papers" id="subtitle"]]
[[!template text="""class in my Emacs init. This way I can use the CLS file""" start="00:05:12.760" video="mainVideo-papers" id="subtitle"]]
[[!template text="""directly and also give the parameters that I want. In that""" start="00:05:18.600" video="mainVideo-papers" id="subtitle"]]
[[!template text="""case, I'm going to have a apris.cls next to my Org note,""" start="00:05:22.720" video="mainVideo-papers" id="subtitle"]]
[[!template text="""and it's going to be able to to use it.""" start="00:05:26.403" video="mainVideo-papers" id="subtitle"]]
<div class="transcript-heading">[[!template new="1" text="""Using a different LaTeX command""" start="00:05:31.395" video="mainVideo-papers" id="subtitle"]]</div>[[!template text="""A third element is, in some cases,""" start="00:05:31.395" video="mainVideo-papers" id="subtitle"]]
[[!template text="""you might want to use a different LaTeX compiler to build""" start="00:05:33.600" video="mainVideo-papers" id="subtitle"]]
[[!template text="""your project, to build your notes. That can be done per""" start="00:05:38.360" video="mainVideo-papers" id="subtitle"]]
[[!template text="""file, per note, in my opinion, that's the most flexible way,""" start="00:05:41.720" video="mainVideo-papers" id="subtitle"]]
[[!template text="""by editing, by adding this line as the very first line of your""" start="00:05:45.320" video="mainVideo-papers" id="subtitle"]]
[[!template text="""file and thus changing the LaTeX PDF process variable. And""" start="00:05:48.520" video="mainVideo-papers" id="subtitle"]]
[[!template text="""in there, you can put multiple commands in a row.""" start="00:05:52.600" video="mainVideo-papers" id="subtitle"]]
[[!template text="""For example you can have the shell""" start="00:06:00.462" video="mainVideo-papers" id="subtitle"]]
[[!template text="""escape to have the minted note block, the BibTeX element, so""" start="00:06:01.960" video="mainVideo-papers" id="subtitle"]]
[[!template text="""that works very well. When you add that, you need to""" start="00:06:06.080" video="mainVideo-papers" id="subtitle"]]
[[!template text="""reload your file, though. Something to keep in mind.""" start="00:06:08.960" video="mainVideo-papers" id="subtitle"]]
<div class="transcript-heading">[[!template new="1" text="""References links for bibliography""" start="00:06:13.138" video="mainVideo-papers" id="subtitle"]]</div>[[!template text="""Lastly, you have the bibliography. When you have a reference,""" start="00:06:13.138" video="mainVideo-papers" id="subtitle"]]
[[!template text="""when you want to put a reference, you can use the""" start="00:06:17.000" video="mainVideo-papers" id="subtitle"]]
[[!template text="""org-roam-bibtex package that needs to be installed. Then you""" start="00:06:19.880" video="mainVideo-papers" id="subtitle"]]
[[!template text="""have some configuration to to be set so you have the bibtex""" start="00:06:23.720" video="mainVideo-papers" id="subtitle"]]
[[!template text="""compilation bibliography, where you explain where is your""" start="00:06:27.760" video="mainVideo-papers" id="subtitle"]]
[[!template text="""your reference file, your bib file. You can also give a path""" start="00:06:31.200" video="mainVideo-papers" id="subtitle"]]
[[!template text="""for where to search for PDFs. If you have matching names""" start="00:06:35.960" video="mainVideo-papers" id="subtitle"]]
[[!template text="""with your BibTeX entries and some PDF files in there,""" start="00:06:40.080" video="mainVideo-papers" id="subtitle"]]
[[!template text="""they're going to be linked. I'm going to show that later. So""" start="00:06:44.040" video="mainVideo-papers" id="subtitle"]]
[[!template text="""that's something that's going to be part of your init""" start="00:06:46.480" video="mainVideo-papers" id="subtitle"]]
[[!template text="""configuration as part of the org-roam-bibtex package""" start="00:06:49.200" video="mainVideo-papers" id="subtitle"]]
[[!template text="""configuration. Then in the node you are exporting, you want""" start="00:06:53.040" video="mainVideo-papers" id="subtitle"]]
[[!template text="""to add a section called reference. Here you can set a style""" start="00:06:56.480" video="mainVideo-papers" id="subtitle"]]
[[!template text="""for the bibliography. Again you put which of the""" start="00:07:01.320" video="mainVideo-papers" id="subtitle"]]
[[!template text="""reference file you want to use.""" start="00:07:06.480" video="mainVideo-papers" id="subtitle"]]
<div class="transcript-heading">[[!template new="1" text="""Examples""" start="00:07:09.720" video="mainVideo-papers" id="subtitle"]]</div>[[!template text="""With all of that, I'm going to show some examples. Here I""" start="00:07:09.720" video="mainVideo-papers" id="subtitle"]]
[[!template text="""have an Org note that I used as the file to be exported into a""" start="00:07:15.560" video="mainVideo-papers" id="subtitle"]]
[[!template text="""publication. You can see up front, I set all my headers""" start="00:07:21.760" video="mainVideo-papers" id="subtitle"]]
[[!template text="""package. I have some extra package I put. I have the class""" start="00:07:26.720" video="mainVideo-papers" id="subtitle"]]
[[!template text="""that is something that is next to it. You can see in the""" start="00:07:30.520" video="mainVideo-papers" id="subtitle"]]
[[!template text="""files, I have the apris.cls just here.""" start="00:07:35.840" video="mainVideo-papers" id="subtitle"]]
<div class="transcript-heading">[[!template new="1" text="""Tags""" start="00:07:41.240" video="mainVideo-papers" id="subtitle"]]</div>[[!template text="""Also, with all of that, you can also add tags. I""" start="00:07:41.240" video="mainVideo-papers" id="subtitle"]]
[[!template text="""didn't explain that, but you can also ignore some""" start="00:07:47.120" video="mainVideo-papers" id="subtitle"]]
[[!template text="""sections. That's quite convenient as well. Here we""" start="00:07:49.400" video="mainVideo-papers" id="subtitle"]]
[[!template text="""have some section, and if you want to add a bibliography,""" start="00:07:52.720" video="mainVideo-papers" id="subtitle"]]
[[!template text="""you're going to do c l cite:, you can put some cite entry, put""" start="00:07:57.360" video="mainVideo-papers" id="subtitle"]]
[[!template text="""any file in there, no description, and you're going to put""" start="00:08:05.000" video="mainVideo-papers" id="subtitle"]]
[[!template text="""some link like that. It's very convenient because, firstly,""" start="00:08:08.200" video="mainVideo-papers" id="subtitle"]]
[[!template text="""it's going to be exported as a reference like I'm going to""" start="00:08:11.920" video="mainVideo-papers" id="subtitle"]]
[[!template text="""show later, but also it gives you access to it directly from""" start="00:08:14.520" video="mainVideo-papers" id="subtitle"]]
[[!template text="""the note. If I click the thing here, I have some menu, I can""" start="00:08:18.080" video="mainVideo-papers" id="subtitle"]]
[[!template text="""open the bibliography page.""" start="00:08:22.680" video="mainVideo-papers" id="subtitle"]]
[[!template text="""I can also open the PDF that was linked to it. If I do""" start="00:08:31.040" video="mainVideo-papers" id="subtitle"]]
[[!template text="""that, here is the file that pops up that was linked to the""" start="00:08:34.800" video="mainVideo-papers" id="subtitle"]]
[[!template text="""bibliography. That's great. Otherwise, within""" start="00:08:38.920" video="mainVideo-papers" id="subtitle"]]
[[!template text="""that document, you're going to have other things you can""" start="00:08:44.960" video="mainVideo-papers" id="subtitle"]]
[[!template text="""have. Figures with parameters set on top, footnotes as well if""" start="00:08:47.760" video="mainVideo-papers" id="subtitle"]]
[[!template text="""that's something that you need. For example, here it's a""" start="00:08:53.280" video="mainVideo-papers" id="subtitle"]]
[[!template text="""section that's not exported, but you can have your""" start="00:08:57.280" video="mainVideo-papers" id="subtitle"]]
[[!template text="""normal footnotes. We can go back and forth. If they are in""" start="00:09:00.960" video="mainVideo-papers" id="subtitle"]]
[[!template text="""the exported section, they're going to be""" start="00:09:04.080" video="mainVideo-papers" id="subtitle"]]
[[!template text="""managed. So with that, you can export the notes. You're going to""" start="00:09:07.760" video="mainVideo-papers" id="subtitle"]]
[[!template text="""C-c C-e so you have that menu for exporting""" start="00:09:11.920" video="mainVideo-papers" id="subtitle"]]
[[!template text="""Org files. You do l for LaTeX and then o for running directly as""" start="00:09:16.880" video="mainVideo-papers" id="subtitle"]]
[[!template text="""PDF and opening it. It takes a little while to build. Here we""" start="00:09:23.480" video="mainVideo-papers" id="subtitle"]]
[[!template text="""are. The templates have been used, so there is a""" start="00:09:27.400" video="mainVideo-papers" id="subtitle"]]
[[!template text="""two-column situation happening, we have a specific header""" start="00:09:31.360" video="mainVideo-papers" id="subtitle"]]
[[!template text="""format and figures and the citation that we put. It's""" start="00:09:34.880" video="mainVideo-papers" id="subtitle"]]
[[!template text="""happening, it's shown here, and it's also going to be""" start="00:09:41.520" video="mainVideo-papers" id="subtitle"]]
[[!template text="""visible at the end in the reference section. Like I""" start="00:09:45.080" video="mainVideo-papers" id="subtitle"]]
[[!template text="""said, a fully ready, finished paper can be""" start="00:09:49.880" video="mainVideo-papers" id="subtitle"]]
[[!template text="""produced this way. That's all that I had for today.""" start="00:09:55.480" video="mainVideo-papers" id="subtitle"]]
[[!template text="""Thank you very much for your attention. I am""" start="00:10:01.120" video="mainVideo-papers" id="subtitle"]]
[[!template text="""available for questions on IRC or in the video chat.""" start="00:10:03.200" video="mainVideo-papers" id="subtitle"]]
[[!template text="""Thank you.""" start="00:10:06.233" video="mainVideo-papers" id="subtitle"]]
</div>
Captioner: sachac
Questions or comments? Please e-mail [vincent.conus@pm.me](mailto:vincent.conus@pm.me?subject=Comment%20for%20EmacsConf%202023%20papers%3A%20Writing%20academic%20papers%20in%20Org-Roam)
<!-- End of emacsconf-publish-after-page -->
|
