Página inicial Explorar Ajuda
Registrar Entrar
im-changing.ru
/
converse.js
mirror de https://github.com/conversejs/converse.js.git
2
0
Fork 0
Arquivos Issues 0 Wiki
Ver código fonte

Update documentation

JC Brand 12 anos atrás
pai
ded2b23388
commit
edc578b8b7
7 arquivos alterados com 115 adições e 35 exclusões
Visão unificada Mostrar estatísticas do Diff
  1. BIN
      docs/doctrees/environment.pickle
  2. BIN
      docs/doctrees/index.doctree
  3. 39 11
      docs/html/_sources/index.txt
  4. 37 13
      docs/html/index.html
  5. BIN
      docs/html/objects.inv
  6. 0 0
      docs/html/searchindex.js
  7. 39 11
      docs/source/index.rst

BIN
docs/doctrees/environment.pickle
Ver arquivo


BIN
docs/doctrees/index.doctree
Ver arquivo


+ 39 - 11
docs/html/_sources/index.txt
Ver arquivo 

@@ -99,6 +99,8 @@ website. This will remove the need for any cross-domain XHR support.
 
 Server-side authentication
 
 Server-side authentication
 
 ==========================
 
 ==========================
 
 
 
+.. _`Session Support`:
 
+
 
 Pre-binding and Single Session Support
 
 Pre-binding and Single Session Support
 
 --------------------------------------
 
 --------------------------------------
 
 
 
@@ -110,7 +112,7 @@ Jack Moffitt has a great `blogpost`_ about this and even provides an `example Dj
 
 
 
 .. Note::
 
 .. Note::
 
    If you want to enable single session support, make sure to pass **prebind: true**
 
    If you want to enable single session support, make sure to pass **prebind: true**
 
-   when you call **converse.initialize** (see ./main.js).
 
+   when you call **converse.initialize** (see ./index.html).
 
 
 
 When you authenticate to the XMPP server on your backend, you'll receive two
 
 When you authenticate to the XMPP server on your backend, you'll receive two
 
 tokens, RID (request ID) and SID (session ID).
 
 tokens, RID (request ID) and SID (session ID).
 
@@ -153,21 +155,36 @@ connection object.
 
 Quickstart (to get a demo up and running)
 
 Quickstart (to get a demo up and running)
 
 =========================================
 
 =========================================
 
 
 
-When you download a specific release of *Converse.js*, say for example version 0.3,
 
-there will be two minified files inside the zip file.
 
-
 
-For version 0.3 they will be:
 
+When you download a specific release of *Converse.js* there will be two minified files inside the zip file.
 
 
 
-* converse.0.3.min.js
 
-* converse.0.3.min.css
 
+* converse.min.js
 
+* converse.min.css
 
 
 
-You can include these two files in your website via the *script* and *link*
 
+You can include these two files inside the *<head>* element of your website via the *script* and *link*
 
 tags:
 
 tags:
 
 
 
 ::
 
 ::
 
 
 
-    <link rel="stylesheet" type="text/css" media="screen" href="converse.0.3.min.css">
 
-    <script src="converse.0.3.min.js"></script>
 
+    <link rel="stylesheet" type="text/css" media="screen" href="converse.min.css">
 
+    <script src="converse.min.js"></script>
 
+
 
+Then, at the bottom of your page, after the closing *</body>* element, put the
 
+following inline Javascript code:
 
+
 
+::
 
+
 
+    <script>
 
+        converse.initialize({
 
+            auto_list_rooms: false,
 
+            auto_subscribe: false,
 
+            bosh_service_url: 'https://bind.opkode.im', // Please use this connection manager only for testing purposes
 
+            hide_muc_server: false,
 
+            i18n: locales.en, // Refer to ./locale/locales.js to see which locales are supported
 
+            prebind: false,
 
+            show_controlbox_by_default: true,
 
+            xhr_user_search: false
 
+        });
 
+    </script>
 
 
 
 The *index.html* file inside the Converse.js folder serves as a nice usable
 
 The *index.html* file inside the Converse.js folder serves as a nice usable
 
 example of this.
 
 example of this.
 
@@ -180,7 +197,7 @@ You'll most likely want to implement some kind of single-signon solution for
 
 your website, where users authenticate once in your website and then stay
 
 your website, where users authenticate once in your website and then stay
 
 logged into their XMPP session upon page reload.
 
 logged into their XMPP session upon page reload.
 
 
 
-For more info on this, read `Session Support`_.
 
+For more info on this, read: `Pre-binding and Single Session Support`_.
 
 
 
 You might also want to have more fine-grained control of what gets included in
 
 You might also want to have more fine-grained control of what gets included in
 
 the minified Javascript file. Read `Configuration`_ and `Minification`_ for more info on how to do
 
 the minified Javascript file. Read `Configuration`_ and `Minification`_ for more info on how to do
 
@@ -198,6 +215,9 @@ on your website.
 
 *Converse.js* is passed its configuration settings when you call its
 
 *Converse.js* is passed its configuration settings when you call its
 
 *initialize* method.
 
 *initialize* method.
 
 
 
+You'll most likely want to call the *initialize* method in your HTML page. For
 
+an example of how this is done, please see the bottom of the *./index.html* page.
 
+
 
 Please refer to the `Configuration variables`_ section below for info on
 
 Please refer to the `Configuration variables`_ section below for info on
 
 all the available configuration settings.
 
 all the available configuration settings.
 
 
 
@@ -358,6 +378,14 @@ CSS can be minimized with Yahoo's yuicompressor tool:
 
 Translations
 
 Translations
 
 ============
 
 ============
 
 
 
+.. Note :: 
+   Translations take up a lot of space and will bloat your minified file.
 
+   At the time of writing, the difference between *converse.min.js* and
 
+   *converse.min.no-locales.js* is about 50KB! Therefore, make sure to only
 
+   include those languages that you intend to support and remove from
 
+   ./locale/locales.js those which you don't need. Remember to rebuild the
 
+   minified file afterwards.
 
+
 
 The gettext POT file located in ./locale/converse.pot is the template
 
 The gettext POT file located in ./locale/converse.pot is the template
 
 containing all translations and from which for each language an individual PO
 
 containing all translations and from which for each language an individual PO
 
 file is generated.
 
 file is generated.

+ 37 - 13
docs/html/index.html
Ver arquivo 

@@ -115,7 +115,7 @@ properly configure and integrate it into your site.</p>
 
 webchat experience and that you have control over the data. The latter being a
 
 webchat experience and that you have control over the data. The latter being a
 
 requirement for many sites dealing with sensitive information.</p>
 
 requirement for many sites dealing with sensitive information.</p>
 
 <p>You&#8217;ll need to set up your own XMPP server and in order to have
 
 <p>You&#8217;ll need to set up your own XMPP server and in order to have
 
-<a href="#id24"><span class="problematic" id="id25">`Session Support`_</span></a> (i.e. single-signon functionality whereby users are authenticated once and stay
 
+<a class="reference internal" href="#session-support">Session Support</a> (i.e. single-signon functionality whereby users are authenticated once and stay
 
 logged in to XMPP upon page reload) you will also have to add some server-side
 
 logged in to XMPP upon page reload) you will also have to add some server-side
 
 code.</p>
 
 code.</p>
 
 <p>The <a class="reference internal" href="#what-you-will-need">What you will need</a> section has more information on all these
 
 <p>The <a class="reference internal" href="#what-you-will-need">What you will need</a> section has more information on all these
 
@@ -128,7 +128,7 @@ requirements.</p>
 
 <p><em>Converse.js</em> implements <a class="reference external" href="https://en.wikipedia.org/wiki/Xmpp">XMPP</a> as its messaging protocol, and therefore needs
 
 <p><em>Converse.js</em> implements <a class="reference external" href="https://en.wikipedia.org/wiki/Xmpp">XMPP</a> as its messaging protocol, and therefore needs
 
 to connect to an XMPP/Jabber server (Jabber is really just a synonym for XMPP).</p>
 
 to connect to an XMPP/Jabber server (Jabber is really just a synonym for XMPP).</p>
 
 <p>You can connect to public XMPP servers like <tt class="docutils literal"><span class="pre">jabber.org</span></tt> but if you want to
 
 <p>You can connect to public XMPP servers like <tt class="docutils literal"><span class="pre">jabber.org</span></tt> but if you want to
 
-have <a href="#id26"><span class="problematic" id="id27">`Session Support`_</span></a> you&#8217;ll have to set up your own XMPP server.</p>
 
+have <a class="reference internal" href="#session-support">Session Support</a> you&#8217;ll have to set up your own XMPP server.</p>
 
 <p>You can find a list of public XMPP servers/providers on <a class="reference external" href="http://xmpp.net">xmpp.net</a> and a list of
 
 <p>You can find a list of public XMPP servers/providers on <a class="reference external" href="http://xmpp.net">xmpp.net</a> and a list of
 
 servers that you can set up yourself on <a class="reference external" href="http://xmpp.org/xmpp-software/servers/">xmpp.org</a>.</p>
 
 servers that you can set up yourself on <a class="reference external" href="http://xmpp.org/xmpp-software/servers/">xmpp.org</a>.</p>
 
 </div>
 
 </div>
 
@@ -168,7 +168,7 @@ website. This will remove the need for any cross-domain XHR support.</p>
 
 <div class="section" id="server-side-authentication">
 
 <div class="section" id="server-side-authentication">
 
 <h2><a class="toc-backref" href="#id6">Server-side authentication</a><a class="headerlink" href="#server-side-authentication" title="Permalink to this headline">¶</a></h2>
 
 <h2><a class="toc-backref" href="#id6">Server-side authentication</a><a class="headerlink" href="#server-side-authentication" title="Permalink to this headline">¶</a></h2>
 
 <div class="section" id="pre-binding-and-single-session-support">
 
 <div class="section" id="pre-binding-and-single-session-support">
 
-<h3><a class="toc-backref" href="#id7">Pre-binding and Single Session Support</a><a class="headerlink" href="#pre-binding-and-single-session-support" title="Permalink to this headline">¶</a></h3>
 
+<span id="session-support"></span><h3><a class="toc-backref" href="#id7">Pre-binding and Single Session Support</a><a class="headerlink" href="#pre-binding-and-single-session-support" title="Permalink to this headline">¶</a></h3>
 
 <p>It&#8217;s possible to enable single-site login, whereby users already
 
 <p>It&#8217;s possible to enable single-site login, whereby users already
 
 authenticated in your website will also automatically be logged in on the chat server,
 
 authenticated in your website will also automatically be logged in on the chat server,
 
 but this will require custom code on your server.</p>
 
 but this will require custom code on your server.</p>
 
@@ -176,7 +176,7 @@ but this will require custom code on your server.</p>
 
 <div class="admonition note">
 
 <div class="admonition note">
 
 <p class="first admonition-title">Note</p>
 
 <p class="first admonition-title">Note</p>
 
 <p class="last">If you want to enable single session support, make sure to pass <strong>prebind: true</strong>
 
 <p class="last">If you want to enable single session support, make sure to pass <strong>prebind: true</strong>
 
-when you call <strong>converse.initialize</strong> (see ./main.js).</p>
 
+when you call <strong>converse.initialize</strong> (see ./index.html).</p>
 
 </div>
 
 </div>
 
 <p>When you authenticate to the XMPP server on your backend, you&#8217;ll receive two
 
 <p>When you authenticate to the XMPP server on your backend, you&#8217;ll receive two
 
 tokens, RID (request ID) and SID (session ID).</p>
 
 tokens, RID (request ID) and SID (session ID).</p>
 
@@ -209,17 +209,30 @@ connection object.</p>
 
 </div>
 
 </div>
 
 <div class="section" id="quickstart-to-get-a-demo-up-and-running">
 
 <div class="section" id="quickstart-to-get-a-demo-up-and-running">
 
 <h1><a class="toc-backref" href="#id8">Quickstart (to get a demo up and running)</a><a class="headerlink" href="#quickstart-to-get-a-demo-up-and-running" title="Permalink to this headline">¶</a></h1>
 
 <h1><a class="toc-backref" href="#id8">Quickstart (to get a demo up and running)</a><a class="headerlink" href="#quickstart-to-get-a-demo-up-and-running" title="Permalink to this headline">¶</a></h1>
 
-<p>When you download a specific release of <em>Converse.js</em>, say for example version 0.3,
 
-there will be two minified files inside the zip file.</p>
 
-<p>For version 0.3 they will be:</p>
 
+<p>When you download a specific release of <em>Converse.js</em> there will be two minified files inside the zip file.</p>
 
 <ul class="simple">
 
 <ul class="simple">
 
-<li>converse.0.3.min.js</li>
 
-<li>converse.0.3.min.css</li>
 
+<li>converse.min.js</li>
 
+<li>converse.min.css</li>
 
 </ul>
 
 </ul>
 
-<p>You can include these two files in your website via the <em>script</em> and <em>link</em>
 
+<p>You can include these two files inside the <em>&lt;head&gt;</em> element of your website via the <em>script</em> and <em>link</em>
 
 tags:</p>
 
 tags:</p>
 
-<div class="highlight-python"><pre>&lt;link rel="stylesheet" type="text/css" media="screen" href="converse.0.3.min.css"&gt;
 
-&lt;script src="converse.0.3.min.js"&gt;&lt;/script&gt;</pre>
 
+<div class="highlight-python"><pre>&lt;link rel="stylesheet" type="text/css" media="screen" href="converse.min.css"&gt;
 
+&lt;script src="converse.min.js"&gt;&lt;/script&gt;</pre>
 
+</div>
 
+<p>Then, at the bottom of your page, after the closing <em>&lt;/body&gt;</em> element, put the
 
+following inline Javascript code:</p>
 
+<div class="highlight-python"><pre>&lt;script&gt;
 
+    converse.initialize({
 
+        auto_list_rooms: false,
 
+        auto_subscribe: false,
 
+        bosh_service_url: 'https://bind.opkode.im', // Please use this connection manager only for testing purposes
 
+        hide_muc_server: false,
 
+        i18n: locales.en, // Refer to ./locale/locales.js to see which locales are supported
 
+        prebind: false,
 
+        show_controlbox_by_default: true,
 
+        xhr_user_search: false
 
+    });
 
+&lt;/script&gt;</pre>
 
 </div>
 
 </div>
 
 <p>The <em>index.html</em> file inside the Converse.js folder serves as a nice usable
 
 <p>The <em>index.html</em> file inside the Converse.js folder serves as a nice usable
 
 example of this.</p>
 
 example of this.</p>
 
@@ -229,7 +242,7 @@ practical.</p>
 
 <p>You&#8217;ll most likely want to implement some kind of single-signon solution for
 
 <p>You&#8217;ll most likely want to implement some kind of single-signon solution for
 
 your website, where users authenticate once in your website and then stay
 
 your website, where users authenticate once in your website and then stay
 
 logged into their XMPP session upon page reload.</p>
 
 logged into their XMPP session upon page reload.</p>
 
-<p>For more info on this, read <a href="#id28"><span class="problematic" id="id29">`Session Support`_</span></a>.</p>
 
+<p>For more info on this, read: <a class="reference internal" href="#pre-binding-and-single-session-support">Pre-binding and Single Session Support</a>.</p>
 
 <p>You might also want to have more fine-grained control of what gets included in
 
 <p>You might also want to have more fine-grained control of what gets included in
 
 the minified Javascript file. Read <a class="reference internal" href="#configuration">Configuration</a> and <a class="reference internal" href="#minification">Minification</a> for more info on how to do
 
 the minified Javascript file. Read <a class="reference internal" href="#configuration">Configuration</a> and <a class="reference internal" href="#minification">Minification</a> for more info on how to do
 
 that.</p>
 
 that.</p>
 
@@ -241,6 +254,8 @@ you&#8217;ll want to configure <em>Converse.js</em> to suit your needs before yo
 
 on your website.</p>
 
 on your website.</p>
 
 <p><em>Converse.js</em> is passed its configuration settings when you call its
 
 <p><em>Converse.js</em> is passed its configuration settings when you call its
 
 <em>initialize</em> method.</p>
 
 <em>initialize</em> method.</p>
 
+<p>You&#8217;ll most likely want to call the <em>initialize</em> method in your HTML page. For
 
+an example of how this is done, please see the bottom of the <em>./index.html</em> page.</p>
 
 <p>Please refer to the <a class="reference internal" href="#configuration-variables">Configuration variables</a> section below for info on
 
 <p>Please refer to the <a class="reference internal" href="#configuration-variables">Configuration variables</a> section below for info on
 
 all the available configuration settings.</p>
 
 all the available configuration settings.</p>
 
 <p>After you have configured <em>Converse.js</em>, you&#8217;ll have to regenerate the minified
 
 <p>After you have configured <em>Converse.js</em>, you&#8217;ll have to regenerate the minified
 
@@ -357,6 +372,15 @@ manager, NPM.</p>
 
 </div>
 
 </div>
 
 <div class="section" id="translations">
 
 <div class="section" id="translations">
 
 <h1><a class="toc-backref" href="#id23">Translations</a><a class="headerlink" href="#translations" title="Permalink to this headline">¶</a></h1>
 
 <h1><a class="toc-backref" href="#id23">Translations</a><a class="headerlink" href="#translations" title="Permalink to this headline">¶</a></h1>
 
+<div class="admonition note">
 
+<p class="first admonition-title">Note</p>
 
+<p class="last">Translations take up a lot of space and will bloat your minified file.
 
+At the time of writing, the difference between <em>converse.min.js</em> and
 
+<em>converse.min.no-locales.js</em> is about 50KB! Therefore, make sure to only
 
+include those languages that you intend to support and remove from
 
+./locale/locales.js those which you don&#8217;t need. Remember to rebuild the
 
+minified file afterwards.</p>
 
+</div>
 
 <p>The gettext POT file located in ./locale/converse.pot is the template
 
 <p>The gettext POT file located in ./locale/converse.pot is the template
 
 containing all translations and from which for each language an individual PO
 
 containing all translations and from which for each language an individual PO
 
 file is generated.</p>
 
 file is generated.</p>

BIN
docs/html/objects.inv
Ver arquivo


Diferenças do arquivo suprimidas por serem muito extensas
+ 0 - 0
docs/html/searchindex.js


+ 39 - 11
docs/source/index.rst
Ver arquivo 

@@ -99,6 +99,8 @@ website. This will remove the need for any cross-domain XHR support.
 
 Server-side authentication
 
 Server-side authentication
 
 ==========================
 
 ==========================
 
 
 
+.. _`Session Support`:
 
+
 
 Pre-binding and Single Session Support
 
 Pre-binding and Single Session Support
 
 --------------------------------------
 
 --------------------------------------
 
 
 
@@ -110,7 +112,7 @@ Jack Moffitt has a great `blogpost`_ about this and even provides an `example Dj
 
 
 
 .. Note::
 
 .. Note::
 
    If you want to enable single session support, make sure to pass **prebind: true**
 
    If you want to enable single session support, make sure to pass **prebind: true**
 
-   when you call **converse.initialize** (see ./main.js).
 
+   when you call **converse.initialize** (see ./index.html).
 
 
 
 When you authenticate to the XMPP server on your backend, you'll receive two
 
 When you authenticate to the XMPP server on your backend, you'll receive two
 
 tokens, RID (request ID) and SID (session ID).
 
 tokens, RID (request ID) and SID (session ID).
 
@@ -153,21 +155,36 @@ connection object.
 
 Quickstart (to get a demo up and running)
 
 Quickstart (to get a demo up and running)
 
 =========================================
 
 =========================================
 
 
 
-When you download a specific release of *Converse.js*, say for example version 0.3,
 
-there will be two minified files inside the zip file.
 
-
 
-For version 0.3 they will be:
 
+When you download a specific release of *Converse.js* there will be two minified files inside the zip file.
 
 
 
-* converse.0.3.min.js
 
-* converse.0.3.min.css
 
+* converse.min.js
 
+* converse.min.css
 
 
 
-You can include these two files in your website via the *script* and *link*
 
+You can include these two files inside the *<head>* element of your website via the *script* and *link*
 
 tags:
 
 tags:
 
 
 
 ::
 
 ::
 
 
 
-    <link rel="stylesheet" type="text/css" media="screen" href="converse.0.3.min.css">
 
-    <script src="converse.0.3.min.js"></script>
 
+    <link rel="stylesheet" type="text/css" media="screen" href="converse.min.css">
 
+    <script src="converse.min.js"></script>
 
+
 
+Then, at the bottom of your page, after the closing *</body>* element, put the
 
+following inline Javascript code:
 
+
 
+::
 
+
 
+    <script>
 
+        converse.initialize({
 
+            auto_list_rooms: false,
 
+            auto_subscribe: false,
 
+            bosh_service_url: 'https://bind.opkode.im', // Please use this connection manager only for testing purposes
 
+            hide_muc_server: false,
 
+            i18n: locales.en, // Refer to ./locale/locales.js to see which locales are supported
 
+            prebind: false,
 
+            show_controlbox_by_default: true,
 
+            xhr_user_search: false
 
+        });
 
+    </script>
 
 
 
 The *index.html* file inside the Converse.js folder serves as a nice usable
 
 The *index.html* file inside the Converse.js folder serves as a nice usable
 
 example of this.
 
 example of this.
 
@@ -180,7 +197,7 @@ You'll most likely want to implement some kind of single-signon solution for
 
 your website, where users authenticate once in your website and then stay
 
 your website, where users authenticate once in your website and then stay
 
 logged into their XMPP session upon page reload.
 
 logged into their XMPP session upon page reload.
 
 
 
-For more info on this, read `Session Support`_.
 
+For more info on this, read: `Pre-binding and Single Session Support`_.
 
 
 
 You might also want to have more fine-grained control of what gets included in
 
 You might also want to have more fine-grained control of what gets included in
 
 the minified Javascript file. Read `Configuration`_ and `Minification`_ for more info on how to do
 
 the minified Javascript file. Read `Configuration`_ and `Minification`_ for more info on how to do
 
@@ -198,6 +215,9 @@ on your website.
 
 *Converse.js* is passed its configuration settings when you call its
 
 *Converse.js* is passed its configuration settings when you call its
 
 *initialize* method.
 
 *initialize* method.
 
 
 
+You'll most likely want to call the *initialize* method in your HTML page. For
 
+an example of how this is done, please see the bottom of the *./index.html* page.
 
+
 
 Please refer to the `Configuration variables`_ section below for info on
 
 Please refer to the `Configuration variables`_ section below for info on
 
 all the available configuration settings.
 
 all the available configuration settings.
 
 
 
@@ -358,6 +378,14 @@ CSS can be minimized with Yahoo's yuicompressor tool:
 
 Translations
 
 Translations
 
 ============
 
 ============
 
 
 
+.. Note :: 
+   Translations take up a lot of space and will bloat your minified file.
 
+   At the time of writing, the difference between *converse.min.js* and
 
+   *converse.min.no-locales.js* is about 50KB! Therefore, make sure to only
 
+   include those languages that you intend to support and remove from
 
+   ./locale/locales.js those which you don't need. Remember to rebuild the
 
+   minified file afterwards.
 
+
 
 The gettext POT file located in ./locale/converse.pot is the template
 
 The gettext POT file located in ./locale/converse.pot is the template
 
 containing all translations and from which for each language an individual PO
 
 containing all translations and from which for each language an individual PO
 
 file is generated.
 
 file is generated.

Alguns arquivos não foram mostrados porque muitos arquivos mudaram nesse diff