Size: a a a

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

2019 August 01

VS

Vadim Smelyanskiy in DocOps-сообщество
Daniel Ershov
там формат лютый для ручной работы (теоретически можно настроить IDE что нивелирует эту проблему), задолбаешься подгонять всю таблицу если тебе надо, допустим, колонку вставить. я для генерации доков через сфинкс использую вставки с  импортом внешних CSV.

а если табличку каждый раз чем-то генерить, то норм
В Foliant'е ещё вставки CSV есть

А ещё, чуть в сторону, в Balsamiq компонент таблицы параметризуется CSV/TSV
источник

DE

Daniel Ershov in DocOps-сообщество
Vadim Smelyanskiy
В Foliant'е ещё вставки CSV есть

А ещё, чуть в сторону, в Balsamiq компонент таблицы параметризуется CSV/TSV
но в том то и боль, что человеку нужен более гибкий формат чем csv
источник

ES

Elena Shebunyaeva in DocOps-сообщество
Daniel Ershov
там формат лютый для ручной работы (теоретически можно настроить IDE что нивелирует эту проблему), задолбаешься подгонять всю таблицу если тебе надо, допустим, колонку вставить. я для генерации доков через сфинкс использую вставки с  импортом внешних CSV.

а если табличку каждый раз чем-то генерить, то норм
а можно поподробнее про "для генерации доков через сфинкс использую вставки с  импортом внешних CSV"? мы живем на сфинкс/rst, таблицы -- это боль
источник

NV

Nick Volynkin in DocOps-сообщество
Elena Shebunyaeva
а можно поподробнее про "для генерации доков через сфинкс использую вставки с  импортом внешних CSV"? мы живем на сфинкс/rst, таблицы -- это боль
Используйте list-table, в них радость и счастье )
источник

ES

Elena Shebunyaeva in DocOps-сообщество
покурим, спасибо
источник

DE

Daniel Ershov in DocOps-сообщество
Elena Shebunyaeva
а можно поподробнее про "для генерации доков через сфинкс использую вставки с  импортом внешних CSV"? мы живем на сфинкс/rst, таблицы -- это боль
Таблицы
-------

Таблицы хранятся в формате CSV, по умолчанию в папках tables.
Вставка таблицы в документации выглядят так:

.. tabularcolumns:: |p{5cm}|p{10cm}|

.. csv-table:: Термины протокола
   :widths: 5 95
   :file: ./tables/thermines.csv
   :delim: ;
   :class: longtable
   :header-rows: 1

Разберем по пунктикам:

* `.. tabularcolumns::` - параметр отвечающий за отображение таблиц в PDF документах, можно указать точные размеры столбцов, а можно установить их поведение, в нашем случае чаще будет настройка в стиле `|l|l|L|`, данный параметр выставляется перед таблицей, через пустую строчку;
* `.. csv-table::` - непосредственно вставка таблицы;
* `:widths:` - параметр отвечающий за отображение таблиц в HTML страничках;
* `:file:` - путь к вставляемой таблице;
* `:delim:` - делитель ячеек CSV файла;
* `:class: longtable` - данный параметр необходимо выставлять если таблица больше одной страницы, тогда будет перенос на следующюю страницу, **при этом необходимо указать точный размер столбцов в параметре tabularcolumns**
* `:header-rows:` - количество рядов заголовка

Подробнее можно почитать: http://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#tables
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Daniel Ershov
но в том то и боль, что человеку нужен более гибкий формат чем csv
Мне кажется, CSV и есть самый гибкий формат, потому что самый простой

Я так имитировал объединение ячеек заданием двух таблиц с разным кол-вом колонок в вёрстке фиксированной ширины
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Если же хочется прям верстать таблицу – Google Sheets можно вставить
источник

DB

Dima Boger in DocOps-сообщество
Куда 🤔
источник

DB

Dima Boger in DocOps-сообщество
Мы как раз оттуда и убегаем, хочется в гит этот кусок положить
источник

DE

Daniel Ershov in DocOps-сообщество
Vadim Smelyanskiy
Мне кажется, CSV и есть самый гибкий формат, потому что самый простой

Я так имитировал объединение ячеек заданием двух таблиц с разным кол-вом колонок в вёрстке фиксированной ширины
полагаю точнее мы сможем сказать если подробнее погрузимся в кейс и узнаем больше про требования к исходным данным и к требуемому результату, лучше прям в примерах
источник

NV

Nick Volynkin in DocOps-сообщество
Такс, кажется нужно проговорить это явно. Говоря «слово “функционал” — плохое, потому что оно якобы про гомосексуальность, вы подразумеваете что гомосексуальность — это плохо, стыдно и т.п. Не надо так.

Я прошу всех участников чата удалить свои шутки на эту тему. И на этом шутка объявляется баяном и несмешной, в следующий раз буду удалять сам и банить.
источник

NV

Nick Volynkin in DocOps-сообщество
Да, но никто не шутит «хи-хи, вы только что сказали, что у вас в приложении есть сущность из матана»
источник

DE

Daniel Ershov in DocOps-сообщество
пожалуйста, не начинайте лгбтсрач
источник

DE

Daniel Ershov in DocOps-сообщество
Админ попросил, посоны удалили, и жили они долго и счастливо
источник

DE

Daniel Ershov in DocOps-сообщество
а "функционал" это плохо, да
источник

СФ

Семён Факторович in DocOps-сообщество
Денис Старков
@factorized уже кидал ссылку на статью, почему не стоит употреблять слово "Функционал"
я ее не кидал, я ее критиковал
источник

NV

Nick Volynkin in DocOps-сообщество
Вы же написали «иначе я вам предложу бар Голубая устриц.», а не «иначе я вам предложу матан». Про матан давайте шутить. А про ЛГБТ не будем.
источник

AR

Anna Ryutina in DocOps-сообщество
с точки зрения лингвистики, язык развивается. Термины со временем получают новые значения и закрепляются официально в словарях
источник

AR

Anna Ryutina in DocOps-сообщество
я к тому, что не стоит столь в штыки принимать слова и термины
источник