Zwiki 0.57 released --Simon Michael, Sun, 01 Oct 2006 22:18:03 -0700 reply

Good day all!

Zwiki 0.57 has been released. If you feel like it's been a while since last announcement, you're right. I have been in an intense phase of travelling, work hunting, adapting to a new job, and could not avoid the hiatus, for which I apologise.

To be precise, in september, 0.56 was released but not announced on zope-announce; in august, 0.55 was released but not announced on zope-announce or; and in july, there was no release. Ack! Thus ends my four-year run of monthly releases. If you're interested in helping out with release management, or have ideas for simplifying Zwiki processes, get in touch.

Thanks for your support. Peace, -Simon


Style and help cleanups, bugfixes.

Upgrade notes

If you use the , you'll need to update it to work with the new "expandable" css class.



  • reorganize stylesheet
  • add missing mathaction styles
  • rename "aqtree3clickable" css class to "expandable"


  • subtopics, page context, wiki contents styling fixes
  • make help page a built-in view like recentchanges etc.
  • help updates
  • make rss feeds and creationTime()/lastEditTime() more robust, eg

when creation_time property is blank


  • fix backwards compatibility for old page objects
more detail at


issue #1291 --nd51, Mon, 02 Oct 2006 08:38:12 -0700 reply

Just a nudge- when I created this ticket, no mail-out happened, so posting the link here on GeneralDiscussion to make a mail-out happen :

Basically release 0.57 looks uninstallable to me. I'm not sure why its complaining though, can't see whats wrong with the code yet.

Anyone else managed to get 0.57 installed & working with Plone? (2.1.3)

issue #1291 --Simon Michael, Mon, 02 Oct 2006 12:58:16 -0700 reply

:( Sorry I missed it, thanks for reporting and following up. It's rare that I do a release without even looking at the open issues, but that's what I did this time. Just didn't have bandwidth for that.

Anyone out there that can take a look at this ? I'll do a point release if need be.

uh-oh --EmmaLaurijssens, Mon, 02 Oct 2006 14:12:47 -0700 reply

We've got another bot adding urls to pages.

uh-oh --EmmaLaurijssens, Mon, 02 Oct 2006 14:20:47 -0700 reply

Simon, forgot to ask: do you have a script to undo all the changes or should it be done manually?

spam cleanup --Simon Michael, Tue, 03 Oct 2006 09:06:35 -0700 reply

Uh oh. That's a bad one. Thanks for the cleanup and heads-up. Yes, spammers now occasionally will set a zwiki username cookie, unless I'm missing something.

I do have a power method that I made last time: revertEditsEverywhereBy in It hasn't been used too much, I'm going to unleash it now. If you want it I'll give you manage access so you too have this option.

< presses button >

Woah. It's like the clash of mighty robots.

That was big and and slow, but did the job - almost. I went to the search page and did a thorough (= non-catalog) search for the word x o o m e r. I found two more pages which looked as if they should have been reverted by the above, plus one more from an older incident.

The site is now clean again. As far as we know.

About content: one of the affected pages, OldInternationalCharactersInPageNamesDiscussion, is now empty and I'm pretty sure had some archived discussion on it. You can still see it here for the moment: . I thought I'd find it also in the gmane.comp.web.zope.zwiki.edits archive also, but maybe it's too old for that.

These unnoticed page wipes - together with my large zodb and regular packing, and google's frequent reindexing - mean that now and then we're losing content. It seems the same thing happened recently with Zwiki and Plone, which was a kind of valuable page. This is not really ok, something must be done. What ?

If I make it a rule to carefully check gmane.comp.web.zope.zwiki.edits before I pack, perhaps that will be a solution.

Trivia of the day: did you know that our HelpPage is the number two google hit for that word ?

spam cleanup --Simon Michael, Tue, 03 Oct 2006 09:16:18 -0700 reply

> It seems the same thing happened recently with > Zwiki and Plone, which was a kind of valuable page.

Hey, great - I searched for this again on google, and this time found it. Restoring from April 2006.

spam cleanup --EmmaLaurijssens, Tue, 03 Oct 2006 09:27:05 -0700 reply

I kind of forgot to clean up my mailbox, so I pretty much have all the edits for that page before it disappeared. It's just that I haven't got the time to look at them at the moment.

spam cleanup --EmmaLaurijssens, Tue, 03 Oct 2006 09:32:01 -0700 reply

ZwikiAndPurpleNumbersArchive20030616? is empty too. What struck me is that the spam links appeared to be the first edit to the page, and that the revert button was unavailable.

spam cleanup --Simon Michael, Tue, 03 Oct 2006 09:53:53 -0700 reply

That's just because the prior history was packed away, I believe. I last packed on september 19th, and I typically keep only 7 or 14 days' history when I do it.

spam cleanup --EmmaLaurijssens, Tue, 03 Oct 2006 10:29:16 -0700 reply

Hmmm. But the OldInternationalCharactersInPageNamesDiscussion link on the FrontPage blog shows the spammer as creator. Go figure.

spam cleanup --Simon Michael, Tue, 03 Oct 2006 10:44:29 -0700 reply

I could easily be confused. It might have been deleted then re-created. We could explain it with enough archaeology of course, but I'm especially interested in ways to reduce that kind of workload.

User Management --pedz, Tue, 10 Oct 2006 08:41:49 -0700 reply

I started over, installed Zope, Plone, and ZWiki. Created a Wiki but so far it appears the same. I did not read any Plone docs. Any hlep in pointing me to what I need, etc would be appreciated. I'm trying to set up a Wiki where anyone can view it but you need to create a user before adding pages. I guess that is what I want. I am pretty sure that I at least want anonymous users to be able to add a user but not be able to delete or muck with other users.

Users in Plone --nd51, Tue, 10 Oct 2006 08:50:24 -0700 reply

pedz - you need to read the tutorials on, or a Plone book such as "The definitive guide to Plone" or "Plone Live".

But to answer this specific question - the users are created in Plone. If you leave Plone's "register" feature enabled, then an anonymous user can register and therefore create a user in Plone, then as that person (s)he can create/edit/etc Wiki pages within the Plone site. And they cannot do anything to other users (unless, as adminstrator, you make them an adminstrator too)

If you look at your Plone site, you'll see "register" next to "log in".

one more thing --nd51, Tue, 10 Oct 2006 08:53:37 -0700 reply

pedz - it sounds like you probably want to set your permissions in the ZMI (Zope interface) or through a custom workflow (this is a more advanced topic though) to disable "Add Wiki Page" for Anonymous users. If you click the Security tab of your Plone root in the ZMI this'll do it - but I do recommend reading those books to make progress easier....

Users in Plone --pedz, Tue, 10 Oct 2006 12:46:20 -0700 reply

I'm just not having any fun!!! I know this isn't a ZWiki problem but since I already have a 'thread' going I thought I would append it here.

I do not have "Plone Site" listed in the things I can add. I can't figure out why. I've tried a few different types, etc. Lost of the Plone stuff is there but not 'Plone Site'.


Still need help please... --pedz, Tue, 10 Oct 2006 14:47:09 -0700 reply

I added a Plone Site and I go into the site folder and I try to add a ZWiki. When I do, I get an exception. Is this the right process to do this?

To Pedz --nd51, Wed, 11 Oct 2006 06:24:03 -0700 reply

Hello Pedz - "I get an exception" is not enough info - please read the following document throughly, it will help us to help you:

pedz' installation how-to --Simon Michael, Thu, 12 Oct 2006 10:10:24 -0700 reply

I've read through pedz' new doc, which is at <> . As I said on irc, thanks very much for this contribution! It fills a need, the "from nothing" doc for people with no particular zope or plone experience. (Who, really, should be our biggest target market.)

This doc is not useful to everyone; it's specifically for mac users who want to install current versions from source (ie not using fink or ports). I'm thinking of renaming it to InstallingZwikiPloneZopeOnMac? or InstallingFromScratchOnMac.

Very detailed how-tos covering a number of pieces, like this one, are very useful, but also get out of date extremely quickly. We have a real problem managing out of date and duplicated documentation on Hopefully you and/or others will feel motivated to keep this doc current. There might be some ways to evolve it to make this easier - in the past I've tried to link to zope/plone's installation docs rather than duplicate those, but of course there are tradeoffs with that.

task: structured text awareness for vi + external editor --Simon Michael, Thu, 12 Oct 2006 10:19:20 -0700 reply

Here's a little 5-10 minute task that would be a great way to get into the project:

betabug pointed out . Review the docs (on front page), find an appropriate place to link and describe this and reply here telling us where you put it.


pedz' installation how-to --pedz, Thu, 12 Oct 2006 10:44:29 -0700 reply

I have been thinking about this since yesterday. I may have hit a lucky time spot.

The first several items: zlib, libjpeg, elementtree, freetype, and PIL (Imaging) are fairly old and stable. They may not change for a while. Zope 2.9 may not change either. Zope 2.10 is out. I don't know if they plan to continue work on 2.9 or not. But Plone 2.x can not use Zope 2.10. So, Zope and Plone may be locked in. That leaves only ZWiki as changing.

Also, I did this on a Mac. I know nothing about PC's. But this process should work fine on any *nix machine (Linux, BSD, etc). I've kicked around Unix since 1982 so I'm pretty comfortable saying that. So, really this should apply to everything except PC's.

Last, the items that I had a tough time tracking down is not what to build and how to build it. In today's world, everything is pretty simple. The things I had trouble with was:

# runzope -X 'debug-mode=on' I needed to track down why a particular thing was not working.

# How to add a Plone Site. Part of that confusion was things were broken originally. Otherwise, it probably would have been more obvious.

# How to add a Wiki to a Plone Site -- which is on this wiki but I had just assume that you would do it from the "add" menu from Zope.

docs cleanups --simon, Thu, 12 Oct 2006 10:58:14 -0700 reply

I renamed the new how-to

I made HowTos the sole parent of the User/Admin/Dev how-tos. The double parent was confusing. The latter still appear in FrontPage subtopics, but now one level deeper; that's ok.

I'm considering moving User/Admin/DevNotes? down under a single parent too. We have a lot of these notes (which are basically the older, less organized docs). They are the primary candidates for cleanup and perhaps archiving somewhere separate. Without them, the docs would be a lot simpler. But they still have a lot of relevant information, aside from the historical stuff.

docs cleanups --simon, Thu, 12 Oct 2006 11:04:54 -0700 reply

Where in the hierarchy does the plone and cmf page belong ?

slowness --simon, Thu, 12 Oct 2006 12:46:38 -0700 reply

I found some runaway processes which where making, and all free wikis slower than usual. One was the hourly TestResults? generation, which I've disabled, and the other was a lengthy darcs annotate operation triggered by someone or something browsing the darcsweb interface. I'll have to watch out for those.

Where to put Plone and cmf --pedz, Thu, 12 Oct 2006 13:51:47 -0700 reply

Being a resent newbie: is ZWiki used often without Plone? I'm wondering if non-Plone docs should be given a lessor place. My suggestion is to put a node with a discussion of with plone and without plone and then have the tree divide at that node. To me, its a pretty fundamental question that needs to be asked and answered up front.

Error on Installing Zwiki into Plone --bmoon, Fri, 13 Oct 2006 05:15:54 -0700 reply

I have been trying to install Zwiki into my Plone instance. I used the instructions here, but when I restarted Plone and went to the Add/Remove Products page, I see this error at the bottom of the page:

Some products were found to have errors when compiling the install file.
Error Type
Error Value
cannot import name _addDTMLMethod

I've searched the site and can't find anything that seems to point to how to troubleshoot this problem. What is going on?

Error on Installing Zwiki into Plone --pedz, Fri, 13 Oct 2006 06:25:46 -0700 reply

I think I got that when I used 0.57.0. I backed off to 0.56.0. See:

Where to put Plone and cmf --Simon Michael, Fri, 13 Oct 2006 08:59:26 -0700 reply

Right now I use it 95% without plone (though in the past that figure has been as low as 50%). I find Zwiki simpler, faster and more appealing outside of Plone, when there's a choice. Part of me is reluctant to focus the documentation on the more awkward Zwiki+Plone story.

I don't know whether straight-zwiki or plone-zwiki users are more numerous but my guess would be the plone-zwiki users. So you have a point. What are some good adjustments we might to the docs I wonder.

Error on Installing Zwiki into Plone --Simon Michael, Fri, 13 Oct 2006 09:03:04 -0700 reply

The most unique part of the error message is usually good to search on. _addDTMLMethod in the wiki search form will bring up issue which has the workaround. Sorry about the breakage.

More Advanced User Management --pedz, Fri, 13 Oct 2006 09:37:55 -0700 reply

I did all the Plone set up only to get its User management facilities. I would have much preferred to just use ZWiki. But... also... I caution using me as much of a guide. I do not know the Wiki Way... So, I may end up finding out that all this user management is not really needed anyway.

Assuming that Plone's style of user management is something that is generally useful in a Wiki, how hard is it to implement it? Basically, just a way to "join" the site without the need of the system administrator getting involved -- which would include sending out an email with a URL to complete the user setup.

I would kinda like to help out but I have two problems: 1) lack of time. 2) I'd rather spend what little time I have on Zope 3 rather than Zope 2. It appears as if it will eventually turn into something that I could use a lot.

Error on Installing Zwiki into Plone --bmoon, Fri, 13 Oct 2006 09:57:20 -0700 reply

Thanks. I found the page you referenced (, but I'm such a newbie that I wasn't sure of how to implement the workaround. I took pedz's advice and installed 0.56.0, and it worked fine.

More Advanced User Management --Simon Michael, Fri, 13 Oct 2006 11:43:46 -0700 reply

Interesting. I think your need is pretty common actually, and simple member management is increasingly important (with the rise of wiki spam etc.)

It's unfortunate that our only "simple" solution is to tell people to add Plone, if it's more than they need/want.

The only plain Zope member managing system I know of is exUserFolder. It worked and I expect still does, it would be worth checking that to see if it has become any easier to set up.

Any other solutions, folks ? Maybe there's something built in to Zope/PAS these days ?

FYI --Simon Michael, Sat, 14 Oct 2006 22:58:52 -0700 reply

Simon Michael wrote: > An upgraded copy of the Zope 3 wiki is now live: > > > > Please check it out and report any problems. Pretty much everything > should be intact. Note: 1. no special skinning or styling has been done > - a topic for later - and 2. it is slow, slower than it should be, I'll > have to investigate, but later. > > Both wikis are writable right now. The old wiki on is still the > master copy, but I'd like to make it read-only as soon as you agree, to > avoid confusion and resyncing work. Until you might want to just hold > off on major edits. > > It turns out export and import was the efficient way to move these > pages. I didn't expect it to import cleanly first time into a modern > zope, but it just worked! Hurrah!! Then there was a good deal of fun > getting things cleaned up with minimal changes to the metadata. I'll > post my notes somewhere in due course. > > This wiki currently can be edited by anyone who configures a username > (by clicking options). This has stopped most zwiki spam up till now, but > there will be an incident once in a while, which I'll clean up. I will > watch for problems and tighten things up when necessary. (How hard would > it be to authenticated against via ldap ?) > > Structured Text, Restructured Text, Epoz-HTML and Plaintext markups are > available, and the default markup is still STX. Let me know if it should > be changed to RST. > > I have created manager accounts for Jim and Michael H. I'll stop here > for now. Thanks, -Simon

What program is needed to make LaTex? in ZWiki work? --nd51, Mon, 16 Oct 2006 03:08:32 -0700 reply

With the myriads of documentation, some up-to-date , some not, I can't work out what Debian package needs installing to get the needed programs (latex & dvips, right? ) to work. Also , "apt-cache search TeX?" gives a bewilderingly long list. Please can someone who has got LaTeX? pages working tell me what extra things they installed?

Cheers Nick

More Advanced User Management --jmax, Mon, 16 Oct 2006 15:10:38 -0700 reply

For the Thinkubator, I use GRUF (, which gives me most of the rich user management of Plone (groups, etc), but without the slick management screens. So I hacked together a couple of very simple forms/scripts to automate just a couple of pre-cooked registration. It is very simple, but it works quite well.

tracker issue import --EmmaLaurijssens, Tue, 17 Oct 2006 08:33:33 -0700 reply

Just got a message from a user, who wants to add dozens of issues at once. They're all in an Excel spreadsheet now, and (surprise surprise) he has learned that Zwiki's issuetracker suits his needs better than Excel.

I could create separate text files and upload them as wiki pages, but the thought of setting the issue properties by hand is not very compelling neither to me or him. Is there some other smart way to get them imported, other than writing a script form scratch (which, with my current python programming skills, will take more time than I have at the moment)?

tracker issue import --DeanG, Tue, 17 Oct 2006 08:49:49 -0700 reply

Zwiki leverages Zopes "REST" API, so you could try to build a column in your spreadsheet as a URL to the

http:// YOUR WIKI HERE /createIssue?newtitle=testTitle&newtext=testText ...check out the source to the issue tracker page or createIssue()

Then it's at least more convenient to convert the spreadsheet to Zwiki entries.

tracker issue import --EmmaLaurijssens, Tue, 17 Oct 2006 09:55:00 -0700 reply

Of course... why didn't I think of this myself? After all, I'm doing quite a lot of these things to manage zope from a Windows command prompt with curl.

Second time - what does LateXWiki? require to work on Linux? --nd51, Wed, 18 Oct 2006 08:39:30 -0700 reply

Surely someone has done this / knows this?

What extra packages are required to be installed on Linux to make LaTeX? Wiki pages work?

search then ask :) --Bill Page, Wed, 18 Oct 2006 08:44:48 -0700 reply

Google LatexWiki. Find

LateX? --nd51, Wed, 18 Oct 2006 08:44:59 -0700 reply

OK, I'll answer my own question. ;-) Looks like aptitude install tetex did the job....

LaTeX? cont.d --nd51, Wed, 18 Oct 2006 09:16:05 -0700 reply

Well, I did google first BTW, which gave the impression tetex was no longer being maintained but I tried it out on the off-chance anyway. Also Bob McElrath?'s notes are very old, referring to Zope 2.6 and ZWiki 0.35.

Now it won't work because it complains about lack of amsfonts. But there doesn't appear to be a package for amsfonts, and I'm not keen on installing amsfonts by hand due to maintenance/dependency issues that could result. There ought really to be a debian package for TeX? that "just works". If anyone knows what that is, please spill the beans..... ;-)

LaTeX? cont.d --Simon Michael, Wed, 18 Oct 2006 10:44:26 -0700 reply

I have amsfonts here.. let's see.. they are provided by tetex-extra. :)

A great way to find out such things, which I use all the time, is go to or and search the full contents of packages for your desired filename.

tracker issue import --Simon Michael, Wed, 18 Oct 2006 10:45:39 -0700 reply

Nice idea!

How many issues ? Let us know how it goes.

More Advanced User Management --Simon Michael, Wed, 18 Oct 2006 10:46:51 -0700 reply

Good pointer, I forgot about GRUF.

Someone should really make a standard reliable minimal set of member management forms to go with it, so everybody doesn't have to keep reinventing that.

LaTeX? - amsfonts --nd51, Thu, 19 Oct 2006 01:27:23 -0700 reply

Simon - thanks for the pointer to That was a sensible suggestion.

In fact, I already had tetex-extra. The problem was, I had done : sudo aptitude install tetex

Then later realised more packages were needed, so did : sudo aptitude install tetex-base tetex-bin tetex-extra

However this order turns out not to work. When I removed all those packages, and first added text-base, tetex-bin, tetex-extra, THEN tetex afterwards, it worked.

I've a fair amount of experience with Debian packages and haven't found that many which are quite so fussy about the order in which they're done, WITHOUT having a specific dependency. Really tetex should refuse to install till the other packages are there. This maybe needs documenting amongst info for setting up latexwiki

Wasn't being completely stupid, honest. ;-)

spam cleanup --EmmaLaurijssens, Tue, 24 Oct 2006 10:11:35 -0700 reply

simon wrote:

> If you want it I'll give you manage access so you too have this option.

On second thought, it might come in handy, not only for those power tools, but for instance also for removing the html attachments today's spammer dropped in the ZODB.

spam cleanup --Simon Michael, Tue, 24 Oct 2006 10:36:42 -0700 reply

Thanks Frank! Account created.

Unicode - Again ;) --ArnoPucher, Tue, 24 Oct 2006 15:40:31 -0700 reply

I have a old site in fact one of my pages on a freezope server ( to be exact - The server upgraded from ZWiki 0.21 to 0.35 recently. Now all (old) ISO8859-1 "Umlauts" "äöüß" etc. got messed up. I had this problem years ago and could solve it thanks to a friendly ZWiki User ( on my local ZWikis?. Unfortunately at the freezope site (where I dont own the server) I cannot just create a ExternalScript? - I can only create a Python Script. And in a PythonScript self.pageObjects() seems not to be available ...


for page in self.pageObjects():
          page.setText(unicode(, 'ISO-8859-1').encode('UTF-8'))
          self.REQUEST.RESPONSE.write('page %s\n' %

Any suggestions ? Or is this reference for a script (non-external) even for the admin forbidden ?

Regards, ArnoPucher

Unicode - Again ;) --Simon Michael, Tue, 24 Oct 2006 16:20:51 -0700 reply

Hi Arno,

I last used the code on issue 944.. I've started

to gather these things.

I probably ran the code at the debug prompt, but it seems to me it should work from a python script. I think you have one more pages with bad permissions. Put in a try except and print the names of any problem pages, that should help.

In fact, I recently integrated this into upgradeAll, at least for the common case of converting iso8859-1 to utf-8. You could update to latest darcs Zwiki and then try FrontPage/upgradeAll . Set your logging level to BLATHER and watch event.log if you want to see what happens. Keep us posted.

LaTeXWiki? - LocalFS doesn't work? --nd51, Wed, 25 Oct 2006 02:55:19 -0700 reply

I think I've all the dependencies for LaTexWiki? to work, but the final problem is it doesn't create an image. When I try to save a latex format "hello world" page, as StructuredText + LaTex?, it then attempts to show an image called 370643197-18px.png that is supposed to reside in the images directory. I went and created an images directory in our Plone root - tried it out both as a Zope folder and as a Plone folder, but no image ever gets created in there by LatexWiki/ZWiki.
I have LocalFS 1.7-RC1 from , as the LocalFS 1.3 from there appears to be a corrupted .gz file. (platform Plone2.1.3, Zope 2.8.5, Python 2.3.5, Debian Sarge) Could someone who has managed to get LaTeXWiki? working recently please comment on what you had to do to get LaTeX? pages to work or what may be broken in this case? There is very little documentation out there and what there is, is fairly ancient. No errors appear in the event.log. I'll happily put together an up-to-date doc on how to get this working, if someone can give a pointer how to get this working in the first place.

Cheers Nick

LaTeXWiki? - LocalFS doesn't work? --Simon Michael, Wed, 25 Oct 2006 08:03:21 -0700 reply

On, it is saving images etc. in var/LatexWiki/ . points to the latest, I think you found it.

LatexWiki --nd51, Wed, 25 Oct 2006 08:25:39 -0700 reply

Simon - cheers for the reply. Interestingly, I do have images being generated in the same directory as you - /var/LatexWiki, so thanks for pointing that out. However, view source of the html implies that its looking for these in an images directory within zope/plone, so presumably there ought to be some link between the images directory within zope and the var directory on the filesystem. Does your install have an images directory somewhere in Zope/Plone, and does your html source look under images?

LocalFS --Bill Page, Wed, 25 Oct 2006 08:31:05 -0700 reply

Using LocalFS, the zope 'images' folder is mapped to the var/LatexWiki directory in the file system. This should have been setup automatically when you created a new LatexWiki site.

LocalFS didn't automatically link --nd51, Wed, 25 Oct 2006 08:52:23 -0700 reply

Bill - thanks a lot for the comment. This helped me fish around and fix it by just going in and creating a "Local File system" by hand in Zope. Don't know why it didn't create properly first, but now it WORKS thanks. Once I get this live, shall put stuff in my blog (+ copy to if people want) on up-to-date details how to get this working on Debian including creating this by hand if it doesn't get automatically created.

LocalFS didn't automatically link --Simon Michael, Wed, 25 Oct 2006 09:23:31 -0700 reply

That's right - I did the same, I now remember.

There is a setup script which old LatexWiki ran but Zwiki latexwiki doesn't, I think. Did you Add ZWiki -> latexwiki ? ZWiki can be made to run a setup script at this point (search for "config" in latest ZWiki/

latexwiki setup --nd51, Wed, 25 Oct 2006 09:32:28 -0700 reply

Ta for your help too. All I originally did (after correct debian packages were there) was re-installed ZWiki as normal, then tried to add Wiki pages and choose Latex format, and put Latex content in there. You might consider perhaps putting this creation code in ZWiki's standard install? Not a big deal though, especially with helpful people on newsgroup. :-) I did eventually find references to this issue on Bob McElrath?'s old page but I'd been sceptical of those docs somewhat due their age, which is why I plan to put up some more recent info on getting latex working within Zwiki 0.57+

latexwiki setup --Simon Michael, Wed, 25 Oct 2006 09:34:16 -0700 reply

Aha. Is it any better if you start with Add ZWiki -> latexwiki ?

Thanks for clarifying this area.

latexwiki setup --Simon Michael, Wed, 25 Oct 2006 09:35:55 -0700 reply

PS seems like we shouldn't offer the Latex and MathAction page types until those things are configured, that patch would be very welcome.

zwiki for hosting a book? --Riccardo Murri, Fri, 27 Oct 2006 10:22:07 -0700 reply


Do you think a ZWiki in Plone could be a good environment for collaborative authoring of a book?

The long story: the research group I'm currently working in is authoring a short book. Up to now, it has been edited with OpenOffice?, bouncing revisions back and forth between authors via email, which is a painful process... So, we would like to turn to a collaborative environment; also, since most of it deals with software, we would like that users could add explanations, usage comments and even fix the text. It looks like a job for a Wiki :-)

However, we need to produce nice printed copies of the whole book (from time to time; sort of "hardcopy snapshots"), so we thought of using reStructuredText as the markup language, so that we can convert it to LaTeX? for making PDFs? and printed copies. Use of reST which would also allow us to re-use parts of the software docs and pages from the website. (We already use reST as the main markup language for web authoring and in text files accompanying source code.) As far as I know, ZWiki is the only Wiki supporting reStructuredText.

So, given the requirement of turning the whole book into nicely-formatted PDF or printed output, would you reccommend using ZWiki for hosting a book?

Do you know of any similar experiences? Do you have any suggestion on how to set up ZWiki for this kind of task? (Set up page templates, provide a Wiki page hierarchy that mirrors the table of contents from the start, whatever...)

Thank you very much in advance, any comment is welcome!

zwiki for hosting a book? --jmax, Fri, 27 Oct 2006 10:31:47 -0700 reply

I did something similar... I wrote my doctoral dissertation in ZWiki (which was a fabulous writing tool), and then went out to print via XML. Basically I serialized all the finished pages out as one big XHTML file (using a 'print' method I found here at ZwikiPrinting), then did a minor transformation to bring it into a simple print-oriented DTD for FrameMaker?. I was very pleased with how well it worked, considering it was a total one-off.

zwiki book hosting - Riccardo --nd51, Mon, 30 Oct 2006 01:43:35 -0800 reply

Your question suggests you may not know about a recent very cool thing that happened - Latexwiki now (0.56 onwards) comes packaged with ZWiki. So you can save pages as restructedtext + Latex, which sounds even closer to what you're wanting to do. I am in the process getting it working where I am, within Plone 2.1.3. You'll need to install such things as tetex, and possibly upgrade gs to have all the necessary fonts. It sounds worth taking for a spin based on the requirements you've described.

zwiki for hosting a book? --Simon Michael, Mon, 30 Oct 2006 08:48:15 -0800 reply

I posted this to the wrong place -

Ricardo - yes, I think your idea is good. It won't be perfect - no formal revision control is the biggest downside - but it's what I would choose (my second choice would be latex files and darcs).

Zwiki's page hierarchy is aimed at just this sort of scenario and you should find it useful for reorganizing the content. You might want to use Zwiki's basic skin when doing a lot of editing.

zwiki for hosting a book? --simon, Mon, 30 Oct 2006 08:59:21 -0800 reply

And before you ask - no, nobody has figured out a good way to marry zwiki content and revision control yet. :)

zwiki for hosting a book? --DeanG, Mon, 30 Oct 2006 09:30:35 -0800 reply

And APE has also gone from an "almost good enough" to deprecated option.