Displaying items by tag: document
RepoDoc, a call for testing
Try RepoDoc, a new way of documenting your repository.
It’s easy to use, powerful and we offer it for free to anyone willing to test or help.
What is RepoDoc?
A document generator add-in for Enterprise Architect.
What makes it special?
- uses Liquid templates that are easy to create, modify and maintain,
- offers flexible repository filtering capabilities,
- makes non-linear document generation possible,
- supports a wide range of document formats including, but not limited to, HTML, LaTeX, PDF, Markdown, AsciiDoc, CSV, XML or JSON files, SVG, source codes in different languages,
- contains a built-in post processor.
How can you help?
- try it out and submit your wishes for a must/nice to have functionality,
- write a new interesting template or let us know what kind of template would you need.
What you can achieve?
Here are few examples of documents, generated with RepoDoc. Find more at repodoc.archimetes.com.
UML model overview (HTML)
Requirements catalogue (LaTeX)
Dependency graphs (DOT/Graphviz)
Dependencies between UML elements.
Dependencies between Archimate elements.
Class diagram overview (AsciiDoc)
Package list (JSON)
Introducing RepoDoc, a document generator for Enterprise Architect
About
RepoDoc is a document generator for Enterprise Architect able to produce a variety of document formats using templates written in any text editor.
How it works
RepoDoc takes a document template and a starting package as input. It outputs a plain text document together with repository artifacts specified in the template and taken from the repository. An optional profile may be specified to instruct RepoDoc to post-process the document with a third party software (like Asciidoctor or Pandoc).
RepoDoc uses plain text templates and an easy to learn Liquid template language. This allows to output a broad range of different plain text formats like CSV, XML or JSON, but also to post-process the result in various third party backends to produce an office document like DOCX. It also offers new possibilities when iterating repository like multiple iterations, custom loops, conditional expressions and more.
How to use
- Download and install latest RepoDoc bundle.
- Start Enterprise Architect and open your project.
- Select RepoDoc from the Specialize ribbon and open its control panel.
- Click Generate.
- Click View.
Features
✅ Markup languages
Use your favorite markup language like Markdown or AsciiDoc to prepare your document then convert the output to a HTML or DOCX with a single click.
✅ Conditional expressions
Document only elements you need and when you need them. Write logical conditions based on name, type or number of child elements. No more empty sections or tables in the output document.
{%- for element in package.elements -%} {%- if element.type == "Actor" -%} Documenting actor name {{ element.name }} and actor notes {% if element.notes != "" %}{{ element.notes }}{% endif %} (but only if non empty). {%- endif -%} {%- endfor -%}
✅ Multiple iterations
Iterate and document your repository items multiple times. Create requirements section first and then add a use case section. Everything aligned in a single document.
Now I'm documenting only actors. {%- for element in package.elements -%} {%- if element.type == "Actor" -%} ... {%- endif -%} {%- endfor -%} And now I'm documenting only use cases. {%- for element in package.elements -%} {%- if element.type == "UseCase" -%} ... {%- endif -%} {%- endfor -%}
✅ Output redirection
Output images or artifacts to individual files. Export data in different formats to multiple files.
✅ Relationships & analysis
Walk through the connections for elements and diagram objects and document important ones. Analyze and document impacts with recursive templates.
✅ Version control
RepoDoc uses plain text Liquid templates that are ideal for version control system. Track changes in your templates and tag them easily.
Want more?
Select another template or write quickly your own with an easy to learn language. Find out more about RepoDoc at repodoc.archimetes.com.