Skip to content
Normal view History Permalink
README.md 1.07 KiB
Newer Older
realitygaps's avatar
Initial commit
realitygaps committed
1 2 
# Embed codimd pads into Discourse for libreho.st
how's avatar
v0.1.0  
how committed
3 
This allows you to embed libreho.st pads into discourse. It is based on https://github.com/fuerst/embed-etherpad-lite which embeds pads into posts using the Onebox mechanism.
realitygaps's avatar
Initial commit
realitygaps committed
4 5 6 

# Usage
how's avatar
v0.1.0  
how committed
7 8 9 
**This is meant to use with <https://talk.libreho.st>. You need to fork and adapt to your case.**

After installation just insert codimd links into your Discourse posts or comments. The pad will be embedded using the famous and beloved [IFRAME](https://en.wikipedia.org/wiki/HTML_element#Frames) tag and is fully operational.
realitygaps's avatar
Initial commit
realitygaps committed
10 11 12 13 14 15 16 17 18 19 20 21 22 

# Installation

Read [Install a Plugin](https://meta.discourse.org/t/install-a-plugin/19157) at meta.discourse.org.

The configuration line you have to add to your container's app.yml file looks like:

```
- git clone https://lab.libreho.st/librehosters/embed-codimd.git
```

# Details
how's avatar
v0.1.0  
how committed
23 
The plugin uses the ["Brand new plugin interface"](https://meta.discourse.org/t/brand-new-plugin-interface/8793/88) to change URL's like `http(s)://domain.example/pad-id` into HTML code like `<iframe src='http(s)://domain.example/pad-id'></iframe>`.