ME
пошарили сегодня в чяте Write the Docs, лучшая документация которую я видела за долгое время: https://archive.org/details/JohnMuirVwSounds
да, годно
работать только с текстом — ограничивать себя сильно
Size: a a a
2021 October 04
ME
и одновременно немного ASMR )
2021 October 05
D
Коллеги, подскажите, можно ли как-то использовать inline markup с заменами в Sphinx? Например, "**|substitution|**" Сейчас не заменяется в таком виде
NV
inline markup должен быть в теле заменяемого блока
D
Понятно, спасибо!
LR
Вопрос по внутренним ссылкам Sphinx.
Допустим, есть структура документации:
> a
>> a_foo
>>> a_bar
> b
>> b_foo
> c
Я могу, к примеру, из файла b_foo сослаться на файл a_bar? Просто где-то упоминалось, что внутренние ссылки можно размещать либо на разделы того же уровня, либо на уровень ниже. Но не выше.
Допустим, есть структура документации:
> a
>> a_foo
>>> a_bar
> b
>> b_foo
> c
Я могу, к примеру, из файла b_foo сослаться на файл a_bar? Просто где-то упоминалось, что внутренние ссылки можно размещать либо на разделы того же уровня, либо на уровень ниже. Но не выше.
NV
Mожно ссылаться куда угодно внутри проекта. Ссылки могут быть абсолютными или относительными, вот точно как на вебе или в файловой системе
NV
из любого места
:doc:`link to a </a>
:doc:`link to a_foo </a/a_foo>`
из a
:doc:`relative link to a_foo <./a/foo>`
NV
это если у вас лежит документ a.rst и рядом с ним папка а, в которой a_foo
LR
Спасибо!
NV
можно даже использовать путь «наверх»:
но это штука хрупкая
из b_foo
:doc:`link to a <../a>`
:doc:`link to a_foo <../a/a_foo>`
но это штука хрупкая
MM
Привет всем. У меня на работе хотят помочь с обучением. Могут оплатить наставничество. Знаю, что @Nick_Volynkin консультирует. Как у тебя по загруженности? Получится в ближайшее время этим заняться?
Если нет, то может кто-то в курсе, у кого можно получить консультации по техническому писательству?
Если нет, то может кто-то в курсе, у кого можно получить консультации по техническому писательству?
NV
ко мне лучше сразу в личку приходить :)
NV
но есть ещё и другие прекрасные люди: https://getmentor.dev/#tags:Content/Copy
2021 October 07
VS
AB
Привет!
Подскажите, есть ли для sphinx возможность публикации в Wiki OpenProject?
Подскажите, есть ли для sphinx возможность публикации в Wiki OpenProject?
D
Коллеги, подскажите, пожалуйста, pandoc при конвертации docx>rst всегда указывает размеры изображений в дюймах или это как-то настраивается?
2021 October 08
ME
Смотрите какое красивое: https://www.notion.so/blog/sharding-postgres-at-notion
Организация информации, картинки, активный залог, ясные предложения
Организация информации, картинки, активный залог, ясные предложения
ИЦ
IDE для markdown/XML
А тем временем JetBrains что-то готовит:
https://lp.jetbrains.com/stardust-landing/
На лендинге есть ссылка для того, чтобы подписаться на Early Access Program. Верим, надеемся, ждём 😌
А тем временем JetBrains что-то готовит:
https://lp.jetbrains.com/stardust-landing/
На лендинге есть ссылка для того, чтобы подписаться на Early Access Program. Верим, надеемся, ждём 😌
