79ed1a6b4b
By convention, code markup (`~`) is reserved for keybindings in Org-based documentation in Spacemacs. Verbatim markup (`=`) is reserved for code and other code-like things. So change several readmes to reflect this convention. Use verbatim markup for things like (non-exhaustive list): - Emacs Lisp functions, modes, buffers, etc. - Environment variables - Directory paths - Code in general |
||
|---|---|---|
| .. | ||
| img | ||
| packages.el | ||
| README.org | ||
plantuml layer
Description
This layer enables support for plantuml-mode, which provides a major-mode for plantuml. PlantUML is a tool to generate UML diagrams from plain-text.
For help with how to use plantuml, see the plantuml website and the reference guide.
The official file extension supported by this layer is .pum. If you want something else,
set it in your user-config function of your ~/.spacemacs file.
For example, the following diagram can be defined as follows:
@startuml
JAremko->robbyoconnor : I think the docs can benefit from some kind of illustration
JAremko<-robbyoconnor : I'm too lazy -- I have actual work to do. I link to the docs. If you can write me a diagram in plantuml, I'll gladly compile and add it.
JAremko->robbyoconnor : *gives ths diagram*
robbyoconnor<-JAremko : *robbyoconnor adds it and JAremko is happy*
...
robbyoconnor->theOtherPerson : And they thinks it's funny? Yup, they definitely finds it funny. Right?
@enduml
Install
To use this contribution add it to your ~/.spacemacs
(setq-default dotspacemacs-configuration-layers '(plantuml))Org-Babel Integration
To enable the execution of embedded plantuml code blocks within Org-Mode
documents, define a value for org-plantuml-jar-path in your ~/.spacemacs.
Key bindings
| Key Binding | Description |
|---|---|
SPC m c c or C-c C-c |
Build diagram from the text in the current buffer |
SPC m c o |
Set the output type (unicode text, svg, or png) |