Improved general stability.

Improved general stability.

Fixed Issues:
- Improved general stability.
- The preview context menu action "Show Source" did not always work.
- When switching between apps, the editor scroll position or the zoom level could change.
- On the iPad, the preview search field wrongly offered a replace option.
- On the iPad, deleting documents on iCloud Drive did not always work.
- Project spelling dictionaries were not always auto-saved.

New Features:
- You can now add comment blocks in the document header using four slashes (////) as delimiters.
- The user manual now contains a dedicated section for creating CSS product styles.

Fixed Issues:
- Improved general stability.
- Resource links in the HTML export could be invalid when repeatedly exporting.
- The adoc Coach could insert wrong section IDs for xrefs.

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.

Fixed Issues:
- Improved general stability.
- Scroll position syncing did not always work in PDF preview.
- Scholary notes could be shown multiple times in the preview.

Fixed Issues:
- Sometimes, the last text line in the source editor was not fully visible.
- When typing at the end of a source document, the editor scroll position could jump.
- Typing after a collapsed section could make the preview scroll position jump.
- When editing a document, the section title indentation could become inconsistent.
- Under some circumstances, the spell checking could highlight bogus ranges.
- The range highlights for syntax errors could hide spell correction highlights or text range selections.
- Improved speed of image previews.
- When opening the sidebar sections tab for the first time, the section structure was not expanded completely.
- When changing the window or sidebar size, the hidden preview pane could appear unintentionally.
- Spell checking errors sometimes appeared delayed.
- Images loaded from http or https urls could be previewed with a wrong aspect ratio.
- The ranges of a global text search results could become invalid after editing.

WHAT'S NEW:
- AsciiDoc callouts to explain code blocks
- AsciiDoc anchors can now also be assigned within a line.
- AsciiDoc subtitles are now supported in HTML and PDF.
- AsciiDoc Bibliography adds a new way to reference sources.
- Syntax Completion (adoc Coach) for Icon Macros
- New product styles: Manual and Light
- The preview performance has been improved.

FIXED ISSUES:
- The general stability has been improved
- Under rare circumstances, the scroll position of the preview or the text editor could jitter.
- Image names are now excluded from the spell check.
- The triangular buttons for collapsing sections in the text editor were not always visible.
- The highlighting of search results was not removed under certain circumstances.

Newly supported AsciiDoc Features:
- Positional attributes for inline images
- List continuations
- Block anchors

Fixed Issues:
- Fixed problems with comments in indented list item paragraphs.
- The menu item for italic text was missing a keyboard shortcut.
- Improved performance of cursor navigation under iOS.
- Articles without sections incorrectly had a preamble.
- Improved the synchronization of the vertical preview position in definition lists.
- Renaming duplicated styles caused a crash.
- The preview stopped rendering when using a document title ID.