Size: a a a

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

2021 October 30

BF

Bobba Fett in DocOps-сообщество
1. Это же три команды
2. Их можно легко объединить в макрос со своим шорткатом, как, впрочем, в консоли можно задать алиас
3. Форс пуш??? Любимая команда??? Месье знает толк!

Но работать в командной строке всё равно полезно, потому что это наглядно. Все гуи под капотом запускают команды и если их не знаешь, ну это примерно как жать педали автомобиля, не понимая принципов работы ДВС, сцепления, передач… плюс если вдруг окажешься в ситуации, когда нужно что-то править по SSH, например, сразу начнёшь проклинать, что полагался на удобный красивый гуи всю жизнь
источник

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
ну да, давайте всех заставлять учиться ездить на жигуле, потому что мало ли вдруг?
источник

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
ну и last but not least - magit отлично работает по ssh
источник
2021 October 31

TZ

Timofey Zakrevskiy in DocOps-сообщество
Sublime Merge тоже прекрасно работает через ssh - X
источник

DL

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

TZ

Timofey Zakrevskiy in DocOps-сообщество
Вопрос - как у пандока с шаблонами docx? Я бегло погуглил, ничего путного не нашёл. Пациент скорее мёртв? Направление: TeX - > Docx+template
источник

TZ

Timofey Zakrevskiy in DocOps-сообщество
Тогда tig/lazygit/whatever
источник

D

Denis in DocOps-сообщество
Имеете в виду готовые шаблоны?
источник

TZ

Timofey Zakrevskiy in DocOps-сообщество
Есть внешний клиентский шаблон, итоговый документ должен ему соответствовать. Контроля над шаблоном - никакого.
источник

D

Denis in DocOps-сообщество
Я делаю шаблоны для sphinx docx builder, получается. В пандоке, насколько я понял, возможностей гораздо меньше. Но стили можно задать
источник

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
я выше написал про magit :)
источник

CL

Constantine Linnick in DocOps-сообщество
Народы, а есть адекватный способ в asciidoc сделать чтобы вся вложенная нумерация шла числами и вложенные элементы рендерились в виде 1.1.1. без погружения в сырцы и переписывания куска pdf конвертера?
источник

RG

Ramil G in DocOps-сообщество
:sectnumlevels: 3
источник

RG

Ramil G in DocOps-сообщество
источник

CL

Constantine Linnick in DocOps-сообщество
это я уже изучил, там решение для html
источник

RG

Ramil G in DocOps-сообщество
Вам в сообщество https://t.me/asciidoctor
Там есть Николай Поташников, который большой спец в тонкостях asciidoc и он создал проект https://github.com/CourseOrchestra/asciidoctor-open-document
О котором есть развёрнутая статья на хабре
источник

CL

Constantine Linnick in DocOps-сообщество
спасибо
источник
2021 November 01

AB

Albina Brycheva in DocOps-сообщество
Привет, коллеги! Разбираюсь с инструментарием для Doc as code.
Изучив требования к форматированию, как техписатель, я больше склоняюсь к rst + sphinx (т.к. один из обязательных выходных форматов pdf, тут читала не раз, что в этом случае sphinx предпочтителен). Не MD в основном из-за неудобной работы с таблицами (у нас они есть)
DevOps - инженер предлагает связку markdown + docusaurus и через плагин docusaurus в pdf. Его аргумент: он знает javascript и не знает Pyton.
Прошу вашего совета, рекомендаций. Может быть я ошибаюсь, считая, что на markdown неудобно таблицы составлять и есть уже расширения для этого?

Немного вводных данных: пишем документацию для программного обеспечения (в формате html) + документацию для аппаратной части (инструкции для пользователей в формате pdf)
источник

F

Fagor in DocOps-сообщество
Конкретного совета не дам.

Но при проекте разработки стек смотрится под людей. Иначе никак. И люди под стек.

Есть "нюанс" небольшие проекты, берутся люди что хотят стек расширить.

Так что или создаете челлендж своим людям (если они хотят и готовы). Или берете под человека.
источник

AB

Albina Brycheva in DocOps-сообщество
не совсем поняла посыла вашего. Вы имеет в виду, что раз есть человек, знающий js и всю эту кухню, способный администрировать, то логичнее под нему подстраиваться?
источник