Soks 0.0.7 → 1.0.0

data/templates/default/content/How%20to%20report%20a%20bug.textile

@@ -2,7 +2,8 @@ h1. How to report a bug
 
 I really appreciate bug reports.
 
-Please go to http://www.soks.org and create a new page whose title starts with bug:, e.g. @bug: does not make tea@.
+Please click [[ here => http://www.soks.org/edit/BugTypeATitleHere ]] or go to http://www.soks.org and create a new page whose title starts with bug:, e.g. @bug: does not make tea@.
 
 In that page, please give as much information as you can and leave some contact details.
 
+Tag: Include this page in the distribution

data/templates/default/content/How%20to%20upgrade%20soks.textile

@@ -0,0 +1,22 @@
+h1. How to upgrade
+
+First download the latest release of soks:
+
+Preferably:
+# Install rubygems from http://rubyforge.org/projects/rubygems/
+# @gem update Soks@ (you may need to be root first)
+
+Alternatively
+# Download the tar or zip file from http://rubyforge.org/projects/soks/
+# Unzip or untar it
+# Change into the soks directory
+
+Then execute the command. 
+
+# @soks-create-wiki.rb --destination-dir=path/to/your/wiki@ and it will guide you through the upgrade.
+
+If you haven't touched your start.rb file, then you are good to go.  Otherwise you will need to edit the new start.rb file in your wiki to your tastes, the way this is set up changed substantially in v1-0-0, but it should be clear enough.
+
+Should anything go wrong, or you need to revert, a pristine copy of your wiki is created in YourWikiName-bak-0.
+
+Tag: Include this page in the distribution

data/templates/default/content/How%20to%20use%20the%20keyboard%20shortcuts.textile

@@ -9,9 +9,9 @@ Soks has a number of keyboard short cuts.  Depending on your browser, only some
 ** ctrl-u undos the previous edit
 ** ctrl-a shows all the previous changes
 * ctrl-h: Home page
-* ctrl-i: Site Index
-* ctrl-r: Recent changes to this site
 
 *Note:* On Linux/Firefox and WindowsXP/IE6.0, substitute "meta" or "alt" for "ctrl".  And for WindowsXP/IE6.0, these will only move you to the link on the page -- you then have to hit enter to proceed.
 
 fn1. Does not work on Linux/Firefox1.0 or WindowsXP/IE6.0
+
+Tag: Include this page in the distribution

data/templates/default/content/How%20to%20use%20this%20wiki.textile

@@ -25,4 +25,6 @@ h2. Editing Pages
 
 h2. Searching
 
-The search box on the right takes a single regexp.  
+The search box on the right takes a single regular expression.
+
+Tag: Include this page in the distribution

data/templates/default/content/List%20of%20changes.textile

@@ -1,20 +1,95 @@
 h1. List of changes
 
-h2. Between v0-0-8 and v0-0-7
+h2. Since  v1-0-0
 
 *NOTE*: This has not been released yet, although anything listed here will be in the cvs (see how to get the latest Soks from cvs)
 
-h3. Features
-
-* None yet.
+No changes yet.
+
+h2. Between v1-0-0 and v0-0-7
+
+h3. User Features
+
+* Page titles can now have any punctuation, and the wiki urls look slightly prettier.
+** The url for a page now excludes punctuation, so 'Bug: is this a bug?' has the url /view/BugIsThisABug
+** Old urls still work (e.g. /view/home%20page )
+** Pages that differ only in punctuation are permitted, and are given unique urls (e.g. 'A&B' and 'A+B' become 'AB' and 'AB-2'). Unfortunately I haven't figured out a way of ensuring that these urls are consistent across wiki restarts, which means that bookmarks of pages that differ only in punctuation may not always serve the expected page.
+** If you have any authenticators that match specific pages, these will need to be changed to match the unpunctuated, WikiWord style page name.
+* Recent Changes now has a 'changes' link that shows just the changes made by that revision.  I'd appreciate feedback on how best to lay this out.
+* Revisions pages now show only 10 revisions at a time (Should make things faster).
+* Two new RSS feeds, accessed by /listrrss/pagename or /linksfromrss/pagename
+** listrss is aimed at the Recent Changes page and creates a feed that includes the edits made to each page
+** linksfromrss is aimed at Known Bugs and other similar pages, and creates an RSS feed that includes the content of each page referred to by the original page.
+* Some basic page view counters
+** ViewCountHelper maintains a page called 'Popular Pages' that has a ranked list of the number of times a page has been viewed.
+** ViewerCountHelper can be configured to maintain pages like 'Prolific Viewers' or 'Prolific Editors' that provide a ranked list of the IPs (or usernames if they have given them) of those who visit or edit the wiki most often.
+** AuthorCountHelper can be configured to maintain a page with a ranked list of the n people who have made the most revisions to the wiki
+* Can now save cache of page data and views when the wiki is shutdown.  This makes starting the wiki again much faster.
+
+h3. Adminstrative Features
+
+* The way that all the settings are made has completely changed.  See the template/default/start.rb class for details
+* The api for the AutomaticSummary class has changed.  See the templates/default/start.rb file for example use.
+** e.g. @AutomaticList.new( wiki, 'Instructions and Howtos' ) { |page| page.name =~ /^How to /i }@
+* Some maintenance helpers, that periodically slim the wiki (these are not enabled by default)
+** DeleteOldPagesHelper operates (by default) once a day and wipes from disk any deleted pages that were deleted more than (by default) 100 days ago.
+** DeleteOldRevisionsHelper operates (by default) once a day and deletes any revisions that are (by default) more than 365 days old and where (by default) there are more than 20 revisions for the page.
+** MergeOldRevisionsHelper opeates (by default) each hour and merges all revisions more than (by default) 24 hours old, by the same author, and that are created (by default) within an hour of each other.  Note this is pretty processesor intensive, so you may not wish to use it yet, but it should result in a significant reduction in the size of revision files.
+* Can now include several static file handlers by specifying them in a servlet.static_file_directories hash, e.g. @{ 'Attachment' => 'attachment', 'www' => '/var/www' }@
+* Of interest only to people delving under the hood:  
+** The contents of the url's query are now available in the templates
+** Content-type for a particular view is now a setting (default is for text/html, RSS is application/xml, set in soks.rb)
+** The wiki now notify's listeners of time passing using :year,:month,:hour and :minute events.  Helper classes can use these if they need to make periodic changes to the wiki.
+** The wiki now notify's listeners of a page view using a :page_viewed event.  Helper classes can use this to track what pages people look at.
+** The Wiki class now has a wipe_from_disk method to erase a deleted page
 
 h3. Refactoring
 
-* None yet.
+* The way settings are handled has been completely re-organised, removing the $SETTINGS global.
+* Moved the changes_from method from the Page class to the String class
+* Moved page delete method to Wiki class from View class
+* Moved the add_to_index call from save method to mutate method in Wiki class
+* Took out the test mock objects and put them in a separate file
+* Refactored the find method out of the View class into the search results erb.  (Why? Because it seems to me that it is more like a different view of the wiki, rather than something special, and this simplifies the View class).
+* Refactored to remove the dedicated RSS method in the servlet class.  Content-type is now set according to the name of the view.
+* Refactored to replace all the extra threads that I was using to count days with listeners that wait for the periodic events (year,month,day,hour,min) sent out by the wiki. (in the calendar helper classes, and in the disk checking classes). This should increase the gracefulness of shutdowns and make sure that serving the user pages always takes priority.
+* Refactored some common code from Tests to a module in mock objects
+* Refactored the BruteMatch class to cache the title regexps.  May be a little faster.
+* Added some tests for the soks-servlet.rb class in preparation for some refactoring.
+* Refactored all the mutating methods (revise,rollback,delete,move etc) out of the View class into the Wiki and Servlet classes so that View is strictly View only
 
 h3. Bugfixes
 
-* None yet.
+* Added test for, and fixed bug: AutomaticPageMover still apears in RecentChanges
+* Added test for, and fixed bug: Template pages should not be moved.  Now any page with 'type a title here' in its title cannot be moved.
+* Added test for, and partially fixed bug: Cannot change capitalization of a page title in that changes to the page title now work.  However, they cannot be undone, and don't trigger recent changes or any automatic summaries to update.
+* Fixed bug: Print stylesheet does not hide menu or commands (thanks to Pavel Sykora)
+* Fixed bug: Recent changes today can be yesterday
+* Fixed bug in the Calendar automatic helper where the months wouldn't link to each other.
+* Fixed bug where refering to pages [ [ /edit/page name?something=somethingelse ]] would not correctly discern whether page name existed and colour the link accordingly.
+* Added test for and fixed Bug: automatic linking does not work with trailing punctuation
+* Added test and fixed Bug: pages names with single quotes
+* Added test and fixed bug: calendar does not appear
+* Fixed bug: viewing revisions requires authentification
+* Added test and fixed Bug: automatic linking does not work with trailing punctuation
+* Fixed Bug: RSS feed does not validate - Hopefully all fixed now.  Usernames are now turned into (by default dummy) email addresses in order for the feed to officially validate, and the new page url system means the urls are more likely to be accepted as valid.
+
+h3. Bugs Remaining
+
+These bugs definitely remain:
+* Bug: Does not make use of if-modified-since request headers
+* Bug: GEM limits title lengths - This is a limit of file names on Windows OSs?
+* Bug: notextile does not prevent page inserts
+* Bug: Textile mishandles paragraphs
+* Bug: E-mail addresses with hyphens not recognised
+* Bug: Email adresses in page titles cause incorrect links
+* Bug: Memory leak
+* Bug: Pages that link here may not appear on restart
+
+These bugs are partially fixed / tricky to replicate
+* Bug: Unanticipated Rollbacks - Not yet been replicated
+* bug: competing edits - Does what I expect (last person to save, wins) so not a bug for me, but clearly not ideal so will work on something better.
+
 
 h2. Between v0-0-7 and v0-0-6
 
@@ -43,117 +118,8 @@ h3. Bugfixes
 * Fixed Bug: Internet Exploror 6.0 incompatibilities during page edits
 * Fixed Bug: LinuxFirefox1.0 scroll reset after cursor move
 
-h2. Between v-0-0-6 and v-0-0-5
-
-h3. Features
-
-* The default template now includes a 'sidebar page' that can be edited inside the wiki. (Thanks to Bil Kleb).
-* Changed the way the soks libraries are required to hopefully allow a wiki to be more easily moved between machines (Thanks to Giovanni Ferro).
-* Some new settings:
-** Setting @:server_type =>  WEBrick::Daemon@ in start.rb causes Soks to try and fork into a separate process.  By default this is off.  (Thanks to Remy Drouilhet)
-** The name of the home page is now a setting in start.rb (@:home_page => "home page"@).
-** Setting @:redcloth_hard_breaks => true@ in start.rb causes Redcloth to revert to the 2.x approach of turning every newline to a @<br />@. This is off by default (i.e. the default works like Redcloth 3.x).  (Thanks to Seb Clediere.)
-* Roughed up a wiki2html helper that maintains a static html copy of the site in sync with the dynamic copy.
-* Toned down the colors and tweaked the layout of the default wiki look.
-* Removed the 'instiki' and the 'rails' templates from the distribution, because I haven't kept them up to date.
-
-h3. Refactoring
-
-* Filehandler servlet now incorporated into the WikiServlet.
-* General cleanup in WikiServlet 
-* Rewrote the RollingMatch class (in soks-view, deals with automatic linking) to be less complex and a little bit faster.
-
-h3. Bugfixes
-
-* Fixed Bug: Time per change on meta page view incorrect
-* Fixed Bug: Punctuation in page titles still problematic by adding two validations.  The first is a piece of javascript that warns the user from using problematic punctuation, the second is in the servlet and removes all problematic punctuation.  As a side effect, this has fixed Bug: ampersand in page name creates missing links that work .
-* Fixed Bug: Search textarea and button rendered without vertical separation by removing the search button.  It wasn't needed, and IMO looked clunky.
-* Fixed Bug: Certain text crashes yaml revision loading
-* Fixed Bug: Do not save and delete links confusing on edit page by replacing the links with form buttons.
-* Shutting down Soks with ctrl-c (which is trapped by the TERM signal - does this work on Windows? non OSX unix?) now waits until all the running helpers have finished making their changes to the wiki.  This should have fixed bug: Halting can corrupt revisions and may help with Bug: Unanticipated Rollbacks if graceless shutdown is the cause.  
-* Fixed Bug: Update frequency rounds inappropriately in meta view using Bil Kleb's extension to the Numeric class.
-* Fixed Bug: AutomaticRecentChanges ignores changes parameter
-* Fixed Bug: Uploads are not password protected 
-* Fixed Bug: Pictures and Attachments linked to site root
-* Partially fixed Bug: RSS feed does not validate, in that I changed the encoding given in the xml so that umlauts work.
-* Partially fixed Bug: Upload filenames needlessly mangled, in that it now only removes spaces from filename (which is unfortunately required for RedCloth to be able to make links to the file).
-* Robots.txt in the default template dissalows the 'meta' page view
-
-h3. Bugs remaining
-
-Seems like I've accumulated enough changes above to start thinking about another release.  This means that some bugs are not going to be fixed for this release.  If you strongly object, please let me know.
-* Bug: Does not make use of if-modified-since request headers
-* Bug: GEM limits title lengths
-* Bug: notextile does not prevent page inserts
-* Bug: Textile mishandles paragraphs
-* Bug: competing edits
-
-The following bugs have only been partially fixed, so some problems may remain
-* Bug: RSS feed does not validate
-* Bug: Unanticipated Rollbacks
-
-h2. Between v-0-0-5 and v-0-0-4
-
-h3. Features
-
-* Now uses Redcloth v3, and therefore can have some markdown styles as well as textile on the same page
-* Roughed up  two more automatic helpers: rss2wiki that writes the content of a rss feed to a wiki page, and mail2wiki that watches an imap mailbox and adds any messages in it to the wiki.  Both work, but are probably not ready for prime time.
-* Note I have removed the feature in v-0-0-4 that would merge any changes by the same author within 5 minutes, as it seemed to cause some confusion with end users.
-
-h3. Refactoring
-
-* Helpers have been moved to a separate sub directory
-* A module in soks-view that can be used by the erb template.  Has functions for creating urls for pages.  The default template has been updated to use this, but not the other templates. 
-
-h3. Bug fixes
-
-* Fatal bug when renaming picture or attachment pages fixed.
-* References to urls no longer include trailing punctuation
-* Authenticators no longer call depreciated base64 method
-* Now has (partial) support for robots.txt and favicon.ico
-* Search box no longer treats leading and trailling spaces as significant
-* Returns a page not found rather than an exception if an unknown view type is requested
-
-h3. Bugs remaining
-
-* No authentication on pictures and attachments
-* Punctuation in page titles problematic. ? <> and [] cause problems.  : and / are ok.
-* Insert page commands are not inhibited by notextile, pre or code tags
-
-h2. Between v-0-0-4 and v-0-0-3
-
-This was a bugfix release on v-0-0-3. Principally by adding locking code so two pages can't update the same page at the same time.
-
-h2. Between v-0-0-3 and v-0-0-2
-
-h3. Features
-
-* File format for revisions changed from marshalled array of revisions to a yaml'd array of strings and times.  This should allow easier import/export.
-* Changes to the files on disk appear in the wiki (by default checks for changes on disk every 60 seconds) to allow external editing of the wiki.
-* New way of making new pages: highlight the text you wish to link and press crtl-n.  This only works on some browsers.
-* RSS feed for changes made to any page (use the RSS feed on Recent Changes to be notified of all changes to the site, use the RSS feed on Site Index to be notified of new pages).
-* Added a WikiWord link for those that don't like to give out links with %20's in them. e.g. http://yoursite.com/wiki/HomePage redirects to http://yoursite.com/view/Home%20Page.
-* The automatic summary class has been extended to allow summary based on the page title, page author, or page content.
-* Different parts of the wiki, and different commands, can be authenticated differently based on regexps.
-* Kill list of words that will not be automatically linked (default set is the 30 most common English language words).
-* The soks-create-wiki command can now be interactive (or can use command line options including --help and --no-interaction).  It also manages upgrades from the previous version of Soks.
-* There are some demo templates: default is the standard, rails looks a bit like www.rubyonrails.com and instiki which looks a bit like www.instiki.org. 
-* A meta data view of a page. Clicking on the page's title on the top left of the screen brings up a list of the links from and too that page, and a list of the people who have contributed to the page. 
-
-h3. Refactorings
-
-* The recent changes and site index helpers now use the automatic summary class.
-* The Wiki class now notifies other classes of changes to the site, including the View class.
-* The storage methods are now a module which is mixed into the wiki class.
-
-h3. Bug Fixes
-
-* Bug in uploads on windows fixed (thanks to Sebastien Clediere).
-* Bugs in accepting titles with punctuation fixed.
-* Bug in automatic summary fixed.
-* Logo changed from png to tif so that it is transparent on a wider selection of browsers.
+h2. Before v0-0-6
 
-h3. Bugs remaining
+See list of changes for older versions
 
-* No authentication on pictures and attachments
-* Lots of little faults with the textile to html conversion.  Some due to the use of Redcloth v 2.0.11 (looking forward to a stable v3!) and some due to my inept subclassing.
+Tag: Include this page in the distribution

data/templates/default/content/News%3A%20Version%201%2D0%2D0%20released.textile

@@ -0,0 +1,19 @@
+h1. Version 1-0-0 released
+
+It gives me great pleasure to announce the sixth public release of Soks as v1-0-0.  There have been a lot of changes, and much of Soks has now stabalised so I've decided to call it a beta rather than an alpha.  When I iron out a few more bugs I might even be confident in calling it stable.
+
+See how to install soks, or how to upgrade soks for instructions.  There is a full list of list of changes and some known bugs, but in brief:
+
+* Page titles can now have any punctuation, and the wiki urls look slightly prettier.
+* Two new RSS feeds, one of which contains all the pages linked to from a particular page, the other that includes edits made to the contents of linked pages.  These are both useful in conjunction with the automatic summary classes.
+* Some popular pages, authors, visitors counters (not enabled by default)
+* The wiki can now save cache of page data and views when the wiki is shutdown.  This makes starting the wiki again much faster.
+* The way that all the settings are made has completely changed, hopefully to make it clearer, and to enable several wiki's to be mounted on the same Webrick server.
+* Some maintenance helpers, that can periodically slim the wiki (these are not enabled by default)
+* Can now include several static file handlers
+
+There has also been quite a lot of refactoring and bug fixing, all though some (not critical) bugs remain.  With the shift in version numbering, I plan to offer a 1-0-x series of releases as soon as I fix bugs until this release is thoroughly stable.  I will add features to a 1-1-0 release.
+
+
+
+Tag: Include this page in the distribution

data/templates/default/content/Pages%20to%20include%20in%20the%20distribution.textile

@@ -0,0 +1,51 @@
+h2. Pages to include in the distribution
+
+This is a list of pages that will be included in the default soks distribution.  It is created automatically from pages that contain "Tag: Include this page in the distribution".  If you think a page should be included, just write Tag: Include this page in the distribution somewhere on the page.
+
+<automaticsummary warning='DO NOT EDIT between these automatic summary tags, anything you write may be overwritten without warning'>
+
+* [[ Author ]]
+* [[ Automatic Summaries ]]
+* [[ Automatic linking between pages ]]
+* [[ Bug: Does not make use of if-modified-since request headers ]]
+* [[ Distribution Home Page ]]
+* [[ How to administrate this wiki ]]
+* [[ How to change the way this wiki looks ]]
+* [[ How to export a site from this wiki ]]
+* [[ How to hack soks ]]
+* [[ How to import a site from instiki ]]
+* [[ How to install Soks ]]
+* [[ How to use the keyboard shortcuts ]]
+* [[ How to use this wiki ]]
+* [[ List of changes ]]
+* [[ README ]]
+* [[ Recent changes to this site ]]
+* [[ Site Index ]]
+* [[ Soks Licence ]]
+* [[ Latest News ]]
+* [[ All News ]]
+* [[ RSS feed ]]
+* [[ Bug: GEM limits title lengths ]]
+* [[ Planned Features ]]
+* [[ Bug: notextile does not prevent page inserts ]]
+* [[ How to report a bug ]]
+* [[ How to get the latest Soks from cvs ]]
+* [[ Api for classes to modify the wiki ]]
+* [[ Bug: Unanticipated Rollbacks ]]
+* [[ Per Wiki Templates ]]
+* [[ How to password protect your wiki ]]
+* [[ Bug: Textile mishandles paragraphs ]]
+* [[ Bug: Competing edits ]]
+* [[ Bug: E-mail addresses with hyphens not recognised ]]
+* [[ Bug: Email adresses in page titles cause incorrect links ]]
+* [[ Bug: Memory leak ]]
+* [[ News: Next release due, so this site is being edited ]]
+* [[ Tag: Include this page in the distribution ]]
+* [[ Pages to include in the distribution ]]
+* [[ How to import data ]]
+* [[ Bug: Pages that link here may not appear on restart ]]
+* [[ News: Version 1-0-0 released ]]
+* [[ How to upgrade soks ]]
+
+
+</automaticsummary>

data/templates/default/content/Per%20Wiki%20Templates.textile

@@ -33,3 +33,5 @@ For you?  Probably nothing!  They just show how can have a different look and fe
 * Rails has a big logo bar at the top, the content on the right, and the links etc on the left.  Looks a lot like http://wiki.rubyonrails.com
 
 fn1. I've only been updating the default template recently. 
+
+Tag: Include this page in the distribution

data/templates/default/content/Planned%20Features.textile

@@ -1,27 +1,26 @@
 h1. Planned Features
 
-In the long term I'm hoping to spend some time working on the instiki project to incorporate some of the features of Soks into instiki, but not until I've got soks stable and smooth.
+For features that are planned for the next release or two, see the to do list.
 
-h2. v0-0-8:
+h2. Features in v1.1.0
 
-_I'm about to release v-0-0-7 earlier than I had planned, in order to fix the critical Bug: Internet Exploror 6.0 incompatibilities during page edits. Therefore these features have been pushed back to v-0-0-8._
+* A way of storing and using meta-data about each page
 
-* Sort out a decent site wide RSS feed
-* Take a look at any scale / speed limits and see if they can be reduced 
-** May need a housekeeping routine that could periodically prune large revision files, and perhaps permanently remove deleted pages after a while.
+h2. Features in v1.2.0
+
+* A way of editing by paragraph as well as page
 
 h1. Desired Features
 
 Let me know if there is anything that you would like to see, or add it here:
 
 * Flesh out the RSS feed:
-** Have the item content render the most recent change information like that shown at the bottom of an edit page. (Remove the logo and search box?)
-** Have the source link be the "view" view and not the "rss" view.
+** (Remove the logo and search box?)
 ** Replace the <notextile>* [[ page title ]]</notextile> asterisk and brackets with quotation marks? --Bil
 * Fast CGI or the like as an alternative to Webrick
 * Give each automaticsummary a unique name so several can update the same page
 * Some form of tag to automatically create automatic summaries.
-* Make the wiki fork, and give commands to gracefully start and stop it.
+* Give commands to gracefully start and stop it.
 * I was going to make a suggestion, then I noticed that something like it had been added and deleted. Perhaps some explanitory text explaining what has already been suggested or what is or is not acceptable would be a good idea? - Sorry. A mistake on my part.  Please do make your suggestion again, and I won't delete any in future - tamc2
 ** I think a generalized way of extending soks to be very much more dynamic would be allowing dirt-simple extensions. One way would be to put a @scripts@ directory in parallel with @attachment@ and extend @insert@ to then include the output of the script. So something like @[ [insert script helloworld blah ] ]@ would run helloworld.rb with the argument blah and the output would get pasted right into the wiki page. What do people think? --Skorgu
 ** Interesting, what types of script did you have in mind?  The only challenge I can see is deciding how frequently to call the script to update the page, every time the page is viewed? or every time it is editted? or somewhere in between? what do you think? -- tamc
@@ -35,7 +34,29 @@ Let me know if there is anything that you would like to see, or add it here:
 * Perhaps the default layout should have a little table of contents menu like wikipedia pages, e.g., the thing labeled 'contents' at http://en.wikipedia.org/wiki/Wiki. If you create a long page with several headings, it creates a little table of contents at the top so you can leap down the page quickly.
 * The following came from one our site's users.  It would seem contrary to the basic architecture of this wiki engine.  However, it would be nice to be notified somehow of how many or which pages were going to have their links deactivated or altered... --Bil
 ** It would be nice if I changed the name of a page that had other pages linked to it, that I could have the option of changing all of the linked pages to it automatically. --Bil
+* Add a facility to use trackbacks on wiki pages so that can see other sites that link to that page. http://www.sixapart.com/movabletype/docs/mtmanual_trackback.html --tamc2
+* I think this http://tool-man.org/examples/edit-in-place.html would be great.  Double click on a paragraph and edit it in place!  Unfortunately his code only works on some browsers... --tamc2
+** That demo is absolutely gorgeous. It would be obscenely cool to implement soks as an AJAX or whatever we're calling it today frontend a la gmail/google maps etc. It seems that some work is being done to integrate that into rails, so maybe they could both be integrated at once? Another benefit to rails-izing is moving away from WEBRick as the only frontend. "lighttpd":http://bigbold.com/snippets/posts/show/175 apparently plays well with rails --Skorgu
+* Victor Ng-Thow-Hing asked by email about adding rich media (e.g. movies, svg etc) to the wiki.  Can currently upload them as files and link to them, but I'll have a think about how to extend textile to allow movies etc to be embedded.  --tamc2
+
+Suggestions in an email from Seb Clediere copied here
+* Multi-wiki. Have you thought about several wikis? Like instiki where you can setup several wikis? -- See also [[ kleb's email => [soks] Sub wikis ]].
+* Flat hierarchy. With the wiki content growing in size, I am wondering about having a directory hierarchy in the wiki, rather than a flat one. And perhaps there would be not need for a separate attachement and content. (Hieraki are doing something along a hierarchical wiki http://demo.hieraki.org)
+* I had a brief look at a new comer: MiniRubyWiki. I don't like it at all, but the guy add a very good idea: integrate graphziz/dot to it, so it is easy to add somes graphs to the text. Very good.
+** I'll have to take a look.  I am curious whether Graphviz/dot was used for displaying (and navigating) the meta-page link connections like "TheBrain":http://www.thebrain.com or something else? --Bil
 
 Also considering these bigger changes (interested in your thoughts):
 * Making the automatic linking ignore punctuation.  Only the words in page titles would be significant, so "Bug: A bug" would be treated the same as "Bug- A bug" -- tamc
 * Making the automatic linking link to 'similarly' title pages. e.g: If you have a page called "Page One" and another called "Page Two" all instances of the word "One" in "Page Two" would link to "Page One".  Would add a lot of processing, but might allow distinct namespaces. -- tamc
+
+h2. Adopted features
+
+These are suggestions that were above and have been implemented (at least in the CVS version) or are on the to do list.
+
+* Flesh out the RSS feed
+** Have the item content render the most recent change information like that shown at the bottom of an edit page
+** Have the source link be the "view" view and not the "rss" view.
+* Make the wiki fork (possible by changing a setting in the start.rb file)
+* There was a guy on comp.lang.ruby wanted to do a link in instiki to a file, exactly what I have done in soks with the few lines of code I sent you a while ago in fact.  (My mistake in not including this code sooner, I will put it in the next release, sorry! -- tamc2)
+
+Tag: Include this page in the distribution

data/templates/default/content/README.textile

@@ -63,15 +63,16 @@ I suspect there are many, as befits its version number.  In particular it has:
 * Insert page commands are not inhibited by notextile, pre or code tags
 * Does not permit browsers to cache pages
 * Not user friendly in the way it handles simultaneous edits of a page (last person to save wins)
-* Some bugs in layout and formatting of text.
-* RSS feed does not completely validate
 
 See http://www.soks.org/wiki/KnownBugs for details.
 
 h2. RELEASES
 
+# 2005 July 24 - soks-1.0.0 - Sixth public release (beta)
 # 2005 Mar 21 - soks-0.0.7 - Fifth public release (alpha)
 # 2005 Mar 15 - soks-0.0.6 - Fourth public release (alpha)
 # 2005 Feb 12 - soks-0.0.5 - Third public release (alpha)
 # 2005 Jan 24 - soks-0.0.4 - Second public release  (alpha)
 # 2005 Jan 11 - soks-0.0.2 - First public release (alpha)
+
+Tag: Include this page in the distribution

data/templates/default/content/RSS%20feed.textile

@@ -6,4 +6,4 @@ The rss currently only shows:
 * Changes to the textile (not html)
 * Added lines
 
-Note there is a bug: RSS feed does not validate
+Tag: Include this page in the distribution