NV
ой, точно, извини )
Size: a a a
2019 August 28
NV
@kvaleev Костя, а когда будут видео с митапа?
RG
Раз уж смотрите на AsciiDoc, посмотрите ещё и на Sphinx & reStructuredText. Я тут как раз вдохновился докладом @Lananovikova про то, как из Sphinx пушить доки в Confluence и тестирую это у себя.
А чем редактировать?
K
@kvaleev Костя, а когда будут видео с митапа?
Оно по той же ссылке, что и была трансляция: https://www.youtube.com/watch?v=5N3zyvXB6Jg
DC
ID:
Introducing Markdown and Pandoc.
В этом месяце вышла новая книга про документацию как код: «Introducing Markdown and Pandoc: Using Markup Language and Document Converter», автор Thomas Mailund.
Если что, Markdown — это самый популярный (хотя не самый мощный) формат разметки, а Pandoc — универсальный конвертер между десятками форматов документов.
Книга начинает с основ Markdown и доходит до использования шаблонов и фильтров (препроцессоров) в Pandoc. Меня особенно порадовала глава про фильтры с примерами кода на Python и panflute. Когда-то я пытался писать фильтры для Pandoc, но не осилил, пришлось обрабатывать уже готовый HTML. Теперь сделаю ещё одну попытку.
Книгу можно купить на сайте издательства. Приятного чтения!
В этом месяце вышла новая книга про документацию как код: «Introducing Markdown and Pandoc: Using Markup Language and Document Converter», автор Thomas Mailund.
Если что, Markdown — это самый популярный (хотя не самый мощный) формат разметки, а Pandoc — универсальный конвертер между десятками форматов документов.
Книга начинает с основ Markdown и доходит до использования шаблонов и фильтров (препроцессоров) в Pandoc. Меня особенно порадовала глава про фильтры с примерами кода на Python и panflute. Когда-то я пытался писать фильтры для Pandoc, но не осилил, пришлось обрабатывать уже готовый HTML. Теперь сделаю ещё одну попытку.
Книгу можно купить на сайте издательства. Приятного чтения!
Кстати, в сети уже появилась пиратская версия
НН
Кстати, в сети уже появилась пиратская версия
Да, в соседнем чате валяется
SR
Да, в соседнем чате валяется
Хде? 🙄
NV
Ты сейчас спровоцировал набег русскоязычных техписателей в украиноязычный чат. )))
НН
Ну ничо, адаптируются или ливнут :D
SR
Ну ничо, адаптируются или ливнут :D
Nic się nie stanie... Спасибо за ссылку. 🙂
2019 August 29
NV
Вышел на кухню (в офисе) за чаем, а там гости из одной компании, которая делает хорошие API и доки к ним. Договорился предварительно про выступление на митапе :)
NK
Митап про документацию в Новосибирске.
Прямо в эту субботу сообщество Konveerum проводит митап про документацию. Место — Новосибирск, Академгородок. Трансляция будет, если вам не слабо начать смотреть её в семь утра по МСК. :)
Сообщество Konveerum — про приборостроение, так что и митап будет с акцентом на ГОСТ, госзаказчиков, и любимые ими форматы DOCX и PDF.
В программе три доклада:
— Алёна Чернышева из Uniscan Research расскажет про то, как компания переехала с MS Word на Atlassian Confluence, но всё равно продолжила использовать Word, и почему всё именно так. Вероятно, доклад будет расширением или продолжением статьи на Хабре.
— Илья Улеско из documentat.io расскажет про переезд c DOCX на reStructuredText. В этом случае получилось переехать полностью, так что теперь уже из исходников в reST генерируется HTML, PDF и DOCX. По словам Ильи, документ в 150 страниц собирается примерно за 20 секунд.
— Дмитрий Перепелин из Моспротекста расскажет про использование DITA XML для разработки конструкторской документации. Дмитрий сообщает, что наиболее востребован формат PDF, но ещё из DITA можно делать (X)HTML, DOCX и EPUB.
Регистрация тут: https://konveerum.ru/
Прямо в эту субботу сообщество Konveerum проводит митап про документацию. Место — Новосибирск, Академгородок. Трансляция будет, если вам не слабо начать смотреть её в семь утра по МСК. :)
Сообщество Konveerum — про приборостроение, так что и митап будет с акцентом на ГОСТ, госзаказчиков, и любимые ими форматы DOCX и PDF.
В программе три доклада:
— Алёна Чернышева из Uniscan Research расскажет про то, как компания переехала с MS Word на Atlassian Confluence, но всё равно продолжила использовать Word, и почему всё именно так. Вероятно, доклад будет расширением или продолжением статьи на Хабре.
— Илья Улеско из documentat.io расскажет про переезд c DOCX на reStructuredText. В этом случае получилось переехать полностью, так что теперь уже из исходников в reST генерируется HTML, PDF и DOCX. По словам Ильи, документ в 150 страниц собирается примерно за 20 секунд.
— Дмитрий Перепелин из Моспротекста расскажет про использование DITA XML для разработки конструкторской документации. Дмитрий сообщает, что наиболее востребован формат PDF, но ещё из DITA можно делать (X)HTML, DOCX и EPUB.
Регистрация тут: https://konveerum.ru/
NV
@nmpotashnikoff @kvaleev тут близкая вам тема. Если не проснётесь рано в субботу, накидайте мне вопросов, я их задам от вашего имени.
AY
@nmpotashnikoff @kvaleev тут близкая вам тема. Если не проснётесь рано в субботу, накидайте мне вопросов, я их задам от вашего имени.
Я буду в дороге, но постараюсь накидать
NV
Я буду в дороге, но постараюсь накидать
А ты заранее накидай, темы-то известны, а по первому докладу есть статья.
NV
А по второму можно @ulesko заранее поспрашивать )
FM
Темы очень интересные. Но по опыту, из Диты очень хорошо получается html, pdf (без таблиц - с таблицами надо заниматься жестким с..) и просто никакой docx.
Хорошо бы кто-то снял, чтобы посмотреть
Хорошо бы кто-то снял, чтобы посмотреть
NV
Fox Mulder
Темы очень интересные. Но по опыту, из Диты очень хорошо получается html, pdf (без таблиц - с таблицами надо заниматься жестким с..) и просто никакой docx.
Хорошо бы кто-то снял, чтобы посмотреть
Хорошо бы кто-то снял, чтобы посмотреть
Будет трансляция (правда, на ВК) и потом записи на Ютубе