То, что внутри картинка копируется это скорее следствие механики работы библиотеки, потому что это обёртка над CLI, работающая исключительно с файлами на диске. Поэтому создание копии скорее всего не хотят показывать в интерфейсе, но при этом дают понять, что указанная картинка только "открывается".

Скажем, гипотетически, если они придумают способ делать эту промежуточную копию прямо в оперативной памяти (а не на диске) с целью ускорить процесс, у внешнего интерфейса не появляется повод меняться, хоть это уже и не совсем копирование. Но название copy стало бы немного сбивающим.

Кстати, в Ruby есть ещё конвенция вокруг восклицательного знака, часто встречаются пары методов с ним и без него. Метод с восклицательным знаком в таких случаях деструктивный, т. е. меняет исходную сущность. Поэтому несколько более идиоматичными для Ruby названиями могли бы быть open! (вместо new) и open (как есть).
Соглашусь, что это не очень хорошо читается, скорее рассказываю о сложившейся практике в этом мире.

Вот что мы выяснили о предыдущем посте:
— В доке ошибки нет, она верно описывает API.
— Выбор названий методов в API очень спорный. Можно ожидать, что open откроет на редактирование, а new сделает копию. Можно понять иначе: open только откроет картинку и не будет её редактировать.
— Причина такого выбора может быть в том, что new — это метод-конструктор. Он задаёт поведение по умолчанию.

Чтобы не запутывать пользователя API, можно было бы дать методам имена, не связанные с их внутренней реализацией. Например, copy и modify.

Спасибо @dside_ru, что объяснил про конструктор.

Продолжая тему диаграм: https://isoflow.io/ куцо, но красивенько

Для экспорта просит регу, во что умеет экспортить?

Кто подскажет по аскидоку:
Когда делаю нумерованный список и в середине привожу кусок кода (через [source,java]), то последующая нумерация сбивается и начинается сначала.

Ну то есть я понимаю, что можно сделать через  [start=х], но по мне это костыль.

Там блоки нужно склеивать через плюсик на следующей строке

Ага, это работает. Спасибо большое.
Странно, что я это решение нигде не нашел.
Единственно, что плохо - к блоку кода применяется отступ направо. Не есть хорошо.

У одного меня такая история?

К меня все ок

+

Понял.
У меня из-под IP США такая история последние часа три.
Из-под Германии норм.

Спасибо, я тоже сталкивался разок. Заведу тикет

Небольшой ресёрч:
Не могу понять механизм работы атрибута :source-highlighter: для аскидока.
Pygments, CodeRay не работают, то есть при конвертации адока в html не происходит подсветка синтаксиса. Более того, если использовать встроенный в asciidoctor конвентатор из адока в хтмл, то в логе ошибке на эти значения атрибута.
А вот значение highlightjs работает при использовании в качестве конвектора плагин ascoodoctor для visual studio. Встроенный конверктор также сваливается в ошибку. То есть атрибут :source-highlighter: как и [source] не отрабатывается поскольку не определён.

Вот такие пироги.

Такое встретилось https://www.autocloud.dev/

пока слабенько, но интересный заход они придумали — мол, ведите доку+ учёт, чтобы понять, где вы переплачиваете за облако

Коллеги, может кто занимался:
Есть перечень атрибутов для аскидока. Этим атрибутам присваиваются значения.
Как сделать так, чтобы этот заранее предопределённый набор автоматически распространялся на  все создаваемые adoc в независимости от среды разработки, операционной среды и т.п.
То есть, должен быть какой-то conf-файл, который должен содержать требуемое и который можно рассылать.
Или копать в сторону gradle(maven)?