1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
|
<!-- Automatically generated by emacsconf-publish-after-page -->
<a name="papers-mainVideo-transcript"></a>
# Transcript
[[!template new="1" text="""Introduction""" start="00:00:00.000" video="mainVideo-papers" id="subtitle"]]
[[!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"]]
[[!template new="1" text="""What?""" start="00:00:20.130" video="mainVideo-papers" id="subtitle"]]
[[!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"]]
[[!template new="1" text="""Why?""" start="00:01:21.377" video="mainVideo-papers" id="subtitle"]]
[[!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"]]
[[!template new="1" text="""Challenges""" start="00:02:16.215" video="mainVideo-papers" id="subtitle"]]
[[!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"]]
[[!template new="1" text="""Basic Org to PDF""" start="00:03:35.320" video="mainVideo-papers" id="subtitle"]]
[[!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"]]
[[!template new="1" text="""How to LaTeX properly, though?""" start="00:04:08.061" video="mainVideo-papers" id="subtitle"]]
[[!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"]]
[[!template new="1" text="""LaTeX-specific headers""" start="00:04:32.304" video="mainVideo-papers" id="subtitle"]]
[[!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"]]
[[!template new="1" text="""Using a formatting class file""" start="00:04:54.625" video="mainVideo-papers" id="subtitle"]]
[[!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"]]
[[!template new="1" text="""Using a different LaTeX command""" start="00:05:31.395" video="mainVideo-papers" id="subtitle"]]
[[!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"]]
[[!template new="1" text="""References links for bibliography""" start="00:06:13.138" video="mainVideo-papers" id="subtitle"]]
[[!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"]]
[[!template new="1" text="""Examples""" start="00:07:09.720" video="mainVideo-papers" id="subtitle"]]
[[!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"]]
[[!template new="1" text="""Tags""" start="00:07:41.240" video="mainVideo-papers" id="subtitle"]]
[[!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"]]
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 -->
|
