rK
Спасибо за вытаскивание картинок) то что надо
Size: a a a
2020 September 01
NV
Да, в превью нет. Когда html собираешь всё на месте. У нас тут часто мелкие детали интерфейса меняются, и бывает что изменения только картинки и затрагивают, то есть важно при редактировании их видеть. Попробую VSCode тогда.
Я не использую превью, потому что там документ всё равно не такой, как на сайте получается. Просто пересобираю сайт.
PV
Привет, у меня два вопроса:
1. Чем вы редактируете rST? Мне бы какой-нибудь редактор, чтобы там хорошее превью было, всё красиво и понятно. У меня PyCharm под виндой прописную И не пишет, картинок тоже нет. Погуглил, советуют ReText и Formiko, которые только под линукс.
2. Кто подскажет нюансы конвертирования docx в rst с помощью pandoc и главное фильтров pandoc. Я тут всю свою документацию (70 файлов) привел к одному шаблону, с одними стилями и так далее и теперь по идеи при конвертации можно легко задать как какой стиль конвертировать в rst, но я не знаю как, а то щас у меня pandoc даже картинки из ворда не сохраняет никуда, не говоря уже о том, чтобы настроить конвертацию заголовков там или таблиц. Я там тож погуглил, фильтры можно на питоне с помощью panflute сделать, но что-то разобраться с синтаксисом этих самых фильтров не могу, чтобы под свои документы подстроить.
1. Чем вы редактируете rST? Мне бы какой-нибудь редактор, чтобы там хорошее превью было, всё красиво и понятно. У меня PyCharm под виндой прописную И не пишет, картинок тоже нет. Погуглил, советуют ReText и Formiko, которые только под линукс.
2. Кто подскажет нюансы конвертирования docx в rst с помощью pandoc и главное фильтров pandoc. Я тут всю свою документацию (70 файлов) привел к одному шаблону, с одними стилями и так далее и теперь по идеи при конвертации можно легко задать как какой стиль конвертировать в rst, но я не знаю как, а то щас у меня pandoc даже картинки из ворда не сохраняет никуда, не говоря уже о том, чтобы настроить конвертацию заголовков там или таблиц. Я там тож погуглил, фильтры можно на питоне с помощью panflute сделать, но что-то разобраться с синтаксисом этих самых фильтров не могу, чтобы под свои документы подстроить.
1. Использую VS Code (плагин lextudio.restructuredtext). С такими проблемами не сталкивался.
FM
Пишу в asciidoc через vs code, билдю antora. Скринов на превью тоже нет, а при билде в сайт - есть.
Проще поставить http-server и им проверять.
Проще поставить http-server и им проверять.
IC
А кто-то использует в работе или для личных целей GitBook?
H
Коллеги, кто-то из вас сотрудничал или сотрудничает с ребятами из JetAdmin?
2020 September 02
rK
Итак, если кому интересно насчет превью rST для удобного редактирования:
1. Ставим Visual Studio Code
2. Устанавливаем python, при установке надо поставить галочку добавить python в системный путь. (возможно, это необязательный шаг, но лишним не будет)
3. Накатываем следующие плагины/расширения для VSCode:
• reStructuredText от LeXtudio Inc
• Python от Microsoft
4. Устанавливаем docutils и sphinx (если нужен). Через pip install в терминале VSCode: pip install docutils и pip install sphinx sphinx-autobuild
5. Ещё написано можно установить Doc8 or RstCheck как Linter: pip install doc8 и pip install rstcheck
*так как я устанавливал docutils, sphinx, Doc8 и RstCheck в виртуальное окружение, то потом в настройках плагина reStructuredText в поле restructuredtext > Linter: Executable Path надо прописать адрес к виртуальному окружению, иначе VSCode ругается что не может найти линтеры.
Теперь при открытии rST файлов выводит превью, даже с картинками. А если открыть сразу папку проекта sphinx с виртуальным окружением (я его уже сделал ранее в PyCharm), то в превью генерится ваш сайт sphinx, но можно выбрать и обычное превью через docutils
1. Ставим Visual Studio Code
2. Устанавливаем python, при установке надо поставить галочку добавить python в системный путь. (возможно, это необязательный шаг, но лишним не будет)
3. Накатываем следующие плагины/расширения для VSCode:
• reStructuredText от LeXtudio Inc
• Python от Microsoft
4. Устанавливаем docutils и sphinx (если нужен). Через pip install в терминале VSCode: pip install docutils и pip install sphinx sphinx-autobuild
5. Ещё написано можно установить Doc8 or RstCheck как Linter: pip install doc8 и pip install rstcheck
*так как я устанавливал docutils, sphinx, Doc8 и RstCheck в виртуальное окружение, то потом в настройках плагина reStructuredText в поле restructuredtext > Linter: Executable Path надо прописать адрес к виртуальному окружению, иначе VSCode ругается что не может найти линтеры.
Теперь при открытии rST файлов выводит превью, даже с картинками. А если открыть сразу папку проекта sphinx с виртуальным окружением (я его уже сделал ранее в PyCharm), то в превью генерится ваш сайт sphinx, но можно выбрать и обычное превью через docutils
NV
Раз нарушаете правила, будьте готовы принять последствия.
s.
эх, ну думаю рискнуть стоило)))
ML
Удивительно волнующая вещь. Заняться не очередной рекламной биржей или облачным оркестратором, а чем-то, что даст возможность хорошо жить правнукам.
Сколько времени нужно вникать в тему, чтобы хотя бы не путать нейтрон с нейтрино и не называть электронные дырки отверстиями?
Сколько времени нужно вникать в тему, чтобы хотя бы не путать нейтрон с нейтрино и не называть электронные дырки отверстиями?
СФ
Удивительно волнующая вещь. Заняться не очередной рекламной биржей или облачным оркестратором, а чем-то, что даст возможность хорошо жить правнукам.
Сколько времени нужно вникать в тему, чтобы хотя бы не путать нейтрон с нейтрино и не называть электронные дырки отверстиями?
Сколько времени нужно вникать в тему, чтобы хотя бы не путать нейтрон с нейтрино и не называть электронные дырки отверстиями?
зачастую «правильная» предметная область компании не влечет за собой интересные задачи на местах.
До сих пор вспоминаю эмоциональный рассказ товарища, уходившего из 2ГИС с формулировкой вида «картография, открытый город, навигация — круто, пилить скучные апишки — не круто»
До сих пор вспоминаю эмоциональный рассказ товарища, уходившего из 2ГИС с формулировкой вида «картография, открытый город, навигация — круто, пилить скучные апишки — не круто»
DL
Удивительно волнующая вещь. Заняться не очередной рекламной биржей или облачным оркестратором, а чем-то, что даст возможность хорошо жить правнукам.
Сколько времени нужно вникать в тему, чтобы хотя бы не путать нейтрон с нейтрино и не называть электронные дырки отверстиями?
Сколько времени нужно вникать в тему, чтобы хотя бы не путать нейтрон с нейтрино и не называть электронные дырки отверстиями?
один семестр
NV
Вопрос про компанию JetAdmin. Если кто-то здесь с ними работает или собирается — загляните на обсуждение в чат https://t.me/technicalwriters.
NV
Переслано от Семён Факторович...
так, давайте по-другому вопрос поставим: кто-то уже ведет с ними коммерческую деятельность, с подписанным договором или уже выплаченными деньгами?
AR
слишком много каналов для техписов...
v
Любые вакансия техписа: умение обрабатывать большое количество информации
Чатик техписов: слишком много каналов для техписов
Чатик техписов: слишком много каналов для техписов
NV
слишком много каналов для техписов...
Вы про чаты? А @docsascode — не чат для техписов :) Это чат для всех, кому интересна документация как код.
AR
а мне все интересно, но меня раздражает обилие каналов, что делать?)
NV
Таки каналов или чатов?
AR
ну давайте придираться к словам)) мне удобно когда все в одном месте