Wanted: Maintainer of English Puppy Manual

A home for all kinds of Puppy related projects
Message
Author
oli
Posts: 194
Joined: Wed 30 Aug 2006, 09:04
Location: Germany, Frankfurt

Wanted: Maintainer of English Puppy Manual

#1 Post by oli »

I copied my manual from www.puppy-linux.info to the new website at http://www.puppylinux.org/manual . Till now I maintained the German and English version and coordinated the translation into the other languages. The Puppy 4.00 manual is almost ready and will be published soon.

But now it is too much effort for me, so I would like to stay maintainer of the German manual only. That's why I now search for a maintainer of the English manual. Is there somebody out there who is interested in and who has time to be durable a maintainer?

User avatar
puppyluvr
Posts: 3470
Joined: Sun 06 Jan 2008, 23:14
Location: Chickasha Oklahoma
Contact:

#2 Post by puppyluvr »

:D Hello :D

Id be happy to help, but I dont know if I have the skill.. :?
What is required?????
Besides being a Puppy fanatic. :D :D
If it is just maintaining/updating an existing manual, Im sure I could handle it, just dont know
if I could write one from scratch. ( in less than a month or two...LOL)
Close the Windows, and open your eyes, to a whole new world
I am Lead Dog of the
Puppy Linux Users Group on Facebook
Join us!

Puppy since 2.15CE...

User avatar
HairyWill
Posts: 2928
Joined: Fri 26 May 2006, 23:29
Location: Southampton, UK

#3 Post by HairyWill »

Now that the manual is written, it really only requires maintenance from release to release. In wiki format it is possible for it to be edited by many people collaboratively, though it would be good to have one person make the judgment when it was fit for release.
Will
contribute: [url=http://www.puppylinux.org]community website[/url], [url=http://tinyurl.com/6c3nm6]screenshots[/url], [url=http://tinyurl.com/6j2gbz]puplets[/url], [url=http://tinyurl.com/57gykn]wiki[/url], [url=http://tinyurl.com/5dgr83]rss[/url]

User avatar
Lobster
Official Crustacean
Posts: 15522
Joined: Wed 04 May 2005, 06:06
Location: Paradox Realm
Contact:

#4 Post by Lobster »

Id be happy to help, but I dont know if I have the skill..
Skill starts from will (not hairywill - though he might help)
You will learn not only how
but a lot of other skills and a lot more about Puppy
- well that is what happened when I did one of the early manuals
http://tmxxine.com/pm/p1.html

good luck :)
Puppy Raspup 8.2Final 8)
Puppy Links Page http://www.smokey01.com/bruceb/puppy.html :D

User avatar
craftybytes
Posts: 298
Joined: Fri 17 Nov 2006, 10:32
Location: QLD AUSTRALIA

#5 Post by craftybytes »

oli -

As I'm retired (on a pension) and find that I have a reasonable amount of time to sit in front of a computer - AND - as my 'main' OS on my system is now Puppy - AND - as I also speak and write the good olde "Queens" english (even though I am a true blue Aussie) - I"ll put my hand up as a volunteer..

Just let me know what needs to be done - how does one access the manual on the New website - and how to do edits, etc..

Hope this helps..

crafty.
.
.
3 x boot:- ASROCK VIA 'all-in-one' m/b; AMD Duron 1.8Ghz+; 1.0GB RAM; 20GB hdd (WinXP Pro); 80GB hdd (MEPIS 3.4-3/Puppy v2.15CE Frugal); 1GB USB pendrive (Puppy 2.15CE Frugal); CD/DVDRW; 17" LCD monitor; HSF 56k modem... MEPIS is great.. Puppy ROCKS..

oli
Posts: 194
Joined: Wed 30 Aug 2006, 09:04
Location: Germany, Frankfurt

#6 Post by oli »

Hi crafty, hi puppyluvr,
thank you for your offer. I want to describe what you should have to do. First you will find at www.puppylinux.org the English manual. When a new release of Puppy Linux is published (with major changes to the former release) I update the German manual. In the meantime I add sometimes new chapters to the German manual.

I think there are two ways how to maintain the English manual: (a) you update and improve the manual just the way you like or (b) you have a look at the German manual and try to make the same update / improvement in the English manual and use the same screenshots (then it would be good if you are able to read German text or another Puppy user can help you and translate the text).

I don't want to decide who of you is best to maintain the English manual. Perhaps you want to share the chapters. Perhaps "Urban Soul" can help you with the translation (I will send him a link to this post). If you are ready to start please let me know. Then I will inform Tom to give the privilegs to you. Then you will find at www.puppylinux.org a sandbox where you can try to edit the manual first.

Oli

User avatar
craftybytes
Posts: 298
Joined: Fri 17 Nov 2006, 10:32
Location: QLD AUSTRALIA

#7 Post by craftybytes »

Hi oli,

Thanks for the info - don't speak the German language - but I believe that there are several language translation programs available in Linux or even via the WEB - so maybe I can make use of one of those to translate your 'German' updates into 'English' - any translation errors / problems that I can't sort out will be the time I'll ask for assistance via the forums..

If you be happy with this - then I'm ready to go any time you want..

I'll just have to get used to doing editing via the wiki for the manual..

crafty.
.
3 x boot:- ASROCK VIA 'all-in-one' m/b; AMD Duron 1.8Ghz+; 1.0GB RAM; 20GB hdd (WinXP Pro); 80GB hdd (MEPIS 3.4-3/Puppy v2.15CE Frugal); 1GB USB pendrive (Puppy 2.15CE Frugal); CD/DVDRW; 17" LCD monitor; HSF 56k modem... MEPIS is great.. Puppy ROCKS..

User avatar
HairyWill
Posts: 2928
Joined: Fri 26 May 2006, 23:29
Location: Southampton, UK

#8 Post by HairyWill »

The editor for the manual is a wysiwyg module called tinymce. It is very similar to using a word processor, this is the same module as used for the main wiki but with extra features turned on. [mount soapbox] It also has all the bad features of allowing you to edit presentation rather than semantics [unmount soapbox].

I have given Puppyluvr (I hope that that is you) editor and translator status , but I can't find an account called craftybytes. Let me know your account name and I will fix the status.

I'm happy to do some proof reading, if you want.
Will
contribute: [url=http://www.puppylinux.org]community website[/url], [url=http://tinyurl.com/6c3nm6]screenshots[/url], [url=http://tinyurl.com/6j2gbz]puplets[/url], [url=http://tinyurl.com/57gykn]wiki[/url], [url=http://tinyurl.com/5dgr83]rss[/url]

User avatar
craftybytes
Posts: 298
Joined: Fri 17 Nov 2006, 10:32
Location: QLD AUSTRALIA

#9 Post by craftybytes »

HairyWill -

Just a thought - maybe I need to 'register' onto the Community Website & the Wiki - that's probably why you can't find an account as yet.. :oops:

Let me know what I need to do and I'll get to it asap.. :roll:

No - Puppyluvr is another Puppy forum poster..!

With 'tinymce' - does one have to load that locally or does it work via web access.?

Proof reading - if you think it needs it - then OK..

crafty.
.
3 x boot:- ASROCK VIA 'all-in-one' m/b; AMD Duron 1.8Ghz+; 1.0GB RAM; 20GB hdd (WinXP Pro); 80GB hdd (MEPIS 3.4-3/Puppy v2.15CE Frugal); 1GB USB pendrive (Puppy 2.15CE Frugal); CD/DVDRW; 17" LCD monitor; HSF 56k modem... MEPIS is great.. Puppy ROCKS..

User avatar
HairyWill
Posts: 2928
Joined: Fri 26 May 2006, 23:29
Location: Southampton, UK

#10 Post by HairyWill »

@craftybytes
yes register and confirm your account name
tinymce works entirely in the browser
puppyluvr posted earlier in this thread and said that he would like to help too
my forum posts certainly need proof reading ;), basically I'm happy to help, with more hands we can probably increase what is covered
Will
contribute: [url=http://www.puppylinux.org]community website[/url], [url=http://tinyurl.com/6c3nm6]screenshots[/url], [url=http://tinyurl.com/6j2gbz]puplets[/url], [url=http://tinyurl.com/57gykn]wiki[/url], [url=http://tinyurl.com/5dgr83]rss[/url]

User avatar
craftybytes
Posts: 298
Joined: Fri 17 Nov 2006, 10:32
Location: QLD AUSTRALIA

#11 Post by craftybytes »

OK - will get it done by tomorrow.. :cry:

cheers..

crafty.
.
3 x boot:- ASROCK VIA 'all-in-one' m/b; AMD Duron 1.8Ghz+; 1.0GB RAM; 20GB hdd (WinXP Pro); 80GB hdd (MEPIS 3.4-3/Puppy v2.15CE Frugal); 1GB USB pendrive (Puppy 2.15CE Frugal); CD/DVDRW; 17" LCD monitor; HSF 56k modem... MEPIS is great.. Puppy ROCKS..

User avatar
craftybytes
Posts: 298
Joined: Fri 17 Nov 2006, 10:32
Location: QLD AUSTRALIA

#12 Post by craftybytes »

Right - now have a "craftybytes" account on the Community Website.. :P

So let me know what I need to do from now on.. :D

crafty.
.
3 x boot:- ASROCK VIA 'all-in-one' m/b; AMD Duron 1.8Ghz+; 1.0GB RAM; 20GB hdd (WinXP Pro); 80GB hdd (MEPIS 3.4-3/Puppy v2.15CE Frugal); 1GB USB pendrive (Puppy 2.15CE Frugal); CD/DVDRW; 17" LCD monitor; HSF 56k modem... MEPIS is great.. Puppy ROCKS..

User avatar
HairyWill
Posts: 2928
Joined: Fri 26 May 2006, 23:29
Location: Southampton, UK

#13 Post by HairyWill »

OK
craftybytes promoted to editor and translator status
You should now see an edit tab at the top of every manual page.

Editing an existing page is fairly straightforward. One thing I don't understand is how you would add an extra page (or delete) and how the index/menu works. Oli can you any any enlightenment?
Will
contribute: [url=http://www.puppylinux.org]community website[/url], [url=http://tinyurl.com/6c3nm6]screenshots[/url], [url=http://tinyurl.com/6j2gbz]puplets[/url], [url=http://tinyurl.com/57gykn]wiki[/url], [url=http://tinyurl.com/5dgr83]rss[/url]

User avatar
alexthedragon
Posts: 3
Joined: Tue 17 Jun 2008, 09:35
Location: Denmark
Contact:

Reporting for duty

#14 Post by alexthedragon »

I will be happy to help with the English manual and I might even get the time to do a Danish one, though I might need a extra pair of hands for that one.

You really don't need me to tell you that I can speak and write English like a native of the isle. I have also a lot of experience writing articles for wikipedia and other places on the web, including my own blog..

I have just stopped studying because of stress, I was studying to become a teacher of languages, but now I have a lot of free time on my hands and I need something to keep the little grey cells ticking.

Well, I look forward to working with you all. :D

Alex

oli
Posts: 194
Joined: Wed 30 Aug 2006, 09:04
Location: Germany, Frankfurt

#15 Post by oli »

Welcome to the new maintainers.

To add a new page to the manual, click on "Manual" and than (at the left side) on "Add page" (see picture manual1.jpg).

To delete a page, click on "Edit" first. Than you will find a button "Delete" at the end of the page.

Be careful if you add a new page. You must fill in "Title" and "Body". And than you have to enter into "Menüeinstellungen" (I suppose it is called "Menu entry" in the English version). There you have to enter the title again, the menu and the order (see picture manual2.jpg). Don't miss these settings or your page will disturb the whole webpage !!!

If you want to upload an image, click on "enable rich-text" (beyond the body-box). Then click on the camera-symbol and than on the button "Upload" (see pictures manual3.jpg to manual5.jpg).

Please make some exercises at the sandbox first.

The English Puppy 4.0 manual is finishes from chapter "How to get Puppy" to "How to setup an internet connection" (see picture manual9.jpg). The other chapters are finished in the German manual only. Please have a look at the German manual, I edited and added some pages and screenshots.
Attachments
manual1.JPG
(21 KiB) Downloaded 1001 times
manual2.JPG
(38.63 KiB) Downloaded 1445 times
manual3.JPG
(11.17 KiB) Downloaded 1423 times
manual4.JPG
(19.22 KiB) Downloaded 1171 times
manual5.JPG
(27.75 KiB) Downloaded 1380 times
manual9.JPG
(27.37 KiB) Downloaded 1407 times

User avatar
craftybytes
Posts: 298
Joined: Fri 17 Nov 2006, 10:32
Location: QLD AUSTRALIA

#16 Post by craftybytes »

@oli -

Is there a "Users Manual" for the 'TinyMCE' used to edit the Puppy Manual.?

I did an edit in the Puppy 4 manual - BUT - somehow it stuffed up the formatting of the page..DOH..!

Also - can one do a 'revert' back to the original page - e.g.. undo the edits..?

I'm finding out that one has to be extremely careful with how one undertakes any editing steps in this TinyMCE package.

WYSIWYG is not necessarily fully accurate..!!

I just hope I have not bitten off more than I can chew - proverbialy..

Any help much appreciated..

crafty.
.
3 x boot:- ASROCK VIA 'all-in-one' m/b; AMD Duron 1.8Ghz+; 1.0GB RAM; 20GB hdd (WinXP Pro); 80GB hdd (MEPIS 3.4-3/Puppy v2.15CE Frugal); 1GB USB pendrive (Puppy 2.15CE Frugal); CD/DVDRW; 17" LCD monitor; HSF 56k modem... MEPIS is great.. Puppy ROCKS..

User avatar
puppyluvr
Posts: 3470
Joined: Sun 06 Jan 2008, 23:14
Location: Chickasha Oklahoma
Contact:

#17 Post by puppyluvr »

:D Hello oli :D

Well, I took a shot at WLAN under "connecting to the internet". Please review and tell
me how it looks. Any pointers will be gladly appreciated. :D

Also a question?? What is the Sandbox, and how do I use it??
Is it a test area???

I still need to work on my text formatting I know.. :oops:
Hey, I`m new at this!!! :?
Close the Windows, and open your eyes, to a whole new world
I am Lead Dog of the
Puppy Linux Users Group on Facebook
Join us!

Puppy since 2.15CE...

oli
Posts: 194
Joined: Wed 30 Aug 2006, 09:04
Location: Germany, Frankfurt

#18 Post by oli »

@craftybytes: ... that's why I advised to make some exercise at the sandbox first. Perhaps Tom or me can repair the page. Please let us know what is wrong now with the English manual. Don't get discouraged, everyone can make a mistake.

I don't have a "Users Manual" for the TinyMCE.

@puppyluvr: The sandbox is a test area. Besides you / we can prepare the next manual in a closed area where a normal user cannot see it until you / we move it to the publish area.

Your new page looks very good. I will make a test of WLAN with a friend of mine at Friday. Afterwards I will add a WLAN-page too. So I can copy your page to the German manual and make some adaptation if necessary.

User avatar
craftybytes
Posts: 298
Joined: Fri 17 Nov 2006, 10:32
Location: QLD AUSTRALIA

#19 Post by craftybytes »

Thanks oli..

I checked out the 'sandbox' section - no "English" manual access from there - so then did the edits to the actual 'English' manual..

As to the page I stuffed up - well it was really only to do with the format layout of the page - so I went back and 'fixed' it - but I think there is still a couple of little formatting errors on the page..

The page in question:
In the - 'How to make a backup' - 'Backup with rsync' page..

After doing some googling re "tinyMCE" - I think I may be able to fix this slight problem myself - if not I'll give either you or Tom a yell..

Re the 'sandbox' - is there any way to open up the "English" manual in the sandbox - do whatever editing - then save it - before it gets moved to the public area.?

Can't see how to open up the relevant manual in the sandbox..?

TIA.

crafty.
.
3 x boot:- ASROCK VIA 'all-in-one' m/b; AMD Duron 1.8Ghz+; 1.0GB RAM; 20GB hdd (WinXP Pro); 80GB hdd (MEPIS 3.4-3/Puppy v2.15CE Frugal); 1GB USB pendrive (Puppy 2.15CE Frugal); CD/DVDRW; 17" LCD monitor; HSF 56k modem... MEPIS is great.. Puppy ROCKS..

User avatar
puppyluvr
Posts: 3470
Joined: Sun 06 Jan 2008, 23:14
Location: Chickasha Oklahoma
Contact:

#20 Post by puppyluvr »

:D Hello :D

@ Oli,
Thanks :D I still need to add a few images, because I think they are key to
"newbie friendlyness", and any changes / suggestions are greatly appreciated. :)

Also, the screenshots are from :oops: 3.98, and I havnt yet gotten 4.00 final so I hope they apply!!

OK must sleep now as is 2.45 am here!! :roll:
Close the Windows, and open your eyes, to a whole new world
I am Lead Dog of the
Puppy Linux Users Group on Facebook
Join us!

Puppy since 2.15CE...

Post Reply