Libhtml - Revision history

Sam888 at 03:31, 18 September 2015

2015-09-18T03:31:28Z

2013-02-12T01:24:43Z

cleanup

2009-06-10T14:37:35Z

‎Object instantiation

2009-06-09T20:37:25Z

2009-05-11T14:21:40Z

2009-04-03T14:40:31Z

‎Write out your completed page

2009-04-03T14:40:12Z

‎Build up the page body by divisions

2009-04-03T14:39:37Z

‎Add content to your divisions

2009-04-03T14:39:26Z

‎Add additional tags to the header

2009-04-03T14:39:13Z

‎Use Html.page to begin a new page

@@ Line 2: / Line 2: @@
 The Html class is useful for the preparation of Html pages and is found in the following directory:
-* [http://svn.code.sf.net/p/gramps/code/trunk/gramps/plugins/lib/ trunk/gramps/plugins/lib/]
+* [https://github.com/gramps-project/gramps/tree/master/gramps/plugins/lib master/gramps/plugins/lib/]
 == Standard XHTML Template ==

@@ Line 1: / Line 1: @@
-[[Category:Developers/General]]
+'''Html class''' description and user guide.
-=== Html class ===
+The Html class is useful for the preparation of Html pages and is found in the following directory:
+* [http://svn.code.sf.net/p/gramps/code/trunk/gramps/plugins/lib/ trunk/gramps/plugins/lib/]
 == Standard XHTML Template ==
@@ Line 611: / Line 610: @@
   []
   >>> p

@@ Line 236: / Line 236: @@
 ;indent
 :Indent this object with respect to its parent, if parent exists.  Default = True. Note that the indentation is cumulative.  That is, the indentation of this object will be the sum of its indentation and that of its parent, if the parent is indented.  This is useful for producing human-readable output though it should have no effect on browsers rendering the page.
 ;inline
 :Instruct the write() method to output the tag and all its contents (including any nested elements) as one string. Default is False which means call the output method once for the beginning and ending tags and once for each element contained therein, including sub-elements.
 ;close
 :This element should be closed normally (e.g. <tag>...</tag>).  Default is True.
 ;keyword1=arg1...

← Older revision		Revision as of 20:37, 9 June 2009
Line 353:		Line 353:

	from libhtml import _XMLMS		from libhtml import _XMLMS
		+
		+	=== Using the Html class as a context manager ===
		+
		+	As of Python version 2.5, a new statement has been added to enable you to program within a given context. The "with" statement accomplishes this for you. The Html class supports being used in the "with" statement. That means that you can write code like:
		+
		+	with Html('table') as table:
		+	with Html('tbody') as tbody:
		+	table += tbody
		+	with Html('tr') as trow:
		+	tbody += trow
		+	with Html('td') as tcell:
		+	trow += tcell
		+	tcell += 'foobar'
		+
		+	which has the advantage that the indentation structure of your program will match the indentation structure of the html file produced by the write() method.
		+
		+	Note: If you want to use the "with" statement in programs that may run under Python version 2.5, you must include the following as the first executable statement of your module:
		+
		+	from __future__ import with_statement

	== Recommended approach ==		== Recommended approach ==

← Older revision		Revision as of 14:21, 11 May 2009
Line 1:		Line 1:
		+	[[Category:Developers/General]]
		+
	=== Html class ===		=== Html class ===

@@ Line 401: / Line 401: @@
   div1 += table
-== Write out your completed page ==
+=== Write out your completed page ===
 When all content has been added to your page, write it out:

@@ Line 371: / Line 371: @@
   head += Html('link', media="screen" href="../my.css" type="text/css" rel="stylesheet"
-== Build up the page body by divisions ==
+=== Build up the page body by divisions ===
 Try to design the body of your document as a logical arrangement of divisions that refer to CSS styles.  Instantiate each division separately:

@@ Line 389: / Line 389: @@
 '''Note:''' by adding them as a list, the divisions are siblings within the body.
-== Add content to your divisions ==
+=== Add content to your divisions ===
 If you are adding content that is more or less fixed, just add it directly:

@@ Line 364: / Line 364: @@
 You will then have three Html objects to use for the rest of your work.  (Insert your own title text as desired.)
-== Add additional tags to the header ==
+=== Add additional tags to the header ===
 Many pages require additional tags to be added to the <head> ... </head> section.  These can easily be added like this:

@@ Line 356: / Line 356: @@
 The Html class is versatile and there are many ways to use it to produce an HTML page.  You can make your life easier, however, if you organize your work as described in this section.
-== Use Html.page to begin a new page ==
+=== Use Html.page to begin a new page ===
 The Html.page function takes care of the HTML boilerplate that is needed for every valid HTML page.  Start off like this: