3 ms·
I use Pelican on a couple of sites (like http://dylanfoundry.org/ http://dylanfoundry.org/). One thing that I really like is that it is ReStructured Text, so mo
by BruceM 14y ago
I use Pelican on a couple of sites (like http://dylanfoundry.org/ http://dylanfoundry.org/). One thing that I really like is that it is ReStructured Text, so most of the same things that I do with Sphinx for docs can carry over and the work that I've done with Pygments for syntax highlighting, still applies.
There's some room for improvement here and there, but it works pretty well and was easy to get going.
- yen223 14y agoAre there any good guides to using ReStructuredText? I love all things Python, but for some reason I could never wrap my head around ReStructuredText's syntax. Maybe it's because all my favorite sites use Markdown (including this one!), but I find Markdown's syntax to be more intuitive.
- dochtman 14y agoStart here: http://sphinx-doc.org/rest.html http://sphinx-doc.org/rest.html Then go here for more: http://docutils.sourceforge.net/docs/user/rst/quickref.html http://docutils.sourceforge.net/docs/user/rst/quickref.html I don't really understand why reST is so unpopular compared to Markdown.
- BruceM 14y agoI do wish that the process for extending docutils and Sphinx were better documented. There's also a bunch of things in Sphinx that need improvement with the PDF and ePub output. But for what it is and does, I like it a lot. I don't know of anything for Markdown that lets me do as much structured markup as I can do in reST.
- xintron 14y agoFor HTML generation Markdown is much easier for most people to get used to and understand. When needing to provide output in various formats reST is more suited but also have a bit of a steeper learning curve. It depends on what you're doing. For documentation I'm always running reST but for articles for sites etc (with a static site generator) I will turn to Markdown.
- evilduck 14y agoI second this opinion, though it's been a couple years since I last used it. Designing complex tables in reST was far more cumbersome to me than just writing it in HTML. It requires you to basically know the HTML your markup syntax will generate anyways, then deal with the quirks of that but with less overall control than raw HTML gives you. However, generating PDFs, a static website, and any other formats from a single reST document is much easier than doing to equivalent from an HTML document so it has its uses, but I would not use it as blogging markup unless I planned on publishing a book from the same blog content.
- piranha 14y ago> I don't really understand why reST is so unpopular compared to Markdown. There are two reasons: first is that Markdown is much simpler and is more narrow scoped and second is that reST implementation only exists in Python and Haskell - to some extent, not supporting extensions, obviously. Both of those reasons make entry level higher.
- human_error 14y ago> I don't really understand why reST is so unpopular compared to Markdown. Markdown is so much simpler than Rest.
- tangue 14y agoSidenote : you can use Markdown with Pelican if you want. You just need to install the Markdown package.
- eliben 14y agoReST and Markdown are not at odds. The former can be seen as a (vast) expansion of the latter. It's not an actual extension, of course, because the syntax is somewhat different, but it is conceptually.
- d0m 14y agoHa, didn't know Dylan. Seems like a fun little language. Thanks for sharing.