Давно хотелось разобраться с этим вопросом. Ведь аскидок очень удобен и гибок.
Посмотрите на его синтаксис и его документацию - это просто красиво.
К сожалению аскидок командная утилита, и каждый раз генерить html файл не очень удобно.
Есть всякие превьюхи для него:
- Десктопный превью написанный на JavaFX - asciidocfx
- Расширение для хрома
- Есть расширение для Sublime text и Atom и brackets
Почти все они описаны тут
Все утилиты такого рода подразумевают WYSIWYG редактирование, но не решают проблему - перегенерирование документов при каждом редактировании.
Почему нельзя автоматически это делать в браузере? Ведь расширение хрома указывает на то что такая возможность есть.
И если бы получилось писать например документацию в аскидок формате и потом отображать динамически браузером это было бы здорово.
Такая возможность есть! Ладно, хватит болтовни.
“Talk is cheap. Show me the code.”
Linus Torvalds
Весь код доступен на гитхабе Там же приведена инструкция - какчё-куда.
И еще раз там же висит демка
Дальше можно полюбоваться на:
- красивую документацию грувей, которая тоже использует аскидок;
- как спринг переводил свои доки на аскидок
- генерировать rest-документацию с помощью gradle
- и совсем сумасшедшее превью аскидока на грускрипте(именно из-за грускриптаоно сумасшедшее)
Даже Аллен удивлен.