NatSkinTemplates

(TODO: This docu only reflects the templates used on a beijing or cairo TWiki engine. The extra templates used on a dakar engine aren't listed here yet.)

The template setup of the NatSkin differes completely from the standard templates that come with the TWiki folowing its own inner logic compared to the TWiki:Plugins/PatternSkin. The NatSkinTemplates have especially been designed to simplify subskins overwriting parts of the NatSkin.

Every template belongs to a group defined by their function:

• #SkinBaseTemplates: all templates build uppon these
• #AttachTemplates: render the attach pages
• #ChangesTemplates: render the changes (note, the changes cgi has been deprecated)
• #ChangeFormTemplates: render pages used to change a form of a topic
• #EditTemplates: render the edit pages
• #MoveAttachmentTemplates: render pages used to move an attachment
• #OopsTemplates: render oops messages
  • #OopsMessagesTemplates: render notification messages
  • #OopsAuthentificationTemplates: render authentification pages
  • #OopsSystemErrorsTemplates: render error messages
• #PreviewTemplates: render preview page after an edit page
• #DiffTemplates: templates used to render differences of topic versions
• #RenameMoveTemplates: render pages used during topic renaming
• #SearchTemplates: render all sorts of search results
• #ViewTemplates: render the normal topic view

Each group consists of one or more entry templates, e.g. attach group has three entry templates: attach, attachnew and attachagain, If a template group has more than one entry template then these build upon and intercostal base template, named <name>base template (where <name is the short name for the template group). The base template might also be an entry template. The base suffix is then stripped from the template name. For example in the attach group there are two pure entry template, attachnew and attachagain, that base on the attach template which is an entry template also. Pure base templates are for example the renamebase or the oopslogonbase templates. See below for more.

The oops template group is a bit different from the others as it has subgroups of templates for authentification, notification and error messages. Some of these groups have an own base template shared among messages of the same type. All oops templates are finally using the central oops template. Ssee the INCLUDE hierary below.

Every group uses three fragment templates:

• <name>body: the html body
• <name>sidebar: the sidebar next to the main area
• <name>topicactions: the upper right fragment displaying possible actions for the current topic page

So the fragment templates for the attach group are attachbody, attachsidebar and attachtopicactions (omitting the nat.tmpl extension). These can be used by subskins to implement a different look and feel per web with a minimal amount of code duplication.

All groups finally call the page template that constructs the resulting html by inserting all TMPL macros. The page template itself only defines defaults for the standard fragments.

This is the INCLUDE hierarchy of the templates in the NatSkin. Each indentation means, that the upper template INCLUDEs the lower template(s). If a template name has already been defined, further indentations are pruned. So whenever a template INCLUDEs the page template all default fragments are left out for clarity.

1. Skin Base templates:
   • page
     • javascript
     • defaultbody
     • defaultsidebar
     • defaulttopicactions
     • defaulttopbar
   • searchbox
2. Attach templates:
   • attachagain, attachnew
     • attach
       • page
       • attachbody
       • attachsidebar
       • attachtopicactions
3. Changes templates:
   • changes
     • page
     • changesbody
     • changessidebar
     • changestopicactions
4. Change Form templates:
   • changeform
     • page
     • changeformbody
     • changeformsidebar
     • changeformtopicactions
5. Edit templates:
   • edit
     • page
     • editsidebar
     • edittopicactions
6. Move Attachment templates:
   • moveattachment
     • page
     • moveattachmentbody
     • moveattachmentsidebar
     • moveattachmenttopicactions
7. Oops templates:
   • oops
     • page
     • oopsbody
     • oopssidebar
     • oopstopicactions
   1. Messages:
      • oopsbadpwformat, oopschangepasswd, oopsempty, oopslocked, oopslockedrename, oopsmanage, oopsmissing, oopsmngcreateweb, oopsmore, oopsnoformdef, oopsnotwikiuser, oopsnoweb, oopspreview, oopsregemail, oopsregexist, oopsregpasswd, oopsregrequ, oopsregthanks, oopsregwiki, oopsrenamenotwikiword, oopsresetpasswd, oopsrev, oopssave, oopstopicexists, oopsupload
        • oops
   2. Authentication:
      • oopslogon, oopsaccesschange, oopsaccesscreateweb, oopsaccessgroup, oopsaccessrename, oopsaccessview, oopsaccessvote, oopsauth, oopswrongpassword
        • oopslogonbase
          • oops
   3. System Errors:
      • oopsmoveerr, oopsrenameerr, oopssaveerr, oopssendmailerr, oopssoftwareerr
        • oopserrbase
          • oops
8. Preview templates:
   • preview
     • page
     • previewbody
     • previewsidebar
     • previewtopicactions
9. Diff templates:
   • rdiff
     • page
     • rdiffbody
     • rdiffsidebar
     • rdifftopicactions
10. Rename/Move templates:
    • rename, renameconfirm, renamerefs
      • renamebase
        • page
        • renamebody
        • renamesidebar
        • renametopicactions
11. Search templates:
    • search, searchbookview, searchformat, searchrenameview
      • searchbase
        • page
        • searchbody
        • searchsidebar
        • searchtopicactions
          • searchbox
12. View templates:
    • view
      • page
      • viewbody
      • viewsidebar
      • viewtopicactions
        • searchbox