diff --git a/content/developer/howtos/website_themes/layout.rst b/content/developer/howtos/website_themes/layout.rst
index 3b5c79d71..5ebfbd2e9 100644
--- a/content/developer/howtos/website_themes/layout.rst
+++ b/content/developer/howtos/website_themes/layout.rst
@@ -10,6 +10,8 @@ In this chapter, you will learn how to:
- Add a copyright section.
- Improve your website's responsiveness.
+.. _website_themes/layout/default :
+
Default
=======
@@ -41,12 +43,14 @@ an `` tag.
.. note::
- Using precise file names is important to find information through all modules quickly. File names
- should only contain lowercase alphanumerics and underscores.
+ Using precise template names is important to find information through all modules quickly.
+ Template names should only contain lowercase alphanumerics and underscores.
Always add an empty line at the end of your file. This can be done automatically by configuring
your IDE.
+.. _website_themes/layout/xpath :
+
XPath
=====
@@ -71,7 +75,7 @@ A view is coded the following way.
* - id
- ID of the modified view
* - inherited_id
- - ID of the standard view
+ - ID of the standard view (using the following pattern: `module.template`)
* - name
- Human-readable name of the modified view
@@ -99,6 +103,8 @@ For each XPath, you modify two attributes: **expression** and **position**.
all inheritance at a glance. As final *XML IDs* are prefixed by the module that creates them,
there is no overlap.
+.. _website_themes/layout/xpath/expressions :
+
Expressions
-----------
@@ -137,6 +143,8 @@ expression to target the right element. The most useful ones are listed below.
* - \*[@t-call="t-call"]
- Selects a specific t-call.
+.. _website_themes/layout/xpath/position :
+
Position
--------
@@ -162,32 +170,6 @@ below:
- Adds the XPath content inside an attribute.
.. example::
- This XPath adds a `