PHP Nuke book in English is available

[amp2000]

It's available at the following site http://oss.cs-consultants.com

And here's the thread that made this book!!

Hi everyone
There is a book out for PHPnuke written in Italian in PDF and OpenOffice Format.
I copy and pasted all text from the presentation to a MS Word doc and saved it as HTML, I then ran it through a translator.

I have it all in one web page, it is missing the images but I will add them in the next day or two, I am more concerned with getting the htnl correct on the pages, at the moment it's a mess but I am working on it as we speak, here's the catch though (I have never spoken a word of Italian in my life) and the translator missed about 5-10% of the words, it is still very readable but I need an Italian (preferably a few to help me)

With a bit of help from the community we should have a great english PHPnuke book in the next few days

Cheer's
amp2000


<font size=-1>[ This Message was edited by: amp2000 on 2003-01-14 19:59 ]</font>

[chris]

I would be glad to help (I am neither a native english, nor a native italian speaker, but I speak both languages fluently).

Let me suggest something: Trying to get the HTML output right and putting hours of work into formatting is the wrong way to produce high quality documents. OpenSource has given us LyX, the WhatYouSeeIsWhatYouMean Editor. *Please* get it (http://www.lyx.org) and use it to produce a .lyx document. You will see that it is very easy and will free your mind from having to get the ouput right. You just concentrate on what deserves most of your attention: content

Now, after having produced a .lyx document, just send it to me. I will get it through some scripts of mine which

• will produce the SGML source from the .lyx document
  
• will modify the SGML source to be more correct
  
• will produce the HTML, PDF, RTF, TXT, and PS formatted documents, all professionally formatted through the appropriate style files
  

To get an idea of what I mean, just have a look at

http://www.karakas-online.de/myAMANDA/t1.html

for the HTML files and at

http://www.karakas-online.de/myAMANDA/x34.html

for the links to the other formats which I produced with the method proposed above.

And please don't get me wrong: I am not trying to patronage you, all I want is to do it right. And the right way is the one that goes through SGML (as you can verify by having a look at the Linux Documentation Project)).

So I am eager to see your first LyX documents

Regards

[amp2000]

Hi Chris
Thanks for the reply, I dont think you are trying to patronise me
After many failed download attempts with lyx I finally got it and I am running 'make' on it as I write this so I will have the lyx version available (hopefully) in the next hour.
I tried doing what you are saying with Dreamweaver on windows and bluefish on linux but couldnt. Thanks for the tip Chris!
I'll put up a link to the file here when lyx is finished installing.

Cheer's
amp2000

[amp2000]

OK, I have the LyX version in the downloads section of my site, there is only 2 downloads there so I dont think you will have any probs finding it

I'll check back here for an update.

Thanks chris

amp2000

[amp2000]

Hi Chris, the server I have the site running on is VERY restrictive with permissions, ie everything is read only by root as default, I have fixed the permissions on the Kaput theme so it now works.
In case you have any more problems you can access the files directly here
http://oss.cs-consultants.com/EN-Book.html
http://oss.cs-consultants.com/EN-Book.lyx
I had a look at your links and I cant wait to get the page looking like that, once you do that I will add the images and then start fixing the content.

Thanks
amp2000

[amp2000]

OK, all the themes now work on the site.

Cheer's
amp2000

[chris]

Try

[chris]

I have downloaded the lyx version of the document. I will have to format it with the LyX commands, since it was just text imported to LyX. Formatting will take a day or so and I am not sure how we should proceed, since in the meantime you might be working on the translation - we would have to merge the changes then, a classic situation for CVS...

Take a look at the bleeding-edge version at

http://www.karakas-online.de/myPHPbook/EN-Book.lyx

Any ideas?

[chris]

Hello all Nukers,

the bleeding edge of the PHP Book can be found on my homepage under

http://www.karakas-online.de/EN-Book/t1.html

It is available in HTML, for online reading, PDF for compact transportation, PS.GZ for printing, TXT for the purists, RTF for those who (still) prefer Word to LyX and SGML for those who always want to read the source . If you miss a format, say TeX, you can derive it from SGML. Please find the links to the various formats in

http://www.karakas-online.de/EN-Book/x5.html#AEN12

There is also a whole tarball containing all the above in

http://www.karakas-online.de/EN-Book/EN-Book.tar.gz

Please note that this is a very new release and the wording and/or formatting is still very experimental. We still have to put a lot of work to clean it up of all the errors. But feel free to post corrections and suggestions.

amp2000, from now on, we definitely need to coordinate our actions. The source lyx file for the above mentioned formats is

http://www.karakas-online.de/EN-Book.lyx

All changes regarding translation and/or formatting have to be incorporated in this lyx file in order to take effect. Since I speak italian, I could start fixing the translation. But then, during this time (2-3 days?), you shouldn't change anything, or diff will be our closest frient I hope we can find a procedure that is satisfactory enough.

To all who read: What do you think, should we do a HOWTO out of this?

Regards

Chris

[Go*.*]

Wow, unbelievable amount of information! Now there truely will be an answer for the "Where can I get more information" question!

[amp2000]

Hi chris, that looks great, much appreciated.
I cant seem to download the tarball though, it just gives me a blank page, I have the Lyx version though so I'm going to start adding the images from the book now, you have saved me alot of hassle man!

I will post back here when I have added the images so you work on the language for now, I can re-phrase things when I've added the images but I dont think there is much point if you will only be a few days, I cant speak Italian anyway, if you want to do it a different way just let me know.

When we are finished a translator who translates italian computer games to english has agreed to take an editorial look at it:)

I'll check back here for an update and let you know when the images are added.
Thanks again chris,
amp2000

[amp2000]

hmmm, I can download the tarball from windows, must be a prob on my end!

amp2000

[chris]

amp2000,

I can download the tarball from my linux box, so it must be some other problem.

Let's proceed as follows:

• You add the pictures to the lyx file. Please add them as just "imagename.eps", even if no eps file is there. My script takes care of this (it substitutes <graphic> with the more elaborate <mediaobject> SGML tag in the SGML file generated from lyx ).
  
• You tell me when and where to get the new lyx file and images. Until then, I wait.
  
• I get the new lyx and image files and start correcting the translation.
  
• I have to go offline till the weekend from tomorrow afternoon. So, you get the lyx file back tomorrow and continue.
  
• When I get back online, I grasp the lyx file from you and pass it through my script, to produce the newest version.
  

I know where you have your lyx file and you know where I have mine. That should be O.K. What do you think?

Regards

Chris

[amp2000]

Hi Chris
I sorted the download prob, I forgot I was trying out a new download manager called aria, all sorted now.

I was going to add the images from the book but it's in Italian, it will take a little longer than I expected to add the images as I'm just going to take fresh english screenshots from one of my test sites instead of using the origianls from the book, I'll also take the screenshts from nuke6.0 instead of 5.6.
I wont have it back to you tomorrow before you go offline as I need to have an Intranet done by Friday and I'm kinda busy, it's my first one so I dont wanna fu** it up.
I will have the images added by the time you get back online though and fix whatever else I can so DONT touch it till then, you just chill out.
One thing I am a little confused about though is adding the images, you said to add them with as 'imagename.eps', sorry but I dont know how to do that, I tried adding a png image to the lyx file and it converted it to a usable format automatically, (I have no idea what format though) is it EPS??
Is it OK adding images like this??

If you cant explain, it's OK, I found a link to some recent LyX documentation, only a month old, so I'll get a chance to read through it hopefully in the next day or two and understand LyX a bit better.

Talk to you soon, and Nukers, stay tuned, we will be back with a nice english formatted book soon.

Thanks again Chris
amp2000

[chris]

amp2000,

don't bother about the formats, when I export the lyx file to SGML the ending is gone - and LyX' <graphic> tag is insufficient to say the least.

Just do "Insert --> Graphics" and in the popup that comes write "forum.eps", if the image is called "forum.jpg", or "forum.gif", or "forum.whatever". You get the idea. Don't browse to find it, don't insert any directories in the name, don't worry if you have an eps file or not.

Then, when you are done inserting the images at the right places, post a message here and tell me where to find the image files (and update your download link to the lyx file).

I will take the lyx file, the image files, put the images in a directory called "images", then run my script. The script will take care of the correct image location and formats (png, eps, pdf, etc.) while changing the SGML file, then do its further "magic" (I will describe this magic in a separate article on my homepage soon...)

Take the latest lyx file from my site. I have added the author and the collaborators

Regards

Chris

[chris]

Sorry, I forgot to upload the latest lyx version of the book to my site. It is now there and I will not touch it for the next couple of days, as I will be offline. Again, here it is:

http://www.karakas-online.de/EN-Book.lyx

Regards

Chris

[amp2000]

Hi Chris
I have added all but 4 of the images to the lyx file for you , I have the images and LyX file in a tarball for you at http://oss.cs-consultants.com/book.tgz

The images are definitely not the best, I had to take screenshots of my entire screen in some cases as I have no idea how to select a portion of a page to use as an image. I cant for the life of me get the main logo from the fromt of the book either. Graphics applications are definitely not my strong point.

Chris, when you do your magic is it still possible for me to fix up some of the images???? I just need a little more time to get my head around fireworks, I'm useless at the gimp.

Cheer's
amp2000

[amp2000]

Hi Chris
I uploaded the wrong LyX file to my site.
I have also figured out how to properly edit images so I can fix them all up before you do anything.
It's 4 O clock my time and I'll fix up the images by later on tonight and post back here to let you know I'm finished.

Cheer's
amp2000

[amp2000]

Hi Chris
OK, I have fixed the images, the tarball with the Lyx file and images is at http://oss.cs-consultants.com/book-images.tgz
You can download it directly from that link, it's 854K

Thanks again Chris.
I'd be interested to have a look at them scripts your using by the way.

Cheer's
amp2000

[chris]

Hi all,

I have just put a new version of the PHPNuke book online at

http://www.karakas-online.de/EN-Book/index.html

If you browse to the subsection "Formats" in the Introduction, you will find the links to other formats as well, including LyX (this is new) and tar.gz (for those who want to download all files).

There are some points to make here:

• amp2000, somehow you changed the document's layout from "DocBook article SGML" to "article". This changed the environment of all the admonitions ("important", "caution", "note") from "SGML" to "Standard". That's bad.
  
• The environment of the code examples has to be "Code". This was also changed to "Standard" in your .lyx file.
  
• For the above reasons, I did not use your .lyx file directly - I would have to change all the environments! I took mine instead - and added the images .
  
• I have reduced some images to their half size. Otherwise they don't fit in the PDF and PS pages - too large. The problem is, bitmaps scale badly and text becomes unintelligible in the scaled-down images. Any ideas on how to produce crisp bitmaps of the PHPNuke screenshots at roughly half the original size?
  
• I don't understand why the PHPMyAdmin images are so blurred...amp2000, can you remake them? I have remade some images that seemed to be a little squeezed.
  

That's all for the moment. I will start cleaning up the translation tomorrow, Sunday the 17th (actually, it's today ). I should be finished in about 2-3 days. Check http://www.karakas-online.de for intermediate versions. As soon as I have the "final" translation, I will post here.

I almost forgot: the scripts . I am preparing a document on these, which I will publish on my homepage (see above). Just showing a script here will not help much. The "magic" is an interplay between LyX, SGML, sed, openjade, pdfjadetex, sgmltools, stylesheets, graphics conversions, the hyperref package, thumpdf (see the thumbnails in the PDF file?

Regards

Chris