всем привет! кто работает со связкой sphinx&rst, есть ли возможность использовать так называемые сниппеты кода? т.е. в одном файле будет кусок разметки с текстом, каким-то образом промаркированный, и этот кусок можно использовать в других файлах при помощи только идентификатора или маркера

да, есть, я так куски кода инклудила прямо из файлов с кодом, можно указать с какой по какую строку инклудить.

спасибо! это какой-то экстеншн?

.. include:: имя файлика
  literal:
  start-line : integer
  end-line : integer

родной инклуд

спасибо, Lana!

там еще куча модифайеров есть https://docutils.sourceforge.io/docs/ref/rst/directives.html#including-an-external-document-fragment

👍

Коллеги, есть вопрос

существуют для плагины для MemoQ, которые поддерживают Markdown?

Так, вроде, писали выше про Okapi как конвертер из XLIFF в маркдаун

Вот здесь пишут, что файлы .md можно затащить в мемокью, поменяв в фильтрах расширение на Plain Text Filter

Всем привет!

Нашел ваш канал, а затем чатик. Спасибо, много полезной инфы. Даже очень много, я в ней заблудился. Может есть какая-то одна точка входа для нубов?

Хотелось бы попросить помощи и наставлений, что читать, что юзать, чтобы решить свою задачу.
В кратце:
- Для внутреннего пользования нужна документация одного конкретного проекта.
- Цели: упрощение входа нового сотрудника; представление всех компонент, способов и мест их развертки (облако, кастомные пользовательские устройства, смартфоны, тестовые платформы);
- Ресурсы: один человек (я), крайне малое количество времени.

Подскажите, пожалуйста, пути наименьшего сопротивления :)

Я так понимаю нужен совет по выбору инструмента документирования? У вас в компании Confluence есть?

В том числе инструмента.

Был, нам не подошел, слишком маленькая команда, надо что-то попроще и побесплатнее :)

Есть еще https://www.notion.so/

Notion.so?

Иван, с вас конфетка)

😊