Size: a a a

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

2021 November 01

NV

Nick Volynkin in DocOps-сообщество
Во мне сейчас любопытство борется с желанием поддерживать порядок
источник

L

Leia in DocOps-сообщество
Порядок можно навести всегда)
источник

D

Denis in DocOps-сообщество
Мы при помощи sphinx+rst уже настроили публикацию в html, Word и confluence. Знания python пока никуда применить не удалось. Ну если только немного синтаксиса для файла конфигурации, но там несложно и инфы полно. Таблицы по-моему во всех языках разметки неудобные. Думаю, это не достаточно сильная аргументация для отказа от md в пользу rst. Все же rst гораздо сложнее и неписателей будет тяжело сподвигнуть на его освоение, если такая потребность есть.
источник

NV

Nick Volynkin in DocOps-сообщество
Это было про сообщение про про жадность выше )
источник

MM

Mikhail Mironov in DocOps-сообщество
Таких спамеров я ещё не видел)
источник

VB

Vitaly Belyakov in DocOps-сообщество
это где в MD неудобные таблицы? Я начинал знакомство с языками разметки с RsT, и там таблицы — это ад. Чуть сдвинул не туда хотя бы одну «палочку» — всё, таблица не соберётся. В MD же вообще плевать, на каком месте относительно друг друга разграничители стобцов находятся, а разграничивать строки так и вовсе не нужно. Плюс в RsT также нужно соблюдать до пикселя все остальные правила, например, уровень заголовка — помнить, какие символы какому уровню соответствуют, и линия из этих символов должна строго соответствовать количеству символов в заголовке! Бессмысленная боль.

MD, имхо, несравненно проще и для освоения, и для ежедневной работы. И выбор редакторов с мгновенным просмотром готового текста гораздо выше (для RsT пока вообще нет рабочего решения).
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Таблицы в разных flavour'ах MD по-разному отрабатывают. Сам сходу не подскажу, но натыкался на системы, где таблицы в MD работали так себе

Выше по чату (сейчас поищу сообщение) человек искал, нашел и поделился конкретной реализацией, где с таблицами порядок, и разные объединения ячеек работают и т.д.

Лично я согласен, что MD удобнее в целом, чем RsT, тоже не оценил подгона кол-ва дефисов под заголовками и прочие "особенности" синтаксиса)

Но у него есть плюс - у него есть одна конкретная спецификация, и всё работает строго по ней. Markdown таким похвастаться не может
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Переслано от ARN
Приветствую собравшихся! Грид-таблицы существуют, а  объединенные ячейки в них возможны. Есть расширение для Visual Studio (но не Visual Studio Code, прошу обратить внимание). Это расширение на пакете VSIX. Называется Mads Kristensen Markdown Editor / markdig (https://github.com/xoofx/markdig) или просто Markdown Editor (для поиска в marketplase). С его помощью Vusial Studio может строить грид-таблицы с объединением ячеек в строках и столбцах, а также со сложным слиянием colspan and rowspan, когда чередуются в одной строке или столбце ячейки со слиянием и ячейки с разделением. В общем, построение грид-таблиц с объединением ячеек не только возможно, но и возможно практическое использование этого для создания документов Gostdown. Подробности для интересующихся в прилагаемом файле. Спасибо @arvikon за полезную ссылку, благодаря которой я смог найти решение этой проблемы.
источник

VB

Vitaly Belyakov in DocOps-сообщество
ну если говорить конкретно о таблицах, то в MD можно просто запихнуть HTML, многие так и делают, когда им нужны сложные таблицы 🙂
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Можно

Но мы же говорим об удобстве, и вот необходимость собрать HTML, хоть в специальном редакторе, хоть руками, немного процесс сбивает)
источник

VB

Vitaly Belyakov in DocOps-сообщество
согласен, но это всё ещё удобнее редактирования таблиц в формате Rst ))
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Между делом, моё любимое решение для таблиц, это через препроцессор из Foliant'а вставить её из файла

https://foliant-docs.github.io/docs/preprocessors/csvtables/
источник

А

Александр Мокрушин... in DocOps-сообщество
чтобы не страдать с rst, решил грузить таблицы из CSV-файлов
источник

VB

Vitaly Belyakov in DocOps-сообщество
я для облегчения страданий использую вот этот генератор таблиц, там и md, и html, и rst — https://www.tablesgenerator.com/markdown_tables
источник

VB

Vitaly Belyakov in DocOps-сообщество
можно и текстовую таблицу импортировать, и csv
источник

F

Fagor in DocOps-сообщество
Да, но опять таки только если реально нужно использовать стек.

Многие пишут, что немного настроил и нормально, тогда исходите уже не с админа проекта, а с юзеров.
источник

F

Fagor in DocOps-сообщество
Visual studio штука "прожерливая", стоит учитывать
источник

AB

Albina Brycheva in DocOps-сообщество
Мне самой привычнее в MD, если честно. Пока исследую тему. А что скажите про docusaurus и экспорт в pdf ?
источник

L

Leia in DocOps-сообщество
Я так и поняла) меня тоже заинтересовало)
источник

NV

Nick Volynkin in DocOps-сообщество
Увидел, что он там до этого денег просил, но Семён эти сообщения поудалял. Вот и вся интрига
источник