[Repoze-checkins] r608 - www/trunk/blog.repoze.org/entries
repoze at laguna.palladion.com
repoze at laguna.palladion.com
Thu Dec 6 16:32:31 UTC 2007
Author: repoze
Date: Thu Dec 6 16:32:31 2007
New Revision: 608
Log:
Further tweakage.
Modified:
www/trunk/blog.repoze.org/entries/december_usergroups.txt
www/trunk/blog.repoze.org/entries/theming_trac_with_deliverance.txt
Modified: www/trunk/blog.repoze.org/entries/december_usergroups.txt
==============================================================================
--- www/trunk/blog.repoze.org/entries/december_usergroups.txt (original)
+++ www/trunk/blog.repoze.org/entries/december_usergroups.txt Thu Dec 6 16:32:31 2007
@@ -14,7 +14,8 @@
on Repoze to the <a href="http://trizpug.org">Triangle ZPUG</a>, on
December 4th, and to the
<a href="http://groups.google.com/group/charpy">Charlotte Python
- Group</a> on December 5th.</li>
+ Group</a> on December 5th. It looks as though we will be able to
+ do some sprinting on the day of the 5th, as well.</li>
<li>Chris and Tres have also been invited to present Repoze to the
<a href="http://python.meetup.com/46/calendar/6705977/">Atlanta
Modified: www/trunk/blog.repoze.org/entries/theming_trac_with_deliverance.txt
==============================================================================
--- www/trunk/blog.repoze.org/entries/theming_trac_with_deliverance.txt (original)
+++ www/trunk/blog.repoze.org/entries/theming_trac_with_deliverance.txt Thu Dec 6 16:32:31 2007
@@ -1,11 +1,18 @@
Theming Trac with Deliverance
#label general
-<p>While in North Carolina to present Repoze to Zope and Python user
+
+<blockquote>
+<em>Click the screenshot images below to see them without scaling.</em>
+</blockquote>
+
+<p><a target="blank" href="http://static.repoze.org/secoora-theme.png"
+ ><img width="50%" height="50%" align="right"
+ src="http://static.repoze.org/secoora-theme.png" /></a>
+ While in North Carolina to present Repoze to Zope and Python user
groups, we worked with our host, Chris Calloway, to help wrap his
trac instances within the theming and branding of his project site.</p>
-<p><img align="right" src="http://static.repoze.org/secoora-theme.png" />
- Chris supports <a href="http://secoora.org/">SECOORA</a>, a regional
+<p>Chris supports <a href="http://secoora.org/">SECOORA</a>, a regional
marine science collaboration, and needed a way to share branding
for the <a href="http://trac.edgewall.org">Trac</a> instances he
maintains for the various SECOORA software projects.</p>
@@ -47,6 +54,10 @@
...
</pre>
+<p><a target="blank" href="http://static.repoze.org/trac-unthemed.png"
+ ><img width="50%" height="50%" align="right"
+ src="http://static.repoze.org/trac-unthemed.png" /></a></p>
+
<h3>Running Trac under Paste</h3>
<p>Now we can start the server:</p>
@@ -56,7 +67,7 @@
</pre>
<p>And view the Trac homepage.
- <img align="right" src="http://static.repoze.org/trac-unthemed.png" /></p>
+ </p>
<h3>Adding Deliverance to the Mix</h3>
@@ -73,18 +84,21 @@
<pre>
$ cat /etc/minimal_rules.xml
-<?xml version="1.0" encoding="UTF-8"?>
-<rules xmlns="http://www.plone.org/deliverance" >
- <prepend theme="//head" content="//head/link" nocontent="ignore" />
- <prepend theme="//head" content="//head/style" nocontent="ignore" />
- <append theme="//head" content="//head/script" nocontent="ignore" />
- <append theme="//head" content="//head/meta" nocontent="ignore" />
- <copy theme="//table[@id='portal-columns']"
- content="//div[@id='content']" />
-</rules>
+<?xml version="1.0" encoding="UTF-8"?>
+<rules xmlns="http://www.plone.org/deliverance" >
+ <prepend theme="//head" content="//head/link" nocontent="ignore" />
+ <prepend theme="//head" content="//head/style" nocontent="ignore" />
+ <append theme="//head" content="//head/script" nocontent="ignore" />
+ <append theme="//head" content="//head/meta" nocontent="ignore" />
+ <copy theme="//table[@id='portal-columns']"
+ content="//div[@id='content']" />
+</rules>
</pre>
-<p>And configure Deliverance into the pipeline, using those rules:</p>
+<p> <a target="blank" href="http://static.repoze.org/trac-minimal.png"
+ ><img width="50%" height="50%" align="right"
+ src="http://static.repoze.org/trac-minimal.png" /></a>
+ And configure Deliverance into the pipeline, using those rules:</p>
<pre>
$ cat /etc/paste.ini
@@ -100,38 +114,45 @@
trac
</pre>
-<p>View the themed site:
- <img align="right" src="http://static.repoze.org/trac-minimal.png" /></p>
<h3>Making Trac's Nav Fit into the Theme</h3>
-<p>As you can see, the minimal site does not expose any of the standard
+<p>
+ As you can see, the minimal site does not expose any of the standard
Trac navigation links: instead, its navigation is thet from the
theme (a Plone site). We modified the rules file to merge the Trac
links into the theme, along with the search form. </p>
<pre>
$ cat /etc/trac_rules.xml
-<?xml version="1.0" encoding="UTF-8"?>
-<rules xmlns="http://www.plone.org/deliverance" >
- <prepend theme="//head" content="//head/link" nocontent="ignore" />
- <prepend theme="//head" content="//head/style" nocontent="ignore" />
- <append theme="//head" content="//head/script" nocontent="ignore" />
- <append theme="//head" content="//head/meta" nocontent="ignore" />
- <drop theme="//ul[@id='portal-siteactions']" />
- <append-or-replace theme="//head" content="//head/title" nocontent="ignore" />
- <replace theme="//form[@name='searchform']" content="//form[@id='search']" />
- <copy theme="//ul[@id='portal-globalnav']"
- content="//div[@id='ctxtnav']/ul/*" nocontent="ignore" />
- <copy theme="//ul[@id='portal-personaltools']"
- content="//div[@id='mainnav']/ul/*" />
- <append theme="//ul[@id='portal-personaltools']"
- content="//div[@id='metanav']/ul/*" />
- <drop theme="//div[@id='portal-breadcrumbs']" />
- <copy theme="//table[@id='portal-columns']"
- content="//div[@id='content']" />
-</rules>
+<?xml version="1.0" encoding="UTF-8"?>
+<rules xmlns="http://www.plone.org/deliverance" >
+ <prepend theme="//head" content="//head/link" nocontent="ignore" />
+ <prepend theme="//head" content="//head/style" nocontent="ignore" />
+ <append theme="//head" content="//head/script" nocontent="ignore" />
+ <append theme="//head" content="//head/meta" nocontent="ignore" />
+ <drop theme="//ul[@id='portal-siteactions']" />
+ <append-or-replace theme="//head" content="//head/title" nocontent="ignore" />
+ <replace theme="//form[@name='searchform']" content="//form[@id='search']" />
+ <copy theme="//ul[@id='portal-globalnav']"
+ content="//div[@id='ctxtnav']/ul/*" nocontent="ignore" />
+ <copy theme="//ul[@id='portal-personaltools']"
+ content="//div[@id='mainnav']/ul/*" />
+ <append theme="//ul[@id='portal-personaltools']"
+ content="//div[@id='metanav']/ul/*" />
+ <drop theme="//div[@id='portal-breadcrumbs']" />
+ <copy theme="//table[@id='portal-columns']"
+ content="//div[@id='content']" />
+</rules>
+</pre>
+
+<p><a target="blank" href="http://static.repoze.org/trac-themed.png"
+ ><img width="50%" height="50%" align="right"
+ src="http://static.repoze.org/trac-themed.png" /></a>
+ We then swtich the Deliverance Paste configuration to use the new
+ rules.</p>
+<pre>
$ cat /etc/paste.ini
...
[filter:deliverance]
@@ -140,9 +161,13 @@
rule_uri = file:///%(here)s/trac_rules.xml
</pre>
-<p>Now, we see the fully-themed site:
- <img align="right" src="http://static.repoze.org/trac-themed.png" />
- Notice that the "tabs" in the Plone theme are now the "global" navigation
- links from the Trac application, whilte the "personal tools" in the theme
- now contains the "main" and "meta" nav links from Trac. The search form
- is now the Trac version, and the Plone "breadcrumbs" are gone. </p>
+<p>Now, we see the fully-themed site. Notice that:</p>
+
+<ul>
+ <li>The "tabs" in the Plone theme are now the "global" navigation
+ links from the Trac application.</li>
+ <li>The "personal tools" in the theme now contains the "main" and "meta"
+ nav links from Trac.</li>
+ <li>The search form is now the Trac version</li>
+ <li>the Plone "breadcrumbs" are gone. </li>
+</ul>
More information about the Repoze-checkins
mailing list