Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Nested Lists #8

Open
rmzelle opened this issue Jul 9, 2013 · 3 comments
Open

Nested Lists #8

rmzelle opened this issue Jul 9, 2013 · 3 comments

Comments

@rmzelle
Copy link
Contributor

rmzelle commented Jul 9, 2013

It looks like nested lists are rather buggy in Maruku, the markdown parser used by GitHub Pages. See bhollis/maruku#55 and http://zotero-manual.github.io/zotero-manual/introduction#the_case_for_using_a_reference_manager (with 2 spaces, some of the <li> elements contained a <p>, which messed up the formatting; with 4 spaces, the nested lists aren't even recognized)

Some folks suggest switching to the other available parser, rdiscount. See e.g. https://github.com/phleet/blog/blob/master/_config.yml and https://groups.google.com/forum/#!topic/jekyll-rb/VbsCVo03E78

@rmzelle
Copy link
Contributor Author

rmzelle commented Jul 11, 2013

I found a recent discussion about the shortcomings of Maruku, where somebody from GitHub mentions that they're not too happy with the current default either: jekyll/jekyll#1236

They recommend redcarpet instead of rdiscount.

Also relevant, a stackoverflow entry on extensions for redcarpet: http://stackoverflow.com/questions/16099153/table-not-render-when-use-redcarpet-in-jekyll-github-pages

@rmzelle
Copy link
Contributor Author

rmzelle commented Jul 11, 2013

Can't find any information on whether it's possible to automatically create TOCs with redcarpet, though. Grumble.

@rmzelle
Copy link
Contributor Author

rmzelle commented Jul 15, 2013

Nested lists should be fixed in the next release, Maruku 0.7.0. No ETA, but if we stick with it we might be able to have our cake and eat it too.

For compatibility, we might want to use 4 spaces per identation level, which seems to be the pandoc requirement: "The nested list must be indented four spaces or one tab" (http://johnmacfarlane.net/pandoc/README.html).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant