rst examples
Normal text works like this.
For details regarding the topics touched below, see the theme's (m.css for Pelican) documentation.
For information about reStructuredText itself, check out this reStructuredText Primer or the reStructuredText Markup Specification
lists
- unordered lists
- nested
ordered might not start with 1
- nested items (e.g., lists) must be properly indented
and can be auto-numbered
- ordered nested lists
- work as well
links
Link to a …
- … headline links
- … headline with a different link text
- … page
- … file in page's directory (this is also how to link to images you embedd etc.)
- … static file (you should not need this very often)
images
This image is fetched from the Internet and also a link to somewhere…:

This image is served from our server and it has a caption:
galleries
With the m-col-…
classes used below, the grid is 4 columns wide on
larger screens and 3 on smaller screens. Hence, the image count is
ideally a multiple of both (12, 24, 36, …). Of course, you can also
modify the grid widths.
videos
For Vimeo videos use .. vimeo VIDEO_ID
Some of our Vimeo videos can only be embedded by the domains
osm.hpi.de
and localhost
(not 127.0.0.1
, so be aware when
developing/testing locally).
blocks
tables
There are two different types of tables supported by standard rst.
However, you probably want to use list tables (check the source of this file):
date | topic | speaker |
---|---|---|
01.01. | Topic 1 | Speaker 1 |
02.02. | Topic 2 | Speaker 2 |
… or even CSV tables:
date | topic | speaker |
---|---|---|
01.01. | Topic 1 | Speaker 1 |
02.02. | Topic 2 | Speaker 2 |
… which might feed from files:
date | topic | speaker |
---|---|---|
01.01. | Topic 1 | Speaker 1 |
02.02. | Topic 2 | Speaker 2 |
custom HTML header
Such as CSS/style sheets:
======== my title ======== :html_header: <style> td { \ vertical-align: top; } </style>
Please note the backslash, since the lines of the :html_header:
"value" (i. e., the style sheet in this case) must be on the same
indentation level.
comments
(you'll only see it in the source of the page ;))