Awesome
Quick Introduction
AdaML Diagram
This AdaML diagram describes AdaML itself, including relationships between PlatUML, UML and Ada packages. This diagram has been generated, in turn, with AdaML. See below the AdaML source code.
<p align="center"> <img src="http://www.plantuml.com/plantuml/proxy?cache=no&src=https://raw.github.com/rocher/AdaML/release/0.1.2/diagram/self-AdaML-01.aml"> </p> <details> <summary><b>AdaML Source Code</b> — <i>click to expand</i> —</summary> <pre> !include https://raw.github.com/rocher/AdaML/release/0.1.2/AdaML.puml scale 600 widthpackage("AdaML") package("PlantUML") package("Ada") package("UML")
owns("AdaML", "PlantUML") depends("AdaML", "Ada", "tailored") depends("AdaML", "UML", "draws")
note("AdaML draws Ada-tailored\nUML diagrams based on\nPlantUML")
left_right("PlantUML", "UML") left_right("UML", "Ada") </pre>
</details>Doc
For more information and examples, download AdaML.pdf or read online in GitHub.
Introduction
What is AdaML?
- UML tailored for Ada 2012 programming language
- A modeling language to draw UML diagrams, implemented in PlantUML
- An easy way to learn Ada through the use of UML and OOP concepts
Features
- UML tailored to use and show particular Ada language characteristics
- Coherent set of functions to design software components for Ada
- Generates high quality drawings (ps, eps) easy to embedded in other docs
- Easy to learn by example, both AdaML and Ada language
What is /not/ AdaML?
- A model-based tool to generate Ada code
- A reverse engineering tool to draw UML diagrams from Ada code
- An interactive UML modeling or drawing tool
Local Usage
AdaML must be used locally to get quality graphics. You can generate diagrams in
eps
format that can be embedded in LaTeX docs.
Requirements
- PlantUML installed and working in your system
- The AdaML files, check AdaML installation instructions
- Your favorite text editor, preferably with PlantUML support (e.g. Emacs)
- Check the list of supported editors
- For better visualization and integration with LaTeX, computer modern fonts
Online Usage
Online Version - Quick Start
- Open PlantUML Previewer or PlantText editor
- Remove default lines and paste the following code:
!include https://raw.github.com/rocher/AdaML/release/0.1.2/AdaML.puml
scale 300 width
begin_type("Pan_Dimensional")
procedure("Ask_The_Question", "in out Natural")
end()
begin_package("Deep_Thought")
function("Answer_The_Question", "", "Natural")
private()
variable("The_Answer", "Natural", 42)
end()
depends("Pan_Dimensional", "Deep_Thought", "ask >")
Embed Diagrams in GitHub
This is an example of the AdaML documentation:
<p align="center"> <img src="http://www.plantuml.com/plantuml/proxy?cache=no&src=https://raw.github.com/rocher/AdaML/release/0.1.2/diagram/deep-thought-02.aml"> </p>- Check the raw version
of this
README.md
file to see the image link used (plus how to easily center images in GitHub) - The AdaML source code can be found in GitHub: deep-thought-02.aml
ChangeLog
Release 0.1.2
- Adapt to new PlantUML interface
Release 0.1.1
- Scaled images of
REAME.md
file - AdaML file extension changed to
*.aml
Release 0.1.0
- First public release