====== 'XDHBrwQ': 'XDHTML' in a web browser ======

===== Introduction =====
//xdhbrwq// is a tool from the //Epeios// project, which acts as a CGI program for the rendering of applications with an [[..:..:xdhtml:]] interface in web browsers.

#@OS_HTML~xdhbrwq~@#
===== Installation =====
See the [[computing:epeios:compilation:|compilation dedicated page]] to see how to obtain the binaries.

Two files called ''xdhbrwq.xcfg'' and ''xdhbrwq.xlcl'' have to be in the same directory as the one containing the binary.

Like all CGI programs, //xdhbrwq// interacts with an HTTP server software (like [[wp>Apache_HTTP_Server|Apache]]), through a PHP script (which looks more like a CGI program as //xdhbrwq//, although it's the latter which is truly the core of the CGI program). This script, called ''xdh.php'', is common to all //xdhtml//-based software, so you you have to put in the same directory as the one containing ''xdh.php'' another PHP script called ''//<target>//.xdh.php'' (''//<target>//'' is the target software, as defined below), which looks like:

<code php>
<?php
$host= "HOST";
$service = SERVICE;
?>
</code>

with ''//HOST//'', the host or IP address of the computer on which //xdhbrwq// is launched (usually ''**localhost**''), and ''//SERVICE//'', the port on which //xdhbrwq// listens to, as defined in the above mentioned //Configuration// section.

The ''xdh.php'' script is in the ''xdh'' directory of the //xdhbrwq// part of the application's package. This directory, or, at least, all its content, should be placed somewhere where it is accessible from your web server (i.e. generally in a directory referred as //htdocs//, or one of its subdirectory).

The URL to access the application is (''http'' could be ''https'', depending on your web server configuration) ''http:%%//%%//<address:port>//%%/%%//<path to>//%%/%%xdh.php?_prolog&_target=//<target>//&_action=//<action>//&_language=//<language>//'' with:

  * ''//<address:port>//'': the address and port of your web server (''//:port//'' is usually not required, if your web server is configured to use the standard one (80, or 443 for //https//)),
  * ''//<path to>//'': the path to the ''xdh.php'' file, from the server point of view (generally a path relative to a directory referred as //htdocs//), 
  * ''//<target>//'': the target application (usually specified in the application's documentation),
  * ''//<action>//'': the action (also specified in the application's documentation),
  * ''//<language>//'': the language, depending on which ones are available for the application  ; generally ''en'' and ''fr'' are always available.

===== Configuration =====

See the [[computing:epeios:configuration:|global configuration dedicated page]].

There is a ''Service'' entry in the ''Parameters'' section of the configuration file, which contains the default port to listen to. This value can be changed with the ''<service>'' command-line argument. See the [[.manual:|user manual]] for more details.

===== License =====
#@H_LICENSE_HTML~xdhbrwq~@#
===== Status =====
  * Last stable release: **yyyymmdd**
  * [[http://hg.savannah.gnu.org/hgweb/epeios/file/tip/tools/xdhbrwq/CHANGELOG.txt|Changelog]].

===== Download =====

There is no dedicated download section, as this tool is included in each package which needs it.

===== Author =====

#@H_AUTHOR_HTML~xdhbrwq~@#

===== Other resources =====
  * Source repository:
    * [[http://hg.savannah.gnu.org/hgweb/epeios/file/tip/tools/xdhbrwq/|of the tool]],
    * [[http://hg.savannah.gnu.org/hgweb/epeios/file/tip/stable|of the Epeios framework]], 
  * //xdhbrwq// is hosted((submission in progress: http://savannah.gnu.org/task/index.php?...)) on [[http://savannah.nongnu.org/projects/xdhbrwq|GNU Savannah]]((not active yet: see previous footnote.)) ; you will find there some other resources for this tool (bug tracking service, tech support manager...),
  * //xdhbrwq// is also on [[http://freshcode.club/projects/xdhbrwq|Freshcode]], with its own RSS/Atom feed to which you can subscribe to be informed when there are new releases.