Sidebar

This plugin adds a panel to the GUI which contains context sensitive content. This means it is possible to define different content for this panel based on the current page of the book. Until the sidebar has been opened or closed by the user manually, it will be in "automatic mode". In this mode, it will automatically open upon content changes, and closed again after a customizable amount of time.

= Settings =

= Tags = This plugin uses an extra child node of the  node to define the contents of the sidebar.

The main node name is. This node can contain any number of child nodes named, which must have an attribute named. This is the page number starting at which the content defined in the  node gets displayed. The actual content must be defined in the form of ASUL definitions.

= Example =

Example 2: specific font styles
You can adjust your text using HTML tags; like color or font size. But keep in mind that all data within the sidebar is parsed by ASUL and not MegaZine3. And that makes a big difference! Not only that an ASUL TEXT object is far mor complex than a MZ3 element, it also does not allow child elements. Reason is, that due to the clear structure of a MegaZin3 book with e.g. - - - - - elements, the ASUL structure is not as strict, which would make parsing more complicated and error prone. Therefore no child elements within ASUL objects are allowed.

Something that is valid as a CDATA child node in a MZ3 structure like: is not allowed in ASUL syntax. There all has to be defined within the ASUL object.

This results in code like this for text of different size and color:

Please note that instead of the usual delimiters "<" and "<" their literal representation "&lt;" and "&gt;" must be used (because of parsing restrictions). The 4th definition is special. There a reference by an ID to a definition in the language file megazine.xml is made. The ID "localized_txt1" links to the text provided with the megazine/langs/xx/megazine.xml file (xx is the 2-letter code for the language), which will be output within the sidebar. The content of the megazine.xml file was extended by the text to be output in the sidebar as 4th element like this: Everything but the 4th definition is standard. That row defines a text in a common [http://www.megazine3.de/doc/Text_(page_element)#content_. CDATA] representation. Advantage: easier to read localization of the text easily possible (language specific versions can be provided in a standard way.

Here a screenshot of the above given definitions