Add documentation files and GitHub Actions workflow for deploying docs

[developersharif]

No description provided.

[gemini-code-assist]

Code Review

This pull request introduces a comprehensive documentation suite for the PHP GUI library using Docsify, covering installation, architecture, and usage examples. While the documentation is well-structured, several issues need to be addressed: there are broken links in the sidebar to missing widget documentation files, a missing architectural diagram (system.svg), and bugs in the provided code examples, such as the use of undefined variables and non-graceful application exits. Additionally, there are inconsistencies in the widget listings and a missing CSS file for the code-copying plugin.

[gemini-code-assist]

The code example uses an undefined variable $parent when creating the Button and Input widgets. This will cause a fatal error for anyone trying to run the example. Please define $parent or replace it with a valid parent widget ID, like $window->getId() from the preceding example.

Suggested change

	$button = new Button($parent, [
	'text' => 'Click',
	'command' => function() {
	echo "Clicked!\n";
	}
	]);
	// Input enter key
	$input = new Input($parent, ['text' => 'Type here...']);
	$input->onEnter(function() use ($input) {
	echo "Entered: " . $input->getValue() . "\n";
	});
	$button = new Button($window->getId(), [
	'text' => 'Click',
	'command' => function() {
	echo "Clicked!\n";
	}
	]);
	// Input enter key
	$input = new Input($window->getId(), ['text' => 'Type here...']);
	$input->onEnter(function() use ($input) {
	echo "Entered: " . $input->getValue() . "\n";
	});

[gemini-code-assist]

This section and the following ones list many widget documentation pages (e.g., Window.md, Button.md) that are not included in this pull request. This will result in broken links on the documentation site. Please either add these missing files or comment out the links until the pages are ready.

[gemini-code-assist]

The <img> tag references system.svg, but this file is not included in the pull request. This will result in a broken image in the documentation. Please add the SVG file to the repository.

[gemini-code-assist]

The Input widget is already listed, and there is no separate Entry widget class in the project. Listing Entry here is redundant and confusing for users. Please remove this line.

[gemini-code-assist]

The documentation states that the callback ID is written to /tmp/phpgui_callback.txt. However, the implementation uses sys_get_temp_dir() to determine the temporary directory, which is more portable. The documentation should be updated to reflect this for accuracy.

Suggested change

	2. The callback ID is written to `/tmp/phpgui_callback.txt`
	2. The callback ID is written to `phpgui_callback.txt` in the system's temporary directory.

[gemini-code-assist]

Using exit() directly can lead to an abrupt termination of the application, potentially skipping cleanup procedures defined in destructors. It's better to use the application's quit() method for a more graceful shutdown. The $app variable also needs to be passed into the closure's scope.

Suggested change

	$fileMenu->addCommand('Exit', function () {
	exit();
	}, ['foreground' => 'red']);
	$fileMenu->addCommand('Exit', function () use ($app) {
	$app->quit();
	}, ['foreground' => 'red']);

[gemini-code-assist]

This list includes Entry as a widget, but the library provides an Input widget that uses the Tcl entry widget. There is no separate Entry class. This is confusing for users. I recommend removing Entry from the list and adjusting the widget count for clarity. Also, Image is listed here but not in the sidebar, which is inconsistent.

Suggested change

	- **14 Widgets** — Window, Button, Label, Input, Entry, Frame, Canvas, Menu, Menubutton, Checkbutton, Combobox, Message, TopLevel, and Image
	- **13 Widgets** — Window, Button, Label, Input, Frame, Canvas, Menu, Menubutton, Checkbutton, Combobox, Message, TopLevel, and Image

[gemini-code-assist]

The docsify-copy-code plugin requires a CSS file for styling, which is missing. This can lead to incorrect styling for the "Copy" button. Please add the following line to the <head> section of this file to ensure the copy button is styled correctly:

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsify-copy-code/dist/style.css">