Disqus
======
The ``disqus`` directive allows embedding a `disqus comment widget `__
directly inline with other Runestone content.
The directive inserts a hyperlink to pre-defined threaded Disqus discussion.
Synopsis
--------
The general format of the ``disqus`` directive is:
.. code-block:: rst
.. disqus::
:shortname: Your registered shortname with disqus
:identifier: discussion1
The ``disqus`` directive does not use a content area or a unique id.
Required Arguments
------------------
shortname
Your registered shortname with ``disqus``.
The shortname will be used to link directly to your discussion on discuss::
https://' + disqus_shortname + '.disqus.com
identifier
A unique identifier for this discussion on ``disqus``.
Optional Arguments
------------------
No optional arguments are defined for this directive.
Languages supported
-------------------
Not applicable.
Sphinx configuration options
----------------------------
No directive specific configuration options exist.
Internationalization
....................
tbd.
Known limitations
-----------------
Using Disqus does present some security and privacy concerns.
See:
- the disqus blog about a `security breach `__
and a `writeup at hackernews `__.
- A Wikipedia article summarizing some general
`security concerns `__.
Examples
--------
.. tabbed:: example1
.. tab:: Source
.. literalinclude:: di_examples/disqus-ex1.txt
:language: rst
.. tab:: Try It
.. include:: di_examples/disqus-ex1.txt