Skip to content

Add ability to right yUML diagrams directly into a discourse post.

License

Notifications You must be signed in to change notification settings

sekhat/discourse-yuml

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

discourse-yuml

Add ability to write yUML class diagrams directly into a discourse post.

Example of yUML diagram in discourse

Installation

Docker

To install in docker, add the following to your app.yml in the plugins section:

hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - mkdir -p plugins
          - git clone https://github.com/discourse/docker_manager.git
          - git clone https://github.com/sekhat/discourse-yuml.git

and rebuild docker via

cd /var/discourse
./launcher rebuild app

Manual

From your main discourse do:

cd plugins
git clone https://github.com/sekhat/discourse-yuml.git
cd ..

Rebake Posts

rake posts:rebake

Limitations

Currently, it only supports yUML class diagrams.

Usage

A yUML diagram can be specified as so

[yuml]
[Class] -> [AnotherClass]
[/yuml]

Which should give you a diagram like so

Picture of post editor with example

You can now specify the type of diagram you wish to draw via the type argument

For example to start a yuml activity diagram you can do the following:

[yuml type=activity]
(start)->[a]
[a]->(end)
[/yuml]

The following types are supported:

  • class - For class diagrams
  • activity - For activity diagrams
  • usecase - For use case diagrams

If no type is specified, then class is used by default

The different diagram styles for yuml.me can also be specified via the style argument

For example

[yuml style=plain]
[Class]->[AnotherClass]
[/yuml]

The supported styles are:

  • scruffy
  • plain
  • boring

If none is specified then by default scruffy is used.

These options can also be combined:

[yuml type=class style=plain]
[Class]->[AnotherClass]
[/yuml]

Enjoy