Synchronized build

docs/api/db/system-fields/hidden/index.html

@@ -215,10 +215,14 @@
       </ul>
 
       <p>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
+By default, each page is built into a build artifact (HTML page) and each
-attachment is processed.  This can be prevented by setting <code>_hidden</code> to <code>yes</code>.</p>
+attachment is copied to the output directory.
-<p>This also automatically applies to all children of a page unless they
+This can be prevented for a particular page or attachment by setting its <code>_hidden</code> to <code>yes</code>.</p>
-forcefully override this setting.</p>
+<p>If an explicit value for the <code>_hidden</code> field is not set,the value of the <code>hidden</code> option in the
+<a href="https://www.getlektor.com/docs/models/children/#child-configuration" title="The [children] section of the datamodel">child configuration</a> — or, for attachments, <a href="https://www.getlektor.com/docs/models/attachments/" title="The [attachments] section of the datamodel">attachment configuration</a> — 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.</p>
 <p>This is useful for more advanced setups like <a href="../../../../guides/single-page/" class="ref">Single Page Applications</a>.</p>
 <p>Hidden pages are automatically also removed from the <code>.children</code> property
 of records but stay available for querying via the pad.</p>

docs/models/attachments/index.html

@@ -138,9 +138,9 @@ exist in the folder they are silently ignored.</li>
 <li><code>model</code>: an optional default model that is used for all attachments.</li>
 <li><code>order_by</code>: controls the ordering of attachments, similar to how this
 works for child pages.</li>
-<li><code>hidden</code>: if this is set it can override the hidden flag for all
+<li><code>hidden</code>: if this is set, attachments will not be built.
-attachments at once.  The default as of Lektor 2 is that attachments are
+ (Note that any setting here may be overridden on a per attachment basis by
-not hidden by default.</li>
+ setting that attachment's <a href="https://www.getlektor.com/docs/models/attachments/"><code>_hidden</code> field</a>.)</li>
 </ul>
 <div class="admonition admonition-info"><p>The <code>hidden</code> 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.</p></div>

docs/models/children/index.html

@@ -174,7 +174,10 @@ used to implement categories with filtering.</li>
 <li><code>hidden</code>: 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.</li>
+be rendered but all children should.  The default is not set.
+(Note that an explicit value for a
+<a href="/docs/api/db/system-fields/hidden/">child's <code>_hidden</code> field</a> will
+override any value set here.)</li>
 </ul>
 <div class="admonition admonition-info"><p>The <code>hidden</code> flag was added in Lektor 2.0</p></div><h2 id="child-slug-behavior">Child Slug Behavior</h2><p>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

index.html

@@ -151,7 +151,7 @@ speak multiple languages and allow you to easily create localized websites.</li>
 <div class="slideshow-wrapper">
   <div class="slideshow">
     <div class="slideshow-inner">
-      <div class="carousel slide" data-ride="carousel" data-interval="8500" id="carousel-f593b837ab0041d0b170e07917634bbb">
+      <div class="carousel slide" data-ride="carousel" data-interval="8500" id="carousel-bcf39b6ec611478c82e0fec68dd1fe87">
         
         <div class="carousel-inner" role="listbox">
           
@@ -210,11 +210,11 @@ be completely customized.</p>
           </div>
           
         </div>
-        <a class="left carousel-control" href="#carousel-f593b837ab0041d0b170e07917634bbb" role="button" data-slide="prev">
+        <a class="left carousel-control" href="#carousel-bcf39b6ec611478c82e0fec68dd1fe87" role="button" data-slide="prev">
           <span class="glyphicon glyphicon-chevron-left" aria-hidden="true"></span>
           <span class="sr-only">Previous</span>
         </a>
-        <a class="right carousel-control" href="#carousel-f593b837ab0041d0b170e07917634bbb" role="button" data-slide="next">
+        <a class="right carousel-control" href="#carousel-bcf39b6ec611478c82e0fec68dd1fe87" role="button" data-slide="next">
           <span class="glyphicon glyphicon-chevron-right" aria-hidden="true"></span>
           <span class="sr-only">Next</span>
         </a>