15 Jan
2008
15 Jan
'08
11:16 p.m.
Hi Karim,
Hi again :)
I've just read that thread on XWiki's documentation where you mention you
want to develop the skin for the iPhone. I guess you then certainly want
to drop features from albatross (at least to begin with) and indeed start
from scratch, or almost ; albatross layout being probably "too heavy" for
such device. My advice would then be to start with simple things, and add
features incrementally : first render documents, writing a new view.vm;
then add the wikieditor, writing edit.vm (will it be usable btw ?), and so
on.
Still, you will definitely need to have albatross as a model, even if
yours has to be lighter. The doc on URL/forms mappings can be usefull too
when it'd be more complete.
Regards,
Jérôme.
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.
In fact, there is no real need for a save.vm template : save is an action
of the URL, which is handled by xwiki, and that will send back another
template, according to user choices (click on "save" or "save and
continue" for example) ; and result of the save process : view.vm (for
save and view), edit.vm (for save and continue), or exception.vm (if the
save somehow failed) - possibly any template.
I started to write a document that will detail this forwarding process and
the parameters you can use in XWiki forms and urls (can be handy when you
write a skin) :
http://dev.xwiki.org/xwiki/bin/view/Drafts/XWikiURLMappings. It's only a
draft now, so can't be taken as complete.
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"))
What's important for your concern (building a new skin from scratch), is
how much of the default skin behavior you want to keep. If you want to
keep just everything (let's say, code viewer, history viewer, change
viewer, comments & attachments forms and viewers, etc.) then, your best
choice is probably to use that albatross skin as a basis for your new
skin; otherwise you'll have a big amount of code to write, so be sure this
is what you want to do :)
Modifying a copy of the albatross skin (or even better, extending the
albatross skin by overriding only the templates you need to modify/adding
new templates) will allow you to change the layout of rendered html,
add/remove things you want/things you don't want... well, let you free to
decide of your own skin layout and behavior.
Note that it is in the roadmap for XWiki 1.3 to make skin creation easier,
moving every velocity templates to a single place (right now they are
either in templates/ or in skins/albatross/), and introducing a new "skin
extension" mechanism.
Hope it answer your questions.
Regards,
Jérôme.
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
:
_______________________________________________
users mailing list
users(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/users
_______________________________________________
users mailing list
users(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/users
> 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 :-)