Add FAQ entry about theme overrides (#3406)
Some checks failed
build / Test - 3.10 - macos (push) Has been cancelled
build / Test - 3.11 - macos (push) Has been cancelled
build / Test - 3.12 - macos (push) Has been cancelled
build / Test - 3.10 - ubuntu (push) Has been cancelled
build / Test - 3.11 - ubuntu (push) Has been cancelled
build / Test - 3.12 - ubuntu (push) Has been cancelled
build / Test - 3.8 - ubuntu (push) Has been cancelled
build / Test - 3.9 - ubuntu (push) Has been cancelled
build / Test - 3.10 - windows (push) Has been cancelled
build / Test - 3.11 - windows (push) Has been cancelled
build / Test - 3.12 - windows (push) Has been cancelled
build / Lint (push) Has been cancelled
build / Test build (push) Has been cancelled
build / Build docs (push) Has been cancelled
build / Deploy (push) Has been cancelled

This commit is contained in:
Justin Mayer 2024-10-17 09:13:39 -07:00 committed by GitHub
commit 31264498e1
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -64,6 +64,19 @@ How do I create my own theme?
Please refer to :ref:`theming-pelican`. Please refer to :ref:`theming-pelican`.
Can I override individual templates without forking the whole theme?
====================================================================
Yes, you can override existing templates of the theme that you are using, or
add new templates, via the ``THEME_TEMPLATES_OVERRIDES`` variable. For example,
to override the page template, you can define the location for your templates
like this::
THEME_TEMPLATES_OVERRIDES = ["templates"]
You can then define a custom template in ``templates/page.html``.
See :ref:`settings/themes` for details.
I want to use Markdown, but I got an error. I want to use Markdown, but I got an error.
=========================================== ===========================================
@ -122,7 +135,8 @@ For content in Markdown format::
Template: template_name Template: template_name
Then just make sure your theme contains the relevant template file (e.g. Then just make sure your theme contains the relevant template file (e.g.
``template_name.html``). ``template_name.html``). If you just want to add a new custom template to an
existing theme, you can also provide it in a directory specified by ``THEME_TEMPLATES_OVERRIDES`` (see :ref:`settings/themes`).
How can I override the generated URL of a specific page or article? How can I override the generated URL of a specific page or article?
=================================================================== ===================================================================