VectorLinux

Cooking up the Treats => General Development => Topic started by: Masta on August 28, 2007, 09:41:14 pm

Title: VectorLinux WIKI
Post by: Masta on August 28, 2007, 09:41:14 pm
A new VL-WIKI is up!
 The Team is looking for some dedicated volunteers to help maintain the new wiki. If you've been wanting to get more involved with VectorLinux, then this may be an opportunity for you to do just that.  8)
Title: Re: VectorLinux WIKI
Post by: vector on August 28, 2007, 09:45:32 pm
heres the url http://vectorlinux.com/wiki
anyone can contribute but we need some administrative volunteers............please

vec
Title: Re: VectorLinux WIKI
Post by: Xeon on August 29, 2007, 07:25:26 am
I can be volunteer :> Depends on what i got to do.
Title: Re: VectorLinux WIKI
Post by: kidd on August 29, 2007, 07:50:31 am
Great news!
Wikis are great to have updated info provided comunity is active enough.

I'll contribute for sure, but not  sure about compromising in administration matters.

IMO we should move (or copy) the howtos from our forum to the wiki.

For ideas about contributions, we could look archlinux and/or gentoo wiki.

Possible sections

     
Howto section should have subsections (desktop/server oriented....).  Arch wiki has the order inverted, so people first look for desktop/server, and inside the "subsection", you can find howtos, scripts to do cool things, tips....

Just my 2 cents

Title: Re: VectorLinux WIKI
Post by: M0E-lnx on August 29, 2007, 08:22:00 am
If I may say so, vvucic is good with this kind of stuff...
/me screams out vvucic ....... where are you???
Title: Re: VectorLinux WIKI
Post by: vvucic on August 29, 2007, 09:34:43 am
Hello,

I am here.  I am willing to join you.  What I am supposed to do?

regards,

veki


Title: Re: VectorLinux WIKI
Post by: blurymind on August 29, 2007, 09:38:09 am
i can write a few howtos myself  =) (submit graphic files, get this or this to work,etc)
Title: Re: VectorLinux WIKI
Post by: M0E-lnx on August 29, 2007, 09:57:26 am
How about an "How to install" section in the wiki?
Covering everything from a simple CD ISO install to a more complex Direct ISO install and maybe even a pendrive install.

I guess simple things like installing software...
Adding repositories to gslapt

things like that would make a good start ;)
Title: Re: VectorLinux WIKI
Post by: vvucic on August 29, 2007, 10:38:33 am
hello,


I have on my site some manuals for free software that is part of one international project (http://www.selfproject.eu)

Those manuals are on
http://www.gnulinuxcentar.org/atutor

Please feel free to register browse courses and and share the content.

best wishes,

veki
Title: Re: VectorLinux WIKI
Post by: rbistolfi on August 29, 2007, 02:20:07 pm
This is good, you can count with me, of course.
Title: Re: VectorLinux WIKI
Post by: uelsk8s on August 29, 2007, 02:31:40 pm
We need someone to say "I have the time and Would like to be the Administrator".
If this is you please speak up.
Until that time i wouldnt edit the wiki too much

Thanks,
Uelsk8s
Title: Re: VectorLinux WIKI
Post by: metvas on August 29, 2007, 02:38:08 pm
Hello:
Are we re-creating the wheel??
Wiki for FAQ and Howto's are in existance already.
https://vector.ecosq.com/ic/FAQs (https://vector.ecosq.com/ic/FAQs)
and
https://vector.ecosq.com/ic/HowTos (https://vector.ecosq.com/ic/HowTos)

Regards
Darrell
Title: Re: VectorLinux WIKI
Post by: M0E-lnx on August 29, 2007, 04:07:57 pm
by looking at the https at the beginning of those links i assume they are available to those who buy a copy of the distro. Althoug it may be a good idea to simply link to those in case they are in fact available to the general public.
Title: Re: VectorLinux WIKI
Post by: metvas on August 29, 2007, 05:15:32 pm
They are "Public", as in free for anyone to view. Should anyone "CHOOSE" to purchase a subscription, they would become pre-paid help subscribers. No other cost obligations are attached to there use. I posted the final structure in the lounge today under the "pre-paid help" topic
As it is there completly set up with complete instructions on how to post, seems we are duplicating work when we are people resource hungry now.

Regards
Darrell
Title: Re: VectorLinux WIKI
Post by: Toe on August 29, 2007, 06:29:09 pm
Good to see!  I currently admin a wiki for another software project, also running on Dokuwiki.  I'd volunteer to help out, but I'm already pretty overloaded with my current one. ;)  Still, I could probably give some pointers on it, if needed.
Title: Re: VectorLinux WIKI
Post by: Xeon on August 30, 2007, 08:49:07 am
ok, so I have been put on this case, lets make it brilliant. I am waiting for some more instructions of vec, and I hope to go into the action somewhere tomorrow.

In meanwhile, I also set up a sandbox page on my home httpd. I dislike playgrounds on the wiki's themselves, so thats why I like experimenting somewhere else. I have been busy with the syntax today. http://turkey.fvdh.net/wiki
Title: Re: VectorLinux WIKI
Post by: rbistolfi on August 30, 2007, 09:01:39 am
We need someone to say "I have the time and Would like to be the Administrator".
If this is you please speak up.
Until that time i wouldnt edit the wiki too much

Thanks,
Uelsk8s

I think I have the time, but I am not sure because I never did something like wiki admin and I dont know what needs to be done. As I said before, I have not experience on distro development tasks, but I am good to learn and I am here for this task or others if some one is there to teach or guide or point to the proper knowledge source. I can learn by myself, since I spend a lot of time with books, but there is a lot -I mean a big lot- of documents there and I dont know where to start.
Title: Re: VectorLinux WIKI
Post by: blurymind on August 30, 2007, 09:17:57 am
I have registered,but either i dont have the permission to,or i dont know how to start a wiki (not edit an old one) ::)
so ...whats up with that?
Title: Re: VectorLinux WIKI
Post by: Xeon on August 30, 2007, 09:37:13 am
blury:
http://wiki.splitbrain.org/wiki:pagename

Though, I am going to wait editing until i got some more info
Title: Re: VectorLinux WIKI
Post by: blurymind on August 30, 2007, 10:52:58 am
i will too,just curious ;D
Title: Re: VectorLinux WIKI
Post by: metvas on August 30, 2007, 10:28:58 pm
Hey ALL:
Just got a flash sitting here. For the VL wiki is it moin moin? The one at SQI is moin moin, to make a suggestion if it is not moin moin why not make it one. At least the syntax would all be the same !!! If your going to learn wiki markup may as well just learn one. Thought it was a good idea as VL's is not populate yet. If a change is in order may as well be now.
http://moinmaster.wikiwikiweb.de/MoinMoin/InstallDocs (http://moinmaster.wikiwikiweb.de/MoinMoin/InstallDocs)

Something to consider anyway.
regards
Darrell
Title: Re: VectorLinux WIKI
Post by: Xeon on August 31, 2007, 01:36:01 am
Ok, I got my info, I am now working myself into the first howto article as a test.

edit: I am done with easuters howto.
Give some feedback on the way I translated the forum layout into a wiki page.
Title: Re: VectorLinux WIKI
Post by: vector on August 31, 2007, 06:46:32 pm
Xeon........very nice indeed. Thank you!!!..........................:)

vec
Title: Re: VectorLinux WIKI
Post by: Masta on August 31, 2007, 08:14:05 pm
Ok, I got my info, I am now working myself into the first howto article as a test.

edit: I am done with easuters howto.
Give some feedback on the way I translated the forum layout into a wiki page.

Looking good so far  8) .. keep up the good work
Title: Re: VectorLinux WIKI
Post by: uelsk8s on August 31, 2007, 08:15:45 pm
Very Nice Xeon, Its looking good.
Title: Re: VectorLinux WIKI
Post by: Masta on August 31, 2007, 08:28:47 pm
I was thinking that a section on "How to Contribute to VL" might be handy. There's people that wish to contribute to VectorLinux, but just don't know how to go about it. This could be a helpful section in the how-to. Stuff like packaging, artwork, scripting/coding, and even monetary contributions could fall into this section.
Title: Re: VectorLinux WIKI
Post by: easuter on September 01, 2007, 03:34:38 am
Xeon thats looking pretty neat ;) Hopefully, all the howtos can be written in the Wiki in future, seeing what happened to the forum a while back.
Once the Wiki is fully up-and-running I'm going to give that howto a bit of a clean-up (so much has changed in the 7 or so months since it was written...).

Quote from: Masta
I was thinking that a section on "How to Contribute to VL" might be handy. There's people that wish to contribute to VectorLinux, but just don't know how to go about it. This could be a helpful section in the how-to. Stuff like packaging, artwork, scripting/coding, and even monetary contributions could fall into this section.

Indeed. At least when VL 6.0 is in the making, a new packaging howto must be made. I don't mind doing this, and by then we should also have come to some kind of agreement on the issue of new packaging standards for VL.
Title: Re: VectorLinux WIKI
Post by: The Headacher on September 01, 2007, 03:59:04 am
Quote
Hopefully, all the howtos can be written in the Wiki in future, seeing what happened to the forum a while back.
Well, one hooligan is enough to break a wiki too. The forum is probably still the safer place, as last times screw up is unlikely to happen again (we learned from it didn't we?).
Title: Re: VectorLinux WIKI
Post by: Xeon on September 01, 2007, 03:04:01 pm
Another huge transition finished. Hanumizzles Kernel compile guide is now part of the wiki.
Tomorrow i'll definately look into some shorter how to's, and fix some parts (permissions etc).
Title: Re: VectorLinux WIKI
Post by: vector on September 01, 2007, 06:36:54 pm
Xeon yet another wonderful translation my god man your great...................:)
Hats off
cheers,
vec
Title: Re: VectorLinux WIKI
Post by: InTheWoods on September 01, 2007, 08:49:27 pm
Finally!!!

For quite a while Vector's home page had a link to a wiki that didn't exist. A month or so ago even that dissappeared. I just tried the wiki and added a how to. I hope I didn't jump in before I was supposed to.

I copied Xeon's author code and I'm wondering should we have some standardized style? Or is the wiki markup sufficient? Perhaps since everything in a wiki is a how to it should be divided up into major sections to mirror the forum:

F.A.Q.s
DOCs
Then every section from "The nuts and bolts"

Eauster's networking how to would go to "Networking and Security" Hanumizzle's kernel compilation guide to "Kernel" etc.

Title: Re: VectorLinux WIKI
Post by: Toe on September 01, 2007, 09:45:56 pm
OK, here's some questions to start off with.

1.  How broad should the scope of this wiki be? 

Being a wiki, it's really gonna go whatever way people make it go.  But the initial structure given to it can go a long way toward determining its course. 

I think it's safe to say that this wiki won't document all things Linux.  But do we only want to document Vector-specific things like VASM, or something broader like the Slackware Handbook (http://www.slackersbible.org/)?  To start off with, I would suggest sticking with the Vector-only stuff, but build up a good link library for how-tos and general Linux docs.

2.  What's the editing policy?

Is it gonna go full anonymous editing access, or require registration?  On the wiki I admin, the home page is locked so that only the admin can edit it, but all other pages allow anonymous editing.

3.  What should the home page contain?

On my wiki, there's 3 main elements to the home page: a bit of intro text for the wiki itself describing its purpose & rules, a screenshot of the software in question (could be a logo instead), and a table of contents.  The table of contents is not a full index of every page in the wiki, rather, it's a set of 6 links in a table that go to topical categories for the rest of the site.  Some possible categories: How-to docs, Troubleshooting, About Vector Linux and this wiki, or External Information Resources.  What categories should be made goes back to the question on scope - the categories you pick will play a big role in determining the direction the wiki takes.  You may not want every category under the sun.


Now for some DokuWiki-specific stuff...

DokuWiki has quite a few plugins (http://wiki.splitbrain.org/wiki%3Aplugins) available for it, and you'll probably want to install at least a couple.

The old wiki had problems with defacement, so this should be planned for ASAP.  DokuWiki does have some good plugins to help combat this.  The first one I would consider is the Bad Behavior (http://wiki.splitbrain.org/plugin:badbehaviour) plugin, which basically analyzes a few things about the agent connecting to the site and determines if they're probably a spambot or not.  There's also the Akismet (http://wiki.splitbrain.org/plugin:akismet) plugin, which sends a copy of the page to a remote server for spam analysis.  Personally, I'm not big on the sending to someone else's server part, though.  Then there's a plugin that implements everybody's favorite web annoyance, a CAPTCHA (http://wiki.splitbrain.org/plugin:captcha).

Since there's already a forum here, you might consider adding the BBCode (http://wiki.splitbrain.org/plugin:bbcode) plugin, so that users can use either standard wiki markup, or the BBCode syntax that's used on forums like this.

Someone mentioned putting in a sandbox for the wiki earlier in the thread.  That's actually built into DokuWiki, it's called the Playground (http://vectorlinux.com/wiki/doku.php?id=playground:playground).  There's also a page documenting wiki syntax (http://vectorlinux.com/wiki/doku.php?id=wiki:syntax).  (If you install the BBCode plugin, that's automatically added to the markup documentation page.)  Both of these are linked on the edit page screen, but it wouldn't hurt to have another link to them elsewhere.

One little thing that I'm surprised isn't built into DokuWiki is a page redirector (http://wiki.splitbrain.org/plugin:page_redirector).  I would definitely consider installing that one.

By the way, I notice you don't have nice URLs turned on.  I'd activate that.  (Let me know if you need help.)

DokuWiki supports namespaces (http://wiki.splitbrain.org/wiki:namespaces), but personally I think it's easier to just use a few good category index pages rather than trying to make everyone use the right namespace.  One thing you might consider using it for, though, is translations.  Basically, you would use something like 'vasm' as the page name for the VASM's documentation in English, and 'es:vasm' for the Spanish version.  If people putting things in the wrong namespace becomes a problem, you'll probably want to install the page move (http://www.isection.co.uk/doku.php) plugin.

Sooner or later I assume you're going to want to do some theme work for the wiki.  DokuWiki's theme system is pretty simplistic, just a header, footer, and a couple CSS files.  If it seems like a lot of work, you're probably going about it the wrong way. ;)

If down the road you want to extend the scope a bit, it's feasible that you could use DokuWiki for the home page of vectorlinux.com or something.  I'd suggest taking a look over the list of plugins and discussing anything interesting in this thread.
Title: Re: VectorLinux WIKI
Post by: Xeon on September 02, 2007, 12:16:17 am
About the scope: I am definitely in for a vector only start. I think this would already use a lot of initial startup work (been some work already :))
Editing policy: Personally I am for registered users only. I never liked the idea of having full access to anyone that wiki's have, but it might be paranoia.
As for the starter page, I think it's what I already have been doing. But since there are so far only how to's, There is only the How To section  :P. Faq's and docs coming. For now I make all how to's in namespace howtos, if this is becoming a load I might make subcategory's (however, how would they look?), the page move plugin might be interesting for that

Plugins: Definitely looking good! Especially the anti defacement onces.
Only: I am anti BB code on this one. The wiki syntax is not that hard, and some markup's require HTML (the by User for example). I am also gonna write a How to make a wiki howto page with my used markup soon.
I tried installing some of your suggestion, but automatic downloading didn't seem to work... I'll need vecs assistance for manual installing.

Theme: I think the theme is nice for now: but one remark. The currently layout leaves a lot of space unused. The how to's look endless because the lines are very small. Is it possible this gets fixed? If you don't have time vec, mail me the theme and I'll mess with it at home until its a bit larger.

Sandbox: I'll state again that I heavily dislike having a place like the playground on the end wiki. It will always appear in the index, and people that just browse the wiki will end in the markup testing.
http://turkey.fvdh.net/wiki
complete sandbox  ;D

edit: and tbh I am happy I fixed the wiki :s, I completely screwed it with those nice urls
Title: Re: VectorLinux WIKI
Post by: Toe on September 02, 2007, 01:47:48 am
Theme: I think the theme is nice for now: but one remark. The currently layout leaves a lot of space unused. The how to's look endless because the lines are very small. Is it possible this gets fixed? If you don't have time vec, mail me the theme and I'll mess with it at home until its a bit larger.
Eh, the current theme is a pretty generic Kubrick clone.  (Kubrick is the standard theme for WordPress.)  But yeah, I would agree that there's a lot of wasted space here.  First question is do you want a fixed-width layout (always the same width no matter what resolution it's viewed at) or fluid (expands with the width of the screen)?  The other problem is that the menu bar on the side takes up a lot of the width.  There's three ways of solving it.  One, you could try making it horizontal across the top/bottom instead of on the side.  That would work for the basic navigation, but would be infeasible for the table of contents boxes.  Two, you could make the sidebar a float, so that the other contents of the page will wrap around the bottom of it instead of just leaving a blank white area.  Or three, you could move it outside the main white column so that the page's content has the whole main column to itself.  Might look a little funny, though.
Title: Re: VectorLinux WIKI
Post by: Xeon on September 02, 2007, 09:57:04 am
How about make the whole page floating in the middle and then putting the width wider then it is now?
We just need less grey background, and more white main space.
Title: Re: VectorLinux WIKI
Post by: GrannyGeek on September 02, 2007, 08:18:33 pm
Hopefully, all the howtos can be written in the Wiki in future, seeing what happened to the forum a while back.

If HowTo's are written in the Wiki, I think we should have a link to them in the forum. It becomes unwieldy if we have to check both the forum an the Wiki to find out how to do something. I think links from the forum to the Wiki would be sufficient.
--GrannyGeek
Title: Re: VectorLinux WIKI
Post by: M0E-lnx on September 04, 2007, 05:28:29 am
errr... shouldn't vpackager be listed under the "how to install software from source" as one of the methods?

vpackager builds the source and upon a successful build, it offers to install it for you... for easy gslapt/slapt-get removal afterwards....

Title: Re: VectorLinux WIKI
Post by: InTheWoods on September 04, 2007, 08:51:53 am
Quote
Personally I am for registered users only
Xeon I added my how to without registering. Better fix that!

Quote
shouldn't vpackager be listed under the "how to install software from source" as one of the methods?

Please feel free to edit "how to install software from source" MOE-inx. That's what wikis are about.

Quote
I think links from the forum to the Wiki would be sufficient
I agree. The wiki becomes your "How To" the main difference is that it should be easier to find what you are looking for. When a problem that gets a lot of attention is solved in the forum a wiki article should be written. The wiki becomes your up to date vector documentation for all users. Ask questions in the forum. Permanently document answers to common and important questions in the wiki.

Of course if you subscribe to this view of wiki use it should be divided into similar sections as the forum for ease of navigation and familiarity.

Title: Re: VectorLinux WIKI
Post by: M0E-lnx on September 04, 2007, 12:33:58 pm
Just added the vpackager section to the wiki under "Installing software from source"

I dont know a whole lot of wiki syntax, so if anyone can make it look better, Please do
Title: Re: VectorLinux WIKI
Post by: Xeon on September 04, 2007, 02:35:05 pm
Quote
Personally I am for registered users only
Xeon I added my how to without registering. Better fix that!

I do nothing without agreement from the other users. For now the wiki is still go ahead and edit.

Though in a first attempt to prevent random articles to pop up, I restricted the acces for the start file.
Title: Re: VectorLinux WIKI
Post by: Masta on September 06, 2007, 08:46:51 pm
Just looked over wiki. Haven't been there since my last comment. I have to say it is looking very nice, Great job, Very great job!!
Title: Re: VectorLinux WIKI
Post by: metvas on September 07, 2007, 09:55:38 am
Hello All:
Yes I agree, the wiki it looks good. A few suggestions here may help before it gets to populated. These are suggestions for the structure only. Before you write.
Ask yourself who is the intended reader?
Is it Novice? Power user? or Sys admin? They all have to be addressed as they all have questions that require answers.
 
If we create with the “depth first”, thinking. The article becomes an elevator article, goes and goes and goes. If you run into this do this, and if you run into this do this etc, etc. other than a sys. Admin. or advanced power users all others will loose interest and give up. If we look at our current forum the vast majority of questions are obviously mainstream novice or slightly higher users.
 I would suggest breaking off the wiki into three groups of articles as noted above, (mainstream novice, power user and sys. Admin.), with the addition of a glossary for reference for those who get lost in the terminology. They can flip over to the glossary find the meaning and go back to the article, clearly understanding, thus preventing them getting lost in terminology and the article. For them it makes all our efforts useless, as they have given up due to the complexity of terminology. In my mind this would make the wiki as slick as our distro. Your thoughts? Suggestions?
Regards
Darrell
Title: Re: VectorLinux WIKI
Post by: InTheWoods on September 07, 2007, 04:33:37 pm
Quote
suggestions for the structure
I agree. We need some kind of structure. I have suggested mirroring the forum. The suggestion of  "mainstream novice, power user and sys. Admin"  categories is  very important to consider. Either divide the wiki into categories as metvas suggests or label articles as novice etc within each category. Pehaps each level of article could have it's own logo or page colour to show the level of user it is targeted at.

Most important is something as opposed to nothing.
“depth first” this is important and should not be overlooked.

"glossary"
 I really like this idea. How about a glossary page with key words in each article linked to the glossary? I would imagine DokuWiki has the ability to link to sections (glossary item) of a page.
Title: Re: VectorLinux WIKI
Post by: rbistolfi on September 07, 2007, 05:23:35 pm
I have seen a plugin in other Dukuwiki installs which allows you to view / translate a wikipage in others languages, could be a nice addition.

EDIT: I got the link:
http://wiki.splitbrain.org/plugin:translation
Title: Re: VectorLinux WIKI
Post by: InTheWoods on September 07, 2007, 09:29:10 pm

I have added a glossary page. At present there is only one link to it from the installing from source code HOW TO just for testing. I suggest not linking to it much until we get some structure finalized. Perhaps it's time for a poll on just what that structure will be.

Title: Re: VectorLinux WIKI
Post by: InTheWoods on September 08, 2007, 09:26:41 pm
metvas
Quote
Wiki for FAQ and Howto's are in existance already.
https://vector.ecosq.com/ic/FAQs
and
https://vector.ecosq.com/ic/HowTos

I was going to copy the FAQ above when I realized what was said. We already have a wiki!!
For some reason this just did not get noticed. If a wiki is called by any other name is it still a wiki?

The doku wiki which this thread is about appears to have the momentum at the moment But as one who didn't get it, to those who put in the effort on the moin moin wiki my sincere apologies for not catching on.
Title: Re: VectorLinux WIKI
Post by: rbistolfi on September 09, 2007, 03:17:03 pm
I guess we have two choices. 1. pick one of the two wikis and eliminate the other, 2. Duplicate the contents of both of them.
Title: Re: VectorLinux WIKI
Post by: Joe1962 on September 23, 2007, 02:52:28 pm
Can we slim down the blue titlebar? It's unnecessarily taking up a lot of space from the contents, forcing to scroll more than necessary.
Title: Re: VectorLinux WIKI
Post by: Xeon on December 11, 2007, 01:58:30 pm
* Heartbeat *
I am still alive, I am going to continue my work on this asap.
Title: Re: VectorLinux WIKI
Post by: M0E-lnx on December 11, 2007, 02:02:37 pm
Wow.... He's alive!
Title: Re: VectorLinux WIKI
Post by: StrayBit on January 19, 2013, 11:02:05 am
I followed the link given in Vector's comment (the first reply) and was re-routed.  Should I trust it?
(http://file:///home/bruce/screen.png)
Bruce
PS:  I tried to insert an image of my attempt.   From the Wiki & Howtos button on VectorLinux.com:  "The link address is: https://vector.ecosq.com/ic/HowTos" and I got a pop-up saying "This Connection is Untrusted"
Title: Re: VectorLinux WIKI
Post by: bigpaws on January 19, 2013, 01:22:53 pm
It is the right site.

The cert expired.

Bigpaws
Title: Re: VectorLinux WIKI
Post by: StrayBit on January 24, 2013, 04:48:17 pm
Thanks.  That is an awesome site.