Size: a a a

Технические писатели

2021 August 19

NV

Nick Volynkin in Технические писатели
А list-tables вам не подходят?
источник

D

Denis in Технические писатели
Часто нужны списки в ячейках. Через list tables такое реализуется? Пока нашел вот такое https://marketplace.visualstudio.com/items?itemName=shuworks.vscode-table-formatter Есть нюансы, нужно привыкать... Буду рад услышать советы, как вы поступаете с таблицами. Очевидно, что в языках разметки их не очень удобно делать.
источник

D

Dmitriy in Технические писатели
В ячейках list-table может быть почти любое содержимое, по крайней мере в pandoc. Минусом list-table и csv-table является невозможность создания объединенных ячеек (pandoc до сих пор так и не научился их распознавать). Я стараюсь импортировать CSV.
источник

М

Михаил in Технические писатели
По  собственному опыту нашел наиболее удачное решение: вставку таблицы в виде raw html.
Использую для создания таблицы данный конструктор, https://www.tablesgenerator.com/html_tables . Удобно то, что можно формировать сложную форму таблицы, задавать цвета ячеек, устанавливать стиль шрифта и многое другое.
источник

E

Ekaterina in Технические писатели
Подскажите, пожалуйста,  синонимы к словам "запушить" и "закомитить" )
источник

М

Михаил in Технические писатели
Второе интересное решение: вставка таблицы из google table с помощью iframe и дополнительных директив к нему. Однако минус подобного решения, размер области iframe не изменяется динамически от размера Гугл таблицы.
источник

МК

Марина Ковалева... in Технические писатели
зафиксировать/ сохранить версию документа
источник

NV

Nick Volynkin in Технические писатели
Оно только через list-tables и реализуется нормально. Списки, картинки, блоки кода, списки с вложенностью, что угодно.
источник

E

Ekaterina in Технические писатели
Точно! Спасибо!!!
источник

D

Denis in Технические писатели
Спасибо, буду тогда на них ориентироваться. Список уже разобрался как вставлять.
источник

RS

Ruslan Spiridonov in Технические писатели
#вакансия #remote
Занятость: #fulltime
З/п:  от 60 000 до 100 000
Всем привет!
Меня зовут Руслан и я рекрутер Studyworld - EdTech компании, развивающей масштабные сервисы на российском и зарубежном рынке.

Наша команда – более 130 человек, 4 проекта, которые более 8 лет помогают студентам по всему миру. Территория охвата наших проектов – Северная Америка, Африка, Латинская Америка, Россия и страны СНГ.

Сейчас наша команда находится в поисках Технического писателя в наш Российский Образовательный продукт, который возьмет на себя ведение технической документации на всех стадиях жизненного цикла разработки ПО и структурировано и технически грамотно сможет их описать.

Стэк: Jira+ Confluence, Figma, Miro


Что мы хотим увидеть у тебя:
- Опыт в написании технической документации от года;
- Техническая грамотность и желание осваивать новые технологии;
- Опыт написания тех. документации больших IT продуктов;
- Навыки работы с большим количеством legacy будет существенным плюсом.

Задачи:
- Разрабатывать описания технологий, алгоритмов, пользовательских и программных интерфейсов;
- Привести в порядок документацию проекта;
- Работать в связке с продактом и дизайнером при описании новых интерфейсов и функционала;
- Взаимодействовать с разработчиками для описания того, как функционирует текущий продукт;
- Составлять регламенты по созданию документаций;
- выстроить процессы технического описания.

Мы предлагаем:
- Официальное оформление согласно ТК РФ — естественно;
- Care bonus: это ДМС после испытательного срока, оплата обучения, поездки на конференции и все интересующее тебя для личного развития. Внутренний университет — мы приглашаем технических спикеров для освещения интересующих тем;
- Наш офис — двухэтажный open space c собственной террасой и велопарковкой на территории БЦ. Все необходимое в офисе для комфортной работы и времяпрепровождения или частичная/полная удаленка - на твой выбор!

Контакт @ru_spiridonov
источник

V

Vasiliy in Технические писатели
запушить - загрузить версию документа на удалённый сервер
источник

NV

Nick Volynkin in Технические писатели
https://www.tarantool.io/en/doc/latest/contributing/docs/markup/tables/

Там ..  container:: table это наша кухня, а всё что внутри — можно использовать. Отступы в 4 символа не случайно такие, и чередование */- тоже.
источник

NV

Nick Volynkin in Технические писатели
Там проблема не в том, что pandoc не научился, а просто стандарт не предусматривает их. Но суть та же )
источник

D

Dmitriy in Технические писатели
я поторопился и написал путано. объединенных ячеек нет вообще, никак.
источник

D

Denis in Технические писатели
Уже делаю огромную таблицу в list table, спасибо. На самом деле с одним пробелом тоже работает, но так даже нагляднее.
источник

NV

Nick Volynkin in Технические писатели
Важно, чтобы все отступы были кратны четырем пробелам. Если брать минимальные, то у вас внутри таблицы отступ 3 пробела, в ней список на 2 пробела, в нём ещё один на 2, и получается какой-то контент с отступом суммарно в 7. И по нему со стороны вообще непонятно, где он там, на каком уровне.
источник

NV

Nick Volynkin in Технические писатели
Ну и ни один текстовый редактор не угадает вот эти произвольные отступы. В большинстве случаев кнопка Tab отбивает кратно двум или четырем символам.
источник

BF

Bobba Fett in Технические писатели
с таким количеством подсчёта отступов, это не сильно проще, чем написать код на питоне, который отрендерит эту таблицу
источник

SR

Stas Rychkov in Технические писатели
Так это и есть питоновский подход изначально.
источник