Puppy Linux Discussion Forum Forum Index Puppy Linux Discussion Forum
Puppy HOME page : puppylinux.com
"THE" alternative forum : puppylinux.info
 
 FAQFAQ   SearchSearch   MemberlistMemberlist   UsergroupsUsergroups   RegisterRegister 
 ProfileProfile   Log in to check your private messagesLog in to check your private messages   Log inLog in 

The time now is Wed 20 Aug 2014, 09:01
All times are UTC - 4
 Forum index » Advanced Topics » Puppy Projects
Puppy Website: WIKI Migration
Moderators: Flash, JohnMurga
Post_new_topic   Reply_to_topic View_previous_topic :: View_next_topic
Page 1 of 3 Posts_count   Goto page: 1, 2, 3 Next
Author Message
tombh


Joined: 12 Jan 2007
Posts: 422
Location: Bristol, UK

PostPosted: Wed 02 Apr 2008, 08:39    Post_subject:  Puppy Website: WIKI Migration
Sub_title: Where should what go? What should be discarded, marked for updating etc
 

I'm not going to be doing this in the immediate short-term, I'd like to get the bulk of the rest of the website done first. But it's worth thinking about and discussing for now.

Here are the categories/sections in the current WIKI:
CategoryApplication
CategoryDevelopment
CategoryHardware
CategoryHowto
CategoryDocumentation
CategoryCommunity
CategoryDeletionProposal
CategoryLocalisation
CategoryNews
CategoryDerivative
CategoryReleases
CategoryUsers

Here is how I propose these categories will inhabit the new website:
CategoryApplication
CategoryDevelopment
CategoryHardware
CategoryHowto

would all remain WIKI categories -- see here -- and so will remain editable, revisionable and commentable as per expected with a WIKI. Further categories could be added. There is a free tagging mechanism whereby new categories can be created on the hoof, as it were, and also a interlinking thingamyjig that allows entires to belong to multiple categories.

As for the other categories they can find places in the newly structured website and will still be editable, but because of the extra functionality of Drupal they can also be endowed with stricter access. This might provide a way of encouraging slightly tighter editorship for pages that need it such as the Manual/Documentation.

Therefore CategoryDocumentation will be catered for by the "Manual" section and may possibly be consolidated with it.

CategoryCommunity would be catered for by the new "Community" section.

CategoryDeletionProposal would be catered for by a tagging system -- a simple radio button (along with Update Proposal) on the page's edit form.

CategoryLocalisation would be provided for by the "Puppy Sites" bit under the main navigation bar.

CategoryNews is catered for by the "Latest News" sub section under the "Home" section.

CategoryDerivative will be replaced by "Puplets" under "Downloads".

CategoryReleases
doesn't have a direct relative yet but would probably come under "Downloads" -> "Official Releases"

CategoryUsers Will be replaced and built upon by a number of sections, including user profiles and user blogs.

It is likely that most of these categories can be migrated fairly easily using modules and custom scripts. However there will also be a significant number of pages that may need migrating/categorising by hand.

The current WIKI is quite a beast and I know I haven't looked at every single page, so any feedback would be greatly appreciated.
Back to top
View user's profile Send_private_message Visit_website 
LOF


Joined: 15 Dec 2006
Posts: 115
Location: UK

PostPosted: Wed 02 Apr 2008, 13:27    Post_subject:  

My 2 cents:

-There is a lot of stuff in the Documentation category. I've no idea how much of it is fully covered in the manual or is even something that should be there. This might need to be looked at.

-A MainPage equivalent will still be required and a link to that will be needed on the menu.

-Is archiving news easy under the new system? If not then maybe a transfer of old news from the latest news page to the wiki could work?

-I feel that puplets need to have their own seperate page to which specific data could be added. Again I don't know if the wiki or the puplets page with sub-pages is the best way.
-----

Also as a sort of sidenote, I've slowly started going through the existing wiki in search for pages that are in need of serious editing using the new CategoryEditProposal that I created. Anyone is welcome to help either tagging pages or editing them.

_________________
Cheers,

LOF
Very Happy
Back to top
View user's profile Send_private_message 
HairyWill


Joined: 26 May 2006
Posts: 2949
Location: Southampton, UK

PostPosted: Wed 02 Apr 2008, 15:49    Post_subject:  

LOF wrote:
There is a lot of stuff in the Documentation category. I've no idea how much of it is fully covered in the manual or is even something that should be there. This might need to be looked at.
I agree. There is a fair amount of glossary style and general linux stuff eg http://puppylinux.org/wikka/pget
http://puppylinux.org/wikka/DirectoryStructure
general linux background doesn't really belong in the manual or a howto. Whilst it might be preferable to point at general external resources instead, often these subjects need some specific explanation, for example the top level directory /initrd
LOF wrote:
A MainPage equivalent will still be required and a link to that will be needed on the menu.
Not necessarily, if there are several links in from the rest of the site.
LOF wrote:
Is archiving news easy under the new system? If not then maybe a transfer of old news from the latest news page to the wiki could work?
It is done manually by creating new pages for each month, cutting the content out of the main one and adding the archived months to http://puppylinux.org/wikka/ArchivedNews[/quote]
LOF wrote:
I feel that puplets need to have their own seperate page to which specific data could be added. Again I don't know if the wiki or the puplets page with sub-pages is the best way.
Probably the best way to decide this is considering the possible/desired editors of the information. I wouldn't expect every puplet author to have editorial rights on the general site. Once they have produced a wiki page with a reasonable description an editor should ensure it is linked from the puplets page where only the essential (standard) details are held for the puplet The puplet page is problematic in that if it is organised alphabetically recent versions may be hard to find. If it is organised chronologically then searching for a known version when you don't know the release date may be harder.
LOF wrote:
Also as a sort of sidenote, I've slowly started going through the existing wiki in search for pages that are in need of serious editing using the new CategoryEditProposal that I created. Anyone is welcome to help either tagging pages or editing them.
I've seen that. In the case of pages with content less than 2 sentences and one link I think it would be reasonable to mark them as pending deletion. In fact I might start a page with a list later. The more useless pages we can dump before migration the better. Though I am strongly in favour of keeping anything of reasonable substance.

What should we do with all the puppy1 stuff, people still use it I imagine but it must be confusing for newbies?

_________________
Will
contribute: community website, screenshots, puplets, wiki, rss
Back to top
View user's profile Send_private_message 
tombh


Joined: 12 Jan 2007
Posts: 422
Location: Bristol, UK

PostPosted: Thu 24 Apr 2008, 05:35    Post_subject:  

CategoryDocumentation
Yes it would be good to not have any overlapping content in the site, namely between the Wiki and the Manual. But I guess there will inevitably have to be some repetition because the Manual is kind of 'official' advice and the Wiki is 'personal' advice. But saying that there is certainly some easy consolidation that could be done, for instance there is a whole formatted and structured manual already amongst the current Wiki pages, it would be both confusing and a fragmenting of efforts to have both that and the the official Manual.
HairyWill wrote:
Whilst it might be preferable to point at general external resources instead, often these subjects need some specific explanation, for example the top level directory /initrd

Good point, it'd be good to use external sources where possible, but some aspects are too specific to Puppy and do need their own detailing.
My plan is to give the Wiki it's own button on the top banner like the Downloads and Manual currently enjoy. It will also have a sidebar like the manual with a menu tree to help you browse. I can also put teasers to the latest Wiki entries on the front page.

CategoryNews
The way news items work in the new site, is much like a blog, each item is an object within the database and so is archived, ordered and paginated automatically. This will make it easier to archive in the future. However, it would not be straightforward to copy all the old news archives into the new system. Perhaps it would be best to have a category within the new Wiki called archives where we could keep all that.

Puplets
The way I have set this up on the new site is as a sub-section under the main section "Downloads". So strictly speaking they are not part of the Wiki, though they will be user contributable. At the moment anyone can add a Puplet (or an official release for that matter) but they can then only edit the content which they themselves uploaded. Only privileged admins can edit other peoples content. Again each Puplet is an object in the database, with not just a description field, but name, size, parent, md5sum, creation date and download URL fields. It will be easy to program the viewing page to order the Puplets by any of these fields.

Pages for Deletion Editing
Most of the Wiki will be migrated using a custom script so it will be easy enough to add functions that ignore/delete pages depending on their assigned category and functions to ignore/delete pages that have less then 2 sentences. I reckon if there is an Archive Category in the new Wiki we could keep less relevant stuff in there, maybe the Puppy1 stuff?
Back to top
View user's profile Send_private_message Visit_website 
Lobster
Official Crustacean


Joined: 04 May 2005
Posts: 15117
Location: Paradox Realm

PostPosted: Thu 24 Apr 2008, 06:03    Post_subject:  

Smile Looking good. The manual is there.

Can we all be reporters? PCPuppyOS Final is available . . .
Someone just managed to run Puppy for a 64processor (command line only) etc

Is rss or similar possible from Barrys blog?

Smile

_________________
Puppy WIKI
Back to top
View user's profile Send_private_message Visit_website 
tombh


Joined: 12 Jan 2007
Posts: 422
Location: Bristol, UK

PostPosted: Thu 24 Apr 2008, 07:02    Post_subject:  

Yeah, at the moment anyone who is registered can contribute content (apart from actual main pages themselves), eventually though I think registered users will only be able to submit wiki entries where all other content will require the user to ask for higher privileged role first.

Yeah, that's a great idea about including an RSS feed to Barry's blog, I might even have a look at that today.
Back to top
View user's profile Send_private_message Visit_website 
WhoDo


Joined: 11 Jul 2006
Posts: 4441
Location: Lake Macquarie NSW Australia

PostPosted: Thu 24 Apr 2008, 19:05    Post_subject:  

Lobster wrote:
Can we all be reporters?

If "we" can't, then "you" most certainly can! Tom if you can't feed the news from Barry's blog, and even if you can, I'd suggest that Lobster needs access to the Latest News as Editor-in-Chief. IMHO, 99% of what we find out about new releases, puplets etc comes from Ed. That shouldn't change just because we've move the site and given it a facelift. Agreed?

_________________
Actions speak louder than words ... and they usually work when words don't!
SIP:whodo@proxy01.sipphone.com; whodo@realsip.com
Back to top
View user's profile Send_private_message 
WhoDo


Joined: 11 Jul 2006
Posts: 4441
Location: Lake Macquarie NSW Australia

PostPosted: Thu 24 Apr 2008, 19:06    Post_subject:  

Duplicate. Please delete.
_________________
Actions speak louder than words ... and they usually work when words don't!
SIP:whodo@proxy01.sipphone.com; whodo@realsip.com
Back to top
View user's profile Send_private_message 
raffy

Joined: 25 May 2005
Posts: 4762
Location: Manila

PostPosted: Thu 24 Apr 2008, 19:57    Post_subject: redirect plan  

(Just a note about the redirect after puppylinux.org is pointed to the new host.) When puppylinux.org is pointed to Hostgator (new host), the link to the current wikka will be: http://pupweb.org/wikka and a permanent redirect of old wikka links will be placed at puppylinux.org.
_________________
Puppy user since Oct 2004. Want FreeOffice? Get the sfs (English only).
Back to top
View user's profile Send_private_message 
Lobster
Official Crustacean


Joined: 04 May 2005
Posts: 15117
Location: Paradox Realm

PostPosted: Thu 24 Apr 2008, 23:16    Post_subject:  

WhoDo wrote:
If "we" can't, then "you" most certainly can! Tom if you can't feed the news from Barry's blog, and even if you can, I'd suggest that Lobster needs access to the Latest News as Editor-in-Chief. IMHO, 99% of what we find out about new releases, puplets etc comes from Ed. That shouldn't change just because we've move the site and given it a facelift. Agreed?


I need help (but enough of my personal life) Rolling Eyes
The news used to be daily but that is quite a pace
I started it to familiarise myself with Puppy World
http://puppylinux.org/wikka/LatestNews

It means going through the forums
each day and reporting any important bits (your choice)

A great way of learning and contributing Cool

The Additional Software (PUPs, n' stuff) section in
this forum are all newsworthy items
- not sure if rss is possible?

Another thing to consider is the HowTo section in this forum
Excellent posts like this deserve to be on the new site . . .
http://www.murga-linux.com/puppy/viewtopic.php?p=192635#192635

_________________
Puppy WIKI

Edited_time_total
Back to top
View user's profile Send_private_message Visit_website 
tombh


Joined: 12 Jan 2007
Posts: 422
Location: Bristol, UK

PostPosted: Fri 25 Apr 2008, 14:54    Post_subject:  

@Whodo:
Quote:
I'd suggest that Lobster needs access to the Latest News as Editor-in-Chief

How do you mean exactly? Currently all registered users can add news items and Lobster is an admin and can edit absolutely anything he wants on the whole site.

@Lobster: I've just been mastering HTML parsing and custom RSS syndication today, which basically means I can RSS-ify anything. Darrelljon had made some feeds for certain forums here but they frustratingly had the sticky threads always at the top, but I've figured out how to remove them now. In fact I should even be able to RSS-ify the "View topics since last visit".

I'd never thought of taking some of the many excellent forum posts and making them a part of the website/wiki. It's a good idea because there are quite a few. But wow that is a particularly clear and concisive post on CPU management!

_________________
Colour-Memories Database
Back to top
View user's profile Send_private_message Visit_website 
darrelljon


Joined: 08 Apr 2007
Posts: 548

PostPosted: Fri 25 Apr 2008, 19:05    Post_subject:  

The sticky threads can be hidden with a bit of tweaking of the RSS generator I used, but someone else will have to do it. Otherwise might aswell just wait for the new site with new RSS feeds. I've noticed the old RSS feeds unavailable sometimes, I don't know if they're a drain on the bandwidth of the forums.
Back to top
View user's profile Send_private_message Visit_website 
tombh


Joined: 12 Jan 2007
Posts: 422
Location: Bristol, UK

PostPosted: Sat 26 Apr 2008, 10:42    Post_subject:  

I've just posted all the new RSS links on my blog.
_________________
Colour-Memories Database
Back to top
View user's profile Send_private_message Visit_website 
prit1


Joined: 03 Jan 2008
Posts: 540
Location: Los Angeles

PostPosted: Sat 26 Apr 2008, 19:41    Post_subject:  

@Tom: Great job. This will be very useful. I can add them to my RSS parser and get the updates from there. Cool one. Smile Thanks a lot.
Back to top
View user's profile Send_private_message 
tombh


Joined: 12 Jan 2007
Posts: 422
Location: Bristol, UK

PostPosted: Wed 30 Apr 2008, 19:31    Post_subject:  

Okay, I've managed to migrate the entire wikka wikki into Drupal -- see here. I've followed the roadmap set out in the first post of this thread.

There are a few things i want to mention, but I'm not sure if I'll remember them all right now, but I'll give it a go;

*This is now an opportunity to reorganise the wiki; new categories, delete entries, move entries etc.

*Apart from the following categories,
CategoryApplication,
CategoryDevelopment,
CategoryHardware,
CategoryHowto,
I have put everything else under the Archives category.

*Under each of Drupal's menus there are further categories, such as basic, advanced, general, these are not set in stone, they're just suggestions for what is possible. We should discuss the best categories to use for each section.

*Entries can belong to multiple sections and categories.

*Does anyone have time/enthusiasm to help move/sort/reorganise?

*Has the data migrated well? Missing pages, chunks of text, poorly rendered characters, etc?

_________________
Colour-Memories Database
Back to top
View user's profile Send_private_message Visit_website 
Display_posts:   Sort by:   
Page 1 of 3 Posts_count   Goto page: 1, 2, 3 Next
Post_new_topic   Reply_to_topic View_previous_topic :: View_next_topic
 Forum index » Advanced Topics » Puppy Projects
Jump to:  

Rules_post_cannot
Rules_reply_cannot
Rules_edit_cannot
Rules_delete_cannot
Rules_vote_cannot
You cannot attach files in this forum
You can download files in this forum


Powered by phpBB © 2001, 2005 phpBB Group
[ Time: 0.1063s ][ Queries: 11 (0.0044s) ][ GZIP on ]