mirror of
https://github.com/getpelican/pelican.git
synced 2025-10-15 20:28:56 +02:00
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
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:
commit
31264498e1
1 changed files with 15 additions and 1 deletions
16
docs/faq.rst
16
docs/faq.rst
|
|
@ -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?
|
||||||
===================================================================
|
===================================================================
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue