WikiPage Home modified by Portucalle

Portucalle — Wed, 27 Mar 2013 18:08:16 -0000

--- v3
+++ v4
@@ -1,16 +1,8 @@
-Pages
-=====
+Quick Links
+===========

-Introduction Page : [Introduction]
-Examples : [Examples]
+The documentation for **tkml** will be available in this wiki. Here are a few quick links for accessing the top-level pages:

+* Introduction Page : [Introduction]
+* Examples : [Examples]

-Welcome to your wiki!
-=====================
-
-This is the default page, edit it as you see fit. To add a new page simply reference it within brackets, e.g.: [SamplePage].
-
-The wiki uses [Markdown](/p/tkml/wiki/markdown_syntax/) syntax.
-
-[[project_admins]]
-[[download_button]]

WikiPage Home modified by Portucalle

Portucalle — Wed, 27 Mar 2013 17:10:21 -0000

--- v2
+++ v3
@@ -2,6 +2,7 @@
 =====

 Introduction Page : [Introduction]
+Examples : [Examples]

 Welcome to your wiki!

WikiPage Home modified by Portucalle

Portucalle — Wed, 27 Mar 2013 16:35:18 -0000

--- v1
+++ v2
@@ -1,4 +1,11 @@
+Pages
+=====
+
+Introduction Page : [Introduction]
+
+
 Welcome to your wiki!
+=====================

 This is the default page, edit it as you see fit. To add a new page simply reference it within brackets, e.g.: [SamplePage].

Discussion for Home page

Portucalle — Wed, 27 Mar 2013 16:30:21 -0000

Description

What is it?

tkml is a library written in pure Tcl which make use of the Itcl object oriented package for providing its users (Tcl/Tk programmers) with a way of easily creating GUIs based on XML text with a pre-defined set of tags and corresponding attributes.

What is it for?

The tkml library is intended to be used as a very simple way to build Tk GUIs and edit them on the fly. It reads XML text containing pre-defined tags and attributes (whose names are identical to the corresponding Tk widget commands) and creates the corresponding GUI elements. Once created, those elements are accessible through Itcl objects which can be used to read/modify their attributes.
With tkml you can concentrate on creating your GUI's content instead of dealing with its programmatic details.

Who is it for?

tkml is aimed at Tcl/Tk programmers who want to standardize their GUI creation procedures and make use of templates wherever possible. For those who have used CGI/Javascript and realize their ease of use, they should experience no major difficulties in understanding the concept behind the library and how to use it.

Features

Maps XML text into Tcl/Tk GUIs.
The set of tags/attributes used to define the widgets resemble as much as possible the corresponding Tk commands and sub-commands.
Serializes a whole GUI with a single command.
Reads/writes most of the attributes accepted by Tk.

How to use it?

You can save your static or dynamic templates on files (or create them on-the-fly in your code) and then just feed them to the tkml engine which takes care of displaying them. This behavior is similar to the way a Web browser interacts with CGI scripts on the server but, in this case, everything is running on Tcl.
Additionally, you can search for tkml objects by name or ID and query/set their attributes, just like you would using Javascript. For example:
# Load the tkml package #
package require tkml

# Read the file containing the markup #
set handle [open "main-window.xml" "r"]; set xml [read $handle]; close $handle;

# Load the markup into the TclML engine #
mlObject::loadXml $xml

# Find the object containing the 'contents' ID #
set contentsObj [mlObject::findObjectById "contents"]

# Change its background color #
$contentsObj setc background "blue"

In the example above, it is assumed that in file main-window.xml a tag has been defined with the contents ID. After reading the markup from the file and loading it by invoking the loadXml class method of the top level mlObject class, the code finds the object whose ID is contents and changes its background color to blue by invoking the setc (SET Configuration) object method.
Of course, as this is Tcl, your code can create the necessary XML text on-the-fly and feed it to the tkml engine, like in the example below:

# Create new contents #
set    xml "<frame>\n"
append xml "  <label height=\"3\">This is the first page of contents</label>\n"
append xml "</frame>\n"
append xml "<frame><button command=\"show_page_2\">Page 2</button></frame>"

# Find the object containing the 'contents' ID #
set contentsObj [mlObject::findObjectById "contents"]

# Feed it with your XML #
$contentsObj setc xml $xml

In this example, a label and a button are created inside different frame widgets so they get displayed on top of each other (otherwise, they would be displayed next to each other). Next, we simply invoke the setc object method for the xml attribute and provide it with the XML text.

WikiPage Home modified by Portucalle

Portucalle — Wed, 27 Mar 2013 15:13:35 -0000

Welcome to your wiki!

This is the default page, edit it as you see fit. To add a new page simply reference it within brackets, e.g.: [SamplePage].

The wiki uses Markdown syntax.

Portucalle

Recent changes to Home

WikiPage Home modified by Portucalle

WikiPage Home modified by Portucalle

WikiPage Home modified by Portucalle

Discussion for Home page

Description

What is it?

What is it for?

Who is it for?

Features

How to use it?

WikiPage Home modified by Portucalle