markup features
<!--this is an comment-->Known capitalised comments words are called tokens in docTree and are replaced for content that is calculated on the fly. Many tokens are concerned with navigating around the site, providing menus relative to where you are. Many other tokens are intended to contexualise the template, but there are several other interesting ones too.
Everything that follows on this page is proprietary and will not translate into another content management system. The easiest is to use the published pages as a basis for exporting, because all the tokens on the published pages are interpreted, at least for that moment in time. Anyone planning to migragte out of docTree should use these tokens lightly.
tokens intended for the template
<!--BODY--> this is where your contents go
<!--TITLEBAR--> this is the name of the folder, or website
<!--SEARCHFIELD--> This replaced by a simple search field, which you can edit in SEARCHFIELD.htm
<!--GOOGLEFIELD--> inserts a google search field (for the whole domain) in your html output
<!--PAGENAME--> the name of the page
<!--TOOLS--> Is replaced by a sequence of divs, each one containing link to a function which the current user is permitted to do
tokens intended for navigation <!--MAINMENU--> Is replaced by your main menu, which is a sequence of divs, with the class MAINMENU
<!--SUBMENU--> Is replaced by your second level menu, which is a sequence of divs with the class SUBMENU
<!--TREEMENU--> Is replaced by a two level menu, with the relevent level expanded. Using the clases as above
<!--CHILDREN--> is replaced by a sequence of divs showing the immediate descendents of the page, using the class CHILD
<!--PATH--> Is replaced by a sequence of divs containing pagenames starting at the top of the tree and navigating to the current page. class=PATH
<!--PREVNEXT--> is replaced by three divs nested in one, providing previous and next links, and a counter. four classes can be found in default stylesheet
other tokens
<!--LOGIN--> In html mode, this token is replaced by a link to the php mode,
<!--LOGINVITE--> This provides a link for the visitor to login (published websites only)
<!--WEBSITELIST--> A list of all the sibling websites
<!--LASTCHANGED-->shows the last published date of site for htm, or last changed date of page for php modes
<!--GOOGLEFIELD-->Becomes a google search bar in html mode, invisible in other modes.
used internally, but you can use them too
<!--SEARCHSTRING--> this is used internally and is replaced by the text that was searched for
<!--DOMAIN-->Gives the server root (this is used behind the scenes for the Google search)
<!--MESSAGES--> this tells the developer / editor any messages generated in the building of the page (php mode only)
<!--PIPE--> allows you to display the pipe symbol without it being mistaken for a link
pipes
pipes are always used to delimit links to within the wiki itself. docTree decides whether you want to include a picture, an attachment or link to another page
Use of the double pipe delimits an included page
sitemap
The arrangement of the pages into a tree happens in the sitemap where hash symbols # are used to indent a pagename,, one pagename on each line, indicating the pages relationship to the page on the line above it. At the moment this can break if the number of hashes on one line is more than one than on the line above.
| mail matthew |