A history of markup languages
This is a slideshow originally produced for PyCon UK 2017.
The "short" version of the slides is as actually presented at Write the Docs Prague 2018. It is meant to be about 30 minutes long. You can see it as recorded at WtD Prague 2018. This verson was 30 minutes long.
I also gave this longer version of the talk at work in May 2018.
All sources are in reStructuredText, and thus intended to be readable as plain text.
- The sources for the slides are in markup-history.rst and markup-history-wide.rst (customised for 4x3 and 16x9 respectively, although they're actually the same bar some formatting).
- Notes per slide (for the presenter) are separated out into notes-per-slide.rst.
- Extended notes (with links) are in markup-history-extended-notes.rst.
(Note that github will present the
.rst files in rendered form as HTML,
albeit using their own styling (which makes notes a bit odd). If you want
to see the original reStructuredText source, you have to click on the "Raw"
link at the top of the file's page.)
Since this version of the talk uses PDF slides, which I produce via pandoc and TeX, I'm including the resultant PDF files in the repository. These will not necessarily be as up-to-date as the source files, so check their timestamps.
There are two versions of the slides here - the shorter (about 25 minutes) version, and the longer (about 45 minutes) version.
Making the PDF and HTML files
For convenience, you can use the Makefile to create the PDF slides, create the HTML version of the extended notes, and so on. For instance:
$ make pdf
will make the PDF files.
For what the Makefile can do, use:
$ make help
Requirements to build the documents:
- pandoc and TeX (on mac, BasicTeX should be enough). Not needed if you're
just going to do
- docutils (for reStructuredText).
and an appropriate
make program if you want to use the Makefile.
This slideshow and its related files are released under a Creative Commons Attribution-ShareAlike 4.0 International License.