Here is a list of known bugs in Instiki. Comments and fixes are welcome.
The Log Rotation does not seem to work on Windows with some versions of Ruby. When the log file grows to 1MB in size, Instiki tries to rotate the file, which results in a “Do you smell smoke” 500 Application Error.
Workaround: In config\environments\production.rb, comment out the line:
config.action_controller.logger = Logger.new(Rails.root.join('log', "#{RAILS_ENV}.log"), 25, 1024000)(it’s the first line without a “#” comment mark in front of it; please add one). This disables log rotation, which will keep Windows happy. The downside is that log file will now grow, indefinitely, unless you rotate it manually.
If you try to run Instiki from a directory, one of whose parent directories has a space in its name, you will likely run into trouble. So don’t do that.
This is not so much a bug in Instiki itself as in the various associated pieces of software. Which makes it not so straightforward to fix.
The “See Changes” function uses XHTMLdiff to generate a redline document of changes from one version of a page to the next. To do this, it assumes that it is dealing with two well-formed XHTML documents. This works reliably in the Markdown-based text filters.
But, under Textile, it is rather trivial to produce ill-formed XHTML (which is why Textile is served as text/html). When you try to “See Changes”, under Textile, and one or the other of the pages is ill-formed, you will get a 500 Application Error.
Perhaps not a bug, but selecting “Safe mode - strip HTML tags and stylesheet options from the content of all pages” appears to stop S5 slideshows from working.