From 0245947e3632dd6d5049997fc25e99bab07e581a Mon Sep 17 00:00:00 2001 From: =?utf8?q?Vladim=C3=ADr=20Vondru=C5=A1?= Date: Wed, 25 Apr 2018 08:22:08 +0200 Subject: [PATCH] doc: minimal Troubleshooting section for the Pelican theme. --- doc/pelican/theme.rst | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/doc/pelican/theme.rst b/doc/pelican/theme.rst index dcaa5a03..c1f858ee 100644 --- a/doc/pelican/theme.rst +++ b/doc/pelican/theme.rst @@ -102,6 +102,9 @@ If you would want to use the light theme instead, the configuration is this and plugins are prefixed with ``M_``. Configuration variables without prefix are builtin Pelican options. +If you see something unexpected or not see something expected, check the +`Troubleshooting`_ section below. + `Configuration`_ ================ @@ -805,3 +808,14 @@ is valid HTML5 and should be parsable as XML. This is one of the main goals of this project. Please :gh:`report a bug ` if it's not like that. + +`Troubleshooting`_ +================== + +`Output is missing styling`_ +---------------------------- + +If you are on Windows and don't have Git symlinks enabled, empty CSS files +might get copied. The solution is either to reinstall Git with symlinks enabled +or manually copy all ``*.css`` files from ``css/`` to +``pelican-theme/static/``, replacing the broken symlinks present there. -- 2.30.2