Commit Graph

22 Commits (2bde54c9dc0e1776882f4e0fef5750296e848c5b)

Author SHA1 Message Date
Simon McVittie 4fd5f7d910 Clarify documentation 2017-05-16 08:28:04 +01:00
Simon McVittie c72dc5ddb7 mdwn: Don't enable alphabetically labelled ordered lists by default
This avoids misinterpreting initials ("C. S. Lewis was an author"),
the abbreviation for Monsieur ("M. Descartes was a philosopher") and
German page numbering ("S. 42") as ordered lists if they happen to
begin a line.

This only affects the default Discount implementation: Text::Markdown
and Text::MultiMarkdown do not have this feature anyway. A new
mdwn_alpha_list option can be used to restore the old interpretation.
2017-05-16 08:09:15 +01:00
smcv 75f905a18a 2017-05-14 07:53:24 -04:00
smcv 65fe86e6f3 recommend discount over multimarkdown 2017-05-14 07:51:56 -04:00
Joey Hess 9dce803faf discount support
mdwn: Can use the discount markdown library, via the
Text::Markdown::Discount perl module.

This is preferred if available since it's the fastest currently supported
markdown library, speeding up markdown rendering by a factor of 40.

That is to say, when only rendering a lot of markdown, discount is 40x
faster. When building a ikiwiki site, ikiwiki's other overhead gets in the
way, but I still see significant speedups. Building the ikiwiki docwiki
dropped from 62 to 45 seconds, for example.

However, when multimarkdown is enabled, Text::Markdown::Multimarkdown is
still used.

While discount contains some nonstandard markdown extensions,
including tables and footnotes, AFAICS most of them are not
enabled by default in the perl bindings.

I consider sticking to non-extended markdown a desirable thing, since this
is probably not the last markdown engine. In particular, sundown is waiting
in the wings to get packaged and get a perl binding.

----

Reviewing all the showdown extensions, here are the ones that are enabled:

centered paragraphs:

->centered<-

image sizes: [dust mite](http://dust.mite =150x150)

<style>..</style> blocks are eaten. The perl binding does not provide
access to the gathered CSS. This is not legal html anyway, so unlikely
to cause breakage.
2012-01-01 17:28:31 -04:00
Joey Hess 9e195018a2 remove ^P's 2009-08-31 19:30:31 -04:00
martin 9492bf3158 fixed link 2009-08-31 11:03:20 -04:00
Joey Hess a86de9b1f6 update for Text::MultiMarkdown split 2009-08-30 19:17:45 -04:00
Simon McVittie 297ff849b9 Migrate doc/plugins via prefix_directives
This is a partial commit of:
egrep -rl '\[\[[a-z]+ ' doc | xargs --max-args 1 ./ikiwiki-transition
prefix_directives
2008-07-21 12:31:57 +01:00
Joey Hess 62ac574b36 web commit by buo: Typo 2008-05-13 14:57:01 -04:00
Joey Hess fba4a198b5 mdwn: Add a multimarkdown setup file option. 2008-05-13 12:43:25 -04:00
Joey Hess 7960031135 MAJOR basewiki reorg
Including redir pages for the moved basewiki pages. These will be removed in
a future release.
2007-12-08 15:59:08 -05:00
joey 96125d8da5 * Allow multiple tag settings to appear in a single page. 2007-02-14 04:05:08 +00:00
joey 0659624ecd web commit by JoshTriplett: Restore type/core tag; template did not work as expected. 2007-02-14 02:05:39 +00:00
joey 95da104fc3 web commit by JoshTriplett: The plugin template supplies the core tag now. 2007-02-14 02:03:30 +00:00
joey 19c58ac7c1 simplified plugin definitions 2007-02-13 18:51:21 +00:00
joey 8f8959c96e no longer need triple quotes 2006-08-23 20:27:18 +00:00
joey 9d7375c3b2 * Allow preprocessor directives to contain python-like triple-quoted
text blocks, for easy nesting of quotes inside.
* Add a template plugin.
* Use the template plugin to add infoboxes to each plugin page listing basic
  info about the plugin.
2006-08-23 05:41:07 +00:00
joey becacc5566 updats 2006-07-29 22:25:40 +00:00
joey 7f1313c052 * Tag plugins according to type. 2006-07-29 22:15:45 +00:00
joey 08890fdd7f misc updated 2006-07-03 22:35:30 +00:00
joey 6551c1e560 * Support htmlize plugins and make mdwn one such plugin, which is enabled by
default (of course!). Based on a patch by Faidon Liambotis.
2006-07-03 22:08:04 +00:00