1.5. Credits
This section documents the efforts that have been invested into this document by its authors, contributors and the community. We tried hard to give credit where credit is due. However, this does not mean that we used only the sources mentioned explicitly here, in this section. Numerous other sources of information have been used, mainly Forums, such as:
Whenever a source has been used, we have included a link to it. Thus, depending on the context, you should interpret the links in this document not only as a source of further information on a subject, but also as Credit and a “Thank you” for the idea, the explanation, the discussion or the piece of code it offers. If you feel we have ovelooked something, please feel free to contact us.
We do not offer a Bibliography, as strict academic criteria would require, but this may change in the future, as Chris is working on a solution to the Bibliography problem in the context of LyX and SGML.
 | How to enter hundreds of references in LyX |
|---|---|
If you look in the following Section 1.5.1, Section 1.5.2 and especially Section 1.5.3, you will notice the exceptionally large number of cross-references that had to be entered. Although a single cross-reference is inserted very easily in LyX (just choose Insert->Cross-reference from the menu, then choose the label of the reference you want), it becomes a real pain if you have to enter hundreds of them, as in our case. Chris' solution to this was to write a script that reads a LyX file and outputs another LyX file that contains references to all labels of the first one. It was easier to copy the references from the file thus created, paste them in Section 1.5.3(which deals with version 2.0), then delete references to parts that already existed in version 1.0, than try to insert references to all new parts of version 2.0 by using the menu. You can read about Chris' script in Mass insertion of cross-references in LyX. |
1.5.1. Version 1.0
This book started in version 1.0 as a document in italian language, written by Claudio Erba. It contained:
Chapter 1, consisting of Section 1.1, Section 1.2, Section 1.3, Section 1.4 and Section 1.6. This was Chapter 1 of version 1.0.
Chapter 2, consisting of Section 2.1, Section 2.2, Section 2.3, Section 2.4, and Section 2.5. This was Chapter 2 of version 1.0.
Chapter 6, consisting of Section 6.1, a section on AvantGO, now removed, Section 6.2 and Section 6.3. This was Chapter 3 of version 1.0.
Chapter 7, consisting of Section 7.1 and Section 7.2. This was Chapter 4 of version 1.0.
Chapter 3 consisting of Section 3.2, Section 3.2.1, Section 3.2.2, Section 3.2.3, Section 3.3, Section 3.3.1, Section 3.4.5, Section 3.7 and Section 3.8. This was Chapter 5 of version 1.0.
Chapter 9, consisting of Section 9.1, Section 9.2, Section 9.3, and Section 9.4. This was Chapter 6 of version 1.0.
Chapter 14, consisting of Section 14.1, Section 14.2, Section 14.2.1 and Section 14.8. This was Chapter 7 of version 1.0.
Chapter 20, consisting of Section 20.1, Section 20.2, Section 20.2.1, Section 20.2.2. This was Chapter 8 of version 1.0.
Chapter 21, consisting of Chapter 21, Section 21.1, Section 21.2, Section 21.3 and Section 21.4. This was Chapter 9 of version 1.0.
Chapter 23, consisting of Section 23.4.4, Section 23.4.5 and Section 23.4.5.1. This was Chapter 10 of version 1.0.
Chapter 28, consisting of Section 28.1, Section 28.5, Section 3.4, Section 3.3.1, Section 3.3.2, Section 28.6 and Section 28.7. This was Chapter 11 of version 1.0.
Version 1.0 came with the following figures:
Figure 6-1, Figure 6-2, Figure 6-3, Figure 6-4, Figure 6-5, Figure 6-6, Figure 6-7, Figure 6-8, Figure 7-1, a screenshot of the News articles that has been removed, Figure 3-3, Figure 3-6, Figure 3-14, Figure 3-15, Figure 3-16, Figure 3-11, Figure 20-2, Figure 21-1, Figure 21-2, Figure 3-12, Figure 28-2, Figure 28-3, Figure 28-4.
Version 1.0 contained no tables.
Andre Purfield of Open Source Solutions started the translation project (see the PHP-Nuke book translation thread at nukeforums) and coordinated the work of the translators. Fortunato Matarazzo made the transaltion of the version 1.0 Chapters 7, 8 and 9 (see above). Chris Karakas translated the rest. Andre imported Fortunato's part into LyX, remade many of the screenshots and also made corrections to the english text of the whole document. Chris imported his part in LyX, formatted the whole document, created the Index and processed the LyX file through his scripts (see Section 1.8, for details) to render all the versions and files available from Section 1.2.
Chris also made PNG, PDF (encapsulated PDF), EPS (encapsulated Postscript) and BMP versions of all figures. The PDF and EPS versions are included in the PDF and PS versions of the document respectively. The PNG and BMP versions are used by the HTML and RTF versions of the document respectively and are supplied separately in the images folder.
1.5.2. Versions 1.x
In the 1.x versions, various improvements have been made on the document, as can be seen in the Revision History in the front page:
Version 1.1: Andre Purfield of Open Source Solutions cleaned up the wording and a few typos.
Version 1.2: Chris Karakas made various improvements:
Added a new logo.
Added a CSS stylesheet for DocBook.
Took care of HTML validation (all HTML pages now are validated as conforming to the HTML 4.01 Transitional standard[1]).
Added footer icons that have the following property: if you click on them, they validate, depending on the icon, either the HTML code or the CSS code of the page being currently viewed.
Added translation links in the header and footer: in the header of each page, you will find links to Google's automatic translation of that page into 5 languages - french, german, italian, portuguese and spanish. In the footer of each page, on the other hand, you will find links to Alta Vista's automatic “Babelfish” translation of that page into 8 languages: chinese, german, japanese, korean, french, italian, portuguese and spanish.
Incorporated LDP reviewer's comments.
Created Section 1.4 and Section 1.6.
Version 1.2.1: Chris created the PHP-Nuke HOWTO module for PHP-Nuke, a module that integrates this HOWTO into your PHP-Nuke site (you could install this module too, tip, tip!). Chris added a link to it in the Formats section (Section 1.2) and made a smaller logo.
Due to Chris' efforts, starting from version 1.2 this document is an official HOWTO of the Linux Documentation Project.
Also, starting from PHP-Nuke version 6.7 FINAL, this document is included in the docs folder of the standard PHP-Nuke package, as the official PHP-Nuke guide.
In all 1.x versions after 1.0, the original italian text has undergone no changes other than those related to translation. But behind the scenes, Chris and Claudio were working fervently for the next version 2.0, which was going to bring dramatic improvements, as you can read in Section 1.5.3. 
1.5.3. Version 2.0
In version 2.0, Chris Karakas added the following Chapters and Sections:
In Chapter 1: Section 1.5, Section 1.5.1, Section 1.5.2, Section 1.5.3, Section 1.5.5, Section 1.7, Section 1.8, Section 17.2.2.1, Section 1.8.2 and Section 1.9.
In Chapter 2: Section 2.6, Section 2.6.1, Section 2.6.2 and Section 2.6.3.
In Chapter 3: Section 3.1, Section 3.2.4, Section 3.6, Section 3.6.2, Section 3.6.3, Section 3.7.1, Section 3.7.1.1, Section 3.7.1.2, Section 3.9, Section 3.9.1, Section 3.9.1.1, Section 3.9.1.2, Section 3.9.1.3, Section 3.9.2, Section 3.9.3, Section 3.9.4, Section 3.9.5, Section 3.9.6, Section 3.9.7, Section 3.9.8, Section 3.9.8.1, Section 3.9.9, Section 3.9.10, Section 3.9.11, Section 3.9.12, Section 3.9.13, Section 3.9.14, Section 3.9.15, Section 3.9.16, Section 3.9.17, Section 3.9.18, Section 3.9.19, Section 3.9.20, Section 3.9.21, Section 3.9.22, Section 3.9.23, Section 3.10, Section 3.10.1 and Section 3.10.2, Section 3.10.3, Section 3.10.4 and Section 3.10.5.
In Chapter 4: Section 4.1, Section 4.1.1, Section 4.1.2, Section 4.2.
In Chapter 5: Section 5.1 and Section 5.2.
The whole Chapter 8: Section 8.1, Section 8.1.1, Section 8.2, Section 8.2.1, Section 8.2.2, Section 8.2.3, Section 8.2.4, Section 8.2.5, Section 8.2.6, Section 8.2.7, Section 8.2.8, Section 8.3, Section 8.3.1, Section 8.3.2, Section 8.3.3, Section 8.3.4, Section 8.3.5, Section 8.3.6, Section 8.3.7, Section 8.3.8, Section 8.3.9, Section 8.3.10, Section 8.3.11, Section 8.3.12, Section 8.3.13, Section 8.3.14 and Section 8.3.15.
The whole Chapter 10: Section 10.1 and Section 10.2.
The whole Chapter 11: Section 11.1, Section 11.2, Section 11.3, Section 11.4, Section 11.5, Section 11.6, Section 11.7, Section 11.8 (FIXME: Well, this may not be finished by the time version 2.0 is released, but the will to write it was certainly there! :-) ).
The whole Chapter 12: Section 12.1.
The whole Chapter 13: Section 13.1, Section 13.2, and Section 13.3.
In Chapter 14: Section 14.3, Section 14.3.1, Section 14.3.2, Section 14.3.3, Section 14.3.4, Section 14.3.5, Section 14.3.6, Section 14.3.7, Table 14-1, Section 14.3.8, Section 14.3.9, Section 14.4, Section 14.4.1, Section 14.4.2, Section 14.5, Section 14.6, Section 14.6.1, Section 14.6.2, Section 14.7, Section 14.9, Section 14.10, Section 14.11 and Section 14.12.
The whole Chapter 15: Section 15.1 and Section 15.2.
The whole Chapter 16: Section 16.1, Section 16.2 and Section 16.3.
The whole Chapter 17: Section 17.1, Section 17.2, Figure 17-1, Section 17.2.1, Section 17.2.2, Figure 17-2, Section 17.2.2.1, Figure 17-3, Figure 17-4, Figure 17-5, Figure 17-6, Section 17.2.2.2, Section 17.3 and Section 17.4.
The whole Chapter 18: Section 18.1, Section 18.1.1, Section 18.1.2, Section 18.2, Section 18.2.1, Section 18.2.2, Section 18.3, Section 18.3.1, Section 18.4, Section 18.4.1, Section 18.4.2, Section 18.5, Section 18.5.1, Section 18.5.2, Section 18.6, Section 18.6.1, Section 18.6.2, Section 18.6.3, Section 18.6.4, Section 18.6.5, Section 18.6.6, Section 18.6.7, Section 18.6.8, Section 18.7, Section 18.7.1, Section 18.8, Section 18.8.1, Section 18.8.1.1, Section 18.9, Section 18.9.1, Section 18.10, Section 18.10.1, Section 18.11 and Section 18.11.1.
The whole Chapter 19: Section 19.1 and Section 19.2.
In Chapter 20: Section 20.3, Section 20.4, Section 20.5, Section 20.5.1, Section 20.5.2, Section 20.5.3, Table 20-1, Section 20.7, Section 20.8, Section 20.8.1, Section 20.9.
In Chapter 21: Section 21.5, Section 21.6, Table 21-1, Table 21-2, Section 21.7, Section 21.8, Section 21.9, Section 21.9.1, Section 21.9.2, Section 21.10, Section 21.11, Section 21.11.1, Section 21.11.2, Section 21.12,
The whole Chapter 22: Section 22.1.
In Chapter 23: Section 23.1, Section 23.2, Section 23.3, Section 23.3.1, Section 23.3.2, Section 23.3.3, Section 23.3.4, Section 23.4, Section 23.4.1, Section 23.4.2, Section 23.4.3, Section 23.4.4 (some changes), Section 23.4.5.2, Section 23.5 and Section 23.6.
The whole Chapter 24: Section 24.1, Section 24.1.1, Section 24.1.1.1, Section 24.1.1.2, Section 24.1.1.3, Section 24.1.2, Section 24.1.2.1, Section 24.1.2.2, Section 24.1.3, Section 24.1.3.1, Section 24.1.3.1, Section 24.1.3.3 and Section 24.1.4.
The whole Chapter 25: Section 25.1, Section 25.1.1, Section 25.2, Section 25.2.1, Section 25.2.2, Section 25.2.3, Section 25.2.4, Section 25.3, Section 25.4, Section 25.5, Section 25.5.1, Section 25.5.1.1, Section 25.5.1.2, Section 25.5.1.3, Table 25-1, Section 25.6 and Section 25.7.
In Chapter 26: Section 25.8, Section 26.1, Section 26.5, Section 26.6 and Section 26.7.
The whole Chapter 27: Section 27.1, Section 27.2, Section 27.3, Section 27.4, Section 27.5, Section 27.6, Section 27.7, Section 27.8, Section 27.9, Section 27.10, Section 27.11, Section 27.13, Section 27.13.1, Section 27.13.2, Section 27.13.3, Section 27.14, Section 27.15 and Section 27.16.
In version 2.0, Claudio Erba added the following Chapters and Sections:
In Chapter 3: Section 3.4, Section 3.4.1, Section 3.4.2, Section 3.4.3, Section 3.4.4, Section 3.5, Section 3.6.1, Section 3.6.1.1, Section 3.6.4 and Section 3.6.5.
In Chapter 4: The introductory text (Chapter 4) and Section 4.3.
In Chapter 6: A lot of additions and improvements in the whole chapter: Section 6.1, Section 6.2, Section 6.3.
In Chapter 7: A lot of additions and improvements in the whole chapter: Section 7.1, Section 7.1.1 (which was added in this version) and Section 7.2.
In Chapter 9: Some changes in Section 9.1 and Section 9.2.
In Chapter 26: Section 26.2, Section 26.2.1, Section 26.2.2, Section 26.3, Section 26.3.1, Section 26.3.2, Section 26.3.3 and Section 26.4.
In Chapter 28: Section 28.2, Section 28.2.1, Section 28.2.2, Section 28.2.3, Section 28.2.4, Section 28.3, Section 28.4, Section 28.4.1, Section 28.4.2 and Section 28.4.3.
 | Note |
|---|---|
As you can see, almost all labels of version 1.0 have been preserved in version 2.0 too. More specifically, all labels that give rise to HTML files have been preserved in the LyX file. That's no coincidence: Cool labels don't change! |
Chris translated Claudio's additions from italian and inserted some additions and many cross-references. On the other hand, some of Claudio's information has found its way in the sections added by Chris.
We have added the GNU Free Documentation Licence in the Section A.1.
The following figures have been added in version 2.0:
Chris added: Figure 3-4, Figure 3-5, Figure 3-25, Figure 3-26, Figure 3-27, Figure 3-28, Figure 3-29, Figure 3-30, Figure 3-31, Figure 3-32, Figure 3-33, Figure 3-34, Figure 3-35, Figure 3-37, Figure 3-38, Figure 3-39, Figure 6-9, Figure 6-10, Figure 6-11, Figure 6-13, Figure 7-2, Figure 7-3, Figure 7-4, Figure 7-5, Figure 7-6, Figure 7-7, Figure 7-8, Figure 7-9, Figure 7-10, Figure 7-11, Figure 7-12, Figure 7-13, Figure 7-14, Figure 7-15, Figure 7-16, Figure 7-17, Figure 7-18, Figure 7-19, Figure 7-20, Figure 7-21, Figure 7-22, Figure 7-23, Figure 7-24, Figure 7-25, Figure 7-26, Figure 7-27, Figure 7-29, Figure 7-30, Figure 7-31, Figure 7-32, Figure 7-33, Figure 7-34, Figure 7-35, Figure 8-1, Figure 8-2, Figure 8-3, Figure 8-4, Figure 8-5, Figure 8-6, Figure 8-7, Figure 8-8, Figure 8-9, Figure 8-10, Figure 8-11, Figure 8-12, Figure 8-13, Figure 8-14, Figure 8-15, Figure 8-16, Figure 8-17, Figure 8-18, Figure 8-19, Figure 8-20, Figure 8-21, Figure 8-22, Figure 8-23, Figure 8-24, Figure 8-25, Figure 8-26, Figure 8-27, Figure 8-28, Figure 8-29, Figure 8-30, Figure 8-31, Figure 8-32, Figure 8-33, Figure 8-34, Figure 12-1, Figure 14-3, Figure 14-4, Figure 16-1, Figure 17-1, Figure 17-2, Figure 17-3, Figure 17-4, Figure 17-5, Figure 17-6, Figure 18-2, Figure 18-3, Figure 18-4, Figure 18-5, Figure 18-6, Figure 18-7, Figure 18-8, Figure 18-9, Figure 18-10, Figure 18-11, Figure 18-12, Figure 18-13, Figure 18-14, Figure 19-1, Figure 19-2, Figure 19-3, Figure 20-1, Figure 20-3, Figure 20-4, Figure 20-5, Figure 20-6, Figure 20-7, Figure 20-8, Figure 20-9, Figure 20-10, Figure 20-11, Figure 20-12, Figure 20-13, Figure 21-3, Figure 21-4, Figure 23-1, Figure 23-2, Figure 23-3, Figure 24-1, Figure 24-2, Figure 24-3, Figure 24-4, Figure 24-5, Figure 25-1, Figure 25-2, Figure 25-3, Figure 25-4, Figure 26-1, Figure 26-3, Figure 26-4, Figure 26-5, Figure 27-1, Figure 27-2, Figure 27-3, Figure 27-4, Figure 27-5, Figure 27-6, Figure 27-7, Figure 27-8, Figure 27-9, Figure 27-10, Figure 27-11, Figure 27-12, Figure 27-13 and Figure 28-1.
Claudio added: Figure 2-1, Figure 3-1, Figure 3-2, Figure 3-7, Figure 3-8, Figure 3-9, Figure 3-10, Figure 3-13, Figure 3-17, Figure 3-18, Figure 3-19, Figure 3-20, Figure 3-21, Figure 3-22, Figure 3-23, Figure 3-24, Figure 3-36, Figure 6-12, Figure 6-14, Figure 6-15, Figure 7-28, Figure 9-1, Figure 14-1, Figure 14-2, Figure 26-2 and Figure 27-2.
Again, as in version 1.0, Chris made PNG, PDF (encapsulated PDF), EPS (encapsulated Postscript) and BMP versions of all figures to be used in the various formats of the document.
The following tables have been added in version 2.0:
Chris added: Table 6-1, Table 14-1, Table 16-1, Table 16-2, Table 20-1, Table 21-1, Table 21-2, Table 23-1 and Table 25-1.
Chris wrote all new material of version 2.0 in LyX, formatted the whole document, created the Index (semi-automatically this time, through some of his sed and awk scripts, as described in Document processing with LyX and SGML) and processed the LyX file through his scripts (see Section 1.8, for details) to render all the versions and files available from Section 1.2.
1.5.4. Version 2.1
In version 2.1, Chris Karakas added the following Chapters and Sections:
In Section 21.5: how to include two files side-by-side in a module.
1.5.5. General
Some quotes have been taken from the installation files of phpnuke.org, as well as from the MySQL manual.
In Section 25.3 we use material taken from A Brief Introduction to Regular Expressions.
The sections on mod_rewrite: Section 25.2.1, Section 25.2.2, Figure 25-2, Section 25.2.3 and Section 25.2.4 have been taken from the Apache Documentation of mod_rewrite.
Section 10.1 and part of Section 10.2 were taken from a post of Paul S. Owen, Development Team Leader of phpBB, in http://www.phpbb.com/phpBB/viewtopic.php?t=69493, as well as in http://www.phpbb.com/kb/article.php?article_id=54 and are included here with permission.
Figure 28-1 is taken from W3C's working draft CSS3 Paged Media Module, version of Dec. 18th 2003 and is Copyright © 2003 W3C (MIT, ERCIM, Keio), All Rights Reserved. Used with permission according to W3C document licence.
The examples for admonition in the Conventions Section (Section 1.7) were taken from the Section on admonitions of the DocBook Guide of the Debian Newbiedoc Project.
The CSS file for DocBook that is used in this document , ck-style.css, uses QBullets in links. See Explain CSS on how to do this. Thanks to Matterform Media for providing QBullets for free. If you plan to use them on your website, please observe the QBullets usage terms.
The CSS also got important elements from the Newbiedoc CSS file for DocBook and Mark Pilgrim's influential dive into Accessibility. The CSS font size controlling code and its explanation are taken from Using relative font sizes.