document how to customize slides

bast · Nov 12, 2018 · dd9af8c · dd9af8c
1 parent 204864b
commit dd9af8c
Show file tree

Hide file tree

Showing 6 changed files with 23 additions and 43 deletions.
diff --git a/doc/index.rst b/doc/index.rst
@@ -37,8 +37,8 @@ You can **style your slides** to your heart's content.
    style/css.rst
    style/images.rst
    style/background.rst
+   style/customize.rst
    style/math.rst
-   style/highlighting.rst
 
 
 .. toctree::

diff --git a/doc/style/background.rst b/doc/style/background.rst
@@ -3,5 +3,9 @@
 Background image
 ================
 
+
+remark
+------
+
 Setting and changing the background image is nicely documented here:
 https://github.com/gnab/remark/wiki/Markdown#background-image
diff --git a/doc/style/css.rst b/doc/style/css.rst
@@ -1,7 +1,7 @@
 
 
-How to use own CSS
-==================
+How to use your own CSS
+=======================
 
 If you place a file in the same path as your talk, with the same name as your
 talk, and only replace the ``.md`` suffix by ``.css``. Then the rendering engine

diff --git a/doc/style/customize.rst b/doc/style/customize.rst
@@ -0,0 +1,14 @@
+
+
+How to customize everything
+===========================
+
+You want to change looks and fonts? CSS is not enough? Perhaps you need an
+external JavaScript library?
+
+You can place ``*.head.html`` and/or ``*.body.html`` alongside your ``*.md`` slides.
+In these files you can do and change almost everything:
+https://github.com/bast/cicero/blob/master/cicero/templates/render.html.
+
+To get inspired of what is in these by default and what can be changed, please
+browse https://github.com/bast/cicero/tree/master/cicero/static/engines.
diff --git a/doc/style/highlighting.rst b/doc/style/highlighting.rst
diff --git a/doc/style/math.rst b/doc/style/math.rst
@@ -3,8 +3,5 @@
 Math equations
 ==============
 
-Math equations are rendered using https://www.mathjax.org. Here is an example Markdown code::
-
-  $$ e = mc^2 $$
-
-MathJax is configured here: https://github.com/bast/cicero/blob/master/cicero/static/engines/remark-0.13.0/js.html#L8-L42
+Here is an example:
+https://github.com/bast/cicero/tree/master/demo/remark/equations