Per Wiki Templates
—
!!1!
!
>Per Wiki Templates
—
!!2!
!
—
!!3!
!
When you create a new wiki with the soks-create-wiki command,
it copies the contents of path-to-soks-installation/templates/default into a new folder called soks-wiki.
!
!4!
!
—
!!5!
!
If you change anything in the soks-wiki folder
(see
‘
how to change the way this wiki looks’ for ideas and tips)
then it will apply to that wiki only.
!
!6!
!
If you wish to create a default set up for future
wikis:
—
!!7!
!
>
—
!!8!
!
Change a running wiki into a form that you find useful,
!
!9!
!
!
!10!
!
Create a new folder under path-to-soks-installation/templates/
e.g.
path-to-soks-installation/templates/yourtemplate
—
!!11!
!
!
!12!
!
Copy the contents of your running wiki to this new folder
—
!!13!
!
!
!14!
!
(Optional)
edit the path-to-soks-installation/templates/yourtemplate/start.rb file to allow the port,
url,
name etc to be set from the soks-create-wiki command
(see the
path-to-soks-installation/templates/default/start.rb for ideas on how to do this)
!
!15!
!
—
!!16!
!
—
!!17!
!
You can then use this template to create future
wikis by using the
—template option of the soks-create-wiki.rb command.
e.g.
—
!!18!
!
!
!19!
!
!
!20!
!
!
!21!
!
—
!!22!
!
I’m still confused as to exactly what templates are doing and why/when I would use them.
In other words,
what’s a typical use case?
—
Bil !
!23!
!
So,
the use I imagine is so that I a user of Soks might wish to be able to quickly deploy
(by
!
!24!
!
!
!25!
!
).
..
—
!!26!
!
>
—
!!27!
!
An internal team wiki
—
!!28!
!
!
!29!
!
An external public wiki
—
!!30!
!
!
!31!
!
A wiki that looks just like other wiki X
—
!!32!
!
!
!33!
!
A French localised wiki
—
!!34!
!
!
!35!
!
A wiki that acts like a blog and no more
—
!!36!
!
—
!!37!
!
—
!!38!
!
..
.Each with a diffent look and feel,
different default
automatic summaries, default authentication,
with or without a calendar by default,
etc.
. etc.
..
!
!39!
!
—
!!40!
!
What do the currently supplied instiki,
default,
and someother templates do for me?
(
Still dense on this topic.
)
—
Bil !
!41!
!
For you?
Probably nothing!
They just show how can have a different look and feel.
The default,
instiki and rails layouts are just the three different layouts I originally considered for Soks
1:
—
!!42!
!
>
—
!!43!
!
Default has the content on the left,
and the links etc on the right
—
!!44!
!
!
!45!
!
Instiki has the links and control stuff at the top and bottom,
with the content centered in the middle.
Looks a lot like
http://www.instiki.org !
!46!
!
!
!47!
!
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 !
!48!
!
—
!!49!
!
—
!!50!
!
>
—
!!51!
!
1
—
!!52!
!
I’ve only been updating the default template recently.
!
!53!
!
—
!!54!
!
!
!55!
!
