You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tdewebdev/quanta/data/doc/templates.html

190 lines
7.4 KiB

<html>
<head>
<title>Konquer the Web with Quanta!</title>
<link rel="stylesheet" href="konq.css" type="text/css" />
<link rel="stylesheet" href="quanta.css" type="text/css" />
</head>
<body BGCOLOR=#3679AD LEFTMARGIN=0 TOPMARGIN=5>
<a name="top"></a>
<div style="position:absolute; left: 0px; top: 5px; right: 0px; bottom: 500px;">
<table BORDER=0 WIDTH=100% CELLPADDING=0 CELLSPACING=0 CELLPADDING=0>
<colgroup>
<col WIDTH=170>
<col WIDTH=20>
<col WIDTH=309>
<col WIDTH=*>
</colgroup>
<tr HEIGHT=24>
<td BGCOLOR=#505050 ALIGN=RIGHT><img width="77" height="22" src="aniquanta.gif" border="0"></td>
<td class="deco" BGCOLOR=#505050 COLSPAN=3>Konquer the Web with Quanta!</td>
</tr>
<tr>
<td WIDTH=190 COLSPAN=2 ROWSPAN=2> &nbsp;</td>
<td BGCOLOR=#DDDDDD><img WIDTH=309 HEIGHT=77 SRC="quantahdr.png"></td>
<td BGCOLOR=#DDDDDD BACKGROUND="lines.png"><img src="webdev.png" width="135" height="77" border="0"></td>
</tr>
<tr>
<td COLSPAN=2 BGCOLOR=#505050 ALIGN=RIGHT HEIGHT=22>
<table BORDER=0 CELLPADDING=0 CELLSPACING=0 CELLPADDING=0>
<tr>
<td HEIGHT=20 class="menu">&nbsp; <a class="menu" HREF="intro.html">Introduction</a> &nbsp;</td><!-- Introduction -->
<td HEIGHT=20 class="menu">|</td>
<td HEIGHT=20 class="menu">&nbsp; <a class="menu" HREF="faq.html">FAQ</a> &nbsp;</td><!-- Introduction -->
<td HEIGHT=20 class="menu">|</td>
<td HEIGHT=20 class="menu">&nbsp; <a class="menu" HREF="tips.html">Tips</a> &nbsp;</td><!-- Tips -->
<td HEIGHT=20 class="menu">|</td>
<td HEIGHT=20 class="menuactive">&nbsp; Where we're going &nbsp;</td>
<td HEIGHT=20 class="menu">|</td>
<td HEIGHT=20 class="menu">&nbsp; <a class="menu" HREF="developer.html">Developer Info</a> &nbsp;</td><!-- Specifications -->
<td HEIGHT=20 class="menu">&nbsp;</td>
</tr>
</table>
</td>
</tr>
<tr>
<td COLSPAN=2 WIDTH=190></td>
<td COLSPAN=2 class="shadow1" HEIGHT=9 COLSPAN=4></td>
</tr>
<tr>
<td COLSPAN=2 WIDTH=190></td>
<td COLSPAN=2 HEIGHT=41 COLSPAN=4></td>
</tr>
</table>
<!-- end of header -->
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0 CELLPADDING=0>
<TR>
<TD WIDTH=190></TD>
<TD class="trans" BGCOLOR=#D0DFEC>
<TABLE WIDTH= 100% BORDER=0 CELLPADDING=0 CELLSPACING=0 CELLPADDING=0>
<TR>
<TD HEIGHT=20 WIDTH=20>&nbsp;</TD>
<TD>&nbsp;</TD>
</TR>
<TR>
<TD WIDTH=20>&nbsp;</TD>
<TD VALIGN=TOP>
<!-- here comes the content -->
<P><H2>Quanta Plus Templates<H2></P>
<p class="minihdr">Template description
</p>
<p>Templates are basically skeleton documents, code snippets and files to link to. Quanta
uses templates fundementally as a standard file system with enhanced organization and interfacing.
You can copy, move or link any repository currently on your system into the templates tree.
Think of Quanta templates as having roughly the limitations to your imagination that your file system
has.
</p>
<p>Templates exist in nested directories. There is no limit to how deep you can nest them however
within any given directory Quanta expects a consistent action for the base template type described
below. Additionally templates allow for <i>pre</i> and <i>post</i> text to be concatonated to
non document type templates. This facilitates tag creation. The next update after the introduction
is scheduled to add the ability to pass variables to the text such as image size information to
assist in tag creation.
</p>
<p class="minihdr">Template types
</p>
<p>Currently templates are limited to being one of the following types of objects:
<ul>
<li>Document </li>
<li>Text to insert in a document </li>
<li>A file to link to from a document </li>
</ul>
Documents can be any type of document. Generally you would want to nest more specific or diverse
documents in subdirectories. Here you can make a basic framework for what you do and deliver it
to your work in an organized fashion and realize much better effiency. Text insertion could be
anything from a snippet of code to a script or whatever you might wish to use. Note also this overlaps
the ability to insert text blocks as an action which can be triggered from the toolbar. Linked files
can be binary, PHP class libraries or whatever.
</p>
<p class="minihdr">Template scope
</p>
<p> Templates are scoped into three general categories: Global, Local and Project.
<ul>
<li>Global - Available to all folks all the time. </li>
<li>Local - Available to a specific user (maybe others if they can see it where it
exists in the file system). </li>
<li>Project - Available to the associated project only. </li>
</ul>
</p>
<p class="minihdr">Creating templates
</p>
<p>Create a document structure that you love (XML, HTML, DocBook, etc.) and
click on File->Save as Template->Save as Local/Project Template.
</p>
<p> Once this is done, you'll notice that (even if it's saved as a Project template)
the template does NOT show in the project tab view. Look into the templates view
to find your template under the Project templates tab.
</p>
<p>Additinoally if you look at your options with the Right Mouse Button (RMB) you
will see complete file management tools for creatind directories or copying and pasting
templates from one location to another.
</p>
<p class="minihdr">Using templates with Projects
</p>
<p>Project templates allow you to be more tightly focused. You can create headers, footers
or go dynamic with PHP include files and link them. Additionally there are some very
cool things we took into consideration when using templates in projects.
<ul>
<li>When creating a project you can opt to copy over all global and user templates. </li>
<li>Legacy project get default templating abilities so nothing is lost </li>
<li>You can choose where to locate your template files so they can be in your server root
and easy to upload or you can make them secure to link to below server root which is a
very cool trick </li>
<li>When linking to a file not in the project templates you will be prompted to copy
the file to the project templates prior to linking. This will prevent broken links on upload. </li>
<li>You always have control where you place your templates so you can choose to move them.
However Quanta does not track this so you will need to change links. This is a good
task for kfilereplace which we are setting up to plug in as a kpart. </li>
</ul>
</p>
<p class="minihdr">Templates conclusion
</p>
<p>Our goal with templates is to extend them to include multi file "concept" templates useful
for things like placing an order or creating an about section, Ideally this will be a tool for
making your work more productive and dynamic. An eventual goal is to have a structural template
design mode to deal with site layout and structure which you could use to design and interactively
update your sites. If you would like to be involved contact us.
</p>
<br>
&nbsp;<IMG WIDTH=16 HEIGHT=16 BORDER=0 SRC="more.png">&nbsp;<A HREF="developer.html">Continue</A>
<!-- End of text -->
</TD>
<TD WIDTH=20>&nbsp;</TD>
</TR>
<TR>
<TD HEIGHT=20 WIDTH=20>&nbsp;</TD>
<TD>&nbsp;</TD>
</TR>
</TABLE>
</TD>
<TD WIDTH=20>&nbsp;</TD>
</TR>
<TR>
<TD HEIGHT=91 COLSPAN=3>&nbsp;</TD>
</TR>
</TR>
</TABLE>
<TABLE WIDTH=100% BORDER=0 CELLSPACING=0 CELLPADDING=0>
<TR>
<TD class="end" WIDTH=*>&nbsp;</TD>
<TD WIDTH=204><A HREF="http://www.kde.org"> <IMG WIDTH=204 BORDER=0 HEIGHT=57
SRC="kdelogo2.png"></A></TD>
</TR>
<TR>
<TD HEIGHT=50 COLSPAN=2>&nbsp;</TD>
</TR>
</TABLE>
</div>
</BODY>
</HTML>