Puppy Linux Discussion Forum

craftybytes · Joined: 17 Nov 2006 Posts: 298 Location: QLD AUSTRALIA

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

puppyluvr · Posted: Wed 18 Jun 2008, 01:59 Post_subject:

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

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

Hey, I`m new at this!!! Confused

oli · Joined: 30 Aug 2006 Posts: 194 Location: Germany, Frankfurt

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

craftybytes · Joined: 17 Nov 2006 Posts: 298 Location: QLD AUSTRALIA

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

puppyluvr · Posted: Wed 18 Jun 2008, 03:42 Post_subject:

Hello

@ Oli,
Thanks Very Happy

I still need to add a few images, because I think they are key to
"newbie friendlyness", and any changes / suggestions are greatly appreciated. Smile

Also, the screenshots are from Embarassed

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!! Rolling Eyes

ICPUG · Joined: 24 Jul 2005 Posts: 1278 Location: UK

puppyluvr,

The basis of a good manual is that what is written is not based on hope - but can be trusted!

Painful though it is you should check everything you write by doing what you write. Then you rewrite it to correct the errors found from the experience!

Get yourself a copy of Puppy 4.

My intention here is not to be critical but to provide advice. I know how difficult it is to devote time to writing and applaud you and craftybytes for stepping up to the plate.

ICPUG

oli · Joined: 30 Aug 2006 Posts: 194 Location: Germany, Frankfurt

@craftybytes: You can't open the manual in the sandbox. Either the manual is at the publish area or it is in the sandbox. And because the main chapters like how to run and install Puppy 4.0 are finished I decided to move the English manual out of the sandbox into the publish area. So everything you change is for real.

In the sandbox you can try out what you want to do with the manual. For example you can copy the html-code of the manual page and paste it into a page of the sandbox. Then you try out and when everything is alright you copy the html-code back into the manual.

@puppyluvr: Please use Puppy 4.0 when you add or edit a page to/of the Puppy 4.0 manual. There are many changes from release to release. Only if the layout (e.g. colour) is different I sometimes keep the old screenshot (because it is a question of time and importance).

puppyluvr · Posted: Wed 18 Jun 2008, 10:15 Post_subject:

Oli

Will upgtade my Dingo asap from 3.98 to 4.00. Been ueing 3.98 for a while, and didnt
think there was any significant difference from 4.00.
I will go thru it again in 4.00 step by step like I did in 3.98 to see if the screenshots remain the same and change any that may be different. Embarassed

alienjeff · Joined: 08 Jul 2006 Posts: 2290 Location: Winsted, CT - USA

First, thank you for stepping up to the plate in this project.

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

Eagle eyed proof readers, reading the manual itself would be very helpful.

puppyluvr · Posted: Wed 18 Jun 2008, 12:26 Post_subject:

@alienjeff

Sorry, I didnt know the smileys were so annoying, I will attempt to refrain.
Suggestion #2 - Don't hope. Make certain.
@ I have now made certain that there are no difference`s between
3.98 and 4.00 as far as the screenshots of WLAN setup are
concerned. I had truely forgotten I was on 3.98 until I had finished
and really had to sleep, so I figured I`d D/L 4.00 and check the next
morning, which I did.
@ Of course Ive read the 4.00 manual, (translated from German),
hence my choice of a section that was unfinished in either language
while using the 3.01 and 4.00 manuals as stylistic reference, to
(hopefully) maintain consistency, for the ease of the end user..

@ Well, I did ask for criticism, didnt I ?? Keep it up!! I just want to do the best job
I can, for the benefit of the end user, and for Puppy...

craftybytes · Joined: 17 Nov 2006 Posts: 298 Location: QLD AUSTRALIA

@HairyWill -

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

craftybytes · Joined: 17 Nov 2006 Posts: 298 Location: QLD AUSTRALIA

Thanks Will..

Now that that has been sorted - I think it be time for us new 'maintainers/translators' to now get together and discuss our personal approaches and our perceived priorities towards editing the Manual - more for coordination purposes..

Should this be done in this particular thread or should we open a new topic to follow through..?

And if a new topic - still in this forum or in the sub-forum "Documentation Project" - as any ongoing queries / discussions are related to the Manual (thus 'documentation')..?

TIA.

crafty.
.

puppyluvr · Posted: Thu 19 Jun 2008, 08:58 Post_subject:

Hello,
@ When I go to the site and log in all is well. But if I go to the "Manual" tab it automatically logs me out. If I re-log-in again it navigates me away from the manual page, and when I attempt to return to the manual it logs me out again!! The wiki page..ect..doesnt do this, just the manual page.The edit button is there, but I cannot
input text as it says im not logged in. Have I been revoked???
Too many smileys in my posts perhaps????LOL

@