Zwiki's "wiki templates" are preconfigured wiki folders which can be used as a prototype when starting a new wiki web. They are listed as choices when you choose "Add ZWiki" in the zope management interface. These template wikis come from

  1. /Control_Panel/Products/ZWiki/* in the ZODB. Zope managers can put wiki folders here to make them available as templates. These can contain any kind of zope object.
  1. ZWiki/wikis/* on the filesystem. Zwiki's built-in templates are defined here, as directories of files with suffixes and some metadata at the top representing wiki pages, dtml methods etc. See Wikis.py for exact details of what's allowed. Currently there is one built-in template: "basic".

Wiki templates don't have to be wikis; they could be a web application or static content.

Here is more about the DefaultWikiTemplates that we provide.

History

  • in the beginning just a zexp file shipped with ZWiki
  • ChrisWithers' zclass-based ZWikiWebProduct provided a nice form interface.
  • this was updated and included with ZWiki as a zexp. I maintained the content on disk and used make scripts to upload into zope for export & release.
  • switched to maintaining the wiki templates online as live wikis, to allow shared effort and to more easily see the effect of changes. Exported a snapshot before each release.
  • 20010805 discontinued the ZWikiWebs? zclass product; switched to individual versioned wiki zexps in .../ZWiki/imports, auto-imported on product startup. Content still maintained online and exported for release.
  • 20011123 switched to maintaining & shipping a single flexible template (zwikidotorg) as files in .../ZWiki/wikis, following CMFWiki. This time it's in CVS and I'm using scripts to sync back and forth with zwiki.org whenever possible. Zodb-based templates can still be installed at user discretion.
  • ..stuff..
  • 200605 cleaning up the ZMI add forms and basic wiki content

dtml now separated? --jks, Fri, 23 Jan 2004 04:23:12 -0800 reply

It seems to me that with the current (0.26) ZWiki the dtml pages form a separate template. Is this correct, or am I confused?

dtml now separated? --Simon Michael, Fri, 23 Jan 2004 05:18:58 -0800 reply

At present there's one "wiki template" shipped with Zwiki: 'basic', which is listed in the Add Zwiki form. A couple of extra DTML pages are kept in contents/dtml and contents/tracker, which can be added to a wiki via setupDtmlPages and setupTracker. Does this help ?

dtml now separated? --SimonMichael, Fri, 23 Jan 2004 05:22:10 -0800 reply

PS if 'dtml' is listed in the Add Zwiki form, that might be a bug.

dtml and misc --Tue, 24 Aug 2004 22:23:09 -0700 reply

Seems to me neither 'dtml' or 'misc' on the Add ZWiki form work. Only 'basic' works. Of course, I'm brand new to this, so I may not know much of anything.

dtml and misc --Simon Michael, Wed, 25 Aug 2004 01:47:50 -0700 reply

I believe you're quite right, and some code needs updating.

dtml and misc --Mon, 07 Feb 2005 12:36:26 -0800 reply

The dtml and misc templates still don't work. You can add them but any time you try to reference them, you get the main index page. I'd like to make some rudimentary changes to the skin. I started with trying to replace the default icon with my company icon. I've been working on it for a couple of days now and have still not been able to figure it out. I even tried to replace the ZWikiPage_icon.gif file in /ZWiki/images folder but nothing changed.

If someone could come up with a step by step example on how to do it that would be usefull. Everything I've seen so far seems to be geared towards explaining how it works to people who already know how it works. For me it's caused more confusion than enlightenment.

dtml and misc --Bob McElrath?, Mon, 07 Feb 2005 13:30:16 -0800 reply

I think the contents of 'skins/', 'content/', and 'images/' are confusing, and it is not at all clear to new users how the contents of these directories have to do with their site, or how to change them.

First and foremost we need a way to install all relevant files onto the newly-created wiki. (e.g. an "install all files" checkbox in the create zwiki management form)

anonymous [zwiki-wiki@zwiki.org]? wrote:

> The dtml and misc templates still don't work.  You can add them but
> any time you try to reference them, you get the main index page.  I'd
> like to make some rudimentary changes to the skin.  I started with
> trying to replace the default icon with my company icon.  I've been
> working on it for a couple of days now and have still not been able to
> figure it out.  I even tried to replace the ZWikiPage_icon.gif file in
> /ZWiki/images folder but nothing changed.

Did you restart zope? This file is used at startup to tell zope what the icon for the ZWikiPage class is. See __init__.py:initialize(). Zope places product icons in a dictionary called misc_. So, this file is not part of any skin. Seeing it change should require a zope restart.

> If someone could come up with a step by step example on how to do it
> that would be usefull.  Everything I've seen so far seems to be geared
> towards explaining how it works to people who already know how it
> works.  For me it's caused more confusion than enlightenment.

You realize these are not true skins, but can be added to other skins, right? They just add a bit of functionality. As such, they should be "extensions" or some such and not show up in the skins menu.

I'm not sure what you're trying to do, but the "skin" used on a wiki is in skins/standard. Those files should be added to your wiki, and then you can edit them. If they aren't present then zwiki will use the files on disk.

dtml and misc --Simon Michael, Tue, 08 Feb 2005 08:58:51 -0800 reply

anonymous wrote:

>The dtml and misc templates still don't work.

Note: these were never intended to appear in the Add ZWiki form, that's a glitch that has been with us a long while.

nautica status --simon, Sat, 04 Nov 2006 16:04:33 -0800 reply

Exploring how to make wiki templates/skins like http://nautica.demo.zwiki.org easier to convert/develop/install/upgrade. Status: tried to make the whole skin load from the filesystem, ran into trouble because extra skin objects (images, css, javascript) are not published, unless we add more page methods to do that, and then paths in the skin templates must be changed, because zwiki folders are not skin-aware. For now, then:

  • nautica is a wiki template; I must add a new nautica zwiki, or copy its skin objects into an existing wiki, to see it working
  • and I have a skins/nautica symlink (and code changes) such that I can change the templates and see changes immediately
  • and I can't add a nautica wiki yet, until I either flatten the directory hierarchy, changing all paths, or make add zwiki support subdirectories
  • and tools/zwikiimport.py seems a good starting point for the latter