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 Mon 24 Nov 2014, 14:13
All times are UTC - 4
 Forum index » Taking the Puppy out for a walk » Puppy Power
Puppy Linux Documentation Project (PLDP)
Moderators: Flash, JohnMurga
Post new topic   Reply to topic View previous topic :: View next topic
Page 1 of 2 [25 Posts]   Goto page: 1, 2 Next
Author Message
puppian


Joined: 18 Jul 2005
Posts: 538
Location: PuppyLand

PostPosted: Sat 05 Nov 2005, 10:58    Post subject:  Puppy Linux Documentation Project (PLDP)  

After much discussion,
http://www.murga.org/~puppy/viewtopic.php?t=3210&
http://www.murga.org/~puppy/viewtopic.php?t=3120&
http://www.murga.org/~puppy/viewtopic.php?t=2669&
http://www.murga.org/~puppy/viewtopic.php?t=2912&
http://www.goosee.com/puppy/wikka/PuppyDocumentation

I think it's time for us to get going with our Puppy Linux Documentation Project (PLDP) Smile

Here is the proposed tree (probably incomplete Embarassed):
http://puppylinux.org/docs/pre/?&sitemap

Volunteers please choose which section(s) you would like to oversee. To join the committee please add your name to this page.

I think PLDP should be installed in its own directory (like the ./doc folder above) apart from the main site (test site here) as CMSimple stores all pages in one file and it's not preferable if that file is too big (may get slow). Seperate installations will avoid the risk of messing up the settings, etc, of the main site when editing the docs too.

I suggest setting up the main site at puppylinux.org first. With the documentation committee adding docs to the documentation test site gradually and when it's almost finished, articles can be moved to a directory of puppylinux.org (moving should be easy as everything is in one file which can be downloaded from the setting page). And a link to it can then be put on the main site.

The main site could be overseen by Barry, raffy, Lobster, and maybe other foundation members. More advance topics on the doc site (e.g, Compiling Applications, Kernel and Drivers, etc) would probably need Barry's overseeing as well.

To try editing with CMSimple you can go to this sandbox page (password: pldp)
http://puppylinux.org/docs/pre/?SANDBOX
Click "Normal Mode" and "Edit Mode" to toggle between viewing and editing. Click the buttom "HTML" to toggle between layout mode and html mode. Click the top left floppy button to save a page. Please see the attached pic.
You can also do your editing in editors like Mozilla Composer and NVU and then copy and paste things back to CMSimple (don't use Abiword).

To try other CMS:
http://www.murga.org/~puppy/viewtopic.php?t=3339

Btw I think each foundation members/committee may have a small website with its own layout using the method raffy suggests here (perhaps with large files upload disable to conserve bandwidth).
editorcmsimple.png
 Description   CMSimple WYSIWYG editor
 Filesize   5.87 KB
 Viewed   5565 Time(s)

editorcmsimple.png


_________________
Puppylinux.org - Community home page of Puppy Linux hosted by Barry (creator of Puppy), created and maintained by the Puppy Linux Foundation since 2005

Last edited by puppian on Fri 18 Nov 2005, 06:22; edited 3 times in total
Back to top
View user's profile Send private message Visit poster's website 
klhrevolutionist


Joined: 08 Jun 2005
Posts: 1124

PostPosted: Sat 05 Nov 2005, 15:19    Post subject: yes  

Very good puppian.
I have already taken a step to doing something similar.
Creating How To dotpups. I have only made three so far.
But they are ver detailed. While I told you about this on the other forum,
I have been looking at the how to section of the forum.
The How To needs to be for end-user's, developer's should really
in my opinion have their own section locked, and only avail to developer's to post.

The how to's that I have posted as dotpup's are straight forward,
only lazy people would not understand them.

_________________
Heaven is on the way, until then let's get the truth out!
Back to top
View user's profile Send private message 
raffy

Joined: 25 May 2005
Posts: 4796
Location: Manila

PostPosted: Sun 06 Nov 2005, 02:04    Post subject: Docs at Puppylinux.org ready  

Great work there, Puppian! FYI, i have moved the docs folder to puppylinux.org.

http://puppylinux.org/docs

The docs is driven by CMSimple and maintained by Puppian. Take note of the practice pages that he pointed out:

http://stet-vip.net/puppian/cmsimple

Members who would like to contribute and also keep pages that they developed can begin writing there (in the practice site), or request/use their own (member's) folder at puppylinux.org (or using another, owned site), then just paste the finished HTML page in CMSimple (Puppian will have more to say about the useful procedure here). Another way to draft documents is through the Wiki.

Don't worry about redundancy (identical page in two or more sites), that is part of enhancing reliability. What is important is we keep the docs as updated as possible, with links to related pages (wherever those pages may be).

If you want to check out the feel of member's webpages, it's here.
Back to top
View user's profile Send private message 
puppian


Joined: 18 Jul 2005
Posts: 538
Location: PuppyLand

PostPosted: Sun 06 Nov 2005, 06:32    Post subject:  

raffy wrote:
Great work there, Puppian! FYI, i have moved the docs folder to puppylinux.org.

http://puppylinux.org/docs

Thanks for moving the files from stet-vip.net/puppian/doc to puppylinux.org/docs, raffy.
But no, I think an installation shouldn't be moved like that as things will be broken. When I login now, this is what I see
Quote:
WARNING

* Could not write to log ./cmsimple/log.txt
* Not writeable log /mounted-storage/home7/sub003/sc14300-FRIH/puppylinux/docs/cmsimple/log.txt
* Not writeable configuration /mounted-storage/home7/sub003/sc14300-FRIH/puppylinux/docs/cmsimple/config.php
* Not writeable language /mounted-storage/home7/sub003/sc14300-FRIH/puppylinux/docs/cmsimple/languages/en.php
* Not writeable stylesheet /mounted-storage/home7/sub003/sc14300-FRIH/puppylinux/docs/templates/default/stylesheet.css
........

......etc.

That's probably a file/folder permission problem, but some other paths/settings may have been broken as well. I prefer a fresh installation of CMSimple at puppylinux.org/docs and set it up from scratch. I can't fix the problem above as I don't have true ftp access at puppylinux.org
Raffy wrote in his pm:
Quote:
. . .
The ftp tool you may use for now at puppylinux.org is XXXX.php

puppylinux.org/docs/XXXX.php
. . .

The 'ftp tool' raffy mentioned is actually a webpage for uploading one file each time from the browser. And one can't change file permission (e.g, chmod 755, etc) from there. It would be extremely inconvenient and not enough for someone who's maintaining a website. I don't want to upload one file each time (CMSimple is small in size, but it has LOTS of files, even installing just one template/addon/plugin will need to upload MANY files) and has to send someone a pm just to change the permission of one file/folder.

. . . . .

raffy wrote:
Members who would like to contribute and also keep pages that they developed can begin writing there (in the practice site), or request/use their own (member's) folder at puppylinux.org (or using another, owned site), then just paste the finished HTML page in CMSimple (Puppian will have more to say about the useful procedure here). Another way to draft documents is through the Wiki.

I think we can have around seven to ten documentation committee members each overseeing different section of PLDP, with other contributors submitting content to them (e.g by email, pm, etc) if needed. The documentation committee will have the CMSimple password needed to edit the pages at puppylinux.org/docs. There's no need for them to write the docs in other places first. As they are the experts about the topics they oversee, we can trust them publishing at puppylinux.org/docs. And they won't be able to mess up with the main site at http://puppylinux.org as there will be a seperate CMSimple installation there.

IMO the 'member's webpages' you suggested can be used for the foundation member's own homepage (not for documentation purpose), so that people will know them more. It's not a good idea to host websites for all puppy users as that'll make puppy a 'free hosting service provider'.
Btw, I think wiki is for most update info. with broad interests & various user's input while PLDP is more reliable (as raffy said), organized and finalized.

_________________
Puppylinux.org - Community home page of Puppy Linux hosted by Barry (creator of Puppy), created and maintained by the Puppy Linux Foundation since 2005

Last edited by puppian on Thu 01 Dec 2005, 16:29; edited 3 times in total
Back to top
View user's profile Send private message Visit poster's website 
raffy

Joined: 25 May 2005
Posts: 4796
Location: Manila

PostPosted: Sun 06 Nov 2005, 08:52    Post subject: Permissions  

Looks like a permissions problem, as anticipated. No hurry, though, as we're just preparing the puppylinux.org site. You still have unimpeded access to stet-vip.net, so testing and initial writing can go on, as you suggested.
Quote:
I suggest setting up the main site at puppylinux.org first. With the documentation committee adding docs to the documentation test site gradually and when it's almost finished, articles can be moved to a directory of puppylinux.org (moving should be easy as everything is in one file which can be downloaded from the setting page). And a link to it can then be put at the main site.

The main site could be overseen by Barry, raffy, Lobster and other foundation members. More advance topics on the doc site (e.g, Compiling Applications, Kernel and Drivers, etc) would probably need Barry's overseeing as well.

To try editing with CMSimple you can go to this test page (password: fans)
http://stet-vip.net/puppian/cmsimple/?Test_Page_One


As to "difficult for both of us", I now have root access. If I give you the same access and then make a mistake, you will be taking the blame, too. So be patient for now, we will have an access plan in due time.

As to being webmaster, you are already one - and a prolific one at that Smile We've already gone through CMS identification and are now getting into colors - the details, really. I guess the redirection to puppylinux.org/docs seemed to have jumped the process a bit, but you can remove that easily. Embarassed

Let's stick to your suggestion of starting to write pages and work out the transfer to the site next.

PS - As to your opinions about CMS and members' website - they are all CMS's, ranging from simple to complex, but you are entitled to your own opinion, of course. Just let me clarify that when I use the term "member", I mean "active contributor", not every user.
Back to top
View user's profile Send private message 
puppian


Joined: 18 Jul 2005
Posts: 538
Location: PuppyLand

PostPosted: Mon 07 Nov 2005, 05:30    Post subject: Re: Permissions  

raffy wrote:
As to "difficult for both of us", I now have root access. If I give you the same access and then make a mistake, you will be taking the blame, too.

Thanks for the explanation. Now I understand your concern.

I don't think that's very important however.
We have more than one admininstrator and more than one moderator in this forum. Obviously we're going to have more than one person in our documentation committee too.

When things go wrong, usually people will complain, and the person who has made a mistake will come out and admit it (I think this happened before in this forum too). Sharing of rights/access/responsibilies are needed as long as we want the benefits of team-work.

_________________
Puppylinux.org - Community home page of Puppy Linux hosted by Barry (creator of Puppy), created and maintained by the Puppy Linux Foundation since 2005
Back to top
View user's profile Send private message Visit poster's website 
raffy

Joined: 25 May 2005
Posts: 4796
Location: Manila

PostPosted: Mon 07 Nov 2005, 18:58    Post subject: FTP access  

You just got your FTP account from Barry - congrats! (Or, rather, "best wishes for the challenging work ahead" Wink )
Back to top
View user's profile Send private message 
Flash
Official Dog Handler


Joined: 04 May 2005
Posts: 11157
Location: Arizona USA

PostPosted: Mon 07 Nov 2005, 22:29    Post subject:  

You guys sure you wouldn't like to have a PLDP Usergroup in the forum? Anyone could read but only the group members could post to it.
Back to top
View user's profile Send private message 
puppian


Joined: 18 Jul 2005
Posts: 538
Location: PuppyLand

PostPosted: Tue 08 Nov 2005, 06:19    Post subject: Re: FTP access  

raffy wrote:
You just got your FTP account from Barry

Yes, I received you pm with the ftp login information.
Thank you for your pm to Barry requesting that new FTP user account which allows access to the /docs folder.
Back to top
View user's profile Send private message Visit poster's website 
puppian


Joined: 18 Jul 2005
Posts: 538
Location: PuppyLand

PostPosted: Sat 12 Nov 2005, 08:44    Post subject:  

Flash wrote:
You guys sure you wouldn't like to have a PLDP Usergroup in the forum? Anyone could read but only the group members could post to it.

Yes please Smile I have asked the opinion of the other documentation committee members and they would like to have a discussion place for PLDP (Documentation forum section) so that off topic stuff can be sorted out and we can be focused on the project. Some of them also think we'd better start it now while the structure is being set up as we don't want to start something and have to scrap the time and effort for something else Smile

For people who want to know more here is a link:
http://www.phpbb.com/kb/article.php?article_id=16

_________________
Puppylinux.org - Community home page of Puppy Linux hosted by Barry (creator of Puppy), created and maintained by the Puppy Linux Foundation since 2005
Back to top
View user's profile Send private message Visit poster's website 
puppian


Joined: 18 Jul 2005
Posts: 538
Location: PuppyLand

PostPosted: Sat 12 Nov 2005, 08:55    Post subject:  

Contributors and documentation committee members can now start writing at the preparation site here:

http://puppylinux.org/docs/pre

Anyone can contribute. Just click the Login link (see left pan) to start. Password: pldp

When the documentation is almost finished the whole site will be moved to http://puppylinux.org/docs and be maintained by the documentation committee. To join the committee please add your name to this page.

The whole documentation can be downloaded for offline viewing. Link

_________________
Puppylinux.org - Community home page of Puppy Linux hosted by Barry (creator of Puppy), created and maintained by the Puppy Linux Foundation since 2005

Last edited by puppian on Mon 14 Nov 2005, 13:21; edited 1 time in total
Back to top
View user's profile Send private message Visit poster's website 
puppian


Joined: 18 Jul 2005
Posts: 538
Location: PuppyLand

PostPosted: Mon 14 Nov 2005, 13:07    Post subject:  

Some updates:

J_Rey and Seth have proposed some great modifications to the tree structure and puppylinux.org/docs/pre has been ammended accordingly.

Brad_chuck would be overseeing the "troubleshooting" and "create a custom puppy" sections, J_Rey would be overseeing the "installation" sections and I would be overseeing part of the "getting started" section Smile

_________________
Puppylinux.org - Community home page of Puppy Linux hosted by Barry (creator of Puppy), created and maintained by the Puppy Linux Foundation since 2005
Back to top
View user's profile Send private message Visit poster's website 
puppian


Joined: 18 Jul 2005
Posts: 538
Location: PuppyLand

PostPosted: Fri 18 Nov 2005, 12:05    Post subject:  

Brad_chuck has written some very nice stuff here Cool
http://puppylinux.org/docs/pre/?Troubleshooting_Puppy:Install_Problems

The ability to convert the pages to pdf has been added to http://puppylinux.org/docs/pre. Just click the 'PDF' link on the left (somewhere near the login link) to try it.
Some pages won't convert in Puppy however (but ok in Windows; using Puppy103, probably something to do with puppy's pdf viewer). I can't get the whole docs to convert too...hope it can be solved soon.

_________________
Puppylinux.org - Community home page of Puppy Linux hosted by Barry (creator of Puppy), created and maintained by the Puppy Linux Foundation since 2005
Back to top
View user's profile Send private message Visit poster's website 
Lobster
Official Crustacean


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

PostPosted: Tue 22 Nov 2005, 06:01    Post subject: efforts are very much appreciated  

Cool Great work from the whole team. I am not sure who is doing all the work? It seems Raffy, Jrey and Puppian? The new blog is great. Communication is a key issue. I really am trying to understand what is being done and where . . .

Smile

This will be clearer after the weekend Doc party.
People can now focus on their areas of interest. Please include the flash vids in your documentation

Just really came to encourage those involved. We are moving towards a more egalitarian and sharing Puppy. Please know that everyones times and efforts are very much appreciated. That does not get said enough. I know egos are fragile and text does not communicate sufficient goodwill. Goodwill and Buddhist prayers to you all.

OM YA HA HUM
(translation: Woof! woof!)

_________________
Puppy WIKI
Back to top
View user's profile Send private message Visit poster's website 
puppian


Joined: 18 Jul 2005
Posts: 538
Location: PuppyLand

PostPosted: Mon 05 Dec 2005, 15:55    Post subject:  

Template:

http://www.murga.org/~puppy/viewtopic.php?p=26901

_________________
Puppylinux.org - Community home page of Puppy Linux hosted by Barry (creator of Puppy), created and maintained by the Puppy Linux Foundation since 2005
Back to top
View user's profile Send private message Visit poster's website 
Display posts from previous:   Sort by:   
Page 1 of 2 [25 Posts]   Goto page: 1, 2 Next
Post new topic   Reply to topic View previous topic :: View next topic
 Forum index » Taking the Puppy out for a walk » Puppy Power
Jump to:  

You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum
You cannot attach files in this forum
You can download files in this forum


Powered by phpBB © 2001, 2005 phpBB Group
[ Time: 0.1048s ][ Queries: 13 (0.0045s) ][ GZIP on ]