As told in a previous discussion, I am trying to figure out how to
build a whole new skin in order to better understand how the skin system
works (or vice-versa). In parallel, I will be writing the missing doc on
<http://platform.xwiki.org/xwiki/bin/view/AdminGuide/Skins#HCreatingawholenewskin>
For the moment there is only a couple of phrases stating that the
minimum templates needed are view, edit, preview and save. I have
guessed these info after some studying of the structure of other
templates, any confirmation or correction is welcome.
Next I would like to know what variables should be handled by the
templates. For example, a test for a parameter that I see often in other
templates is
#if ($request.getParameter("raw").equals("1"))
I have guessed that when this is true there is just a code page to be
displayed, but that does not tell me when and where this parameter is
set, and if every parameter is set in the $request variable and what
they mean...
I have tried to list every parameter by this code, but it doesn't
work:
#foreach($param in $request.getParameterNames())
* $param : $request.getParameter($param)
#end
If someone could help me figure out all these things it would really
help me understand how the skin system works and how to build a new
skin. Of course you can complete yourself the wiki page but if you don't
I will do it once I understood the process.
Thanks.
Le jeudi 20 décembre 2007 à 16:13 +0100, Karim-Pierre Maalej a écrit :
So e.g. I want to know how to make a site like
Curriki. How should I
proceed? And first, in which section should I have a look? There's
something missing here, maybe just a few words that say to me 'hey guy,
if you want to build a website upon XWiki, it's that way!'
+1, we're mostly documenting features and OpenSource development
practices. A complete tutorial should be written; for the moment, there
are some articles about setting up XWiki, they used to be linked
somewhere on
xwiki.org.
To give you a more actual illustration, I am currently working on
designing a skin for XWiki for the iPhone. It takes me quite a lot of
time because I have to figure out how all this thing works (the Skins
section only suggests tweaks to existing skins, and not redesigning a
whole new one from scratch).
I intend to write a detailed howto based on my experience when I get to
it, but for the moment I am right in the middle of the jungle, exploring
and slowly drawing a map of the continent around me :-)