(old)Puppy Linux Discussion Forum

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?

Hello

Id be happy to help, but I dont know if I have the skill..
What is required?????
Besides being a Puppy fanatic.
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)

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.

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

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.
.
.

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

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.
.

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.

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..

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

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.
.

@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

OK - will get it done by tomorrow..

cheers..

crafty.
.

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

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

crafty.
.

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?

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.

Alex

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.

@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.
.

Hello oli

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.

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..
Hey, I`m new at this!!!

@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.

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.
.

Hello

@ Oli,
Thanks 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 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!!