xmpp.chapril.org-conversejs/docs/source/index.rst

55 lines
1.6 KiB
ReStructuredText
Raw Permalink Normal View History

2018-09-18 10:53:43 +02:00
.. Converse documentation master file, created by
2013-04-26 21:01:39 +02:00
sphinx-quickstart on Fri Apr 26 20:48:03 2013.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
.. raw:: html
<div id="banner"><a href="https://github.com/jcbrand/converse.js/blob/master/docs/source/index.rst">Edit me on GitHub</a></div>
2018-09-18 10:53:43 +02:00
======================
Converse Documentation
======================
Preface
=======
2018-09-18 10:53:43 +02:00
This is the official documentation for Converse. If you'd like to
contribute, please read the :doc:`documentation` page.
Introduction
============
Converse is a free and open-source `XMPP <https://xmpp.org/about-xmpp/>`_
2017-09-03 22:12:17 +02:00
chat client written in JavaScript which can be tightly integrated into any website.
The benefit of using converse.js as opposed to relying on a SaaS
(software-as-a-service) solution, is that your users can have a much more
customized, streamlined and integrated webchat experience and that you have
control over the data. The latter being a requirement for many sites dealing
with sensitive information.
You'll likely want users who are authenticated on your website, to also
automatically be authenticated on the XMPP server. In order to do this, you'll
have to add some server-side code for your website.
The :ref:`what-you-will-need` and :ref:`session-support` sections provide more information on how to achieve this.
Table of Contents
=================
.. toctree::
:maxdepth: 2
quickstart
features
setup
session
configuration
development
theming
security
translations
troubleshooting
documentation