Size: a a a

DocOps-сообщество

2021 November 04

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
с вертикальными в html вешается, в odt игнорит таблицу :(
источник

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
отака фигня, table--probe-cell виноват в обоих случаях
источник

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
а вот такое работает
источник

a

akater in DocOps-сообщество
Не сомневаюсь, что орговские таблицы лучшие из plaintext'овых.
источник

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
но тут мутная штука, это работает через доп. пакет table.el, потому, как видишь, маркап орговский в ячейках не распознаётся
источник
2021 November 05

ML

Maksim Lapshin in DocOps-сообщество
коллеги, сижу и в openapi схеме редактирую документацию.

Понимаю, что есть много ссылок на поля описаний и на operationId.


Есть ли какие-то стандартизованные способы ссылаться?   Использую redoc как очень простой и быстрый способ.

Или оно опять в foliant сделано?
источник

A

ARN in DocOps-сообщество
Может быть для работы с таблицами в маркдаун стоит попробовать markdown monster? https://markdownmonster.west-wind.com/
источник
2021 November 08

AB

Albina Brycheva in DocOps-сообщество
Коллеги, sphinx перестал собирать html и pdf.
- Исходники rst расположены в корневой папке проекта. Там же расположены папки \source и \build.
- index.rst в папке \source, включаемые файлы прописаны

При попытке собрать html или pdf появляется предупреждение - "toctree contains reference to nonexisting document 'test'"

Если скопировать исходник test.rst в папку \source все работает.

Прошу помощи.
В теме я новичок
источник

D

Denis in DocOps-сообщество
Значит, у Вас в index.rst есть test.rst
источник

CL

Constantine Linnick in DocOps-сообщество
самое простое – сделать поиск по содержимому всех файлов и поискать где упоминается test
источник

NV

Nick Volynkin in DocOps-сообщество
Не надо по всему содержимому искать :)
источник

CL

Constantine Linnick in DocOps-сообщество
Это универсальный ответ: если видите какое-то странное или неожиданное имя - попробуйте его поискать
источник

NV

Nick Volynkin in DocOps-сообщество
Где-то, наверняка в index.rst, есть директива toctree, и в ней одним из пунктов test
источник

NV

Nick Volynkin in DocOps-сообщество
Если у вас index.rst лежит в /source, то весь контент должен лежать там же или в подпапках
источник

AB

Albina Brycheva in DocOps-сообщество
В index.rst указан test, без расширения. Сам файл test.rst является исходником.
источник

NV

Nick Volynkin in DocOps-сообщество
да, но тогда test.rst должен лежать рядом, в одной папке с index.rst
источник

NV

Nick Volynkin in DocOps-сообщество
и когда вы его туда помещаете, всё работает
источник

AB

Albina Brycheva in DocOps-сообщество
при применении sphinx-quickstart исходники в \source не копируются автоматически?
Порядок создания проекта получается следующий:
- в некоторой папке есть rST-файлы;
- это папке выполняется команда sphinx-quickstart, которая создает структуру проекта с вложенными подпапками \source и \build;
- rST-файлы копируются в \source и из корневой удаляются.

Так?
источник

А

Александр Мокрушин... in DocOps-сообщество
в директиве toctree файлы проекта указываются без расширения
источник

AB

Albina Brycheva in DocOps-сообщество
С этим разобралась.

Далее на команду "make latexpdf" подобная ошибка - указан несуществующий файл "test.rst"
В шаблоне \latex\yourdoc.tex присутствует строка \input{test.rst} - ругается на этот фрагмент.
Файл test.rst находится в \source.
Если скопировать test.rst  в \latex, все работает.

Но, убеждена, что так не должно работать. Получается, нужно хранить 2 копии исходников в соседних папках.
+ ручное копирование
источник