Skip to content
/ docuss Public

A comment/discussion/collaboration system for websites and web apps

License

Notifications You must be signed in to change notification settings

sylque/docuss

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Docuss

A comment/discussion/collaboration system for websites and web apps.

This project is not active anymore.

You might want to check DiscPage, which shares a lot of features with Docuss.

Features

  • Add comments or full discussion topics to your web pages
  • Create menus or buttons with attached comments/discussions
  • Supports Wordpress out of the box

Live Demo

  • Mustacchio: a fake website demonstrating most Docuss features

Other Demos

  • WorDPress: a fake Wordpress blog, with comments added to Post headings and discussions added to Pages.
  • OpenStack: a single page from a live* website, with discussions added to each heading
  • Discuss The Web: a sample Meteor+React web app.

How It Works

Docuss allows to integrate your website (or web app) with Discourse, the popular open-source discussion platform. Docuss is composed of a plugin running in your Discourse forum and a JavaScript library running in your web pages.

Project Status

Docuss is in prototype phase. Please report any idea or issue in the above Issues tab.

How To Use It

"I just want to see if it really works"

  1. Set up your Discourse instance (see the installation manual here) with SSL (see SSL setup here).
  2. Install the Docuss plugin in your Discourse instance, and set it up with this JSON description file: https://sylque.github.io/dcs-client/demos/mustacchio/dcs-website.json
  3. You should see the Mustacchio demo running smoothly within your Discourse instance (with the exception of the menu bar, as explained here)

"I'm convinced, I want to integrate my website"

You will need:

  • A server running a Discourse instance (see the installation manual here).
  • A server hosting your website or web app.

Docuss installation:

  1. Add a Docuss client library to your website pages (if your website is a Wordpress blog, this can be done automatically for you by the dcs-wordpress-plugin).
  2. Create a JSON description file and host it alongside your website.
  3. Install the Docuss plugin in your Discourse instance and set it up with your JSON description file.

License

All Docuss components are released under the MIT license.




---
* Demos targeting live websites use a specific proxy server to inject a Docuss client library into pages. This proxy is not available yet.

About

A comment/discussion/collaboration system for websites and web apps

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published