This forum has been archived. All content is frozen. Please use KDE Discuss instead.

Userbase Editing course 1

Tags: None
(comma "," separated)
User avatar
annew
Manager
Posts
1155
Karma
11
OS

Re: Userbase Editing course 1

Wed Jan 13, 2010 6:39 pm
fpuelz wrote:There's also documentation for Qt Designer 4.6, the link should be updated.


Can you take care of updating that, please?


annew, proud to be a member of KDE forums since 2008-Oct and a KDE user since 2002.
Join us on http://userbase.kde.org
fpuelz
Alumni
Posts
10
Karma
0
OS

Re: Userbase Editing course 1

Wed Jan 13, 2010 7:16 pm
annew wrote:Can you take care of updating that, please?


I've noticed that the link I tried was only wrong in the german page. But there were more wrong links in both the german and the english page. The german one also had links to different Qt versions. All fixed now (always to the latest Qt version) :)
User avatar
annew
Manager
Posts
1155
Karma
11
OS

Re: Userbase Editing course 1

Wed Jan 13, 2010 7:34 pm
fpuelz wrote:Maybe I should change the database to SQLite, maybe as alternative. But the most stuff of setting up MySQL is done automatically (create a krosswordpuzzle user, create the database and the tables), the user just needs to know the root MySQL password (which is blank by default). So setting up MySQL here only means installing it with the package manager and changing the root password for security reasons (or just leave it). But a page explaining this could be useful.


If it's that easy, I wouldn't change it. 'If it's not broken, don't fix it' :-)

Also for amarok, they use a method, where the user needs to create the database and user manually and grant privileges to the newly created user (but they use SQLite by default).
So, yes, I think, such a page would be useful. I don't know a good existing page for that, but we could google one :)


Perhaps I should also discuss this with Mamarok, since she will know in detail how it works for Amarok.

Splitting up the KrossWordPuzzle page is a great idea. There's some more text to come..


Yes, I see it's growing fast :-) You can decide on page splits when you feel you have sorted all you want to say.

I've changed the size of the other inline images, looks much better now :)


I can give you guidelines, but you always have to make the final decision based on the aesthetic effect on your page.

I found something in Toolbox, which adds a line saying "Support for this application can be found from the project's home page". But I don't know where the default place to put the project's home page url is. That would be the kde-apps.org page as I have no other page for it.


I don't think that's a problem. Users can contact you from there, can't they, if they need help? Also, of course, you will be aware if they are asking questions on the KrossWordPuzzle discussion page, or on the forum - don't forget to mark them for following. Just put the link to the home page at the end of your page, then add the <nowiki>{{Community-app-footnote}}</nowiki>


annew, proud to be a member of KDE forums since 2008-Oct and a KDE user since 2002.
Join us on http://userbase.kde.org
User avatar
annew
Manager
Posts
1155
Karma
11
OS

Re: Userbase Editing course 1

Wed Jan 13, 2010 8:03 pm
fpuelz wrote:
annew wrote:Can you take care of updating that, please?


I've noticed that the link I tried was only wrong in the german page. But there were more wrong links in both the german and the english page. The german one also had links to different Qt versions. All fixed now (always to the latest Qt version) :)


Thanks for that


annew, proud to be a member of KDE forums since 2008-Oct and a KDE user since 2002.
Join us on http://userbase.kde.org
User avatar
BelaLugosi
Alumni
Posts
69
Karma
0
OS

Re: Userbase Editing course 1

Wed Jan 13, 2010 9:06 pm
annew wrote:
BelaLugosi wrote:Ok, here we go --> Preview KUser

It's not finished yet, but it is time for me to go to bed... ;)


Going on very nicely :-) Some minor comments -

The introductory table - please use text-align="center", for consistency with other pages. Experiment with width of the table to get better balance of text lines -probably 75-80% width would work. Tables that use icons rather than screenshots need this kind of compromise. I'd also suggest adding one or two colons in front of the table, to balance it on the page. However, all this is subjective, so use your discretion.

Under LDAP - change lokal to local :-)

When you've finished, change your info panel to explain about clickable images - many people won't know about them, and your images will benefit.

That's it, really. Well done!


As i was struggling with some things, i called for help in the irc-channel (#kde-forum). Here a small summary of hints i got there:

* If you are using a icon for the introduction (instead of a screenshot thumb), center it using
Code: Select all
::{|style="text-align:center" width="75%"
|[[Image:image_name.png|128px|center]]|| '''indtroduction text'''
|}


* When using (a lot of) screenshot thumbnails, it can be useful to add a hint at the beginning, that these are clickable to show the full-size image.
Code: Select all
{{info|'''Images are clickable, wich displays the full-size image. You have to use the back-button of you browser to return.'''}}

This information box isn't really beautiful, but as it is "hardcoded", there is no really good alternative to that (a "Tip" or a "Note" is to modest).

@annew
I think, i'm done with it. Would you please have another look at it? Thanks.


i don't have hard drives. i just keep 30 chinese teenagers in my basement and force them to memorize numbers (bash.org)
User avatar
annew
Manager
Posts
1155
Karma
11
OS

Re: Userbase Editing course 1

Thu Jan 14, 2010 9:36 am
BelaLugosi wrote:I think, i'm done with it. Would you please have another look at it? Thanks.


The only thing I'd change, is that I'd use the Tip icon, rather than a section heading, where you mention that defaults are usually fine. Did you have a reason for preferring to do it this way?

Otherwise, yes. Go to the Applications/System page, click on the red-link, and paste your work there. As always, play safe. Copy rather than cut, until you are sure that everything is as you want it. Thanks, and well done :-)


annew, proud to be a member of KDE forums since 2008-Oct and a KDE user since 2002.
Join us on http://userbase.kde.org
User avatar
BelaLugosi
Alumni
Posts
69
Karma
0
OS

Re: Userbase Editing course 1

Thu Jan 14, 2010 10:55 am
annew wrote:The only thing I'd change, is that I'd use the Tip icon, rather than a section heading, where you mention that defaults are usually fine. Did you have a reason for preferring to do it this way?

I just haven't thought about it, that's all. I changed it to a Tip.

Otherwise, yes. Go to the Applications/System page, click on the red-link, and paste your work there.

Ok, done.

As always, play safe. Copy rather than cut, until you are sure that everything is as you want it.

As i wrote it all in kate, i have a local copy of it. So, nothing can happen.. ;-)

Thanks, and well done :-)

Thank you too, for your help.

P.S.: I will add a german translation too these days.

Greetings,
Steven


i don't have hard drives. i just keep 30 chinese teenagers in my basement and force them to memorize numbers (bash.org)
User avatar
annew
Manager
Posts
1155
Karma
11
OS

Re: Userbase Editing course 1

Thu Jan 14, 2010 11:11 am
BelaLugosi wrote:P.S.: I will add a german translation too these days.


Great stuff! :-) Are you going to do another page?


annew, proud to be a member of KDE forums since 2008-Oct and a KDE user since 2002.
Join us on http://userbase.kde.org
User avatar
BelaLugosi
Alumni
Posts
69
Karma
0
OS

Re: Userbase Editing course 1

Thu Jan 14, 2010 1:06 pm
annew wrote:Are you going to do another page?

Oh yes, i will. But as i haven't used any of the applications, that are left in your list in the openening post, i took a look around and found 'KNemo' still unwritten. As i use that one, i will do a page for that.


i don't have hard drives. i just keep 30 chinese teenagers in my basement and force them to memorize numbers (bash.org)
fpuelz
Alumni
Posts
10
Karma
0
OS

Re: Userbase Editing course 1

Thu Jan 14, 2010 4:01 pm
I think it's time to split my KrossWordPuzzle page. It's currently a lot of scrolling and searching while editing ;)

Will the table of contents also work automatically with multiple pages? Or do I need to add something to the base page? And can I have parts of the index in the other pages? Or: What's the standard way of doing this?
User avatar
annew
Manager
Posts
1155
Karma
11
OS

Re: Userbase Editing course 1

Thu Jan 14, 2010 4:15 pm
fpuelz wrote:I think it's time to split my KrossWordPuzzle page. It's currently a lot of scrolling and searching while editing ;)


OK - do you want to do it there, on your user page, or do you want to move into the long-term pages?

Will the table of contents also work automatically with multiple pages? Or do I need to add something to the base page? And can I have parts of the index in the other pages? Or: What's the standard way of doing this?


Up to now we've not had a ToC that spans pages, but I suspect it might be possible, and I'll look into that for you. While you're waiting for that we can just use the 'standard' in userbase terms, of creating a series of page links at the bottom of your page. Once I've found you a solution for the all-in-one ToC we can decide whether you still want those there - they may still be useful.


annew, proud to be a member of KDE forums since 2008-Oct and a KDE user since 2002.
Join us on http://userbase.kde.org
User avatar
MTGap
Alumni
Posts
45
Karma
0
OS

Re: Userbase Editing course 1

Thu Jan 14, 2010 10:09 pm
Sorry haven't been able to work on it, my time is basically committed to one single thing. I might possibly be able to work on the page this weekend.
fpuelz
Alumni
Posts
10
Karma
0
OS

Re: Userbase Editing course 1

Fri Jan 15, 2010 1:34 am
annew wrote:OK - do you want to do it there, on your user page, or do you want to move into the long-term pages?

I will first complete it in my user page. And I think "Board Games" would be the best category to add the page. But all other games link to games.kde.org (there's also a note on top). What should I do?

Up to now we've not had a ToC that spans pages, but I suspect it might be possible, and I'll look into that for you. While you're waiting for that we can just use the 'standard' in userbase terms, of creating a series of page links at the bottom of your page. Once I've found you a solution for the all-in-one ToC we can decide whether you still want those there - they may still be useful.

Great, thanks! I have now added links to sub chapters in info boxes with ToC entries in the base page. It's nice, but an all-in-one ToC would be even nicer :)

I have another question: Is it possible to add a hide/show link to hide sub-bullets. I could use that for the feature list. Just like the link to hide/show the ToC. But that's not too important.
User avatar
annew
Manager
Posts
1155
Karma
11
OS

Re: Userbase Editing course 1

Fri Jan 15, 2010 4:19 pm
fpuelz wrote:
annew wrote:OK - do you want to do it there, on your user page, or do you want to move into the long-term pages?

I will first complete it in my user page. And I think "Board Games" would be the best category to add the page. But all other games link to games.kde.org (there's also a note on top). What should I do?


For a start, I think I should remove that notice. While most of the games currently listed are from the core games package, they re not all, and I hope even more games will join the list.

For the moment, please just use Games for the category. I have no control over those external pages, so we could end up with the category pages listing just one or two applications, if we sub-categorize. We can split them later when we have enough.

Up to now we've not had a ToC that spans pages, but I suspect it might be possible, and I'll look into that for you. While you're waiting for that we can just use the 'standard' in userbase terms, of creating a series of page links at the bottom of your page. Once I've found you a solution for the all-in-one ToC we can decide whether you still want those there - they may still be useful.

Great, thanks! I have now added links to sub chapters in info boxes with ToC entries in the base page. It's nice, but an all-in-one ToC would be even nicer :)


That's fine for now. We can refine it when we have decded what will look best.

I have another question: Is it possible to add a hide/show link to hide sub-bullets. I could use that for the feature list. Just like the link to hide/show the ToC. But that's not too important.


Again, it's something I haven't done or even tried to do, but I'll certainly look into it. Are you thinking of something like expanding directories - something clickable that will show lower levels?


annew, proud to be a member of KDE forums since 2008-Oct and a KDE user since 2002.
Join us on http://userbase.kde.org
User avatar
annew
Manager
Posts
1155
Karma
11
OS

Re: Userbase Editing course 1

Sat Jan 16, 2010 1:58 pm
I've given a lot of thought to the problem of those sub-pages. My query on the Mediawiki list brought two responses:
There's no way to do it. At least not in core. This has been also requested in the past, feel free to open a bug for that.
and
Well, if such pages are all subpages of the first one, probably this can be done by a template that use the __TOC___ statement for the main page and a Dynamic Page List extension to obtain the subpages toc.. difficult to do but not impossible


I have looked, before, at the Dynamic Page List extension and found it difficult to understand. Also, from our sandbox experiments we have become aware that it's very easy for extensions to clash, so I'd be reluctant to add more extensions without both proof that it is helpful and also time to thoroughly test it. I'm inclined to rule this out, at least for the present.

So, I started looking at alternatives using standard mediawiki markup.

You could leave your headings (Using KrossWordPuzzle) followed by text links such as
Code: Select all
::[[http://userbase.kde.org/User:Fpuelz/Using_KrossWordPuzzle#Printing|Print your puzzles]]


but only the headings will appear in your ToC.

Another way is to make them all headings, such as:

Code: Select all
===Your Library===
====[[User:Fpuelz/Using_KrossWordPuzzle#Library|Download]] or Import puzzles====
====[[User:Fpuelz/Using_KrossWordPuzzle#Exporting_Crosswords|Create]] and Export puzzles====
====[[User:Fpuelz/Using_KrossWordPuzzle#Exporting_Crosswords|Export]] your puzzles====
===[[User:Fpuelz/Using_KrossWordPuzzle#Printing|Printing]] a puzzle===


This puts all the headings into the ToC, but the headings within the body don't look too nice. Also, the ToC entries take you to the right page, but not the section (looks like a mediawiki bug) although the links in the body section headings do work correctly.

That's about all I can come up with at the moment


annew, proud to be a member of KDE forums since 2008-Oct and a KDE user since 2002.
Join us on http://userbase.kde.org


Bookmarks



Who is online

Registered users: Bing [Bot], Google [Bot], kesang, Sogou [Bot], Yahoo [Bot]