adoc Studio - Writing App 4+

With version 3 of adoc Studio you get a wealth of new functions and improvements that make your work with AsciiDoc even easier and more efficient.


BIBLIOGRAPHY

The bibliography is a special section that should not be missing in any scientific project. The list of references is its own area that includes a variety of books, papers, and articles. As a reference, you use the classic syntax for references in the text.


SF SYMBOLS FOR ICON MACROS

Since version 2, adoc Studio has been able to use the icon macro to place small symbols from the Font Awesome library in the text. Starting now, not only macOS and iOS software developers can enjoy SF Symbols. This is the collection of all symbols used in the various Apple operating systems. In adoc Studio 3, you have access to more than 6,000 images to describe your app interfaces.

Activate the Apple symbols by setting the following attributes:

:icons: font
:icon-set: apple


CONTROL RESOLUTION / REDUCE FILE SIZES

An important topic for exporting documents is images. The challenge is often their size. The product team usually provides images in maximum resolution. And that's a good thing. But a reader of documentation, for example on the iPhone, does not need images of hundreds of megabytes.

In adoc Studio version 3, there are new attributes to adjust the resolution of your images in the output. This way, you can dynamically reduce the file size of your documents with the following attributes:

ads-max-image-resolution → Sets the maximum output resolution of images (in dpi, dpcm, or dppx) if height or width are defined in the source code.

ads-max-image-width → Limits the image width in the HTML output if no fixed height or width is specified.

ads-rasterizing-resolution → PDF, SVG images, and STEM formulas are converted to PNG and set to a specified resolution (in dpi, dpcm, dppx).

ads-static-stem → Normally, STEM formulas are exported with JavaScript. With this option, they are included in the document as SVG (no more JavaScript required).


PROJECT DICTIONARIES FOR YOUR TEAM

Until now, adoc Studio used the system dictionary on your local machine. Any corrections went into it and were not available for other team members. For professional authors working on many different projects, this was not ideal. That's why adoc Studio 3 now has project-specific dictionaries.

When spell check is enabled (Edit → Spelling & Grammar → check “Check Spelling & Grammar”), you can add unknown words directly to a new dictionary. The new dictionary (.adict file) appears in the sidebar. Of course, it can be versioned, transferred to other projects, and used collaboratively by the team.


AUTOMATION WITH ADOC STUDIO

Documentation products are often automatically created – especially when they are ongoing projects. Starting with this version, you can integrate adoc Studio into your processes. You can install the adocstudio command line tool via the adoc Studio menu and then use it in all shell scripts. It offers the following sub-commands:

Document export:

adocstudio export documents --project Projektname.adocproject --document Dokumentname.adoc (Directory)

Product export:

adocstudio export products --project Projektname.adocproject --product Produktname (Directory)

Simply enter adocstudio help export products or adocstudio help export documents in the terminal to view all available commands.


NEW DRAG & DROP FUNCTIONS

1. Drag text from the source code editor

Now you can work with text snippets. You can drag text out of the editor. For example, drag it to your desktop to automatically create a new text snippet. Of course, a text snippet can also be dragged back into the editor.

2. Drag & drop into the source code

If you drag a file from the project navigator into the editor, an include statement is inserted.

If you hold down the Option key while dragging, its content will always be inserted.