ищется годный софт для подготовки мануалов, документации. плюс истории успеха.

сейчас тебе напишут latex

Слишком много требований. Ну совершенно любой вики-движок, например.

org-mode

пока открыл для себя Google Docs. Дешево и сердито…

Из чего можно сделать вывод, что автор не учился ни на математика, ни на физика, где без знания теха делать нечего)

Из чего можно сделать вывод, что автор не учился ни на математика, ни на физика, где без знания теха делать нечего)

Я вот учился на радиотехническом факультете и всякие рефераты-курсачи мы лабали в ворде, ловко тыкая разные мелкие кнопочки.

верстай в openoffice 4,1,11

все четко работает.

стили разработал и вперед.

я даже раздатку в ООо верстаю :)

С тех пор как типографии жуют pdf с rgb - забил всякий проф софт от адоба…

https://asciidoctor.org/

Латех, маркдаун, асциидок.

Пишите там, где удобно. Можете попробовать https://cryptpad.fr/.

Очевидный Notion.

Еще есть Coda, Slite, GitBook, Slab и т.д.

Шел 2021 год, а народ о латехе даже не слышал!

Жесть какая-то!

Бывают ВУЗы, сидящие на мелкомягкой игле. Их выпускники линух в глаза не видели. И о дядюшке Кнуте не слышали никогда! Пишут дипломы в ворде,а формулы вписывают руками. И библиографию руками. И предметный указатель. И отступы пробелами. И нумерацию вручную.

Шел 2021 год, а народ о латехе даже не слышал!

да мне не надо писать формулы насыщенных спиртов!

я мануал к «прекрасной ide будущего» пишу. работа простая, но буков много.

Markdown, Asciidoc.

Уже можно представить прекрасность этой ИДЕ, если её автор не знает про такие банальные вещи, более того, не может даже вопрос сформулировать.

сейчас тебе напишут latex

ИЧСХ будут правы.

Какая разница, что ты пишешь? Все равно лучше теха еще ничего не придумали для верстки любых текстов. А латех - хорошая надстройка, как С над асмом. Но знаний одного только латеха не хватит, если захочешь что-нибудь эдакое делать. И тут тебе поможет знание теха. Все-таки, тьюринг-полный язык — это тебе не пробелами в ворде отступы делать!

Уже можно представить прекрасность этой ИДЕ, если её автор не знает про такие банальные вещи,…

а автор и не обязан знать «банальные вещи» для технописа, автор не технопис.

автор вообще никому ни чем не обязан… и оказалось, что тулзов посоветовано немеряно, что говорит в некотором смысле о запущенности проблемы и некоем отсутствии мейнстрима.

Это не «банальные вещи для технописа», это банальные вещи для разработчика.

автор вообще никому ни чем не обязан

Безусловно.

и оказалось, что тулзов посоветовано немеряно, что говорит в некотором смысле о запущенности проблемы и некоем отсутствии мейнстрима.

Мейнстрим — маркдаун. А что вы дальше с ним будете делать — решайте сами (хоть в гитхаб выкладывайте, он умеет в его обработку).

Хоть бы описали, как видите результат документации. Можно же просто ман-страницу со ссылками на картинки, а можно как-то так.

Мейнстрим — маркдаун.

ни разу не видел чтобы разрабы писали доки на маркдауне. потому что разраб доки выкатывает начальству, заказчику или коллегам, а не кладет в бложик или страничку.

начальство или заказчик в бложик смотреть не будут. им в печатном виде с нумерованными страницами подавай, футерами и хидерами. короче, как настоящий увесистый мануал.

ни разу не видел чтобы разрабы писали доки на маркдауне

гитхаб открой, например, удивишься

потому что разраб доки выкатывает начальству, заказчику или коллегам, а не кладет в бложик или страничку.

Доки для коллег и начальства обычно пишутся в используемой вики-системе, confluence например

им в печатном виде с нумерованными страницами подавай, футерами и хидерами. короче, как настоящий увесистый мануал

Такое уже давно никому не нужно, но если все-таки нужно, то спасет только latex

ни разу не видел чтобы разрабы писали доки на маркдауне. потому что разраб доки выкатывает начальству, заказчику или коллегам, а не кладет в бложик или страничку.

У вас очень странное представление о маркдауне. Маркдаун — облегчённый язык разметки, его используют далеко не только в бложиках или страничках. Хотите — соберите из него ПДФ-документ, хотите — в гипертекст. А доки на маркдауне везде.

в свободном стиле, не гост

им в печатном виде с нумерованными страницами подавай, футерами и хидерами

Мейнстрим для свободного стиля, про который идёт речь — маркдаун.

Ну зачем (ла)тех для подобной банальщины?

Ну, вот, например. Банальщина, но значительно удобней в латехе делается. На маркДауне я бы такого не сделал никак. Особенно longtable и плавающие картинки. Да и нумерация страниц, оглавление…

Маркдаун - жутко неудобная дрянь. Он годится разве что для отображения краткого readme на гитхабе. А документация должна быть в нормальном pdf, со страничками, перекрестными ссылками, списком литературы, формулами, картинками, таблицами и т.д., и т.п.

Чтобы можно было распечатать и в сортире почитать.

Можно добавить к списку reStructuredText

Ну вы и сравнили, человеку нужно мануал к ИДЕ, а не доку подобную научной диссертации.

На маркДауне я бы такого не сделал никак. Особенно longtable и плавающие картинки

Вы бы конвертировали его в латех перед компиляцией, там бы дописали.

У Yii доки в маркдауне, а готовые в хтмл и пдф, читайте где удобно.

мануал к ИДЕ

Там явно будут разделы (следовательно, оглавление понадобится) и картинки. Так что, латех вполне поможет. Потому как иначе он не сгенерирует вменяемый pdf.

там бы дописали

А смысл, если удобней сразу в латехе писать?

… распечатать и в сортире почитать.

речь не мальчика со смартфоном, но мужа с нормальными жилищными условиями!

о чем я и говорю.

Возможно, видел его аж только у линукса.

Yii

Жуть, до чего же люди-опущенцы бывают! 2021 год на дворе, а они дырявый пыхпых используют!

Будто у пыха есть альтернативы.

https://en.wikipedia.org/wiki/Texinfo

Потому как иначе он не сгенерирует вменяемый pdf

Что вы привязались к пдф? Отдайте бразеру при печати нормальную страницу(там можно несколько версий стилей для экранов и для печати) вида ПДФ. Можете даже в пдф из браузера сохранять.

А смысл, если удобней сразу в латехе писать?

Времени больше на латех уходит. Там банально больше текста надо набирать.

В бесплатном onedrive есть бесплатный онлайн Ворд.

Мозг, например. Кто мешает сервер на С или С++ написать? Зачем это дырявое свистопердящее поделие, которое каждый, кому не лень, ломает, использовать?

Что вы привязались к пдф?

Потому что я люблю читать литературу, распечатанную на бумаге! Особенно если это - техническая литература, которую на миниатюрной читалке с 6-8" диагональю никак не прочесть.

Отдайте бразеру при печати

И будут картинки, разрезанные между страницами... Я молчу об отсутствии содержания и невозможности нормально писать формулы.

Времени больше на латех уходит

Зато в латехе возможностей - хоть отбавляй, а МаркДаун - тот еще отстой. Не зря его назвали в честь какого-то больного Марка…

Кто мешает сервер на С или С++ написать

Сервер и так на с(++), вы, вероятно, про бек.

Капитализм и здравый смысл.

На плюсах пишут в частных случаях, когда производительность важна.

Зачем это дырявое свистопердящее поделие, которое каждый, кому не лень, ломает, использовать?

Ещё раз: альтернатив нет. Знаете сколько времени уходит на пыхе, чтобы написать форму обратной связи? Там, с занесением в БД и отправкой мыла, мол, мы с вами свяжемся? Минут 10.

Некоторые генераторы статических сайтов его используют, например, nikola.

Sphinx, емнип,его поддерживает.

И будут картинки, разрезанные между страницами… Я молчу об отсутствии содержания и невозможности нормально писать формулы.

Нет, у вас будет стиль, мол, ширина картинки при печати — условные 18 см, остальное — отступы. Формулы через латех.жс или как вам удобно.

МаркДаун - тот еще отстой

Просто он вас в нём нет необходимости. Докблоки когда-то писали? Как и зачем туда впихивать латех, если есть маркдаун?

говорит в некотором смысле о запущенности проблемы и некоем отсутствии мейнстрима

Ну всё, придется писать что-то своё!

Как и зачем туда впихивать латех, если есть маркдаун?

Я хоть и пишу уже много лет комменты в стиле doxygen, никогда им не пользовался для генерирования документации. Ее я пишу вручную, т.к. то, что делает doxygen — убогое УГ.

Зачем? Ты все равно не сможешь сделать круче, чем дядюшка Кнут.

Вот представь себе: мужик решил книжку написать (хрень, честно говоря, но некоторые ее считают мегакрутой). Но в природе не было средств для компьютерной типографии. И он такое средство сделал, изучив все типографские штучки!!! А потом Лампорт упростил «для лохов» ТеХ. Ну, а Кнут написал свое «искусство программирования» (правда, обещался больше), которое нафиг никому не нужно… Зато кнутовский «Все про ТеХ» — бестселлер!!!

Ты все равно не сможешь сделать круче

А вдруг ТС может.

Доксиген вообще не замена рукописной документации, а от вспомогательный элемент.

Если б мог, сделал бы уже ☺

LaTeX

Ну всё, придется писать что-то своё!

хочется «оглавление-ориентированной» разработки документа.

пишется оглавление в виде дерева. кликаешь в нужный элемент и наполняешь его текстом и картинками. не понравился пункт оглавления в данном месте - перетянул его в дереве на новое место, соотвественно текст в документе переехал куда надо.

нужно между двумя пунктами вставить третий - вставил в дереве, в тексте документа соответственно появился его заголовок на нужном месте.

такое наверняка есть, только не знаю где.

О, дык, это просто нужно texstudio расширить дополнительным функционалом. Я бы тоже не отказался от такой возможности. Особенно когда редактируешь презентации и нужно слайд из одной позиции в другую перетянуть. Тут без облегчения в виде древовидной менюшки с содержанием приходится ctrl+x нужного куска, а потом долго искать, где сделать ctrl+v.