aboutsummaryrefslogtreecommitdiff
path: root/doc/forum
diff options
context:
space:
mode:
authorsmcv <smcv@web>2017-05-22 07:02:44 -0400
committeradmin <admin@branchable.com>2017-05-22 07:02:44 -0400
commitb29efcb4c6e2106a40c155f829ebfebf9cae30b7 (patch)
treeb76ffc3f6bc54c1e8d05ce4127f45f876f9816a9 /doc/forum
parent88ca349cd118aa3d62332e72d9ad0f4ca685e41e (diff)
downloadikiwiki-b29efcb4c6e2106a40c155f829ebfebf9cae30b7.tar
ikiwiki-b29efcb4c6e2106a40c155f829ebfebf9cae30b7.tar.gz
Added a comment: I suggest asking macOS/brew people
Diffstat (limited to 'doc/forum')
-rw-r--r--doc/forum/How_to_install_Text:Multimarkdown__63__/comment_1_1095806303c9d701d71078efe431e35e._comment40
1 files changed, 40 insertions, 0 deletions
diff --git a/doc/forum/How_to_install_Text:Multimarkdown__63__/comment_1_1095806303c9d701d71078efe431e35e._comment b/doc/forum/How_to_install_Text:Multimarkdown__63__/comment_1_1095806303c9d701d71078efe431e35e._comment
new file mode 100644
index 000000000..52b5ef753
--- /dev/null
+++ b/doc/forum/How_to_install_Text:Multimarkdown__63__/comment_1_1095806303c9d701d71078efe431e35e._comment
@@ -0,0 +1,40 @@
+[[!comment format=mdwn
+ username="smcv"
+ avatar="http://cdn.libravatar.org/avatar/0ee943fe632ff995f6f0f25b7167d03b"
+ subject="I suggest asking macOS/brew people"
+ date="2017-05-22T11:02:44Z"
+ content="""
+The multimarkdown option is not necessarily a good idea. The default
+and recommended Markdown implementation in ikiwiki is Discount, which already
+supports many of the same extensions as multimarkdown (in released versions of ikiwiki,
+footnotes are a notable omission, but those will be enabled by default in the
+next release).
+
+If you want to use multimarkdown anyway, please check what the search path is
+for the version of Perl that you are using to run ikiwiki. In particular, the
+most reliable setup is likely to be one where you get Perl, Text::MultiMarkdown
+and IkiWiki from the same vendor (for example Homebrew or pkgsrc) without
+mixing those vendors.
+
+If you obtained one of those packages (for example ikiwiki) by building it
+yourself from source code, its author is unlikely to be able to help you
+unless they happen to be a macOS user themselves, which most of the ikiwiki
+contributors are not. If you are doing this, you should make sure you
+understand how Perl finds libraries (for example this is described in
+the perlrun man page). It might be necessary to add
+
+```
+ENV:
+ PERL5LIB: /some/path:/some/other/path
+```
+
+(YAML syntax) or
+
+```
+ ENV => {
+ PERL5LIB => \"/some/path:/some/other/path\",
+ },
+```
+
+(Perl syntax) to your [[setup file|setup]].
+"""]]