Size: a a a

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

2019 February 16

СФ

Семён Факторович in DocOps-сообщество
Andrei Yemelianov
Мне пиши
Договорились!
источник
2019 February 17

I

Igor in DocOps-сообщество
А вы не знаете софта, которым можно делать такие вот сниппеты с футнотами нумерованными, хотя бы по строкам?
В идеале как плагин к какой-то ide
источник

I

Igor in DocOps-сообщество
А хотя в принципе есть юникодовские символы 🤔 которыми можно сделать похожее
❶ ❷ ❸ ❹ ❺ ❻ ❼ ❽ ❾ ❿
источник

TZ

Timofey Zakrevskiy in DocOps-сообщество
В смысле - как плагин к ide?
А на каком языке такие футноуты можно описать - в ЛаТеХе, например, можно.
источник

I

Igor in DocOps-сообщество
Плагин для ide/редактора который за меня будет следить за номерами и удобно их прятать-показывать

Ну например типа внутри md у меня
s = C()
print(len(s)) [тут вызывается специальный метод __len__]


а на выходе это рендерится уже в блок <pre></pre> и футноты под ним в <li>

Но вы правы, наверное вопрос скорее в расширении для markdown в таком случа
источник

KR

K R in DocOps-сообщество
Igor
Плагин для ide/редактора который за меня будет следить за номерами и удобно их прятать-показывать

Ну например типа внутри md у меня
s = C()
print(len(s)) [тут вызывается специальный метод __len__]


а на выходе это рендерится уже в блок <pre></pre> и футноты под ним в <li>

Но вы правы, наверное вопрос скорее в расширении для markdown в таком случа
Ты в одном шаге в сторону от изобретения Literate Programming
источник
2019 February 18

rd

rus dacent in DocOps-сообщество
Igor
Плагин для ide/редактора который за меня будет следить за номерами и удобно их прятать-показывать

Ну например типа внутри md у меня
s = C()
print(len(s)) [тут вызывается специальный метод __len__]


а на выходе это рендерится уже в блок <pre></pre> и футноты под ним в <li>

Но вы правы, наверное вопрос скорее в расширении для markdown в таком случа
Это точно можно сделать в LaTeX'е.
источник

ML

Maksim Lapshin in DocOps-сообщество
https://www.overleaf.com/

online latex editor уже видели?
источник

ML

Maksim Lapshin in DocOps-сообщество
обсуждалось?
источник

NV

Nick Volynkin in DocOps-сообщество
Не видел, интересная штука. @Shryke, смотри, тут редактор для латеха.
источник

rd

rus dacent in DocOps-сообщество
Их несколько есть. Мы у себя свой развернули вот этот https://github.com/sharelatex/sharelatex, работает отлично. Можно использовать онлайн версию. "Под капот" развернули TexLive у него большой пак всякого добра "из коробки".
источник

TZ

Timofey Zakrevskiy in DocOps-сообщество
Nick Volynkin
Не видел, интересная штука. @Shryke, смотри, тут редактор для латеха.
Видел и overleaf, и sharelatex. Когда мне нужен был латех  - он был мне нужен оффлайн на "печатной машинке", и минимальная установка техлайва + git/dropbox полностью покрывала мои нужды.

Вспомогательные прилады "работайте вмногером одновременно над одним файлом" мне были побоку, поэтому поигрался и бросил.

ИМХО, такие онлайн-редакторы нужны только если совсем нет желания/возможности использовать теховский тулчейн локально
источник

rd

rus dacent in DocOps-сообщество
Онлайн версия, кстати, имеет интеграцию с overlaf
источник

TZ

Timofey Zakrevskiy in DocOps-сообщество
так оверлиф давно уже шарлатех купил
источник

I

Igor in DocOps-сообщество
sharelatex отлично подходит когда надо кому-то показать кто не силён в техе. Я так с некоторыми соавторами коллаборировал.
А локально удобно gummi поставить, если нужно instant preview
источник

I

Igor in DocOps-сообщество
Но он для более-менее сложных документов не тянет
источник

TZ

Timofey Zakrevskiy in DocOps-сообщество
С другой стороны, моё использование латеха - не документация, а статьи. Возможно, для техдокументации именно онлайн-версия будет проще.
источник

I

Igor in DocOps-сообщество
для техдокументации есть dropbox paper, у него порог входа попроще имхо
имхо, латех если не нужны формулы или постоянные референсы — оверкилл
источник

SS

Sergey Sokolov in DocOps-сообщество
papeeria.com в сердечке, особенно удобно было в универе — у них куча шаблонов курсовых/дипломов и всего такого
источник

rd

rus dacent in DocOps-сообщество
Timofey Zakrevskiy
Видел и overleaf, и sharelatex. Когда мне нужен был латех  - он был мне нужен оффлайн на "печатной машинке", и минимальная установка техлайва + git/dropbox полностью покрывала мои нужды.

Вспомогательные прилады "работайте вмногером одновременно над одним файлом" мне были побоку, поэтому поигрался и бросил.

ИМХО, такие онлайн-редакторы нужны только если совсем нет желания/возможности использовать теховский тулчейн локально
Они удобны, когда у тебя лежит там пример типового проекта с типовым шаблоном для использования. Все его берут, редактируют и ты точно знаешь что у всех будет собираться одинаково оформленный документ.

У нас это всё ещё и к Jenkins прикручено, поэтому сборка проходит через единую точку с единым шаблоном документ/презентация для всех: и для тех кто редактирует онлайн и для тех, кто пушит в git.
источник