diff --git a/docs/api/db/system-fields/hidden/index.html b/docs/api/db/system-fields/hidden/index.html index 9232c742..36d7865c 100644 --- a/docs/api/db/system-fields/hidden/index.html +++ b/docs/api/db/system-fields/hidden/index.html @@ -215,10 +215,14 @@

This field controls if Lektor should process the page into a build artifact. -By default each page is built into a build artifact (HTML page) and each -attachment is processed. This can be prevented by setting _hidden to yes.

-

This also automatically applies to all children of a page unless they -forcefully override this setting.

+By default, each page is built into a build artifact (HTML page) and each +attachment is copied to the output directory. +This can be prevented for a particular page or attachment by setting its _hidden to yes.

+

If an explicit value for the _hidden field is not set,the value of the hidden option in the +child configuration — or, for attachments, attachment configuration — section +of the parent's datamodel is checked. +If that, too, is not set, then pages, but not attachments, inherit the hidden status of their parent — +that is, by default, children of hidden pages will not be built, though attachments of hidden pages will.

This is useful for more advanced setups like Single Page Applications.

Hidden pages are automatically also removed from the .children property of records but stay available for querying via the pad.

diff --git a/docs/models/attachments/index.html b/docs/models/attachments/index.html index 245badaf..5c90331a 100644 --- a/docs/models/attachments/index.html +++ b/docs/models/attachments/index.html @@ -138,9 +138,9 @@ exist in the folder they are silently ignored.
  • model: an optional default model that is used for all attachments.
  • order_by: controls the ordering of attachments, similar to how this works for child pages.
    • -
  • hidden: if this is set it can override the hidden flag for all -attachments at once. The default as of Lektor 2 is that attachments are -not hidden by default.
    • +
  • hidden: if this is set, attachments will not be built. + (Note that any setting here may be overridden on a per attachment basis by + setting that attachment's _hidden field.)

    • The hidden flag was added in Lektor 2.0 and the default was changed so that attachments are not hidden by default, even if the parent is.

    diff --git a/docs/models/children/index.html b/docs/models/children/index.html index 60638f0e..f163a322 100644 --- a/docs/models/children/index.html +++ b/docs/models/children/index.html @@ -174,7 +174,10 @@ used to implement categories with filtering.
  • hidden: if this is set it can override the parent's hidden flag for all children. This is particularly useful if you want to have a folder for error pages or other special pages where the parent itself should not -be rendered but all children are. The default is not set.
    • +be rendered but all children should. The default is not set. +(Note that an explicit value for a +child's _hidden field will +override any value set here.)

    The hidden flag was added in Lektor 2.0

    Child Slug Behavior

    Slugs are the URL paths or more correctly: parts of it. The URL paths always are the concatenation from the parent's page URL path plus the diff --git a/index.html b/index.html index 649c9ac2..35a9f88d 100644 --- a/index.html +++ b/index.html @@ -151,7 +151,7 @@ speak multiple languages and allow you to easily create localized websites.

    -