wiki theme

Discussions about the wiki documentation of FreeCAD and its translation.
Forum rules
Be nice to others! Respect the FreeCAD code of conduct!
User avatar
yorik
Founder
Posts: 13665
Joined: Tue Feb 17, 2009 9:16 pm
Location: Brussels
Contact:

wiki theme

Post by yorik »

I've been playing a bit with wiki theming, have a look at what I have now: (it's on my sourceforge wiki, did you know every sourceforge user has a wiki?)

http://sourceforge.net/userapps/mediawi ... _Main_Page

The idea is that only the sidebar and the homepage have total blue background. The other pages have a white background for better legibility. The theme (or a variation of it) can then be used for the startpage inside freecad...

There are still a couple of issues:
- spacing problems here and there, specially with screens smaller than 1200px, but I'll solve that
- give a special look to the download box
- the updates feed box is not too cool either, but I can only grab feeds from the sourceforge.net domain (since we can't install wiki extensions, I had to do it in javascript, which can't access stuff outside its domain). and unfortunately sourceforge feeds suck...
- maybe less description on the homepage?
- other sideboxes?
- what features should be the most important to show on the homepage? I thought 1) the gui is +/- usable already 2) how the 3D view looks 3) how it's easy to do python scripting... anything else? Parametric stuff would obviously be the next in sight...

Anyway. If someone has ideas, fire away!
Cheers
Yorik
User avatar
jriegel
Founder
Posts: 3369
Joined: Sun Feb 15, 2009 5:29 pm
Location: Ulm, Germany
Contact:

Re: wiki theme

Post by jriegel »

Its really cool!
I think you get a good hint to look in the wiki for popular pages. The download and the screenshoots are the important ones.

The look is great, I look forward when you finish it!!
Stop whining - start coding!
User avatar
yorik
Founder
Posts: 13665
Joined: Tue Feb 17, 2009 9:16 pm
Location: Brussels
Contact:

Re: wiki theme

Post by yorik »

Okay, I think it is more or less ready, outside small adjustments.
http://sourceforge.net/userapps/mediawi ... _Main_Page
If anyone has ideas, comments, things he doesn't like or that don't work well, please say!
Cheers
Yorik
User avatar
jriegel
Founder
Posts: 3369
Joined: Sun Feb 15, 2009 5:29 pm
Location: Ulm, Germany
Contact:

Re: wiki theme

Post by jriegel »

Wow, its just great!

Go ahead and put it on the website!

Do you need us to move some files? You have to tell me how to access the
templating of the Wiki. Did'nt know that kind of customizing is possible on
the sf wiki hosting....
Stop whining - start coding!
User avatar
yorik
Founder
Posts: 13665
Joined: Tue Feb 17, 2009 9:16 pm
Location: Brussels
Contact:

Re: wiki theme

Post by yorik »

Ok! Now I need to rush to finish a project until friday, but this WE I put it all online.
No need to move anything, everything is done from inside the wiki,
simply by modifying these 2 files:
http://sourceforge.net/apps/mediawiki/f ... Common.css
http://sourceforge.net/apps/mediawiki/f ... :Common.js
Those 2 files are protected by default, you will need to allow me to edit them.

From there you can do (almost) as much as if you had access to the php files.
The only thing I wanted to do and I couldn't, was to access external rss feeds,
We could have made the homepage very dynamic... But with javascript only,
no way. But, I'm still searching for something better...
User avatar
yorik
Founder
Posts: 13665
Joined: Tue Feb 17, 2009 9:16 pm
Location: Brussels
Contact:

Re: wiki theme

Post by yorik »

Ok the new theme is on air now!
If any of you sees problems (things that are not legible, or wrong alignments, etc...) tell me please.
Yorik
User avatar
jriegel
Founder
Posts: 3369
Joined: Sun Feb 15, 2009 5:29 pm
Location: Ulm, Germany
Contact:

Re: wiki theme

Post by jriegel »

Its really great! Congratulation Yorik!!

Saw no problem so far.
Stop whining - start coding!
wmayer
Founder
Posts: 20324
Joined: Thu Feb 19, 2009 10:32 am
Contact:

Re: wiki theme

Post by wmayer »

Wow! Excellent job!

I have noticed only a very little nuisance with the link to "Forum" (on the left side). When you click on it you'll come to: viewforum.php but it should be: forum.php (the difference is the viewforum.php at the end of the url).

I tried to change it myself but couldn't find where to do it as it's not inside the edit of the Main page.
midgetfc
Posts: 60
Joined: Fri May 15, 2009 2:50 pm

Re: wiki theme

Post by midgetfc »

Hello,
and congratulations!
The left column of the main page doesn't displays correctly in Epiphany (gnome default browser).
Capture.jpg
Capture.jpg (25.32 KiB) Viewed 3801 times
It's OK in Firefox/Iceweasel.
Cheers
Midgetfc
User avatar
yorik
Founder
Posts: 13665
Joined: Tue Feb 17, 2009 9:16 pm
Location: Brussels
Contact:

Re: wiki theme

Post by yorik »

Thanks for the comments guys

I fixed the forum link (Werner it is inside MediaWiki:Sidebar)
I also have the same display problem as you midget, in both epiphany and midori (both based on webkit... curiously, in google chrome, also webkit, it runs fine?)
Still couldn't find how to solve but I will. [EDIT] solved now...

I was thinking about doing this, what do you guys think:
instead of having the navigation menu, at the bottom of the doc pages, have one simple line, with "previous page" and "next page"... This would help us organize the whole doc like a book (like typical open-source docs)... And maybe it would be easier for people to navigate? Of course we would still have an "index" for offline doc generation... (I'm looking at how to produce a pdf, actually it's not too complicated, I think I can modify a bit the wiki to qhelp script to allow pdf output too... could be handy...
Post Reply