This is great! I'm building our docs using Aglio right now and it's great - this seems similar but with some interesting differences. Really good to see more options out there!
I don't understand all the fuzz about Markdown. Doesn't people realize that it exists other much more powerful lightweight markup languages like AsciiDoc?
I've never heard of AsciiDoc, but I'd say the biggest advantage that Markdown has is its ubiquity. It's used by GitHub, StackOverflow, Reddit, and even Tumblr has an option for it.
Also the fact that there are multiple (and good) client-side Markdown libraries while stuff like AsciiDoc generally requires server-side rendering (and the associated server load and round-trip penalties).
Unless I'm missing it, there's no pure client-side AsciiDoc?
Yeah, hard to say without a live demo. Also, downloading an entire Ruby interpreter in JS seems a little on the heavy side. If you were going to go that route, might as well use texlive.js and get a full-blown LaTeX system. :-)
I think ubiquity comes with knowledge, if there exists superior tools, people tend to use them eventually. I know that GitHub supports AsciiDoc already, one would hope that the other ones become enlightened!
It was simply the plain-text format I am currently using, I'm sure I can add in compatibility for AsciiDoc no probs. Just a matter of adding in an AsciiDoc renderer. :)
It looks powerful, but with a much steeper learning curve for non technical users[1]. I could see the nested list support being great for outlines, and tables look a lot more robust than in markdown, but I do not know if it is worth the tradeoffs of going against markdown's ubiquity.
I would like to add that nothing is technically generated* they. The markdown files are rendered on the fly using a Javascript Markdown parser. The layout is simply HTML5 and CSS, with a dash of jQuery to make the buttons work.
Does Google crawl this documentation? I know they have some JS support in their crawler, but is it enough that it would actually index a docsite built with this tool?
No, google doesn't. I've built a similar solution for the Cocos2D documentation that is going to be released soon.
I've added a php server component to deliver HTML snapshots to google crawlers for that purpose.
26 comments
[ 4.2 ms ] story [ 68.7 ms ] threadUnless I'm missing it, there's no pure client-side AsciiDoc?
[1]: http://asciidoctor.org/news/2013/05/21/asciidoctor-js-render...
Cool nonetheless.
[1] http://powerman.name/doc/asciidoc
1. https://github.com/tripit/slate
http://man7.org/linux/man-pages/man7/mdoc.7.html http://www.mono-project.com/Mdoc
This reply also breaks the guidelines. Please don't reply to incivility with incivility on HN. It's hard not to, but doing so only makes things worse.
New Link: http://chutsu.github.io/ditto/
This conflict may not be as confusing as the original name. I gather from the docs that you never invoke your version of ditto from the command line?
[1]: https://developer.apple.com/library/mac/documentation/Darwin...
I would like to add that nothing is technically generated* they. The markdown files are rendered on the fly using a Javascript Markdown parser. The layout is simply HTML5 and CSS, with a dash of jQuery to make the buttons work.