OpenLLM-France/wikimedia huggingface dataset:
# PHP Programming/phpDocumentor

phpDocumentor is a tool for automatically generating easily readable documentation for a piece of software using inline comments.

## Why use phpDocumentor?

The ideal documentation has two properties. First, it should be easy to maintain and keep up to date. Secondly, it should be easy for the reader to read and navigate the document. These are often contradictory goals. By using tools just as javadoc and phpDocumentor, you can achieve both. When writing the documentation, you simply insert special comments in your code. phpDocumentor will then parse your code an generate easy-to-use documentation in HTML, DocBook, or PDF.

## Basic Usage

The comments which are picked up by phpDocumentor are C-style comments with two asterisks in the opening tag.
These are known as DocBlock comments. By placing this before an element in your code, phpDocumentor will generate documentation for that element. For example, if I want to document the "RhesusMacaque" class, I would place a DocBlock immediatley before it.
See elements documented by phpDocumentor.

## Format of a phpDocumentor comment

There are three sections to a phpDocumentor DocBlock. The first is a short summary of the code element, which should be no more than a sentence. Next is a few sentences describing the element in more detail, which are optional. Finally, there is a sequence of tags.

## Tags

Tags can be inserted into DocBlocks to describe certain parts of a code element in more detail. They provide data such as the return type of a function, or the author of a piece of code. They are marked by an '@' symbol, and take the form
Each element type has a different set of tags which describe it. See elements documented by phpDocumentor.

## Generating Documentation

A command such as
will generate documentation from the PHP files found in /var/www/app.
For a complete list of output formats, see the PhpDocumentor website.
Note that the value of the output parameter is case-sensitive.

### Errors
#### Converter HTMLsmartyConverter specified by --output command-line option is not a class

    The 's' in 'smarty' should be uppercase.

#### template directory "/var/www/pear/PhpDocumentor/phpDocumentor/Converters/HTML/Smarty/templates/php/" does not exist

    The 'php' should be uppercase.

## External Links

* phpDocumentor homepage
* phpDOC homepage
# PHP and MySQL Programming
## Table of Contents

PHP
* Introduction to PHP
* Syntax Overview
* File Handling
* Database Connectivity
* Session Handling
* Command Line Programming
* Form Handling
MySQL
* Introduction to MySQL
* Creating a Database
* Creating a Table
* Basic Queries
* Common Functions and Operators
Advanced Topics
* XML and PHP
# PHP Programming/headers and footers

Create the header and footer files:
Create a file called "header.php" and enter the html code that you'd like at the top of each page as follows:
Create a file called "footer.php" and enter the html code that you'd like at the bottom of each page as follows:
Now we will create a web page that uses these headers and footers. Create a file called "page.php" and enter the following html code:
We set the title for the page using (1) We then include the header page using (2) And we include the footer page using (3)
The final page should look like this:
Files included in this way act as if their text was inserted into the main document right at the include call. PHP then continues to process the inserted file, allowing the inserted file to access all previously defined variables and functions (so $title in header.php was replaced with the value set in page.php: "Welcome"). This can have unintended consequences if a file is included more than once. To learn how to correctly include files containing functions and classes, see PHP Include Files.
# PHP Programming/formatting notes

Commenting in PHP is simple and effective.
Writing notes to yourself, within your code, is the only way to keep track of a large file. Coming back to an uncommented 300-line page of code can be a nightmare.
To insert a single line comment within php code type // before the line. To insert a multi-line comment within code start the comment with /* and end it with */. For example:
# PHP and MySQL Programming/Basic Queries
## Introduction

Here are a few basic queries to get you going. For more detailed information, have a look at the online documentation on the MySQL website http://dev.mysql.com/doc/refman/5.1/en/index.html .

## SELECT

The SELECT query is the standard means by which to retrieve information from the database. The syntax for the SELECT query is as follows:
Example:

## INSERT

The INSERT statement is used to insert data into a particular table of a database. The Syntax is as follows:
Example:

## DELETE

The DELETE statement is used to remove row(s) from a table. The syntax is as follows:
Example:

## ALTER

ALTER is used to modify the structure of a table. Here is the syntax for ALTER:

## DROP

DROP is used to completely remove a table or database. The syntax is as follows:

## TRUNCATE

TRUNCATE is used when you want to remove the data, but not the structure of a table. The syntax is as follows:
# PHP and MySQL Programming/Command Line Programming

PHP was traditionally used to help web administrators automate various mundane tasks and to add dynamism to the web pages. However, PHP (in its modern incarnation) is capable of much more. It is now being used in ways traditional programming languages are used. It is now possible to remove PHP applications from the constraints of the Internet server. Now, PHP is being used to write GUI applications as well as command line applications. We shall now look at writing PHP applications for the command line.

## Getting the PHP-CLI

If you are running Linux, you should get the corresponding package for the PHP-CLI. In Debian, it is just a matter of typing:
In Windows, the CLI should be included with the PHP files. Refer to http://www.php-cli.com/ and http://www.php.net for more help.

## Initial Considerations

We start off our command line applications with the following line:
Note: You do not include this line in Windows!
This should be the first line of the file, as it tells Linux which interpreter to use for the file.
The next thing you should do, is to make the file executable. This is done by the following Unix command:

## Getting Keyboard Input

In order for us to retrieve keyboard input from the command line, we will need to use a little trick. Basically, we create a file handler to a special file called the Standard Input.
Here is the code to create this file handler:
We can now use $stdin just as if it were a normal file that we had opened for reading. (We obviously could not write to it, as it is Standard INPUT).
Here is a useful function to get user input:

## Output Formatting

The main consideration to make when formatting output in command line programming as opposed to generating HTML output is that a new line is not created by a tag, in fact, any HTML tags you put into the output, will simply be displayed as plain text.
In order to create a new line in the command line, we need to use a control character, \n . Another useful function when doing command line programming is this:

## External Resources and Links

PHP CLI - ALL about running PHP script from command line: tutorials, options, examples, PHP CLI and PHP CGI difference.
# PHP and MySQL Programming/Creating a Database
## Introduction

MySQL is a relational database. In a relational database, data is stored as a collection of fields called a row. Like fields, rows are in turn collectively stored as a table. Tables are stored collectively in a database. One MySQL server can store multiple databases, and have users who have various rights to each database.
Nowadays, MySQL is one of the most popular relational databases among others as it is simple, free (open source), easy to maintain, and cost-effective.
In order to store data into MySQL, we will need to prepare a space in MySQL for a database.

## SQL Code

The code for creating such a database in SQL (Structured Query Language) is a simple query:
(Without the ' ' single quotes around the database name)

## Using the Database

After a database has been created, you have to tell MySQL that to make it the active database before you can start running further queries on it. You do this as follows:
# PHP and MySQL Programming/Creating a Table

Before creating a table, please read the previous section on Creating a Database.
A Table resides inside a database. Tables contain rows, which are made up of a collection of common fields or columns. Here is a sample output for a SELECT * query:
As you can see, We have rows (horizontal collection of fields), as well as columns (the vertical attributes and values).

## Creating a Table

The SQL code for creating a table is as follows:

## Example

Here is an example of creating a table called `books`:

## Getting Information about Tables

To get a list of tables:
Which produces the following output:
To show the CREATE query used to create the table:
Which produces the following output:
And then to show the same information, in a tabulated format:
Which produces the following output:
# Pinyin/Alaska

Alaska is a state of the United States. It is in the northwest of North America. Its population is 742 thousand. Its capital is Juneau.
Alaska shì Měiguó de yīgè zhōu. Tā zài Běiměi de xīběibù. Tā de rénkǒu shì 74.2 wàn. Tā de shǒufǔ shì Juneau.
# Pinyin/Albania

Albania is a country in the south of Europe. Its population is 2.9 million. Its capital is Tirana.
Albania shì yīgè zài Ouzhou nánbù de guójiā. Tā de rénkǒu shì 290 wàn. Tā de shǒudū shì Tirana.
# Pinyin/Alibaba

Search Alibaba
# Pinyin/All Saints' Day

See also All Saint's Day
See also saint
# Pinyin/Airport

See also
# Pinyin/Alcohol

Drinking alcohol is common in social meetings. But, it can cause drunkenness, intoxication and addiction, which are harmful to heath and the society.
Yǐnjiǔ shì chángjiàn de shèjiāo jùhuì. Dànshì, huì dǎozhì zuìjiǔ, zhòngdú hé shàngyǐn, duì jiànkāng hé shèhuì yǒuhài.
Drinking often can cause long-term and acute diseases, such as liver hardening and heart attack.
Jīngcháng yǐnjiǔ huì dǎozhì mànxìng hé jíxìngbìng, rú gānyìnghuà hé xīnzàngbìngfā.
# Pinyin/Alien planet

Search Pinyin planet
# Pinyin/All

* quarnbuh
* dou
# Persian/Lesson 8/man
#### People - İnsanlar

Here are some basic words about people, their body and personal details. Here it goes!
| man | adam or erkek |
| woman | kadın |
| child | çocuk |
| people | insanlar |

##### Body - Vücut

Here is the review of body which is in alphabetical order. Here it goes!
| arm | kol |
| back | geri |
| brain | beyin |
| breast | göğsü |
| cheek | yanak |
| chin | çene |
| ear | kulak |
| eye | göz |
| feet | ayak |
| finger | parmak |
| hair | saç |
| hand | el |
| head | kafa |
| heart | yürek (in accusative "yüreği) |
| knee | diz |
| leg | bacak |
| liver | karaciğer |
| lungs | akciğer |
| mouth | ağız |
| nose | burun |
| shoulder | omuz |
| spine | omurga |
| stomach | göbek "or" mide |
| throat | boğaz ("boğaz" when it is written like "Boğaz", which is the short type of "İstanbul Boğazı", means "Bosporus" and "İstanbul Boğazı" literally means "Istanbul's throat") |
| teeth | diş |

##### Personal details - Kişisel bilgiler

Here are some basic personal details that every person in Turkey, France, Croatia, Russia and everywhere in the world has. Like: birthday, gender, ID. Some of these thing are written in passports and other documents. You can also speak about them with person who you met or will meet in Turkey some day, like birthplace or profession. Here it goes!
| birthdate | doğum tarihi |
| birthday | doğum günü |
| name | ad |
| surname | soyadı |
| age | yaş |
| gender | seks |
| male | erkek |
| female | kadın |
| birthplace | doğum yeri |
| qualifications | nitelikleri |
| profession | meslek |
| residence | konut |
| marital status | medeni durum |
| married | evli |
| not married | evlenmemiş |
| widow | dul |
| nationality | vatandaşlık |
| identity card | kimlik |

#### In context - Bağlamında

Here will be some sentences in Turkish which will contain those words above.
1. A women is walking with the baby. - Bir kadın çocukla yürüyor.
2. Cemile'nin saçı kahverengi ve onun gözleri mavi. Burunu küçük ve dar. Onun parmakları kısa, bacakları güzel ve uzun. - Cemile's hair is brown and her eyes are blue. Her nose is small and naroww. Her fingers are small, her legs are nice and long.
3.
# Persian/Lesson 8

| | فارسی (‹fârsi›, “Persian”) Learn the Persian language Contents • Introduction Persian Alphabet lessons: 1 ( ۱ ) • 2 ( ۲ ) • 3 ( ۳ ) • 4 ( ۴ ) Elementary grammar: 5 ( ۵ ) • 6 ( ۶ ) • 7 ( ۷ ) • 8 ( ۸ ) • 9 ( ۹ ) 10 ( ۱۰ ) • 11 ( ۱۱ ) • 12 ( ۱۲ ) • 13 ( ۱۳ ) • 14 ( ۱۴ ) • 15 ( ۱۵ ) Intermediate: 16 ( ۱۶ ) • 17 ( ۱۷ ) • 18 ( ۱۸ ) • 19 ( ۱۹ ) • 20 ( ۲۰ ) 21 ( ۲۱ ) • 22 ( ۲۲ ) • 23 ( ۲۳ ) • 24 ( ۲۴ ) • 25 ( ۲۵ ) • 26 ( ۲۶ ) Advanced: Appendix: Alphabet • Glossary • Handwriting |
| To continue, your computer must display Persian. The box below should show these Persian letters on the far right: ا ب پ ت ث ج چ ح خ د ذ ر ز ژ س ش ص ض ط ظ ع غ ف ق ک گ ل م ن و ه ی If they are different or in the wrong order, see Persian Computing. |||
In this lesson, you will learn how to create and use the negative of Persian verbs.

## Dialogue: ... ‹...›

... and... are talking....
| X: | ‹....› “....” | ... Missing audio. If you are fluent in Persian, record and upload your voice. | ...: |
| Y: | ‹...› “...” | ... Missing audio. If you are fluent in Persian, record and upload your voice. | ...: |
Explanation
    ... and ....
Vocabulary
* {{{1}}} ‹{{{2}}}› IPA: [[:Media:fa-{{{1}}}.ogg|{{{3}}}]]

## Negation

Negative particle ن ‹na-› takes the stress and prefixes conjugated verb, not the invariant part

## Negative copula

* نیستم ‹nistam› (“I am not”)
* نیستی ‹nisti› (“you are not”)
* نیست ‹nist› (“ he/she/it is not”), colloquially pronounced ‹nis›
* نیستیم ‹nistim› (“ we are not”)
* نیستید ‹nistid› (“you are not”)
* نیستند ‹nistand› (“they are not”), colloquially pronounced ‹nistan›

## Other negative words

* هیچ ‹hic› (“none, not at all”)

## Exercises

درس 8 و
    مرد – man (man)
    زن – vrouw (woman)
    تند - snel (fast)
    دوات – inktpot (inkwell)
    پروين – Parvin (meisjesnaam) (girls name)
    پرويز – Parviz (jongensnaam) (boys name)
    نانوا – bakker (baker)
    دويدن – rennen (hele werkwoord) (running)
    مي دود – hij rent, zij rent (he, she runs)
    بيرون – uit, buiten (out)
    مي پزد – hij kookt, zij kookt (he, she cooks)
    پختن- - koken, bakken (hele werkwoord) (cooking, baking)
    اين دوات است – dit is een inktpot (this is an inkwell)
    پرويز با پروين دوست است – Parvin is met Parviz bevriend
    اين مرد نانوا است – die mijnheer is bakker
    نانوا نان مي پزد – de bakker bakt brood
    آن مرد از نانوائي تند آمد – die man komt snel uit de bakkerij
    پرويز با پروين دوست است

## Next: Lesson 9 ( ۹ ), Plural nouns

Continue to Lesson 9 ( ۹ ), Plural nouns >>
* Contents • Introduction
* Persian Alphabet lessons: 1 ( ۱ ) • 2 ( ۲ ) • 3 ( ۳ ) • 4 ( ۴ )
* Elementary grammar: 5 ( ۵ ) • 6 ( ۶ ) • 7 ( ۷ ) • 8 ( ۸ ) • 9 ( ۹ )
* 10 ( ۱۰ ) • 11 ( ۱۱ ) • 12 ( ۱۲ ) • 13 ( ۱۳ ) • 14 ( ۱۴ ) • 15 ( ۱۵ )
* Intermediate: 16 ( ۱۶ ) • 17 ( ۱۷ ) • 18 ( ۱۸ ) • 19 ( ۱۹ ) • 20 ( ۲۰ )
* 21 ( ۲۱ ) • 22 ( ۲۲ ) • 23 ( ۲۳ ) • 24 ( ۲۴ ) • 25 ( ۲۵ ) • 26 ( ۲۶ )
* Advanced:
* Appendix: Alphabet • Glossary • Handwriting
This section of the Persian Language Wikibook is a stub. You can help Wikibooks by expanding it. (See the Persian course Planning page.)
# Persian/Lesson 22

22
    - Mijnheer
    خانم - Mevrouw
    دوشیزه - Mejuffrouw
    بله - Ja
    خوانا - Leesbaar
    نه - Nee
    سلام - Hallo
    صبح بخیر - Goedemorgen
    ظهربخیر - Goedemiddag
    عصر بخیر - Goedenavond
    شب بخیر - Goedenacht
    خداحفظ - Tot ziens
    خواهش میکنم - Alstublieft
    متشکرم - Dank u wel
    خیلی ممنون - dank u wel
    مرسی - merci
    ببخشید - Pardon
    حال شما چطورید - Hoe gaat het met u
    خیلی خوب، متشکرم - Heel goed, dank u wel
    اجزه هست - Is het toegestaan
    بفرمایید - Ga uw gang
Exercise on this lesson (experimental)
# Persian/Persian Computing
## Reading Persian on the Internet

If the following text appears as nonsense or boxes, you may need to enable Persian on your computer:
* زبان فارسی
Sometimes it is necessary to make a page display properly by manually changing the encoding of the browser. In Firefox, follow View, Character Encoding, More Encodings, Middle Eastern and then Farsi.

## Typing in Persian
### Windows XP

To enable typing in Persian in Windows XP, follow these steps. You will need administrator rights on the computer on which you wish to enable Persian typing, therefore if you are on a network (such as at work, University or school) you may need to contact your network administrator. You may also be prompted to insert your Windows disk.
1. Go to Start, then go to the Control Panel and click on Date, Time, Language and Regional Options. 2. Click on "Add other Languages". 3. Click on Details. 4. Click on Add. 5. Select Input method as "Farsi" and for Keyboard layout/IME select "Farsi" from the menus.
The language bar will appear on your screen, enabling you to switch between Persian and your default or other languages. If you do not have the Persian alphabet on your keyboard, and only have a Latin alphabet, you can use the on screen keyboard to input Persian. The on-screen keyboard can be found by following Start then clicking on Accessories, Accessibility and On-Screen keyboard. It is also possible to buy Persian keyboard stickers, or you may find that you can memorize the positions of the varios letters.

### Linux
## Joiners
### Zero-Width Joiner (ZWJ)

This section of the Persian Language Wikibook is a stub. You can help Wikibooks by expanding it. (See the Persian course Planning page.)
* Contents • Introduction
* Persian Alphabet lessons: 1 ( ۱ ) • 2 ( ۲ ) • 3 ( ۳ ) • 4 ( ۴ )
* Elementary grammar: 5 ( ۵ ) • 6 ( ۶ ) • 7 ( ۷ ) • 8 ( ۸ ) • 9 ( ۹ )
* 10 ( ۱۰ ) • 11 ( ۱۱ ) • 12 ( ۱۲ ) • 13 ( ۱۳ ) • 14 ( ۱۴ ) • 15 ( ۱۵ )
* Intermediate: 16 ( ۱۶ ) • 17 ( ۱۷ ) • 18 ( ۱۸ ) • 19 ( ۱۹ ) • 20 ( ۲۰ )
* 21 ( ۲۱ ) • 22 ( ۲۲ ) • 23 ( ۲۳ ) • 24 ( ۲۴ ) • 25 ( ۲۵ ) • 26 ( ۲۶ )
* Advanced:
* Appendix: Alphabet • Glossary • Handwriting
# Photography Equipment/DSLR Bodies

The body of a DSLR is the heart of the system, in the sense that it is the primary interface and that one generally has a single body (sometimes two), but many lenses. This is not to say that the body (or the sensor) is more important than the lens (indeed, the opposite in the case), but simply less variable.

## Canon and Nikon

Both brands segment their line by price/target audience, and replace models on an approximately 2 year cycle. The entry-level DSLRs are the biggest sellers by a large margin.
The current ranges are:
| | Canon | Nikon |
| Entry-level | 1100D/Rebel T3 / 600D/Rebel T3i | D40 / D60 / D5000 |
| Prosumer/Enthusiast | 60D / 7D | D90 / D300 |
| Semi-professional (Full-frame) | 5D Mark II | D700 |
| Professional : High-speed | 1D Mark IV | D3 |
| Professional | 1Dx | D3X |
Notice that Canon model numbers are of the form "40D", while Nikon model numbers are of the form "D40".
For history, see table of Canon DSLRs and table of Nikon DSLRs, and glosses at Canon EOS DSLRs, Canon EOS model naming scheme and list of Nikon DSLRs.

## References

* ↑ This table should not be read to mean that the corresponding cameras are directly comparable or even the closest competitors, but rather that this is how the manufacturers segment their lines.
* ↑ At first Canon also used a D- prefix, in the D30 and D60, but switched to a -D suffix with the 1D, presumably to reduce confusion with Nikon models.
# Photography Equipment/Lenses/Overview
## Standard Lenses

As a standard lens, most commonly people use the zoom lens that is included with the DSLR body (called the kit lens). Indeed, many people use no other lenses, and thus reap relatively little benefit from a DSLR. Others decry this practice and suggest instead that one use a (prime) normal lens.

## References

* ↑ http://photo.net/equipment/building-a-digital-slr-system/
# Photography Equipment/Canon and Nikon

Canon and Nikon are the two dominant DSLR makers as of 2007, and have been for a number of years. They are both excellent brands, and both have large followings. That said, they are incompatible (ones lenses don't work on the others body), and in building a collection of equipment, you will choose one or the other. It makes a difference, but not a great one, and after committing to a system, many develop a love-hate relationship with the manufacturer. Some differences are detailed below.

## How to choose?

    This is also applicable to non-Canon/Nikon systems.
Most importantly, you are choosing a system, not a body. Instead of thinking about minor differences between current bodies, consider which lenses and bodies you expect to be using over the next 10 or 20 years. This is admittedly difficult when starting off, but lenses last decades, and it is prohibitively expensive to switch between systems or have two parallel sets of equipment: switching systems is a major decision.
Ideally, consider what kind of photography you are likely to do or may do for the foreseeable future, and how each system fits it. What equipment would you get initially? Over the next few years? Further down the road?
Also, actually test out both systems: some people fall in love with the Nikon feel, for instance.

## Bodies

Broadly, Canon is generally averred to produce higher IQ bodies at lower prices, while Nikon cameras are considered more enjoyable to use.

### Canon

* better image quality
** full-frame sensors
** less noise, especially at high ISOs
* cheaper
Canon has had full-frame sensor cameras since 2001, with the 1D. As of 2008, Nikon has just introduced a full-frame camera, the D3.
Canon's DSLRs have traditionally been cheaper than comparable Nikons, but Nikon's D40 is rather cheaper than Canon's 400D.

### Nikon

* better physical feel
* better software UI

## Lenses

Both produce an extensive (which is not to say complete) range of lenses, unlike the other DSLR manufacturers. Both have individual lenses with strong followings; below are notable classes of lenses that they each make.

### Canon

* Sports lenses (fast super telephotos)
    Canon's white super telephoto lenses are instantly recognizable at sports events.
* T/S: 3 currently
    against Nikon's having had none, and having introduced 1 in 2008

### Nikon

* Largest lineup
    Because Nikon retained the F-mount, every lens they've made still works, in contrast to Canon, whose EOS system of 1987 broke backwards compatibility.

## References

* ↑ Such as Thom Hogan's with Nikon, as at If I ran Nikon. A similar article could be written for Canon.
* photo.net
* Ken Rockwell