Location: PHPKode > projects > XmlWeblication > weblication/content/articles/doc_firsthints.xml
<?xml version="1.0" encoding="utf-8"?>


  <article aid="doc_firsthints">
    <htmltemplate include="article.html"></htmltemplate>
		<contentmenu aid="documentation" />
	<title>First Hints</title>
	<intro>What you will do when sucessfully installed [@:weblication]</intro>
	<author email="hide@address.com">Andi</author>
	<date>Dec 12th 2003</date>
	
	[@:p]Remember [LINK:doc_overview] when reading this hints.
	
	[@:p]It should be a matter of minor priority but everybode wants to
	do this first ,-) So, this Article starts with {em}Layout{/em}-Matters
	first.
	
	[@:0]HTML-Templates
	[@:p]HTML-Starting-File is {strong}[@:weblication]/index.php{/strong}.
	But this file has nothing do to with layout. Within {strong}index.php{/strong}
	you define which Application-Path is to be used. The html-template then will
	load from {strong}[@:weblication]/APPNAME/index.html{/strong}. You have to
	define a HTML template with Placeholders. 
	The HTML code itself may be as simple or complex as you like it.
	
	 [@:p]Placeholders
	 [@:source]Placeholder        will be replaced by
	 [@:source]APP:TITLE ......... Application's title from application/APPNAME/APPNAME.xml {BR}
	           MENU:menuname.xml ..A Menu from menu/MENUNAME.xml {BR}
	           APP:CONTENTMENU ....Contentmenu of actualy displayed Article menu/AID.xml {BR}
	           APP:MAIN ...........[@:weblication]'s Main Procedure {BR}
	           IMAGE:filename.ext .Will be replaced by image from content/articles/img/filename.ext {BR}
	           MENU:menuname.xml ..A Menu from menu/MENUNAME.xml {BR}
						 DATE,YY,MM,DD,{br}
						 YYYY-MM-DD .........The server's date and time{br}
						 
		[@:p]Example: [EXTURL:/weblication/application/weblication-demo/index.html,Template for this demo]
	  (This is the Template of the page you're viewing)
		[@:p]Example for different layouts at the same time [LINK:doc_layout2]
		
		[@:0]A new Capture - Checklist
		[@:p]{ul}
		  {li} Write a Welcome-Article called {strong}mycapture.xml{/strong} and place it in
			Article's subdirectory.
			{li} Write a Contentmenu for your Capture, call it {strong}mycapture.xml{/strong} and place
			it in {strong}menus/{/strong}
			{li} If you want to use MODULE:news for your Capture you have to place ... guess ... a file
			called {strong}mycapture.xml{/strong} into directory {strong}news/{/strong}.
		{/ul}
		
		[@:0]Using Menus
		[@:p]For all new Pages within your Capture write XML-Files like 
		{strong}articles/mycapture_page1.xml{/strong} and define a Menu Item in 
		{strong}menu/mycapture.xml{/strong}.
		You may if necessary define a content menu for each single Article 
		({strong}menu/mycapture_page1.xml{/strong}) but in most cases it will be more
		efficient to define one menu per capture and use includes (the CONTENTMENU-Item in XML) 
		in all articles of this capture. Working with file prefixes will be a good idea.

		[@:0]Using MODULE:news
    [@:p]News may be used for different purposes.{BR} Standalone - an Article which only includes it's
		{strong}news/myarticle.xml{/strong} it's a chronological list of latest news and each entry
		may point to an Article. {BR}Embended - you may have content which is more or less static but of
		one section in your article which is a matter of frequently maintaining. (See 
		the [LINK:doc_listofmodules]). To prevent from editing the static part each time you want to
		maintain the dynamic list you can write the static part in {strong}articles/myarticle.xml{/strong}
		and the dynamic list as a news-module in {strong}news/myarticle.xml{/strong}.


 </article>
<!-- end of file -->
Return current item: XmlWeblication