====== Section Editing ======

Section Editing **allows** to edit a [[page#Sections|sub-section]] of the page only. This makes it easier to change long documents. Section Editing is sometimes called //Partial Page Editing//.

If you have the [[ACL|rights to do it]], each headline (usually only the first 3 levels) starts a new section. When a page is writable a small ''Edit'' button appears at the end of the section. Using this button loads only this section into the editor.

===== Configuration =====
  * In the Admin page, you can set up the maximum level of section editing, so that your page isn't flooded by "edit" buttons. See ''Maximum section edit level'' in your admin page or [[config:maxseclevel]] in your local.php config file.

===== Tips =====
  * Setting up a [[:config:maxseclevel]] of 0 will disable section editing.
  * If you prefer having your ''edit'' button beside the header, see the plugin [[plugin:editsections]]
  * To edit part of longs sections, you can put sections with no text in it. The button will still appear (if they are not of a level higher than maxseclevel). However this may break you style, so you should then correct your CSS.

===== Issues =====
  * The use of the linebreak plugin may break the section editing mechanism : see [[plugin:linebreak#bugs|bug]]
  * It is not possible, to collaborate on one page with one editing a section and someone else editing another. This is due to the fact that section editing [[locking|locks]] the whole page.