Skip to content

Commit e4bc5bb

Browse files
committed
Acknowledge that theme support is not ready
1 parent 357ed1f commit e4bc5bb

File tree

1 file changed

+9
-40
lines changed

1 file changed

+9
-40
lines changed

docs/themes.rst

+9-40
Original file line numberDiff line numberDiff line change
@@ -3,45 +3,14 @@
33
Themes
44
========
55

6-
Using a theme
7-
---------------------------
6+
Theme support is a work in progress!
87

9-
Just add the following line in the end of the head tag:
8+
In the meantime, you can add CSS (inline or via a link) directly in your
9+
presentation. Here is a non exhaustive list of CSS selector you might be
10+
interested in tweaking:
1011

11-
.. code-block:: html
12-
13-
<link rel="stylesheet" type="text/css" href="<link to your style>.css">
14-
15-
Theme list
16-
---------------------------
17-
18-
Slipshow comes with its set of themes.
19-
20-
* Theme ``Vanier``:
21-
22-
.. code-block:: html
23-
24-
<link rel="stylesheet" type="text/css" href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/themes/vanier/vanier.css">
25-
26-
27-
If you want your theme
28-
29-
Writing a theme
30-
---------------------------
31-
32-
You need to define the css of at least the following attributes:
33-
34-
* The rule ``#universe`` for the canvas,
35-
* The rule ``slip-slip`` for the slips,
36-
* The rule ``slip-title`` for slip titles,
37-
* The rule ``slip-body`` for the inside of the slips,
38-
* The rule ``.emphasize`` for emphasized content,
39-
* The rules ``.block``, ``.theorem``, ``.lemma``, ``.definition``, ``.example``, ``.corollary``, ``.remark``, with special rules when they have the attribute ``title`` defined,
40-
* The rule ``.cpt-slip`` for the counter (bottom right by default),
41-
* The rules ``.toc-slip`` and ``.toc-slip li`` for the table of content,
42-
* The rule ``.toc-slip .before`` for the entries of the table of content already seen,
43-
* The rule ``.toc-slip .current`` for the entry of the table of content where we are,
44-
* The rule ``.toc-slip .after`` for the entries of the table of content to come,
45-
* The rule ``.toc-slip .toc-function`` for the entries of the table of content that are clickable,
46-
47-
You can also add any additionnal rules, such as ``h1``, that are not specific to ``slipshow``.
12+
* ``.slip-body`` to restyle a slip, eg to add margin, set font size and color...
13+
* ``.block``, ``.theorem``, ``.lemma``, ``.definition``, ``.example``,
14+
``.corollary``, ``.remark``, for admonitions (with special rules when they
15+
have the attribute ``title`` defined),
16+
* Any non-specific elements, such as titles, paragraphs, ...

0 commit comments

Comments
 (0)