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