Soks 0.0.2 → 0.0.3

data/templates/instiki/content/Site%20Index.textile

@@ -0,0 +1,16 @@
+h1. Site Index
+
+* Picture of a pair of soks 
+* AutomaticSummary 
+* home page 
+* How to export a site from this wiki 
+* How to hack soks 
+* How to import a site from instiki 
+* Improving the style of this wiki 
+* Known bugs 
+* List of changes 
+* Pointers on adjusting the settings 
+* Pointers on how to use this wiki 
+* Recent Blog Entries 
+* Recent Changes to This Site 
+* Soks Licence 

data/templates/instiki/content/Soks%20Licence.textile

@@ -0,0 +1,64 @@
+h1. Soks is licensed under the The Ruby License
+
+Note: This licence applies to all that is contained in this distribution EXCEPT files within the contrib folder which may be under different licences.
+
+Soks is copyrighted (c) 2004, 2005 free software by Thomas Counsell tamc@rubyforge.org. 
+
+<pre>
+
+You can redistribute it and/or modify it under either the terms of the 
+GPL (see the file GPL), or the conditions below:
+
+  1. You may make and give away verbatim copies of the source form of the
+     software without restriction, provided that you duplicate all of the
+     original copyright notices and associated disclaimers.
+
+  2. You may modify your copy of the software in any way, provided that
+     you do at least ONE of the following:
+
+       a) place your modifications in the Public Domain or otherwise
+          make them Freely Available, such as by posting said
+          modifications to Usenet or an equivalent medium, or by allowing
+          the author to include your modifications in the software.
+
+       b) use the modified software only within your corporation or
+          organization.
+
+       c) rename any non-standard executables so the names do not conflict
+          with standard executables, which must also be provided.
+
+       d) make other distribution arrangements with the author.
+
+  3. You may distribute the software in object code or executable
+     form, provided that you do at least ONE of the following:
+
+       a) distribute the executables and library files of the software,
+          together with instructions (in the manual page or equivalent)
+          on where to get the original distribution.
+
+       b) accompany the distribution with the machine-readable source of
+          the software.
+
+       c) give non-standard executables non-standard names, with
+          instructions on where to get the original software distribution.
+
+       d) make other distribution arrangements with the author.
+
+  4. You may modify and include the part of the software into any other
+     software (possibly commercial).  But some files in the distribution
+     are not written by the author, so that they are not under these terms.
+
+     For the list of those files and their copying conditions, see the
+     contrib directory.
+
+  5. The scripts and library files supplied as input to or produced as 
+     output from the software do not automatically fall under the
+     copyright of the software, but belong to whomever generated them, 
+     and may be sold commercially, and may be aggregated with this
+     software.
+
+  6. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+     IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+     WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+     PURPOSE.
+</pre>

data/{template → templates/instiki}/content/home%20page.textile

@@ -1,16 +1,21 @@
 h1. Welcome! 
 
-You have succesfully installed soks. Remember it is work in progress, and definitely not fully de-bugged. So don't trust your mission critical sites to it. In particular, I have only really used it with ruby 1.8.2 on Mac OS X 10.3.  If you have any success or failure on other platforms, please let me know.
+You have succesfully installed soks. Remember it is work in progress, and definitely not fully de-bugged. So don't trust your mission critical sites to it. 
+
+If you are upgrading from a previous version, you may wish to glance at the list of changes.
+
+h2. Further information
 
-For further information see:
 * Pointers on how to use this wiki
 * Improving the style of this wiki
 * Pointers on adjusting the settings such as the url, or the port, or 'advanced' features such as automatic calendars and summaries.
 * How to import a site from instiki
 * How to export a site from this wiki
-* [[How to hack soks]]
+* How to hack soks
+* [[Known bugs]] (If you know how to fix them, please let me know!)
+
+h2. Feedback
 
-Feedback
 * Please send me your feedback.  tamc@rubyforge.com.  
 * Or submit a bug at  http://rubyforge.org/projects/soks/.  
 * To keep track of developments, you may wish to subscribe to the mailing list at http://rubyforge.org/projects/soks to be notified of updates.

data/templates/instiki/start.rb

@@ -0,0 +1,85 @@
+#!/usr/local/bin/ruby
+
+# This file was created automatically on <%= Time.now %>
+# Uncomment different sections to enable features of this wiki.
+
+#Add the required libraries to the search path:
+$:.push( "<%= settings[:soks_libraries].join('","') %>" )
+
+require 'soks'
+
+module StartSoks
+	
+=begin
+	# You can choose what level of authentication to apply based on regular expressions matched
+	# against the page title.  These regexps are tried in order.Defaults are here:
+	AUTHENTICATORS = [ [ %r{/(view|rss|print|find|meta)/.*}, WEBrick::HTTPAuth::NoAuthenticationRequired.new ],
+							 # [ %r{/upload/.*}, WEBrick::HTTPAuth::NotPermitted.new ],
+							 # [ %r{/(edit|save)/home page}, WEBrick::HTTPAuth::SiteWidePassword.new('password','You need to enter the site wide password to edit the home page') ],
+							# [ %r{/(view|edit|save)/private.*},WEBrick::HTTPAuth::BasicAuth.new( :UserDB => htpasswd, :Realm => realm ) ], # See webrick documentation
+							[ %r{.*}, WEBrick::HTTPAuth::AskForUserName.new( 'No password, just enter a name') ]						
+							] 
+
+=end
+
+	CUSTOMSETTINGS = {
+		:root_directory => '<%= settings[:root_directory] %>', 
+		# :name => 'test',
+		# :description => 'A Soks Wiki',
+		:url => '<%= settings[:url] %>',
+		:port => <%= settings[:port] %>,
+	   # :authenticators => AUTHENTICATORS
+	}
+	
+	def self.start
+		start_wiki( CUSTOMSETTINGS ) do |wiki, view|
+			AutomaticRecentChanges.new( wiki ) 
+
+			AutomaticOnePageIndex.new( wiki ) # Index on one page, best for small wikis
+			# AutomaticMultiPageIndex.new( wiki ) # One page per letter index, best for large wikis
+			
+			# calendar = AutomaticCalendar.new( wiki ) # Adds a series of calendar pages to the wiki
+			# AutomaticUpcomingEvents.new( wiki, calendar ) # Creates a page with the next weeks events drawn from the calendar pages
+
+			AutomaticAuthorIndex.new( wiki )
+
+			# Example of an automatically generated summary of any new pages whose title starts with 'blog'
+			AutomaticSummary.new( wiki, 
+				:regexp_for_title => /^Blog/i,
+				:max_pages_to_show => 10,
+				:pagename => 'Recent Blog Entries',
+				:only_new_pages => true,
+				:lines_to_include => 10,
+				:include_metadata => true
+				)
+			
+			 #  Possible settings for the Automatic Summary	(with defaults)
+		 	 #  :regexp_for_title => /.*/, # These three regexps act as an AND
+			 #  :regexp_for_author => nil, 
+			 #  :regexp_for_content => nil,
+			 #  :max_pages_to_show => nil,
+			 #  :pagename => 'Summary',
+			 #  :author => 'AutomaticSummary',
+			 #  :lines_to_include => nil, # nil puts a link, can pass a block instead to render
+			 #  :only_new_pages => false,
+			 #  :sort_pages_by => :created_on, # Could be :revised_on or :score or :name or :name_for_index, or :author
+			 #  :reverse_sort => false,
+			 #  :include_metadata => false, # Includes author and time in summary
+			 #  :summarise_revisions => false, # If true, then can contain several revisions for same page
+			 #  :remove_deleted_pages => true, # If false will keep references to deleted pages
+			
+			# This is an array of titles that will NOT be automatically linked.
+			# Default is the 30 most common words in the english language
+			# Note that pages can still be created with these titles, and they can still be manually linked to.
+			banned_titles = IO.readlines('<%= settings[:root_directory] %>/banned_titles.txt').map { |title| title.strip }
+			
+			# This takes a while, so do it last. Note that the banned_titles argument is optional.
+			AutomaticUpdateCrossLinks.new( wiki, view, banned_titles ) 
+		end
+	end
+
+end
+
+if $0 == __FILE__ then
+	StartSoks::start
+end

data/templates/instiki/version.txt

@@ -0,0 +1 @@
+0.0.3

data/templates/instiki/views/Page_content.rhtml

@@ -0,0 +1 @@
+<%= page.content %>

data/templates/instiki/views/Page_edit.rhtml

@@ -0,0 +1,8 @@
+<div id="TextileHelp" style="float: right; width: 250px; margin-top: 5px">
    </table>
    
    <h3>Wiki words</h3>
  Internal links are made automatically by typing the title of the other page.  They can be forced by putting them inside double square brackes [[a forced link]]. They can be redirected by [[ this points to => another page ]].  The other page can be inserted by typing [[ insert title of other page ]]. This is particularly useful for adding images [[ insert picture of a pair of soks ]].
  function quickRedReference() {
    window.open( 
      "http://hobix.com/textile/quick.html",
      "redRef",
      "height=600,width=550,channelmode=0,dependent=0," +
      "directories=0,fullscreen=0,location=0,menubar=0," +
      "resizable=0,scrollbars=1,status=1,toolbar=0" 
    );
  }
+
+<form id="editForm" method=post action='/save/<%= pagename %>' >
+<p><input name='newtitle' style="width: 600px;" size='80'  value='<%= pagename %>' onClick="this.value == 'Type a title here' ? this.value = '' : true" /></p>
+<p>
+<textarea name='content' style="width: 600px; height: 500px"  onClick="this.value == 'Type what you want here and click save' ? this.value = '' : true" ><%= page.content %></textarea>
+</p>
+<p>
    <input type="submit" value="Update" accesskey="S"> as <a href='/<%= person %>'><%= person %></a>
    
    | <a href='/<%= pagename %>' accesskey="C" >Cancel</a> | <a href='/delete/<%= pagename %>' accesskey="D" >Delete this page</a>

data/templates/instiki/views/Page_meta.rhtml

@@ -0,0 +1,34 @@
+<p>This page was created on <%= page.created_on %> by <%= page.revisions.first.author %>. </p><p>It was last updated on <%= page.revised_on %> by <%= page.author %>.</p><p> It has been changed <%= page.revisions.size %> time(s) (roughly once every <%= (((Time.now-page.created_on)/page.revisions.size)/(60*60*24)).to_i %> days).</p>
+
+<div class='metacolumn' >
+<h2>Wiki links from this page</h2>
+
+<ul>
+<% page.links_from.each do |linkedpage| %>
+	<li><a href='/<%= linkedpage.name %>'><%= linkedpage.name %></a></li>
+<% end %>
+</ul>
+
+</div>
+
+<div class='metacolumn' >
+<h2>Wiki links to this page</h2>
+
+<ul>
+<% page.links_to.each do |linkedpage| %>
+	<li><a href='/<%= linkedpage.name %>'><%= linkedpage.name %></a></li>
+<% end %>
+</ul>
+
+</div>
+
+<div class='metacolumn' >
+<h2>Authors</h2>
+
+<ol>
+<% page.revisions.each do |revision| %>
+	<li><a href='/<%= revision.author %>'><%= revision.author %></a></li>
+<% end %>
+</ol>
+
+</div>

data/templates/instiki/views/Page_print.rhtml

@@ -0,0 +1,6 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<body>
+<%= renderedview %>
+</body>
+</html>

data/templates/instiki/views/Page_revisions.rhtml

@@ -0,0 +1,17 @@
+<div class="undochange">
+	<% page.revisions.reverse_each do |revision| %>
+		<p><%= revision.created_on %> by <a href='/<%= revision.author %>'><%= revision.author %></a> <a href='/rollback/<%= pagename %>?revision=<%= revision.number-1 %>' >(undo)</a>:</p>
+		<p>	
+		<% revision.changes.each do |change_group| %>
+				<%	change_group.each do |change|
+					case change[0]
+					when "-" %>
+						<del><%= change[1] %>. <%= change[2] %></del><br />
+					<% 	when "+" %>
+						<%= change[1] %>. <%= change[2] %><br />
+					<%	end %>
+				<%	end %>
+		<% end %>			
+		</p>		
+	<% end %>
+</div>

data/templates/instiki/views/Page_rss.rhtml

@@ -0,0 +1,55 @@
+<%=
+require "rss/maker"
+
+RSS::Maker.make("2.0") do |maker|
+  
+  	maker.channel.title = "#{$SETTINGS[:name]} #{pagename}"
+	maker.channel.description = $SETTINGS[:description]
+	maker.channel.link = $SETTINGS[:url]
+
+	maker.image.title = "#{$SETTINGS[:name]}"
+	maker.image.url = "#{$SETTINGS[:url]}/attachment/logo.png"
+
+	maker.textinput.title = "Search"
+	maker.textinput.description = "Search #{$SETTINGS[:name]}'s text"
+	maker.textinput.name = "regex"
+	maker.textinput.link = "#{$SETTINGS[:url]}/find/searchpage"
+
+	maker.items.do_sort = true
+
+	count = 0
+	for revision in page.revisions
+		break if (count +=1) == 15
+		item = maker.items.new_item
+		item.link = "#{$SETTINGS[:url]}/#{pagename}"
+		# Get the first change that makes an addition and use as the title
+		title = nil
+		revision.changes.each do |group|
+			group.each do |type,line,text|
+				if type == '+' && text != ''
+					title = text.gsub(/<.*?>/,'')
+				end
+				break if title			
+			end
+			break if title
+		end
+		# If change found, take just the changed text and remove tags.
+		# If no change found, then must be because only deleted stuff so give that message
+		item.title = title || $MESSAGES[:some_content_has_been_deleted] # Default			
+		item.date = revision.created_on
+		item.author = revision.author
+		item.description = ""
+		content_deleted = false
+		revision.changes.each do |change_group|
+			change_group.each do |change|
+				case change[0]
+				when "-"; content_deleted = true
+				when "+"; item.description << "#{change[2]}<br />"
+				end
+			end
+			item.description << "&#8230;<br />"
+		end
+		item.description << "Content was also deleted" if content_deleted
+	end
+end
+%>

data/templates/instiki/views/Page_search_results.rhtml

@@ -0,0 +1,18 @@
+<h1>Results of Search for &#8220;<%= pagename %>&#8221;</h1>
+<% unless title_results.empty? %>
+	<h2>Matches in the titles of pages</h2>
+	<ul>
+	<% title_results.each do |name, page| %>
+		<li><a href='/<%= name %>' ><%= name %></a></li>
+	<% end %>
+	</ul>
+<% end %>
+<% unless text_results.empty? %>
+	<h2>Matches in the text of pages</h2>
+	<ul>
+	<% text_results.each do |name, page| %>
+		<li><a href='/<%= name %>' ><%= name %></a></li>
+	<% end %>
+	</ul>
+<% end %>
+<div class='command'>(<a href='/edit/<%= pagename %>' accesskey="E" >Create a page titled &#8220;<%= pagename %>&#8221;</a>)</div>

data/templates/instiki/views/Page_view.rhtml

@@ -0,0 +1,2 @@
+<%= renderedview %>
+

data/templates/instiki/views/UploadPage_edit.rhtml

@@ -0,0 +1,16 @@
+<form action='/upload/<%= pagename %>' method=post enctype=multipart/form-data >
+<table>
+	<tr><td>Title:</td><td>
+	<% if page.is_a? ImagePage %>
+		<input type=hidden name='titleprefix' value='Picture of ' />
+		Picture of <input name='newtitle' size = '51' value='<%= pagename[ 10..-1].strip %>'  
+	<% else %>
+		<input type=hidden name='titleprefix' value='Attached ' />
+		Attached <input name='newtitle' size = '52' value='<%= pagename[ 9..-1].strip %>' 
+	<% end %>
+	onClick="this.value == 'Type a title here' ? this.value = '' : true"/></td></tr>
+	<tr><td valign='top'>File:</td><td><input name='file' type=file  /></td></tr>
+	<tr><td>Author:</td><td><a href='/<%= person %>'><%= person %></a> Quit browser to log out.</td>
+	<tr><td></td><td><input name=action value='Save' type=submit accesskey="S"> <a href='/<%= pagename %>' accesskey="C" >(Cancel)</a> or <a href='/delete/<%= pagename %>' accesskey='D'>(Delete)</a> this page.</td></tr>
+	</table>
+</form>

data/templates/instiki/views/frame.rhtml

@@ -0,0 +1,90 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html lang="en">
+<head>
+  <title><%= pagename %></title>
+	<meta name="description" content="<%= $SETTINGS[:description] %>" />
+	<meta name="keywords" content="Soks, <%= $SETTINGS[:name] %>" />
+	
+  <style type="text/css">
+    h1#pageName, .newWikiWord a, a.existingWikiWord, .newWikiWord a:hover, #TextileHelp h3 { 
      color: #008B26; 
    }
    #Container, #Content {
      width: <%= view == 'edit' ? '870px' : '600px' %>;
    }
+ </style>
+
+  <link rel="stylesheet" href="/attachment/instiki_style_sheet.css" type="text/css" media="screen" />
+
+  <style type="text/css">
+    
+    .leftHandSide {
+		  float: right;
+		  width: 147px;
+		  margin-left: 10px;
+		  padding-left: 20px;
+		  border-left: 1px dotted #ccc;
+	}
+
+	.leftHandSide p {
+	  font-size: 10px;
+	}
+	
+	#navigationForm {
+		display: block;
+	}
+  </style>
+</head>
+<body onkeypress="hotkey(event);">
+<div id="Container">
+  <div id="Content">
+  
+  <h1 id="pageName">  
+      <small><%= $SETTINGS[:name] %></small><br />
+      <%= pagename %>
+  </h1>
+	<form id="navigationForm" class="navigation" method=GET action='/find/<%= pagename %>' style="font-size: 10px">  
+	  <a href="/view/home page" title="Home, Sweet Home" accesskey="H">Home Page</a> | 
+	  <a href="/view/site index" title="Alphabetically sorted list of pages" accesskey="A">All Pages</a> | 
+	  <a href="/view/recent changes to this site" title="Pages sorted by when they were last changed" accesskey="U">Recently Revised</a> | 
+	  <a href="/view/authors" title="Who wrote what" accesskey="">Authors</a> | 
+	  <a href="/rss/<%= pagename %>" title="Subscribe to changes by RSS">Feed</a> | 
+	  <a href="/view/How to create a new page" title="How to export from this wiki">New Page</a> | 
+	  <input type="text" id="searchField" name='regex' style="font-size: 10px" value="Search" onClick="this.value == 'Search' ? this.value = '' : true">
+	</form>
+
+<div id="revision">
+ <%= content_of_page %>	
+</div>
+
+<% if page %>
+<div class="byline">
+  Revised on <%= page.revised_on %> 
+  by <a class="existingWikiWord" href="/view/<%= page.author %>"><%= page.author %></a>
+</div>
+<% end %>
+
+<div class="navigation">
+  
+    <a href="/edit/<%= pagename %>" class="navlink" accesskey="E">Edit</a>
+    | <small>(<%= page ? page.revisions.size : '0' %>)</small>
+    <span id="show_changes">
+      | <a href="/revisions/<%= pagename %>" >See changes</a>
+    </span>
+   <small>
+    | Views: <a href="/view/<%= pagename %>" >Normal</a>, <a href="/meta/<%= pagename %>" >Meta-Data</a>, <a href="/print/<%= pagename %>" >Print</a> 
+  </small>
+
+  
+    <small>
+      | Linked from: 
+      <% if page %>
+			<% page.links_to.each do |linkedpage| %>
+				<a href='/<%= linkedpage.name %>'><%= linkedpage.name %></a>
+			<% end %>
+		<% end %>
+    </small>
+  
+</div>
+</script>
+
+  </div>
+<i style='font-size:x-small;'>Powered by <a style='display:inline;' href='http://soks.rubyforge.org'>Soks</a> in 'look a bit like <a href='http://www.instiki.org/'>Instiki</a>' mode</i>
+</div>
+</body>
+</html>